_metadata omitted):
Current usage versus settled credits
Measure settles additional-credit consumption at the end of the billing period. Its stored grant balance can therefore include credits already spent this period. Octave combines the current-period billing snapshot with its real-time usage ledger, including in-flight charges and refunds, to calculate the usable balance. In the example, 1,000 included credits and 500 additional credits cover 1,200 credits of usage. The remaining balance is 300, even if the provider still shows a grant balance of 500 before settlement.additionalUsed estimates consumption beyond the included allowance; additionalRemaining subtracts that consumption once. additional is the extra credit balance available to this period, not lifetime grants or a grant-by-grant audit log.
remaining is clamped to zero. resetAt is the next billing-period reset reported by the provider, or null when unavailable. Additional credits can have their own expiration rules and should not be assumed to reset on that date. asOf is the response calculation time; billing updates and charge ingestion can have short propagation delays.
Overage and unavailable balances
When the plan supports paid overage,overage contains its mode, used units, cost in cents, spending ceiling, and whether that ceiling has been reached. credits.exhausted means the included and additional credits are used up; paid processing may continue if the overage ceiling allows it. A null overage means no overage billing configuration is present.
If billing usage cannot be retrieved, the endpoint returns 503 instead of reporting an artificial zero balance. Retry with backoff. Requests are limited to 30 per minute.