GET
Get Usage Breakdown

Authorizations

Authorization
string
header
required

An EESI API key (sk-eesi-...) or a Clerk session token.

Headers

authorization
string | null
X-API-Key
string | null

Query Parameters

days
integer
default:30

Window length in days

Required range: 1 <= x <= 365

Response

Successful Response

period_start
string
required
period_end
string
required
charged_cents
number
required
comped_cents
number
required
spend_cents
number
required
entries
integer
required
billing_exempt
boolean
required
unattributed
UsageUnattributed · object
required

Work with no API key behind it — the console, and history predating key attribution. Reported so the key rows always sum to the total.

by_kind
UsageKindBreakdown · object[]
by_model
UsageModelBreakdown · object[]
by_api_key
UsageApiKeyBreakdown · object[]