About

The Energy API provides remote access to the most recent recharge status data of vehicles.

You can download the OpenAPI specification as a JSON file.

You will find information about the endpoints exposed by the API in the Endpoints section in the menu. Information such as required scopes, headers and request/response examples.

What do you have access to?

The endpoint for recharge status will retrieve a list of values from several endpoints based on the approved scopes provided:

• Battery charge level
• Target battery charge level
• Charging connection status
• Charging system status
• Charging current limit
• Estimated charging time
• Electric range

Availability

Car models

This API works for all plug-in hybrid and electric vehicles which are equipped with Google Automotive System (Google built-in).

List of supported cars:

• EC40/C40
• EX40/XC40 BEV
• EX30
• XC60 PHEV, S90 PHEV, V90 PHEV from model year 2022
• XC90 PHEV, S60 PHEV, V60 PHEV from model year 2023

BEV = Battery Electric Vehicles, PHEV = Plug-in Hybrid Electric Vehicles

Locations

The API can be used with test credentials around the world. However, when published, only cars in the Europe / Middle East / Africa regions are available. We are working to bring other regions online.

View the full list of available countries.

Limitations

This API is Rate Limited to prevent malicious activity or accidents that cause service disruptions. The limit is set to 100 request per minute for a combination of the user's Volvo ID and the Client ID sending the request. A given user will have 100 requests per minute per application it uses. Should this limit be exceeded, the API will respond with HTTP code 429.

Sandbox

Would you like to experiment with this API on your own? You can test its functionality using your own Volvo ID account or a demo Volvo ID account.