APIs/Energy APIVersion 1

Release Notes

Overview

The release notes provide details about new features, breaking changes, and other updates made to the Energy API.

New features

Additional supported model

This version of the API supports an additional car model for most endpoints. EX30 is now supported with some limitations, as described below.

Endpoints with limited support - The API now provides support for the EX30 in most endpoints, with some limitations for the following endpoints:

Recharge Status: /recharge-status
Charging Current Limit: recharge-status/charging-current-limit
Target Battery Level: recharge-status/target-battery-level

Read more about the limitations on each endpoint.

Updated endpoints

Recharge Status

The recharge status endpoint now supports the EX30 model with some limitations.

The TargetBatteryChargeLevel and ChargingCurrentLimit resources are not supported for the EX30

The following response will be given when accessing the recharge status endpoint for an EX30 vehicle:

{
    "status": 200,
    "data": {
        "estimatedChargingTime": {
            "value": "0",
            "unit": "minutes",
            "timestamp": "2024-09-04T11:29:06Z"
        },
        "batteryChargeLevel": {
            "value": "83.0",
            "unit": "percentage",
            "timestamp": "2024-09-04T11:29:06Z"
        },
        "electricRange": {
            "value": "280",
            "unit": "kilometers",
            "timestamp": "2024-09-04T11:29:06Z"
        },
        "chargingSystemStatus": {
            "value": "CHARGING_SYSTEM_IDLE",
            "timestamp": "2024-09-04T11:29:06Z"
        },
        "chargingConnectionStatus": {
            "value": "CONNECTION_STATUS_DISCONNECTED",
            "timestamp": "2024-09-04T11:29:06Z"
        }
    },
    "operationId": "396aa5dd-67d6-46e0-8317-8f9cfe44e9fe"
}

Charging Current Limit

The charging current limit endpoint is not available for the EX30 model.

The following response will be given when accessing the charging current limit for an EX30 vehicle

{
    "status": 404,
    "operationId": "49c72bca-a2c1-4c4b-b82e-17bcfe30a333",
    "error": {
        "message": "NOT_FOUND",
        "description": "Resource not supported for this vehicle model"
    }
}

Target Battery Level

The target battery level endpoint is not available for the EX30 model.

The following response will be given when accessing the target battery level for an EX30 vehicle

{
    "status": 404,
    "operationId": "49c72bca-a2c1-4c4b-b82e-17bcfe30a333",
    "error": {
        "message": "NOT_FOUND",
        "description": "Resource not supported for this vehicle model"
    }
}