Mint Driver Token

POST/v1/driver-tokens

Exchanges your fleet's API key for a short-lived token scoped to exactly one driver. Call this from your backend only — the token it returns is what you then hand to that driver's app session.

Auth

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

Request parameters

Example request

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

Example success response

200 OK
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresAt": "2026-09-13T15:47:00.000Z"
}

Error responses

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

{ "error": { "code": "driver_not_found", "message": "No active driver adaeze.driver@fleetco.com in fleet f_8f21a9." } }