Vehicle Data

The Vehicle Data endpoints provide access to vehicle details, real-time status, alerts, journey history, location, and electric vehicle telemetry.

Endpoints

Method	Path	Description
GET	/v1/vehicles/{vin}	Vehicle details and capabilities
GET	/v1/vehicles/{vin}/status	Real-time vehicle status
GET	/v1/vehicles/{vin}/alerts	Vehicle alerts
GET	/v1/vehicles/{vin}/journeys	Journey history
GET	/v1/vehicles/{vin}/location	Current location
GET	/v1/vehicles/{vin}/ev	Electric vehicle data
GET	/v1/vehicles/{vin}/ev/hv-battery	High voltage battery telemetry

All endpoints require a DPoP-bound access token.

Vehicle details

Retrieve vehicle identification, powertrain type, exterior colour, capabilities, and features:

curl -X GET https://api.data.jlr-vcdp.com/v1/vehicles/SALGA2BN6PH123456 \
  -H "Authorization: DPoP YOUR_ACCESS_TOKEN" \
  -H "DPoP: YOUR_DPOP_PROOF"

Response:

{
  "Vehicle": {
    "VehicleIdentification": {
      "VIN": "SALGA2BN6PH123456",
      "Brand": "Land Rover",
      "Model": "Range Rover Sport",
      "Year": 2024,
      "BodyType": "SUV"
    },
    "Powertrain": {
      "FuelType": "electric"
    },
    "Capabilities": [
      "remote-lock",
      "remote-climate",
      "live-data-streaming",
      "journey-log",
      "ev-charging"
    ]
  }
}

Vehicle status

Get real-time status including tyre pressures, door/window states, lock status, and fuel level:

curl -X GET https://api.data.jlr-vcdp.com/v1/vehicles/SALGA2BN6PH123456/status \
  -H "Authorization: DPoP YOUR_ACCESS_TOKEN" \
  -H "DPoP: YOUR_DPOP_PROOF"

Alerts

Query alerts with optional filtering by severity and active status:

# Get active critical alerts
curl "https://api.data.jlr-vcdp.com/v1/vehicles/SALGA2BN6PH123456/alerts?severity=critical&active=true" \
  -H "Authorization: DPoP YOUR_ACCESS_TOKEN" \
  -H "DPoP: YOUR_DPOP_PROOF"

Journeys

Retrieve journey history with pagination and date range filtering:

# Get journeys from the last 7 days
curl "https://api.data.jlr-vcdp.com/v1/vehicles/SALGA2BN6PH123456/journeys?from=2024-06-08T00:00:00Z&to=2024-06-15T23:59:59Z" \
  -H "Authorization: DPoP YOUR_ACCESS_TOKEN" \
  -H "DPoP: YOUR_DPOP_PROOF"

EV data

Access charging status, state of charge, range, and charging session details:

curl -X GET https://api.data.jlr-vcdp.com/v1/vehicles/SALGA2BN6PH123456/ev \
  -H "Authorization: DPoP YOUR_ACCESS_TOKEN" \
  -H "DPoP: YOUR_DPOP_PROOF"

High voltage battery

Detailed battery telemetry including cell voltages, temperatures, state of health, and charge cycle count:

curl -X GET https://api.data.jlr-vcdp.com/v1/vehicles/SALGA2BN6PH123456/ev/hv-battery \
  -H "Authorization: DPoP YOUR_ACCESS_TOKEN" \
  -H "DPoP: YOUR_DPOP_PROOF"