Set Fleet Auto-Zero

POST/v1/fleet/auto-zero

Turns the nightly auto-zero on or off for your fleet. When it's on, every driver's unused sub-wallet balance returns to your fleet's wallet each night at 00:00 Africa/Lagos time (WAT). It's off until you turn it on.

Once this is on, your drivers start each day at ₦0. They can't pay from their wallet until you distribute funds to them again, so schedule your top-ups for after midnight before you turn it on.

Auth

Authorization: ApiKey <your fleet's API key> — server-side only.

Request parameters

FieldTypeRequiredDescription
enabledbooleanYestrue to turn nightly auto-zero on, false to turn it off.

Example request

curl https://api.lotgrids.com/v1/fleet/auto-zero \
  -X POST \
  -H "Authorization: ApiKey lg_live_f_8f21a9.9c2e1b7a..." \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true }'

Example success response

200 OK
{
  "autoZeroEnabled": true
}

What to expect

To return one driver's balance immediately instead of waiting for midnight, use Zero Driver Balance.

Error responses

400 invalid_argument
{ "error": { "code": "invalid_argument", "message": "enabled must be true or false." } }