Balance
Markdown ↗

Get balance

GET/api/v3/balance

Overview

The current payer's Common Fuz ledger balance and accepted unpaid commitments, across all keys and execution channels. available = balance - reserved. This is a current snapshot, not an entitlement or a reservation. New runs still perform atomic budget admission. A valid zero balance is 200; a dependency outage is 503 balance_unavailable.

Requires an API key. Send Authorization: Bearer YOUR_API_KEY. Authentication →

curl 'https://fusara.ai/api/v3/balance' \
  -H "Authorization: Bearer $FUSARA_API_KEY"

Responses

OK

Illustrative response. Prices, IDs and URLs come from your own request.

Example response
{
  "unit": "common_fuz",
  "balance": "1200.0000",
  "reserved": "160.0000",
  "available": "1040.0000"
}
unitstringrequired

Billing unit: common_fuz.

balancestringrequired

Current payer ledger balance, as a decimal string.

reservedstringrequired

Accepted unpaid commitments across the payer's execution channels, as a decimal string.

availablestringrequired

balance minus reserved, as a decimal string. This snapshot can be negative.

Response headers

X-Request-Idstringrequired

Support/trace identifier for this HTTP request.