EV Search by Id

Last edit: 2026.02.20

TomTom Orbis Maps

Important note
This API is not available as part of our free evaluation or Pay As You Grow (PAYG) offering. Click the Request Access button above to contact our Sales team.

Private Preview Notice

Important notes:

This TomTom Orbis Maps API is restricted to private preview.

This API is powered by the TomTom Orbis Maps.

See the TomTom Orbis Maps documentation for more information.

Purpose

The EV Search by Id endpoint provides detailed information about one or more EV POIs (points of interest) requested by their ID. This includes details such as location, availability status, and attached connectors.

Request data

HTTPS method: `GET`

For ease of viewing and identification:

Constants and parameters enclosed in curly brackets { } must be replaced with their values.
Please see the following Request parameters section with the required and optional parameters tables for their values. The generic request format is as follows.

Request format

get

Request URL format

https://{baseURL}/maps/orbis/places/ev/id?key={Your_API_Key}&id={EV_POI_Id1,EV_POI_Id2,...}&view={view}

Request curl command example

get

Request curl command example

curl 'https://api.tomtom.com/maps/orbis/places/ev/id?key={Your_API_Key}&id=0b903425-3f5a-4072-9d5d-070f6f0647b3,79ded460-ecbb-4699-852b-71e8cf1d27ab&view=Unified&' \
    -H 'TomTom-Api-Version: 1'

Request parameters

The following table describes the parameters that can be used in a request.

Required parameters must be used or the call will fail.
Parameters and values are case-sensitive.
Optional parameters may be used.

Required parameters Description

Required parameters	Description
`baseURL` string	Base URL for calling the API. Values: `api.tomtom.com` `kr-api.tomtom.com` (see theRegion-specific content page)
`key` string	An API Key valid for the requested service. Value: Your valid `API Key`.
`id` string	Comma-separated list of EV POI Ids. Value: Comma-separated list of EV POI Ids. Maximum number of Ids: `100`

baseURL string

Base URL for calling the API.
Values:

api.tomtom.com
kr-api.tomtom.com (see theRegion-specific content page)

key string

An API Key valid for the requested service.
Value: Your valid API Key.

id string

Comma-separated list of EV POI Ids.
Value: Comma-separated list of EV POI Ids.
Maximum number of Ids: 100

Optional parameters Description

Optional parameters	Description
`view` string	Geopolitical View. The context used to resolve the handling of disputed territories. Enum: `Unified`, `AR`, `IL`, `IN`, `MA`, `PK`, `RS`, `RU`, `TR`, `CN`, `TW` Default values: Argentina, default view: `AR`, available views: `Unified`, `IL`, `IN`, `MA`, `PK`, `RS`, `RU`, `TR`, `CN`, `TW` India, default view: `IN`, available views: - Morocco, default view: `MA`, available views: `Unified`, `AR`, `IL`, `IN`, `PK`, `RS`, `RU`, `TR`, `CN`, `TW` Pakistan, default view: `PK`, available views: `Unified`, `AR`, `IL`, `IN`, `MA`, `RS`, `RU` , `TR`, `CN`, `TW` Serbia, default view: `RS`, available views: `Unified`, `AR`, `IL`, `IN`, `MA`, `PK`, `RU`, `TR`, `CN`, `TW` Russia, default view: `RU`, available views: `Unified`, `AR`, `IL`, `IN`, `MA`, `PK`, `RS`, `TR`, `CN`, `TW` Turkey, default view: `TR`, available views: `Unified`, `AR`, `IL`, `IN`, `MA`, `PK`, `RS`, `RU`, `CN`, `TW` China, default view: `CN`, available views: `Unified`, `AR`, `IL`, `IN`, `MA`, `PK`, `RS`, `RU`, `TR`, `TW` Taiwan, default view: `TW`, available views: `Unified`, `AR`, `IL`, `IN`, `MA`, `PK`, `RS`, `RU`, `TR`, `CN` Others, default view: `Unified`, available views: `AR`, `IL`, `IN`, `MA`, `PK`, `RS`, `RU`, `TR`, `CN`, `TW`
`include` string	Enum: tariffs Example: include=tariffs Additional information to be included in the response.

view string

Geopolitical View. The context used to resolve the handling of disputed territories.
Enum: Unified, AR, IL, IN, MA, PK, RS, RU, TR, CN, TW
Default values:

Argentina, default view: AR, available views: Unified, IL, IN, MA, PK, RS, RU, TR, CN, TW
India, default view: IN, available views: -
Morocco, default view: MA, available views: Unified, AR, IL, IN, PK, RS, RU, TR, CN, TW
Pakistan, default view: PK, available views: Unified, AR, IL, IN, MA, RS, RU , TR, CN, TW
Serbia, default view: RS, available views: Unified, AR, IL, IN, MA, PK, RU, TR, CN, TW
Russia, default view: RU, available views: Unified, AR, IL, IN, MA, PK, RS, TR, CN, TW
Turkey, default view: TR, available views: Unified, AR, IL, IN, MA, PK, RS, RU, CN, TW
China, default view: CN, available views: Unified, AR, IL, IN, MA, PK, RS, RU, TR, TW
Taiwan, default view: TW, available views: Unified, AR, IL, IN, MA, PK, RS, RU, TR, CN
Others, default view: Unified, available views: AR, IL, IN, MA, PK, RS, RU, TR, CN, TW

include string

Enum:

tariffs

Example: include=tariffs

Additional information to be included in the response.

Request headers

The following table describes HTTP request headers.

Required headers	Description
TomTom-Api-Version	The version of the API being called. Currently, only version `1` is supported. Example: `1`

Optional headers	Description
Tracking-ID	Specifies an identifier for the request. It can be used to trace a call. The value must match the regular expression `'^[a-zA-Z0-9-]{1,100}$'`. An example of the format that matches this regular expression is UUID (e.g., `9ac68072-c7a4-11e8-a8d5-f2801f1b9fd1` ). For details check RFC 4122. If specified, it is replicated in the Tracking-ID response header. It is only meant to be used for support and does not involve tracking of you or your users in any form. Value: An `identifier` for the request.
Accept	Specifies one of the following values as the response format of an API request: `application/json` Default if the header is not provided. `application/xml`
Accept-Language	Should be one of the TomTom supported IETF language tags, case insensitive. When data in the specified language is not available for a specific field or the language is not specified, the NGT (NeutralGroundTruth) of the POI will be used.
JMESPath	This header can be used to execute a JMESPath query on the API response. For more information refer to JMESPath examples. Default value: If no header is provided, all response fields are included. Note: The header value has to be URL encoded. Example: `results[*].{id:id,position:position}` will only return the id and position fields of the results.

Response data

Response body

If the Accept header value is set to application/json, the response will be a JSON object with the following structure:

Json Response body example
1{
  "summary": {
      "numResults": 1,
      "totalResults": 1
  },
  "results": [
      {
          "id": "0b903425-3f5a-4072-9d5d-070f6f0647b3",
          "name": "Mega M d.o.o.",
          "position": {
              "lat": 44.810263,
              "lon": 20.4354
          },
          "chargingStations": [
              {
                  "id": "RS*ORI*E1161",
                  "chargingPoints": [
                      {
                          "capabilities": [
                              "RemoteStartStopCapable"
                          ],
                          "connectors": [
                              {
                                  "id": "1",
                                  "currentA": 32,
                                  "currentType": "AC3",
                                  "ratedPowerKW": 22.0,
                                  "type": "IEC62196Type2Outlet",
                                  "voltageV": 400
                              }
                          ],
                          "evseId": "RS*ORI*E1167",
                          "status": "Available"
                      },
                      {
                          "capabilities": [
                              "RemoteStartStopCapable"
                          ],
                          "connectors": [
                              {
                                  "id": "1",
                                  "currentType": "DC",
                                  "ratedPowerKW": 50.0,
                                  "type": "Chademo"
                              }
                          ],
                          "evseId": "RS*ORI*E1166",
                          "status": "Occupied"
                      },
                      {
                          "capabilities": [
                              "RemoteStartStopCapable"
                          ],
                          "connectors": [
                              {
                                  "id": "1",
                                  "currentA": 16,
                                  "currentType": "AC3",
                                  "ratedPowerKW": 11.0,
                                  "type": "IEC62196Type2Outlet",
                                  "voltageV": 400
                              }
                          ],
                          "evseId": "RS*ORI*E1163",
                          "status": "Unknown"
                      },
                      {
                          "capabilities": [
                              "RemoteStartStopCapable"
                          ],
                          "connectors": [
                              {
                                  "id": "1",
                                  "currentA": 16,
                                  "currentType": "AC3",
                                  "ratedPowerKW": 11.0,
                                  "type": "IEC62196Type2Outlet",
                                  "voltageV": 400
                              }
                          ],
                          "evseId": "RS*ORI*E1162",
                          "status": "Available"
                      },
                      {
                          "capabilities": [
                              "RemoteStartStopCapable"
                          ],
                          "connectors": [
                              {
                                  "id": "1",
                                  "currentType": "DC",
                                  "ratedPowerKW": 75.0,
                                  "type": "IEC62196Type2CCS"
                              }
                          ],
                          "evseId": "RS*ORI*E1165",
                          "status": "OutOfService"
                      },
                      {
                          "capabilities": [
                              "RemoteStartStopCapable"
                          ],
                          "connectors": [
                              {
                                  "id": "1",
                                  "currentA": 16,
                                  "currentType": "AC3",
                                  "ratedPowerKW": 11.0,
                                  "type": "IEC62196Type2Outlet",
                                  "voltageV": 400,
                                  "tariffId": "USCPIT10vn*B*2llX"
                              }
                          ],
                          "evseId": "RS*ORI*E1164",
                          "status": "Available"
                      }
                  ]
              }
          ],
          "address": {
              "countryCode": "RS",
              "countryCodeISO3": "SRB",
              "country": "Serbia",
              "countrySubdivision": "Central Serbia",
              "countrySubdivisionName": "Central Serbia",
              "countrySecondarySubdivision": "Belgrade City",
              "freeformAddress": "Улица Владимира Поповића 8, 11070 Belgrade",
              "localName": "Belgrade",
              "municipality": "Belgrade",
              "municipalitySubdivision": "Нови Београд",
              "postalCode": "11070",
              "streetNumber": "8",
              "streetName": "Улица Владимира Поповића"
          },
          "phone": "+386 3 777 77 77",
          "openingHours": {
              "mode": "nextSevenDays",
              "timeRanges": [
                  {
                      "startTime": {
                          "date": "2024-05-02",
                          "hour": 0,
                          "minute": 0
                      },
                      "endTime": {
                          "date": "2024-05-09",
                          "hour": 0,
                          "minute": 0
                      }
                  }
              ]
          },
          "timeZone": {
              "ianaId": "Europe/Belgrade"
          },
          "paymentOptions": [
              {
                  "brands": [
                      {
                          "name": "Shell Recharge"
                      },
                      {
                          "name": "Eneco"
                      }
                  ]
              }
          ],
          "nearbyPois": [7315,9932],
          "accessType": "Public",
          "vehicleConstraint": {
              "types": ["Car", "Truck"],
              "categories": ["N1", "N2"],
              "length": 5.0,
              "height": 2.75,
              "width": 2.0,
              "weight": 3500,
              "brands": [
                  {
                    "name": "Tesla"
                  },
                  {
                    "name": "Rivian"
                  }
              ]
          }
      }
  ],
  "references": {
      "tariffs": [
          {
              "id": "USCPIT10vn*B*2llX",
              "partner": {
                  "id": "CHCXGIH2",
                  "type": "CPO"
              },
              "currency": "USD",
              "product": {
                  "name": "Adhoc",
                  "type": "ADHOC"
              },
              "minPrice": {
                  "amount": 0.0,
                  "vat": 20.0
              },
              "maxPrice": {
                  "amount": 100.0,
                  "vat": 20.0
              },
              "elements": [
                  {
                      "priceComponents": [
                          {
                              "price": {
                                  "amount": 2.3,
                                  "vat": 20.0
                              },
                              "stepSize": 1.0,
                              "type": "ENERGY"
                          }
                      ],
                      "restrictions": {
                          "daysOfWeek": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY"],
                          "startDate": "2026-02-01",
                          "endDate": "2026-02-28",
                          "startTime": "08:00",
                          "endTime": "20:00",
                          "minPowerInKilowatts": 7.0,
                          "maxPowerInKilowatts": 22.0,
                          "minCurrentInAmperes": 16.0,
                          "maxCurrentInAmperes": 32.0,
                          "minEnergyInKilowattHours": 1.0,
                          "maxEnergyInKilowattHours": 50.0,
                          "minDurationInSeconds": 1800,
                          "maxDurationInSeconds": 14400,
                          "reservation": "RESERVATION"
                      }
                  }
              ]
          }
      ]
  }
242}

If the Accept header value is set to application/xml, the response will be a XML object with the following structure:

XML Response body example
1<response>
  <summary>
      <numResults>1</numResults>
      <totalResults>1</totalResults>
  </summary>
  <results>
      <item>
          <id>0b903425-3f5a-4072-9d5d-070f6f0647b3</id>
          <name>Mega M d.o.o.</name>
          <position>
              <lat>44.810263</lat>
              <lon>20.4354</lon>
          </position>
          <address>
              <countryCode>RS</countryCode>
              <countryCodeISO3>SRB</countryCodeISO3>
              <country>Serbia</country>
              <countrySubdivision>Central Serbia</countrySubdivision>
              <countrySubdivisionName>Central Serbia</countrySubdivisionName>
              <countrySecondarySubdivision>Belgrade City</countrySecondarySubdivision>
              <freeformAddress>Улица Владимира Поповића 8, 11070 Belgrade</freeformAddress>
              <localName>Belgrade</localName>
              <municipality>Belgrade</municipality>
              <municipalitySubdivision>Нови Београд</municipalitySubdivision>
              <postalCode>11070</postalCode>
              <streetNumber>8</streetNumber>
              <streetName>Улица Владимира Поповића</streetName>
          </address>
          <phone>+386 3 777 77 77</phone>
          <openingHours>
              <mode>nextSevenDays</mode>
              <timeRanges>
                  <timeRange>
                      <startTime>
                          <date>2024-05-02</date>
                          <hour>0</hour>
                          <minute>0</minute>
                      </startTime>
                      <endTime>
                          <date>2024-05-09</date>
                          <hour>0</hour>
                          <minute>0</minute>
                      </endTime>
                  </timeRange>
              </timeRanges>
          </openingHours>
          <timeZone>
              <ianaId>Europe/Belgrade</ianaId>
          </timeZone>
          <accessType>Public</accessType>
          <chargingStations>
              <chargingStation>
                  <id>RS*ORI*E1161</id>
                  <chargingPoints>
                      <chargingPoint>
                          <evseId>RS*ORI*E1167</evseId>
                          <status>Available</status>
                          <capabilities>
                              <capability>RemoteStartStopCapable</capability>
                          </capabilities>
                          <connectors>
                              <connector>
                                  <id>1</id>
                                  <currentA>32</currentA>
                                  <currentType>AC3</currentType>
                                  <ratedPowerKW>22.0</ratedPowerKW>
                                  <type>IEC62196Type2Outlet</type>
                                  <voltageV>400</voltageV>
                              </connector>
                          </connectors>
                      </chargingPoint>
                      <chargingPoint>
                          <evseId>RS*ORI*E1166</evseId>
                          <status>Occupied</status>
                          <capabilities>
                              <capability>RemoteStartStopCapable</capability>
                          </capabilities>
                          <connectors>
                              <connector>
                                  <id>1</id>
                                  <currentType>DC</currentType>
                                  <ratedPowerKW>50.0</ratedPowerKW>
                                  <type>Chademo</type>
                              </connector>
                          </connectors>
                      </chargingPoint>
                      <chargingPoint>
                          <evseId>RS*ORI*E1163</evseId>
                          <status>Unknown</status>
                          <capabilities>
                              <capability>RemoteStartStopCapable</capability>
                          </capabilities>
                          <connectors>
                              <connector>
                                  <id>1</id>
                                  <currentA>16</currentA>
                                  <currentType>AC3</currentType>
                                  <ratedPowerKW>11.0</ratedPowerKW>
                                  <type>IEC62196Type2Outlet</type>
                                  <voltageV>400</voltageV>
                              </connector>
                          </connectors>
                      </chargingPoint>
                      <chargingPoint>
                          <evseId>RS*ORI*E1162</evseId>
                          <status>Available</status>
                          <capabilities>
                              <capability>RemoteStartStopCapable</capability>
                          </capabilities>
                          <connectors>
                              <connector>
                                  <id>1</id>
                                  <currentA>16</currentA>
                                  <currentType>AC3</currentType>
                                  <ratedPowerKW>11.0</ratedPowerKW>
                                  <type>IEC62196Type2Outlet</type>
                                  <voltageV>400</voltageV>
                              </connector>
                          </connectors>
                      </chargingPoint>
                      <chargingPoint>
                          <evseId>RS*ORI*E1165</evseId>
                          <status>OutOfService</status>
                          <capabilities>
                              <capability>RemoteStartStopCapable</capability>
                          </capabilities>
                          <connectors>
                              <connector>
                                  <id>1</id>
                                  <currentType>DC</currentType>
                                  <ratedPowerKW>75.0</ratedPowerKW>
                                  <type>IEC62196Type2CCS</type>
                              </connector>
                          </connectors>
                      </chargingPoint>
                      <chargingPoint>
                          <evseId>RS*ORI*E1164</evseId>
                          <status>Available</status>
                          <capabilities>
                              <capability>RemoteStartStopCapable</capability>
                          </capabilities>
                          <connectors>
                              <connector>
                                  <id>1</id>
                                  <currentA>16</currentA>
                                  <currentType>AC3</currentType>
                                  <ratedPowerKW>11.0</ratedPowerKW>
                                  <type>IEC62196Type2Outlet</type>
                                  <voltageV>400</voltageV>
                                  <tariffId>USCPIT10vn*B*2llX</tariffId>
                              </connector>
                          </connectors>
                      </chargingPoint>
                  </chargingPoints>
              </chargingStation>
          </chargingStations>
          <paymentOptions>
              <paymentOption>
                  <brands>
                      <brand>
                          <name>Shell Recharge</name>
                      </brand>
                      <brand>
                          <name>Eneco</name>
                      </brand>
                  </brands>
              </paymentOption>
          </paymentOptions>
          <nearbyPois>
              <nearbyPoi>
                  <categoryId>7315</categoryId>
              </nearbyPoi>
              <nearbyPoi>
                  <categoryId>9932</categoryId>
              </nearbyPoi>
          </nearbyPois>
          <vehicleConstraint>
              <types>
                  <type>Car</type>
                  <type>Truck</type>
              </types>
              <categories>
                  <category>N1</category>
                  <category>N2</category>
              </categories>
              <height>2.75</height>
              <width>2.5</width>
              <length>5.0</length>
              <weight>3500</weight>
              <brands>
                  <brand>
                      <name>Tesla</name>
                  </brand>
                  <brand>
                      <name>Rivian</name>
                  </brand>
              </brands>
          </vehicleConstraint>
      </item>
  </results>
  <references>
      <tariffs>
          <tariff>
              <id>USCPIT10vn*B*2llX</id>
              <partner>
                  <id>CHCXGIH2</id>
                  <type>CPO</type>
              </partner>
              <currency>USD</currency>
              <product>
                  <name>Adhoc</name>
                  <type>ADHOC</type>
              </product>
              <minPrice>
                  <amount>0.0</amount>
                  <vat>20.0</vat>
              </minPrice>
              <maxPrice>
                  <amount>100.0</amount>
                  <vat>20.0</vat>
              </maxPrice>
              <elements>
                  <element>
                      <priceComponents>
                          <priceComponent>
                              <price>
                                  <amount>2.3</amount>
                                  <vat>20.0</vat>
                              </price>
                              <stepSize>1.0</stepSize>
                              <type>ENERGY</type>
                          </priceComponent>
                      </priceComponents>
                      <restrictions>
                          <daysOfWeek>
                              <dayOfWeek>MONDAY</dayOfWeek>
                              <dayOfWeek>TUESDAY</dayOfWeek>
                              <dayOfWeek>WEDNESDAY</dayOfWeek>
                              <dayOfWeek>THURSDAY</dayOfWeek>
                              <dayOfWeek>FRIDAY</dayOfWeek>
                          </daysOfWeek>
                          <startDate>2026-02-01</startDate>
                          <endDate>2026-02-28</endDate>
                          <startTime>08:00</startTime>
                          <endTime>20:00</endTime>
                          <minPowerInKilowatts>7.0</minPowerInKilowatts>
                          <maxPowerInKilowatts>22.0</maxPowerInKilowatts>
                          <minCurrentInAmperes>16.0</minCurrentInAmperes>
                          <maxCurrentInAmperes>32.0</maxCurrentInAmperes>
                          <minEnergyInKilowattHours>1.0</minEnergyInKilowattHours>
                          <maxEnergyInKilowattHours>50.0</maxEnergyInKilowattHours>
                          <minDurationInSeconds>1800</minDurationInSeconds>
                          <maxDurationInSeconds>14400</maxDurationInSeconds>
                          <reservation>RESERVATION</reservation>
                      </restrictions>
                  </element>
              </elements>
          </tariff>
      </tariffs>
  </references>
261</response>

Response fields

The following table describes all the fields that can appear in a response. Fields are listed by the response section they belong to and in the order that they appear in the response.

Primary fields
Field	Description
`summary` object	Summary information about the search that was performed.
`results` array	Array of `result` objects.
`references` object	`References` to requested additional information.

summary object
Field	Description
`numResults` integer	Number of results in the response.
`totalResults` integer	Total number of results found.

result object
Field	Description
`id` string	EV POI Id.
`name` string	Name of the POI.
`position` object	`Position` of the EV POI.
`chargingStations` array	Array of `chargingStation` objects.
`address` object	Structured `address` for the result.
`phone` string	Phone number of the POI.
`openingHours` object	Opening hours for the POI.
`timeZone` object	Time zone for the POI.
`brands` array	Array of `brand` objects. Brands available at the POI.
`paymentOptions` array	Array of `paymentOption` objects.
`nearbyPois` array	Array of `nearbyPoi`. Nearby POIs are points of interest within walking distance of the charging stations that users can explore while charging their vehicles.
`accessType` string	Access type of the EV POI station. Enum: Public: No restriction, POI is open for public use. Authorized: Restriction applies, often requires a permit or registration, i.e., `EmployeesOnly`. Restricted: Restricted POIs are public locations with the intention to be used by a certain member of the public, i.e., `ResidentsOnly`. Private: Private POIs are locations that are not open to the public.
`vehicleConstraint` object	Vehicle constraint of the EV POI.

position object
Field	Description
`lat` double	Latitude of the result.
`lon` double	Longitude of the result.

chargingStation object
Field	Description
`id` string	Charging station Id.
`chargingPoints` object	Array of `chargingPoint` objects.

chargingPoint object
Field	Description
`capabilities` string (list)	List of capabilities. Enum: `ChargingProfileCapable`: The charging point supports charging profiles. `ChargingPreferencesCapable`: The charging point supports charging preferences. `ChipCardSupport`: The charging point has a payment terminal that supports chip cards. `ContactlessCardSupport`: The charging point has a payment terminal that supports contactless cards. `CreditCardPayable`: The charging point has a payment terminal that supports credit cards. `DebitCardPayable`: The charging point has a payment terminal that supports debit cards. `PedTerminal`: The charging point has a payment terminal with a pin-code entry device. `RemoteStartStopCapable`: The charging point supports remote start and stop functionality. `Reservable`: The charging point can be reserved. `RfidReader`: Charging at this point can be authorized with an RFID token. `StartSessionConnectorRequired`: When a StartSession is sent to the charging point, the MSP must add the optional connector id field in the StartSession object. `TokenGroupCapable`: The charging point supports token groups. Two or more tokens work as one so that a session can be started with one token and stopped with another (handy when a card and key-fob are given to the EV-driver). `UnlockCapable`: The connectors of the charging point have a mechanical lock that the eMSP can request to be unlocked. `PlugAndCharge`: The charging point is compliant with ISO-15118 Plug and Charge functionality.
`connectors` array	Array of `connector` objects.
`id` string	Charging point Id.
`evseId` string	The EVSE ID is a unique alphanumeric code assigned to each individual charging point (or connector) within a station or network. It's essential for identifying specific chargers in public or roaming charging systems, enabling apps and providers to locate, authenticate, and bill for sessions accurately.
`physicalReference` string	Physical identification of the charging station printed on the station and visible to the driver. One of the parameters that can be used for booking or charging purposes to locate the physical station. No standard format is available.
`restrictions` string (list)	List of parking restrictions. Enum: `evOnly`: Reserved parking spot for electric vehicles. `plugged`: Parking is only allowed while plugged in (charging). `disabled`: Reserved parking spot for disabled people with a valid ID. `customers`: Parking spot for customers/guests only, for example in case of a hotel or shop. `motorcycles`: Parking spot only suitable for (electric) motorcycles or scooters.
`status` string	Dynamic availability status of charging point. Enum: Available Reserved Occupied OutOfService Unknown

connector object
Field	Description
`id` string	Id of the connector.
`currentA` integer	Amperage in amperes[A].
`currentType` string	The current type of the connector. Enum: AC1 AC3 DC
`ratedPowerKW` double	Rated charging power in kilowatts[KW].
`type` string	The connector type which is one of the supported types.
`voltageV` integer	Voltage in volts[V].
`tariffId` string	Identifier of tariff attached to the connector, included only when parameter include=tariffs was provided. Refers to a `tariff` object with the given ID in the `references` section of the response.

address object
Field	Description
`countryCode` string	The two-letter code of the country.
`countryCodeISO3` string	ISO alpha-3 country code.
`country` string	The country name.
`countrySubdivision` string	State or Province. For regions like USA, CAN, & GB, this will be the province code, and for the rest the subdivision name.
`countrySecondary Subdivision` string	Country.
`countryTertiary Subdivision` string	Named area.
`countrySubdivisionName` string	State or Province name.
`countrySubdivisionCode` string	State or Province code. Only for regions like USA, CAN, GB.
`countrySubdivisionName` string	The full name of the first level of a country's administrative hierarchy. This field appears only in case `countrySubdivision` is presented in an abbreviated form. Supported only for USA, Canada, and Great Britain.
`freeformAddress` string	An address line formatted according to the formatting rules of the result's country of origin.
`localName` string	An address component which represents the name of a geographic area or locality that groups a number of addressable objects for addressing purposes, without being an administrative unit.
`municipality` string	City / Town.
`municipality Subdivision` string	Sub / Super City.
`postalCode` string	Postal code / Zip code.
`extendedPostalCode` string	Extended postal code (availability dependent on region).
`streetNumber` string	The building number on the street.
`streetName` string	The street name.

openingHours object
Field	Description
`mode` string	Requested mode for opening hours. Value: `nextSevenDays`
`timeRanges` array	List of time ranges for the next 7 days. Array of `timeRange`.

timeRange object
Field	Description
`startTime` object	Start of the `timeRange` in the form of `dateHourMinute`.
`endTime` object	End of the `timeRange` in the form of `dateHourMinute`.

dateHourMinute object
Field	Description
`date` string	The date in the calendar year in the local time zone.
`hour` integer	Possible values: `0` - `23`
`minute` integer	Possible values: `0` - `59`

timeZone object
Field	Description
`ianaId` string	ID from the IANA Time Zone Database.

brand object
Field	Description
`id` string	Brand Id.
`name` string	Brand name.

paymentOption object

Field Description

paymentOption object
`method` string	Payment method. Enum: subscription
`brands` array	Array of `payment option brand` objects.

method string

Payment method.
Enum:

subscription

brands array Array of payment option brand objects.

paymentOptionBrand object
Field	Description
`id` string	Unique identifier of the payment option.
`name` string	Name of the payment option.
`restricted` boolean	Indicates if payment option is restricted to the current request.

nearbyPoi object

Field Description

nearbyPoi object
`categoryId` integer	Category Id of the nearby POI. Enum: 7315 - Restaurant 9932 - Public Amenity 9376 - Café/Pub 7314 - Hotel/Motel 9361 - Shop 9362 - Park Recreation Area

categoryId integer

Category Id of the nearby POI.
Enum:

7315 - Restaurant
9932 - Public Amenity
9376 - Café/Pub
7314 - Hotel/Motel
9361 - Shop
9362 - Park Recreation Area

vehicleConstraint object
Field	Description
`types` string (list)	Vehicle types constraint of the result. Enum: Car Truck
`categories` string (list)	Vehicle categories constraint of the result. Enum: N1 N2 N3 N3+O4
`length` double	Vehicle length —in meters— constraint of the result.
`height` double	Vehicle height —in meters— constraint of the result.
`width` double	Vehicle width —in meters— constraint of the result.
`weight` integer	Vehicle weight —in kg— constraint of the result.
`brands` object	Array of `vehicleBrand` objects.

vehicleBrand object
Field	Description
`name` string	Vehicle brand name.

references object
Field	Description
`tariffs` array	Array of `tariff` objects related to connectors.

tariff object
Field	Description
`id` string	Tariff identifier.
`partner` object	`Partner` information.
`currency` string	Currency of the price, in ISO-4217 format.
`product` object	`Product` information.
`minPrice` object	`Price` object for minimum applicable price.
`maxPrice` object	`Price` object for maximum applicable price.
`elements` array	Array of `element` objects providing pricing details and restrictions.

product object

Field Description

name string Name of payment product.

product object
`name` string	Name of payment product.
`type` string	Product type. Example value: ADHOC

type string

Product type.
Example value:

ADHOC

partner object

Field Description

id string Identifier of CPO/eMSP partner.

partner object
`id` string	Identifier of CPO/eMSP partner.
`type` string	Type of partner. Example values: CPO MSP

type string

Type of partner.
Example values:

price object
Field	Description
`amount` number	The price amount (tax included).
`vat` number	The VAT (Value Added Tax) value.

element object For more info: `OCPI-TariffElement`
Field	Description
`priceComponents` array	Array of `price component` objects describing how each dimension is priced.
`restrictions` object	`Restrictions` object describing when the price components of given tariff element apply.

priceComponent object For more info: `OCPI-PriceComponent`
Field	Description
`price` object	`Price` object for given component.
`stepSize` number	Step size for given price component.
`type` string	Type of given price component. Example values: ENERGY TIME FLAT PARKING_TIME

restrictions object For more info: `OCPI-TariffRestrictions`
Field	Description
`daysOfWeek` array	Days of the week for which the restriction applies. Example values: SUNDAY MONDAY TUESDAY WEDNESDAY THURSDAY FRIDAY SATURDAY
`startDate` string	Start date of the restrictions. Example: `2025-01-01`
`endDate` string	End date of the restrictions. Example: `2025-12-31`
`startTime` string	Start time of the restrictions. Example: `00:00`
`endTime` string	End time of the restrictions. Example: `23:59`
`minPowerInKilowatts` number	Minimum power in kW.
`maxPowerInKilowatts` number	Maximum power in kW.
`minCurrentInAmperes` number	Sum of the minimum current (in Amperes) over all charging phases.
`maxCurrentInAmperes` number	Sum of the maximum current (in Amperes) over all charging phases.
`minEnergyInKilowattHours` number	Minimum consumed energy in kWh.
`maxEnergyInKilowattHours` number	Maximum consumed energy in kWh.
`minDurationInSeconds` integer	Minimum duration in seconds the charging session must last.
`maxDurationInSeconds` integer	Maximum duration in seconds the charging session can last.
`reservation` string	Reservation restriction type. Example values: RESERVATION: indicates pricing is for the duration when user’s reservation is active. RESERVATION_EXPIRES: indicates pricing is applicable if user’s reservation time has expired. Note: Reservation restriction can only have: FLAT and TIME tariff dimensions, where TIME is for the duration of the reservation.

Response codes

Code	Meaning & possible causes
`200`	OK: If any matching charging station was found, the body of the response will contain the data. Otherwise, an empty response will be returned: Empty response example - JSON 1{ 2 "summary": { 3 "numResults": 0, 4 "totalResults": 0 5}}
`400`	Bad request: One or more parameters were incorrectly specified or are out of range.
`403`	Forbidden: Possible causes include: Forbidden Not authorized Account inactive Account over queries per second limit Rate limit exceeded
`404`	Not Found: The requested resource could not be found, the HTTP request method or path is incorrect.
`405`	Method Not Allowed : The client used an HTTP method other than `GET`.
`406`	Media Type Not Acceptable
`414`	The requested URI is too long
`429`	Too Many Requests: The API Key is over QPS (Queries per second).
`5xx`	Server Error: The service was unable to process your request. Contact support to resolve the issue.

Response headers

The following table lists HTTP response headers.

Header	Description
Access-Control-Allow-Origin	The EV Search service allows cross-origin resource sharing. Value: `*` This asterisk signifies access to the TomTom API using the Access-Control-Allow-Origin (ACAO) header in its response, indicating which origin sites are allowed.
Content-Encoding	The EV Search service supports HTTP compression if requested by the client. Value: `gzip`
Cache-Control	The Cache-Control general-header field is used to specify directives that must be obeyed by all caching mechanisms along the request/response chain. Supported by HTTP/1.1 clients. May not be supported by HTTP/1.0 clients. Value: `no-cache`
Content-Type	Indicates the format of the response as chosen by the client. Format: `type/subtype; charset=utf-8` Value: `type/subtype: application/json`
Tracking-ID	An identifier for the request. If the Tracking-ID header was specified, it is replicated in the response. Otherwise, it is generated automatically by the service. It is only meant to be used for support and does not involve tracking of you or your users in any form. Value: An `identifier` for the request.

Error response

The error response content type depends on the Accept header.

Error response example - JSON
1{
2  "message": "Missing parameter 'parameterName'",
3  "detailedError": {
4    "code": "MissingParameter",
5    "message": "Missing required parameter 'parameterName'."
6  },
7  "httpStatusCode": "400"
8}

Error response example - XML
1<ErrorEvResponse>
2  <message>Missing parameter 'parameterName'</message>
3  <detailedError>
4    <code>MissingParameter</code>
5    <message>Missing required parameter 'parameterName'.</message>
6  </detailedError>
7</ErrorEvResponse>

Error response fields

Primary fields	Description
`message` string	A human-readable description of the error.
`detailedError` object	Detailed information about the error. `detailedError` object
detailedError object
Field	Description
`code` string	One of a server-defined set of error codes.
`message` string	A human-readable description of the error code. It is intended as an aid to developers and is not suitable for exposure to end users.

EV Search by Id

Private Preview Notice

Important notes:

Purpose

Request data

HTTPS method: GET

Request format

Request curl command example

Request parameters

Request headers

Response data

Response body

Response fields

Response codes

Response headers

Error response

Error response fields

HTTPS method: `GET`