Skip to main content
GET
Returns the account’s cumulative usage in the same shape as OpenAI’s /dashboard/billing/usage, so existing credit-checking tools work against it unchanged.
Two things catch people out: total_usage is in cents (USD × 100), not dollars; and this endpoint ignores start_date / end_date — a wallet reports a cumulative figure, not a per-day slice.

​
Authorizations

​
string
required
Bearer YOUR_API_KEY.

​
Response

​
string
Always list.
​
number
Usage to date, in cents. Divide by 100 for dollars — the 348.2914 above is $3.482914.

​
Deriving the remaining balance

OpenAI’s tools compute what is left as total credit minus usage:
Get balance returns the remaining balance directly as total_available_usd, with no subtraction needed.