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
| Field | Type | Required | Description |
|---|---|---|---|
chargerId | string | Yes | Exactly 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
{ "error": { "code": "token_expired", "message": "Driver token expired." } }
{ "error": { "code": "charger_not_found", "message": "No charger chg_04af1c." } }