Distribute to Driver

POST/v1/drivers/distribute

Moves funds from your fleet's wallet into one driver's sub-wallet, atomically. This is the same transfer your fleet owner can already trigger from the Partner Dashboard's Drivers tab — this endpoint just lets your own backend do it directly, e.g. to automate top-ups on a schedule instead of a human clicking a button each time.

Auth

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

Request parameters

FieldTypeRequiredDescription
driverEmailstringYesWhich driver receives the funds.
amountnumberYesNGN amount to move from the fleet wallet into the driver's sub-wallet.

Example request

curl https://api.lotgrids.com/v1/drivers/distribute \
  -X POST \
  -H "Authorization: ApiKey lg_live_f_8f21a9.9c2e1b7a..." \
  -H "Content-Type: application/json" \
  -d '{
    "driverEmail": "adaeze.driver@fleetco.com",
    "amount": 20000
  }'

Example success response

200 OK
{
  "fleetBalance": 130000,
  "driverBalance": 32000
}

Error responses

402 insufficient_balance
{ "error": { "code": "insufficient_balance", "message": "Fleet balance 8000 is less than 20000." } }
404 driver_not_found
{ "error": { "code": "driver_not_found", "message": "No active driver adaeze.driver@fleetco.com in fleet f_8f21a9." } }