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
Predictable spend for headless agents.
An agent booking freight on a schedule should not discover payment state at book time. The balance read answers "can I afford this load?" with the exact number the booking path uses, so a preflight check here means no surprise card charge mid run.
An agent booking freight on a schedule should not discover payment state at book time. The balance read answers "can I afford this load?" with the exact number the booking path uses, so a preflight check here means no surprise card charge mid run.