Skip to main content
GET
Usage aggregates

Authorizations

Authorization
string
header
required

Short-lived JWT issued by the CarHub auth service (Better Auth), verified against its JWKS. Claims: sub (user), org_id (active organisation) and role (owner | admin | member | billing_manager). Used by the dashboard for /mgmt/v1/… only — it is never accepted on /v1/….

Query Parameters

days
integer
default:30
Required range: 1 <= x <= 365
livemode
boolean

Keep only live (true) or test (false) records. Omitted, both are returned.

is_staging
boolean

true selects staging; false selects production in live mode or sandbox in test mode. Omitted, includes both production and staging in live mode. true requires livemode=true.

Response

A page of usage rows plus period totals.

object
string
required
Allowed value: "usage"
days
integer
required
Required range: 1 <= x <= 365
livemode
boolean
required
data
object[]
required
totals
object
required

Totals across the returned environments for the requested period.