Skip to main content

Charger Data

The Charger Data endpoint provides access to wall charger details and real-time status.

Endpoint

MethodPathDescription
GET/v1/chargers/{chargerId}Charger details and status

Requires a DPoP-bound access token.

Charger details

Retrieve charger model, firmware, status, power output, connector type, and energy delivery stats:

curl -X GET https://api.data.jlr-vcdp.com/v1/chargers/c1d2e3f4-a5b6-7890-cdef-123456789012 \
-H "Authorization: DPoP YOUR_ACCESS_TOKEN" \
-H "DPoP: YOUR_DPOP_PROOF"

Response:

{
"chargerId": "c1d2e3f4-a5b6-7890-cdef-123456789012",
"serialNumber": "WC-2024-00142",
"model": "JLR Home Charger Pro",
"manufacturer": "JLR Energy",
"firmwareVersion": "2.4.1",
"status": "charging",
"maxPower": { "value": 22, "unit": "kW" },
"currentPower": { "value": 7.4, "unit": "kW" },
"connectorType": "type-2",
"energyDelivered": {
"lifetime": { "value": 4520.8, "unit": "kWh" },
"currentSession": { "value": 32.5, "unit": "kWh" }
},
"connectedVehicleVin": "SALGA2BN6PH123456",
"networkStatus": "connected",
"lastUpdated": "2024-06-15T14:30:00Z"
}

Charger status values

StatusDescription
onlineAvailable and idle
offlineNot communicating
chargingActively charging a vehicle
faultError state requiring attention
scheduledWaiting for scheduled charge time

Connector types

TypeDescription
type-1SAE J1772 (single phase AC)
type-2IEC 62196 (single/three phase AC)
ccsCombined Charging System (DC fast charge)
chademoCHAdeMO (DC fast charge)