Skip to main content
GET
Account Reporter V2
This call is free — it does not consume credits or count against your rate limit.

What this endpoint does

Returns usage counters and remaining balance for both the authenticated API key (key_usage) and the entire account (account_usage). The two objects are identical if you only have one key. If you have multiple keys, account_usage reflects the sum across all keys.

Query parameter

Pass month in YYYY-MM format to get usage for a specific month. If omitted, returns the current month.

Usage fields

Both key_usage and account_usage return the same set of counters:

Authorizations

x-api-key
string
header
required

To access the API, provide your API key in x-api-key.

Query Parameters

month
string

Optional month in YYYY-MM format used to scope usage counters.

Required string length: 7
Pattern: ^\d{4}-\d{2}$

Response

Success. You can check usage.

Account reporter response containing key-level and account-level usage metrics.

key_usage
object

Usage counters for a given time window.

account_usage
object

Usage counters for a given time window.

balance_remaining_usd
number<float>
Example:

23.34