Example EV charging availability API

I use the URL example in the EV charging availability API: “https://api.tomtom.com/search/2/chargingAvailability.json?key={My_API_Key}&chargingAvailability=00112233-4455-6677-8899-aabbccddeeff&connectorSet=IEC62196Type2CableAttached&minPowerKW=22.2&maxPowerKW=43.2
However, I did not the example response data. Instead, I get: "{‘connectors’: [], ‘chargingAvailability’: ‘00112233-4455-6677-8899-aabbccddeeff’}.
I also tried change the URL to “https://api.tomtom.com/search/2/chargingAvailability.json?key={My_API_Key}&chargingAvailability=442009000132285”, and I get “{‘connectors’: [], ‘chargingAvailability’: ‘442009000132285’}”.

I am wondering what’s going on or is there anything wrong with my URL?


Hello, happy to see you are checking out our API!
Please mind the example is using a dummy id in “changingAvailability” request parameter and that results in the empty response.
The correct id can be found by doing search in for example Fuzzy Search (Fuzzy Search | Search API) and using the id specified in dataSources > chargingAvailability.

This ID is only available for POI which have the dynamic availability data, therefore will not be present in all of the POIs.
I have selected few IDs for you, so that you can easily test the EV Charging Stations Availability API. Please try it with: 528009010067112 or 528009010041202, without using any additional request parameters like connector type or power. Once you get more familiar with fuzzy search, please try getting IDs from there and experimenting with additional request parameters (which btw, can also be used in fuzzy search).
Hope that answers your question. Good luck!

1 Like

Thank you for your reply. I am looking into the fuzzy search. I would like to get all the locations with ChargerAvailability in the US. When I have the URL as: “https://api.tomtom.com/search/2/search/countrySet=US.json?key={MY KEY}”, I didn’t see any key as “chargerAvailability”. I am wondering is there a straight forward way to get all the locations with ChargerAvailability in the US? Or I need to try different (lat, long) pairs to see what I can get?

The query you have provided, basically looks for anything in US. Try using our API explorer (API Explorer | Search API) to play around with the available request parameters and get more familiar with the working of the API.
As an example, you can try this query: https://api.tomtom.com/search/2/search/Dallas.json&countrySet=US&categorySet=7309?key=**** which searches for EV POIs (defined in categorySet=7309) in the city of Dallas. You will see that several of the POIs will have the dataSources section which I included in the previous message.

Please mind that currently our data set contains around 38124 EV POIs with more than 122k charging points. More than 63% of those points will have a dynamic availability status. So it will not be possible to get them all from one query.

Is there a different endpoint for the EV Charging Stations Availability API?

I don’t see it in the API explorer

EV Charging Stations Availability API was moved to a separate page. Here is a link to the API Explorer: API Explorer | EV Charging Stations Availability API