Skip to main content
GET
Node.js

Authorizations

Authorization
string
header
required

Send your API key as a bearer token: Authorization: Bearer sk_<secret>.

Query Parameters

start
string<date-time>
required

Inclusive ISO 8601 start timestamp. Must include a time zone.

end
string<date-time>
required

Inclusive ISO 8601 end timestamp. Must include a time zone, fall after start, and sit within 180 days of it.

Response

Daily costs across every API key in the project, bucketed by UTC calendar date in ascending order. Buckets cover zero-cost days and the end date, and the first and last bucket can each cover a partial day. Costs are reported in USD and can lag recent charges, so read them as usage telemetry rather than an authoritative billing ledger. Responses are sent with Cache-Control: no-store.

currency
enum<string>
required
Available options:
USD
data
object[]
required

One bucket per UTC calendar date in the range.

total_cost
number
required

Total cost for the range in USD.

Example:

3.45

start
string<date-time>
required

Start of the requested range.

end
string<date-time>
required

End of the requested range.