Skip to main content
GET
Usage and billable amounts per end customer

Authorizations

Authorization
string
header
required

Your AI Reserve API key (aireserve_api_…) from the API Keys page in the portal (https://portal.aireserve.com/keys).

Query Parameters

start
string

Inclusive start of the period: a UTC date (2026-10-01) or an RFC 3339 timestamp. Defaults to 30 days before end.

end
string

Exclusive end of the period: a UTC date or an RFC 3339 timestamp. Defaults to now. The period may span at most 92 days.

Response

OK

period
object
required

The period the figures cover.

currency
enum<string>
required
Available options:
USD
has_pricing_rules
boolean
required

Whether at least one of your pricing rules applies to the period. When false, billable_usd and margin fields are omitted everywhere.

truncated
boolean
required

True when the period held more rows than one response carries and the cheapest were dropped. Narrow the period or query one customer.

customers
object[]
required

One row per tagged customer, highest cost first.

untagged
object
required

Usage with no x-aireserve-customer tag. Cost only — untagged requests are never priced. Sourced from hourly aggregates, so it can trail live traffic by a few minutes.

totals
object
required

Sum over every tagged customer in the period.