Billing and Usage API

Manage subscriptions, payments, credits, budgets, and usage. Inspect usage by account, project, member, or API key. Use budgets to cap monthly AI spend. Subscriptions · Billing Details · Invoices · Payment Methods · Payments · Credits · Budgets · Account usage · Project usage · API key usage · Feature gates

​

Subscriptions

Read, upgrade, or cancel the account subscription. Create a checkout session or open the billing portal.

​

Billing Details

Read or update account billing details.

​

Invoices

List invoices and upcoming invoices.

​

Payment Methods

List, attach, detach, or select payment methods.

​

Payments

List account payments.

​

Credits

Check the credit balance, review transactions, buy credits, or redeem a coupon.

​

Budgets

Set monthly AI spending caps by project, person, API key, or a combination of these fields. New budgets count spending already incurred that month; use PATCH /budgets/{budget_id} to change an existing cap.

​

Account usage

Read account consumption, credit usage, limits, trends, and warnings.

​

Project usage

Use member usage for project AI spend by person and automation. The project usage endpoint returns the project owner’s account-wide totals, not project-attributed usage.

​

API key usage

List usage across API keys or inspect one key. Manage the keys themselves through API key endpoints. Manage inference limits for project-bound keys.

​

Feature gates

Check access to a named plan or feature gate. Individual endpoints still enforce their resource permissions. Back to REST API reference