v2

latestOpenAPI 3.1.02026-08-07139158192.4 KB
Billing

Org balance + recent transactions

get/v1/orgs/{orgId}/billing/balance

Path parameters

orgIdstring required

Response

Balance

accruedUsageCentsinteger required

Usage cost not yet settled into a transaction: the current month, plus any recently ended month whose settlement debit has not been written yet (briefly higher than currentMonthUsageCents right after a month rollover).

availableCentsinteger required

Spendable balance = balanceCents − accruedUsageCents. This is what the deploy gate checks; it can be below balanceCents while usage is running, and slightly negative between auto-recharge ticks.

balanceCentsinteger required

Raw ledger balance (deposits + credits − settled debits).

currentMonthUsageCentsinteger required

Usage cost accrued in the current calendar month only. Use this for "spend this month" displays; use accruedUsageCents for balance math.

monthlySpendLimitCentsinteger nullable

The org's monthly spend cap, or null if no limit is set. Drives the "used of limit" budget gauge in the dashboard.