Skip to main content
Retrieve your account balance, including funds reserved against in-flight jobs.
GET /balance

Headers

Authorization
string
required
Bearer <YOUR_API_KEY>. See Authentication.

Response

balance
string (decimal)
Total deposited balance.
reserved
string (decimal)
Held against jobs that haven’t completed yet.
available
string (decimal)
balance − reserved — what you can spend now.
curl -s https://bananahub.io/api/v1/balance \
  -H "Authorization: Bearer $API_KEY"
{
  "balance": "100.00",
  "reserved": "5.50",
  "available": "94.50"
}
A generation returns 402 when available doesn’t cover the job’s reserved price. See Errors.