Get Charger Connectors

POST/v1/chargers/connectors

A charger's QR code encodes only its chargerId — one code can cover a charger with two or more physical connectors. The LotGrids map app resolves the connector list itself because it reads our database directly; your driver app can't do that, so call this endpoint right after a scan to get the same list, show your own "which connector?" step, and pass the driver's choice as connectorId to Quote or Start Charge Session.

Auth

Authorization: Bearer <driver token>, minted via Mint Driver Token. Read-only and not scoped to any one driver, so any valid token works — there's no driverEmail field to match.

Request parameters

FieldTypeRequiredDescription
chargerIdstringYesExactly what the scanned QR code encodes.

Example request

curl https://api.lotgrids.com/v1/chargers/connectors \
  -X POST \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "chargerId": "chg_04af1c"
  }'

Example success response

200 OK
{
  "chargerId": "chg_04af1c",
  "locationName": "Ikeja City Mall",
  "connectorType": "CCS2",
  "powerKw": 60,
  "connectors": [
    { "connectorId": "conn_01", "available": true },
    { "connectorId": "conn_02", "available": false }
  ]
}

An unavailable connector is already mid-session with another driver — Quote/Start Charge Session will reject it with connector_busy if you send it anyway. Only offer the driver connectors where available is true.

Error responses

401 token_expired
{ "error": { "code": "token_expired", "message": "Driver token expired." } }
404 charger_not_found
{ "error": { "code": "charger_not_found", "message": "No charger chg_04af1c." } }