Sorry, you need to enable JavaScript to visit this website.
EV Service
Request access

API 1.8

XML Schemas

XML schemas can be found here.

Example

Static Feed

The static feed for Germany

https://api.tomtom.com/electromobility/api/1.8/static/de?key=<apiKey>

Example Response

The available static information for all known charging stations in the requested country is provided as xml. The order of the stations is not specified.

<?xml version="1.0" encoding="UTF-8" ?>
<chargingParks xmlns="http://www.tomtom.com/service/tis/chargingstation/static/1.0"
               xmlns:meta="http://www.tomtom.com/service/tis/chargingstation/metadata/1.0"
               xmlns:p="http://www.tomtom.com/service/tis/primitives/1.0"
               xmlns:lb="http://www.tomtom.com/service/tis/locBbox"
               xmlns:lp="http://www.tomtom.com/service/tis/location/point/1.0"
               xmlns:la="http://www.tomtom.com/service/tis/location/address/1.0"
               xmlns:lh="http://www.tomtom.com/service/tis/location/hash/1.0"
               xmlns:oh="http://www.tomtom.com/service/tis/openinghours/1.0"
               schemaVersion="1.0">

    <meta:metaData>
        <meta:creatorVersion>0.01-9.1.RC2@0</meta:creatorVersion>
        <meta:creatorUUID>1232abdf-6ef7-4310-81b5-e7e4be3786f0</meta:creatorUUID>
        <meta:creationTimeUTC>2016-01-13T09:06:46Z</meta:creationTimeUTC>
        <meta:description>Example showing static charging station information</meta:description>
    </meta:metaData>

    <chargingPark>
        <uuid>9876dcba-5f0e-2314-435a-aa34cd12f9fe</uuid>
        <externalId>042009000104250</externalId>

        <properties>
            <name>Baker Motor</name>
            <countryCode>DE</countryCode>
            <contact>
                <email>aEmail@address.com</email>
                <web>http://tomtom.com</web>
                <phone>+49 228 123231</phone>
                <fax>+49 228 123232</fax>
            </contact>
            <operator>
                <name>operator's name</name>
                <contact>
                    <email>operatorEmail@address.com</email>
                    <web>http://tomtom.com/operator</web>
                    <phone>+49 228 223231</phone>
                    <fax>+49 228 223232</fax>
                </contact>
                <address>
                    <la:street>An den Treptowers 1</la:street>
                    <la:city>Berlin</la:city>
                    <la:postalCode>5455</la:postalCode>
                    <la:country>DE</la:country>
                </address>
            </operator>
            <oh:openingHours>
                <oh:openingPeriod>
                    <oh:day>
                        <oh:from>Mo</oh:from>
                        <oh:to>Fr</oh:to>
                    </oh:day>
                    <oh:time>
                        <oh:opens>00:00</oh:opens>
                    </oh:time>
                </oh:openingPeriod>
                <oh:openingPeriod>
                    <oh:day>
                        <oh:from>Su</oh:from>
                        <oh:to>Su</oh:to>
                    </oh:day>
                    <oh:time>
                        <oh:opens>06:30</oh:opens>
                        <oh:closes>10:00</oh:closes>
                    </oh:time>
                </oh:openingPeriod>
            </oh:openingHours>
            <paymentOptions>
                <paymentOption>
                    <method>Direct</method>
                    <currencies>
                        <currency>EUR</currency>
                        <currency>USD</currency>
                    </currencies>
                    <brands>
                        <brand>visa</brand>
                        <brand>maestro</brand>
                    </brands>
                    <benefits>
                        <benefit>Special benefit</benefit>
                        <benefit>Special benefit 2</benefit>
                    </benefits>
                </paymentOption>
                <paymentOption>
                    <method>Subscription</method>
                    <brands>
                        <brand>ChargeMSP</brand>
                        <brand>PlugMSP</brand>
                    </brands>
                </paymentOption>
                <paymentOption>
                    <method>Subscription</method>
                    <brands>
                        <brand>F2C-MSP</brand>
                    </brands>
                    <benefits>
                        <benefit>20% discount</benefit>
                    </benefits>
                </paymentOption>
            </paymentOptions>
        </properties>

        <locations>
            <lb:boundingBox>
                <lb:lowerLeft>
                    <p:latitude>50.73689</p:latitude>
                    <p:longitude>7.10662</p:longitude>
                </lb:lowerLeft>
                <lb:upperRight>
                    <p:latitude>50.73698</p:latitude>
                    <p:longitude>7.10674</p:longitude>
                </lb:upperRight>
            </lb:boundingBox>
            <lp:pointLocation>
                <p:latitude>50.73689</p:latitude>
                <p:longitude>7.10674</p:longitude>
            </lp:pointLocation>
            <lh:locationHash>7230324</lh:locationHash>
        </locations>

        <chargingStations>
            <chargingStation>
                <uuid>1232abdf-6ef7-4310-81b5-e7e4be3786f0</uuid>
                <externalId>anExternalId-A</externalId>
                <name>First station</name>
                <accessibilityType>Public</accessibilityType>
                <locations>
                    <lb:boundingBox>
                        <lb:lowerLeft>
                            <p:latitude>50.73689</p:latitude>
                            <p:longitude>7.10662</p:longitude>
                        </lb:lowerLeft>
                        <lb:upperRight>
                            <p:latitude>50.73698</p:latitude>
                            <p:longitude>7.10674</p:longitude>
                        </lb:upperRight>
                    </lb:boundingBox>
                    <lp:pointLocation>
                        <p:latitude>50.73689</p:latitude>
                        <p:longitude>7.10674</p:longitude>
                    </lp:pointLocation>
                    <lh:locationHash>6138943</lh:locationHash>
                </locations>
                <chargingPoints>
               <chargingPoint>
                        <uuid>5e332e95-b0bc-3f35-0000-00090af7026d</uuid>
                        <externalId>anExternalId-A_1a</externalId>
                        <name>Connector A</name>
                        <connectors>
                            <connector>
                                <plugType>IEC_62196_Type_3_Outlet</plugType>
                                <ratedPower>22</ratedPower>
                                <currentType>AC3</currentType>
                            </connector>
                        </connectors>
                        <locations>
                            <lp:pointLocation>
                                <p:latitude>50.73689</p:latitude>
                                <p:longitude>7.10676</p:longitude>
                            </lp:pointLocation>
                        </locations>
                    </chargingPoint>
                    <chargingPoint>
                        <uuid>7260f725-04ea-38a4-0000-00090af7026d</uuid>
                        <externalId>anExternalId-A_1b</externalId>
                        <name>Connector B</name>
                        <connectors>
                            <connector>
                                <plugType>Combo_to_IEC_62196_Type_2_Base</plugType>
                                <ratedPower>50</ratedPower>
                                <voltageRange>V_50_500</voltageRange>
                                <current>125</current>
                                <currentType>DC</currentType>
                            </connector>
                            <connector>
                                <plugType>Combo_to_IEC_62196_Type_2_Base</plugType>
                                <ratedPower>50</ratedPower>
                                <voltageRange>V_50_500</voltageRange>
                                <current>125</current>
                                <currentType>DC</currentType>
                            </connector>
                        </connectors>
                    </chargingPoint>
                    <chargingPoint>
                        <uuid>1232abdf-6ef7-4310-81b5-e7e4be3786f3</uuid>
                        <externalId>anExternalId-A_2a</externalId>
                        <name>Connector C</name>
                        <connectors>
                            <connector>
                                <plugType>Unspecified</plugType>
                            </connector>
                        </connectors>
                        <locations>
                            <lp:pointLocation>
                                <p:latitude>50.73689</p:latitude>
                                <p:longitude>7.10678</p:longitude>
                            </lp:pointLocation>
                        </locations>
                    </chargingPoint>
                </chargingPoints>
            </chargingStation>
            <!-- Can contain more -->
        </chargingStations>
    </chargingPark>
</chargingParks>

Usage and Freshness

By nature of this static feed, there is infrequent changes in the provided content. It is reasonable to expect update requests of approximately once per day. Using the support for If-None-Match or If-Modified-Since header fields, update request frequencies higher than once per day could be used to minimize the delay between updated information being available on the server and being received by the client.

Dynamic Feed

The dynamic feed for Germany

https://api.tomtom.com/electromobility/api/1.8/dynamic/de?key=<apiKey>

Example Response

The Dynamic Feed provides information for all known charging points in the requested country, referenced by UUID. The order of the stations is not specified.

<?xml version="1.0" encoding="UTF-8"?>
<chargingParksDynamic xmlns="http://www.tomtom.com/service/tis/chargingstation/dynamic/1.8"
                      xmlns:meta="http://www.tomtom.com/service/tis/chargingstation/metadata/1.8"
                      schemaVersion="1.8">

    <meta:metaData>
        <meta:creatorUUID>0d96c37e-cfdf-4f50-a1bc-5a05044ecbd4</meta:creatorUUID>
        <meta:creationTimeUTC>2020-02-11T13:07:47</meta:creationTimeUTC>
    </meta:metaData>

    <chargingStationUpdate>
        <referenceUuid>798c93fc-ba74-102b-b5ef-00304891a58c</referenceUuid>
        <chargingPointUpdates>
            <chargingPointUpdate>
                <referenceUuid>7260f725-04ea-38a4-0000-00090af7026d</referenceUuid>
                <status>Available</status>
            </chargingPointUpdate>
            <chargingPointUpdate>
                <referenceUuid>2823a471-1d57-311f-0000-00090af7026d</referenceUuid>
                <status>Occupied</status>
            </chargingPointUpdate>
        </chargingPointUpdates>
        <!-- Can contain more -->
    </chargingStationUpdate>

</chargingParksDynamic>

Usage and Freshness

Updates are provided regularly; typically at a rate of once per minute. Using the support for If-None-Match or If-Modified-Since header fields, any update request frequencies higher than once-per-minute can be used to minimize the delay between updated information being available in the server and being received by the client.