API Reference › Account › Get billing

Free · account read

POST/get_billing

Get billing

Return billing summary, renewal date, and recent token usage. Never charged.

Request body

Empty object

Bearer auth required

Send an empty JSON object. No request parameters are required.

Response

application/json

A processed request returns status: "ok". The nested result may be empty; in that case tokens_charged remains zero.

results.subscription_status

active, trialing, or canceled.

results.renewal_at

Next renewal timestamp when applicable.

results.tokens_used_period

Tokens consumed in the current billing window.

metadata.tokens_charged

Credits charged for the returned result. Zero for a miss.

metadata.fair_use

Remaining records and reset timestamps for applicable plan windows.

400

Malformed request body

401

Missing or invalid API key

422

Unsupported filter value

429

Rate limit exceeded