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: current-month compute, pending inference, plus any recently ended compute month whose settlement debit has not been written yet. This is the amount netted from balanceCents to produce availableCents.

availableCentsinteger required

Spendable balance = balanceCents − accruedUsageCents. This is what every control-plane billing gate checks. It includes pending compute and inference usage, can be below balanceCents while usage is running, and can be slightly negative between auto-recharge ticks.

balanceCentsinteger required

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

currentMonthComputeCentsinteger required

Compute usage accrued in the current UTC calendar month.

currentMonthInferenceCentsinteger required

Inference usage in the current UTC calendar month: settled whole-cent inference debits plus whole pending inference cents. A fractional pending cent is intentionally omitted instead of inflating displayed spend.

currentMonthUsageCentsinteger required

Total compute plus inference usage in the current UTC calendar month, including inference already drained into the ledger and the live pending inference accrual. Use this for "spend this month" displays; use accruedUsageCents for balance math.

minDepositCentsinteger

Smallest deposit the org can make right now, in cents: the flat $25 floor, raised to one hour of usage at the current burn while the org has open usage running, clamped to the org's per-deposit cap. This is the exact minimum the deposit endpoint enforces (INSUFFICIENT_RUNWAY on a lower amount), so clients should render it rather than re-derive it.

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.

pendingInferenceCentsinteger required

Whole inference cents not yet drained into the ledger. Fractional cents remain in nanoUSD in the accrual and are omitted from this integer display value.

pendingInferenceReservedCentsinteger required

Pending inference reserved by balance enforcement, rounded up to the next cent. This can be one cent higher than pendingInferenceCents.

priorUnsettledComputeCentsinteger required

Compute usage from recently ended months that is marked billable but whose settlement transaction has not been written yet.

Changes