Account-level billing routes for listing owned billing accounts, reading balances, summaries, and transactions. Billing accounts are the top-level source of truth for balances, lifetime charged amounts, and free-tier attribution. Every user receives a default billing account with 1000 cents of introductory credit. Workspaces bind to one billing account as their default billing source, and can optionally link additional billing accounts.

​
Account Routes

ActionEndpoint
List owned billing accountsGET /billing-accounts
Get billing account detailsGET /billing-accounts/{billingAccountId}
Get billing account balanceGET /billing-accounts/{billingAccountId}/balance
Get billing account summaryGET /billing-accounts/{billingAccountId}/summary
Get billing account transactionsGET /billing-accounts/{billingAccountId}/transactions

​
Workspace Binding Routes

ActionEndpoint
List linked billing accountsGET /workspaces/{workspaceId}/billing/accounts
Create and link billing accountPOST /workspaces/{workspaceId}/billing/accounts
Link existing billing accountPOST /workspaces/{workspaceId}/billing/accounts/link
Set workspace default billing accountPOST /workspaces/{workspaceId}/billing/accounts/{billingAccountId}/default
Unlink non-default billing accountDELETE /workspaces/{workspaceId}/billing/accounts/{billingAccountId}

​
Notes

  • Balance and summary responses now include billingAccountId.
  • Workspace-scoped billing endpoints still exist for product usage and checkout workflows.
  • Account-level transaction history is the canonical cross-workspace ledger when multiple workspaces share one billing account.