Skip to content
APIs/Energy API
APIs/Energy API

Overview

About

The Energy API provides access to the most recent energy state of a vehicle.

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?

Energy State endpoint

Retrieves information about the latest energy state of the vehicle based on the provided scopes:

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

Capabilities endpoint

Retrieves information about the capabilities of the vehicle.

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
  • EX90
  • XC60 PHEV, S90 PHEV, V90 PHEV from model year 2022
  • XC90 PHEV, S60 PHEV, V60 PHEV from model year 2023

Limited support of PHEV Classic vehicles without Google Automotive System (Google built-in).

  • XC40 PHEV
  • XC60 PHEV, S90 PHEV, V90 PHEV including model year 2021
  • XC90 PHEV, S60 PHEV, V60 PHEV including model year 2022

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 and US / Canada / Latin America 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.

Try it out

/