Billing

Billing and invoice management

📄️ Get Wallet Balance

The tenant's drawable credit balance, the lots behind it in the order they will be burned, and the usage recorded since the last settlement. This is the replacement for the retired `/api/v1/billing/current`.

📄️ List Invoices

The tenant's issued billing documents, newest first. This is the replacement for the retired `/api/v1/billing/invoices`.

📄️ Get Invoice

One issued billing document, including its priced lines.

📄️ List Invoice Transactions

The payments and discounts recorded against one document. This is what explains a `remaining` that is lower than `total` — the document total never moves.

📄️ List Billing Transactions

The tenant's money feed across all documents.

📄️ Get PAYG Spend Cap

The tenant's pay-as-you-go spend cap and how much of the current billing period it has already used. Total: a tenant with no cap answers 200 with `cap_usd: null`, never 404.

📄️ Set PAYG Spend Cap

Set or change the cap. Takes effect on the next request the gateway prices — raising a cap is the documented unblock for a tenant that hit it, so there is no scheduling and no grace period.

📄️ Clear PAYG Spend Cap

Remove the cap entirely. Idempotent: clearing a cap that is not there answers 200 with `cap_usd: null`, not 404.

📄️ Get Commitment

The tenant's in-flight commitment offer and their live contract; either may be null. A commitment is a negotiated dollar contract and is not the same thing as the plan quota.

📄️ Redeem Coupon

Redeem a coupon code into the tenant's wallet. Session-authenticated only: this moves money, so it is not reachable with an API key.

📄️ Get Current Plan

The tenant's plan for the active billing period. A period carrying a dollar budget answers with the percent-only shape; every other basis answers with the full payload including quota groups, meters and totals.