Get the latest energy state of the vehicle.

Provides the latest energy state data for the vehicle in te form of a map of resource values.

Each resource has a status set to either OK or ERROR. When the status is OK, the response includes a value property. If the data point cannot be retrieved due to reasons such as the data point not being supported by the vehicle, that no valid value exists for the vehicle or an internal server error, the status will be set to ERROR and the response will contain an error code and error message.

Scopes

Headers

Mandatory request headers:

Response body

The response body is a map of resources where each resource is one of ResultResourceInstance*WithUnit, ResultResourceInstanceString or ErrorResultWithDescription. Each resource contains the latest known value for that data point.

ResultResourceInstanceFloatWithUnit
ResultResourceInstanceIntegerWithUnit:

Examples

{
    "status": "OK",
    "value": 50.5,
    "unit": "percentage",
    "updatedAt": "2025-05-27T11:28:24Z"
}

{
    "status": "OK",
    "value": 180,
    "unit": "km",
    "updatedAt": "2025-05-27T11:28:24Z"
}

ResultResourceInstanceString:

Examples

{
    "status": "OK",
    "value": "DISCONNECTED",
    "updatedAt": "2025-05-27T11:28:24Z"
}

ErrorResultWithDescription:

Examples

{
    "status": "ERROR",
    "code": "PROPERTY_NOT_FOUND",
    "message": "No valid value could be found for the requested property"
}

Examples