Skip to main content
GET
Get Daily Usage

Authorizations

Authorization
string
header
required

Your API key (ta_live_…) from Settings → API keys, sent as Authorization: Bearer <key>. Keep it on a server: it can message every customer you have. A key is full, build or read-only; a request its level does not allow is refused with 403.

Headers

Thinnest-Workspace
string

Developers only: the customer workspace this request acts in — its org_… id from POST /customers. Leave it out to act in your own workspace.

Example:

"org_3fKq9TzQ1mN8vB2xR7cLpA"

Query Parameters

days
integer
default:30

A rolling window ending today (UTC). Not with from/to.

Required range: 1 <= x <= 90
from
string<date>

First UTC day, YYYY-MM-DD. Needs to.

to
string<date>

Last UTC day, YYYY-MM-DD. Needs from.

Response

Daily usage.

timezone
enum<string>
required

The clock the days are counted in. Always UTC, as on the Usage chart.

Available options:
UTC
from
string<date>
required

First day counted.

to
string<date>
required

Last day counted (a to past today is cut to today).

totals
object
required
days
object[]
required

Every day in the range, quiet days as zeros.