{"name":"billing","stage":"ga","description":"Package billing is your org's balance, what it has spent, and the cards it pays with.","operations":[{"operationId":"get_billing_accounts","method":"GET","href":"/v1/billing/accounts","summary":"Answers the caller's billing accounts: the org itself, its currency, when it was opened, and the caller's own standing in it."},{"operationId":"get_billing_accounts_by_id_members","method":"GET","href":"/v1/billing/accounts/{id}/members","summary":"Answers one billing account's roster."},{"operationId":"get_billing_alerts","method":"GET","href":"/v1/billing/alerts","summary":"Lists this org's spend caps: the ceiling, its scope, whether it enforces, and how much of it has been spent this period."},{"operationId":"post_billing_alerts","method":"POST","href":"/v1/billing/alerts","summary":"Opens a spend cap on the caller's own org."},{"operationId":"get_billing_alerts_authorize","method":"GET","href":"/v1/billing/alerts/authorize","summary":"Answers whether one proposed spend fits inside this org's caps."},{"operationId":"delete_billing_alerts_by_id","method":"DELETE","href":"/v1/billing/alerts/{id}","summary":"Removes one of the caller's spend caps and answers 204."},{"operationId":"patch_billing_alerts_by_id","method":"PATCH","href":"/v1/billing/alerts/{id}","summary":"Changes one spend cap: raise or lower the ceiling, flip enforcement, retune the rate limit."},{"operationId":"get_billing_balance","method":"GET","href":"/v1/billing/balance","summary":"Prepaid credit the caller's org can still spend"},{"operationId":"get_billing_credit-balance","method":"GET","href":"/v1/billing/credit-balance","summary":"Answers what the caller can spend right now, one entry per currency."},{"operationId":"get_billing_credit-balance_breakdown","method":"GET","href":"/v1/billing/credit-balance/breakdown","summary":"Answers that same spendable credit split by grant tag, with the earliest expiry under each and the total across all of them."},{"operationId":"get_billing_credits","method":"GET","href":"/v1/billing/credits","summary":"Lists the caller's credit grants — every one of them, spent and lapsed and voided included."},{"operationId":"post_billing_crypto_deposit","method":"POST","href":"/v1/billing/crypto/deposit","summary":"Issues a deposit address the caller can send crypto to, on the asset they ask for."},{"operationId":"get_billing_crypto_deposit_by_id","method":"GET","href":"/v1/billing/crypto/deposit/{id}","summary":"Reads one of the caller's own deposit intents back — pending, confirming, or succeeded."},{"operationId":"get_billing_crypto_gateway","method":"GET","href":"/v1/billing/crypto/gateway","summary":"Answers the terms to sign a USDC top-up against, for an agent or a person paying from a wallet: the treasury to pay, the networks and USDC contracts, the EIP-712 domain and types, the limits, and a nonce issued to the caller."},{"operationId":"post_billing_crypto_gateway","method":"POST","href":"/v1/billing/crypto/gateway","summary":"Takes a signed USDC payment from the caller's Circle Gateway balance to the treasury, and answers what became of it."},{"operationId":"get_billing_crypto_gateway_by_id","method":"GET","href":"/v1/billing/crypto/gateway/{id}","summary":"Reads one of the caller's own USDC top-ups back: pending, accepted (credited or deferred), settled, failed or refused."},{"operationId":"get_billing_crypto_options","method":"GET","href":"/v1/billing/crypto/options","summary":"Answers which chains and tokens the crypto rail accepts — what an asset picker renders."},{"operationId":"get_billing_invoices","method":"GET","href":"/v1/billing/invoices","summary":"Lists the caller's invoices, newest first, with the count beside them."},{"operationId":"raiseInvoice","method":"POST","href":"/v1/billing/invoices","summary":"Raise a draft invoice against a customer"},{"operationId":"getInvoice","method":"GET","href":"/v1/billing/invoices/{id}","summary":"Read one invoice"},{"operationId":"collectInvoice","method":"POST","href":"/v1/billing/invoices/{id}/collect","summary":"Collect an issued invoice from credits, balance, then card"},{"operationId":"issueInvoice","method":"POST","href":"/v1/billing/invoices/{id}/issue","summary":"Issue a draft invoice, making it collectible"},{"operationId":"get_billing_invoices_by_id_pdf","method":"GET","href":"/v1/billing/invoices/{id}/pdf","summary":"Download one invoice as a PDF"},{"operationId":"voidInvoice","method":"POST","href":"/v1/billing/invoices/{id}/void","summary":"Void a draft or issued invoice"},{"operationId":"get_billing_ledger","method":"GET","href":"/v1/billing/ledger","summary":"Answers the org's own postings inside `range=`, each as a signed entry: a DEPOSIT CREDITS the wallet (positive, account `credits:\u003corg\u003e`), a HOLD sets money aside for a payment agreed and not yet made (negative, account `held:\u003corg\u003e`) and its return gives it back (positive), and every other posting DEBITS it (negative, account `usage:\u003corg\u003e`), described by its notes or its tags."},{"operationId":"get_billing_methods","method":"GET","href":"/v1/billing/methods","summary":"Cards and accounts on file for the caller"},{"operationId":"post_billing_methods","method":"POST","href":"/v1/billing/methods","summary":"Save a card or account for the caller"},{"operationId":"delete_billing_methods_by_id","method":"DELETE","href":"/v1/billing/methods/{id}","summary":"Removes one card or account the caller has saved."},{"operationId":"post_billing_mode","method":"POST","href":"/v1/billing/mode","summary":"Moves this org between sandbox money and real money."},{"operationId":"get_billing_payouts","method":"GET","href":"/v1/billing/payouts","summary":"Answers the org's outbound payouts, newest first — amount, destination, status, and the failure reason where one applies."},{"operationId":"get_billing_plans","method":"GET","href":"/v1/billing/plans","summary":"The plan catalog, priced with whatever offer is in force"},{"operationId":"get_billing_portal_methods","method":"GET","href":"/v1/billing/portal/methods","summary":"Cards and accounts on file for the caller"},{"operationId":"post_billing_portal_methods","method":"POST","href":"/v1/billing/portal/methods","summary":"Save a card or account for the caller"},{"operationId":"delete_billing_portal_methods_by_id","method":"DELETE","href":"/v1/billing/portal/methods/{id}","summary":"Removes one card or account the caller has saved, at the address a hosted checkout reaches it by."},{"operationId":"get_billing_recharge","method":"GET","href":"/v1/billing/recharge","summary":"Reads the org's auto-reload rule: top the balance up by `amountCents` whenever it falls below `thresholdCents`, charging the card on file off-session, at most `perDay` times in a UTC day."},{"operationId":"put_billing_recharge","method":"PUT","href":"/v1/billing/recharge","summary":"Sets the org's auto-reload rule, and answers with the rule as stored."},{"operationId":"post_billing_recharge_run-all","method":"POST","href":"/v1/billing/recharge/run-all","summary":"Sweeps every org's auto-recharge and answers what it did."},{"operationId":"get_billing_settings","method":"GET","href":"/v1/billing/settings","summary":"Answers the PUBLIC half of this org's processor configuration — the ids a browser needs to tokenize a card, and the environment it must tokenize against."},{"operationId":"post_billing_subscribe_card","method":"POST","href":"/v1/billing/subscribe/card","summary":"Buy a plan with a card"},{"operationId":"get_billing_subscriptions","method":"GET","href":"/v1/billing/subscriptions","summary":"Lists the plans the caller may see, with the count beside them."},{"operationId":"cancelSubscription","method":"POST","href":"/v1/billing/subscriptions/{id}/cancel","summary":"End a subscription"},{"operationId":"reactivateSubscription","method":"POST","href":"/v1/billing/subscriptions/{id}/reactivate","summary":"Put a canceled subscription back on its plan"},{"operationId":"resizeSubscription","method":"POST","href":"/v1/billing/subscriptions/{id}/resize","summary":"Change a team's seats"},{"operationId":"assignSeats","method":"PUT","href":"/v1/billing/subscriptions/{id}/seats","summary":"Assign a team's seats"},{"operationId":"get_billing_tier","method":"GET","href":"/v1/billing/tier","summary":"Answers which tier the caller is on, what it allows, and what is left to spend."},{"operationId":"post_billing_topup","method":"POST","href":"/v1/billing/topup","summary":"Charges a card the caller already saved and credits the balance."},{"operationId":"post_billing_topup_token","method":"POST","href":"/v1/billing/topup/token","summary":"Charges a single-use card token and credits the caller's balance."},{"operationId":"get_billing_transactions","method":"GET","href":"/v1/billing/transactions","summary":"Answers one page of the caller's own ledger, newest first: what moved, how much, when, and what it was tagged with."},{"operationId":"get_billing_transactions_by_id","method":"GET","href":"/v1/billing/transactions/{id}","summary":"Reads one ledger entry by its id."},{"operationId":"get_billing_usage","method":"GET","href":"/v1/billing/usage","summary":"Every billed call the caller's org made, attributed to a product"},{"operationId":"post_billing_usage","method":"POST","href":"/v1/billing/usage","summary":"Debits one act an application metered to the org it acts for, and answers the receipt."},{"operationId":"get_billing_usage_accounts","method":"GET","href":"/v1/billing/usage/accounts","summary":"Answers per-account totals for the linked provider accounts the gateway ROUTED this caller's traffic through — requests, prompt and completion tokens, recorded cost — plus their honest sum."},{"operationId":"get_billing_usage_rollup","method":"GET","href":"/v1/billing/usage/rollup","summary":"Answers the caller's month: what their plan includes, what has been consumed against it, and the wallet beside it."},{"operationId":"get_billing_wire","method":"GET","href":"/v1/billing/wire","summary":"Answers where to send a wire top-up: the receiving bank details, with the caller's own payment reference."}],"_links":{"describedby":{"href":"/v1/openapi.json?capability=billing"},"self":{"href":"/v1/billing"},"up":{"href":"/v1"}}}