Check your balance

GET https://www.wearewarp.com/api/v1/balance

Returns your prepaid wallet balance, your booking runway. This is the same number a booking settles against: a book call draws the wallet first and charges your saved card only for any shortfall. Read it before you book so your agent knows whether the next load clears without a card charge.

Auth

• Authorization: Bearer wak_... -- own account scoped. A key can only ever read its own balance.

curl example

curl https://www.wearewarp.com/api/v1/balance \
  -H "Authorization: Bearer wak_live_YOUR_KEY"

Response

{
  "balance_usd": 1250.00,
  "currency": "USD",
  "top_up_url": "https://customer.wearewarp.com/..."
}

• balance_usd -- prepaid funds available to book against
• top_up_url -- open to add funds before a big booking run

Errors

• 409 WARP_SESSION_REQUIRED -- the account has not linked a Warp session yet. Sign in once at /agents/account to seed it, then the read works headlessly.

Why a wallet