GET/api/billing/events

Billing & top-ups

Read billing events and top-up records, poll a checkout session, get a payment link, and list manual credit adjustments.

Billing events#

GET /api/billing/events#

Line-item billing activity (the 90-day ledger view shown in the console). Filter by time range, modality, model, billing status, key or request id; cursor paging.

Field	Type	Description
org_id	string · required	Organization id.
from / to	string	Time range (ISO 8601).
modality / unified_model_name	string	Filter by modality or model.
billing_status	string	e.g. billed / pending / unbilled.
api_key_doc_id / request_id	string	Drill down to one key or one request.
limit / cursor	—	Paging.

Top-ups and checkout#

GET /api/billing/topups#

Top-up records for the calling account (ledger entries enriched with live payment status).

GET /api/billing/topup-status#

Poll the status of one checkout session (session_id) until the payment lands.

GET /api/billing/checkout-url#

Returns a payment link URL for a given sku — the API equivalent of the console's top-up button.

Manual credit adjustments#

GET /api/me/manual-credit-history#

Manual credit adjustments applied to your account (grants, corrections), with action, time range and offset paging.

Next steps

PreviousUsage & balance NextModel catalog

Was this page helpful?