Get Fleet Balance

POST/v1/fleet/balance

Returns your fleet's current wallet balance — the pooled balance you top up and distribute from into individual drivers' sub-wallets via Distribute to Driver. Not a driver's own sub-wallet balance — see Quote Charge Session for that.

Auth

Authorization: ApiKey $LOTGRIDS_API_KEY. Works with either key — a test key returns your sandbox balance, a live key your real one. The fleet (and which of those two it reads) is already fully determined by which key you send, so the body is just {}.

Example request

curl https://api.lotgrids.com/v1/fleet/balance \
  -X POST \
  -H "Authorization: ApiKey $LOTGRIDS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Send a body, even an empty {} — a POST with no body at all gets rejected before it reaches us (411 Length Required), since curl doesn't send a Content-Length header without one.

Example success response

200 OK
{
  "fleetId": "f_8f21a9",
  "walletBalance": 842000
}

Error responses

401 invalid_api_key
{ "error": { "code": "invalid_api_key", "message": "Unknown API key." } }