Skip to main content
GET
Get Usage

Authorizations

Authorization
string
header
required

Send Authorization: Bearer <access_token>. This must be an account API access token minted via a supported Parallel OAuth grant, not a standard API key. See the account API docs.

Query Parameters

start_date
string<date>
required

UTC start date, inclusive. Must be within the last 365 days.

end_date
string<date>
required

UTC end date, exclusive. Window of at most 365 days.

interval
enum<string>
default:daily

Span granularity. 'daily' returns one span per UTC day; 'monthly' returns one span per UTC calendar month, clamped to the requested window, with that month's line items summed.

Available options:
daily,
monthly

Response

Successful Response

Usage spans for the authenticated organization.

usage
UsageSpanResponse · object[]

Usage spans, ascending by start time