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
| Field | Type | Required | Description |
|---|---|---|---|
driverEmail | string | Yes | Which driver receives the funds. |
amount | number | Yes | NGN 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." } }