Skip to main content
GET
Monthly Usage
Return recorded external billable usage for the calling API key, across products, for one UTC calendar month. Other keys on the same billing account have separate histories. Replacing a key does not transfer the old key’s usage history. This read works with zero or negative balances. It does not spend credits or consume inference QPS. Responses use Cache-Control: no-store.

Query parameter

string
One UTC calendar month in YYYY-MM form, such as 2026-10. Defaults to the current UTC month and includes transactions committed so far. Future months are rejected.
Use month to select a UTC calendar month. Use the dashboard for account-wide history.

Examples

Response

string
The selected UTC calendar month in YYYY-MM form.
integer
Count of recorded billable requests across products.
string
USD decimal string summing the recorded charges for those requests.
An unused month returns zero requests and "0.000000" cost. These values represent recorded credit consumption. Use /balance for the available credit balance and decimal arithmetic for USD amounts.

Read limits and errors

This route shares the independent account-read budget with balance and limits calls. Respect Retry-After on 429.