Quote Charge Session

POST/v1/sessions/quote

Read-only — moves no money. Returns the price of a full charge for the vehicle currently plugged into the given charger/connector, and the driver's current sub-wallet balance, so your app can decide whether to offer a full or reduced charge.

Auth

Authorization: Bearer <driver token>, minted via Mint Driver Token.

Request parameters

Field	Type	Required	Description
`chargerId`	string	Yes	The LotGrids charger the driver is at — this is exactly what the charger's QR code encodes.
`connectorId`	string	Yes	Which connector/nozzle on that charger the vehicle is plugged into — your app asks the driver to pick this after they scan the QR code.
`driverEmail`	string	Yes	Must match the email your driver token was minted for.

Example request

curl https://api.lotgrids.com/v1/sessions/quote \
  -X POST \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "chargerId": "chg_04af1c",
    "connectorId": "conn_02",
    "driverEmail": "adaeze.driver@fleetco.com"
  }'

Example success response

200 OK
{
  "fleetDriver": true,
  "quotedAmount": 18500,
  "currency": "NGN",
  "subWalletBalance": 12000,
  "socPercent": 41,
  "vehicleModel": "Nissan Leaf (40 kWh)"
}

In this example the driver's balance (₦12,000) is less than the full-charge quote (₦18,500) — your app should offer the driver the option to charge only as much as ₦12,000 covers, then send that reduced amount to Start Charge Session.

Error responses

401 token_expired

{ "error": { "code": "token_expired", "message": "Driver token expired." } }

403 token_scope_mismatch

{ "error": { "code": "token_scope_mismatch", "message": "This token cannot act on a different driver's wallet." } }

404 charger_not_found

{ "error": { "code": "charger_not_found", "message": "No charger chg_04af1c." } }

404 connector_not_found

{ "error": { "code": "connector_not_found", "message": "No connector conn_02 on charger chg_04af1c." } }