Introduction

IONITY makes long distance travel with electric vehicles the new normal. The company builds and operates a high-power charging (HPC) network along Europe’s highways, using state-of-the-art technology with a charging capacity of up to 350 kW. By doing so drivers of current and future generations of electric vehicles - using the leading European charging standard CCS (Combined Charging System) - benefit from maximum charging speeds while taking a break on their journey. Every IONITY charging station consists of an average of four charging points. As a commitment to sustainability, all IONITY chargers deliver 100% renewable energy for both emission-free and carbon neutral driving. IONITY was founded in 2017 and is a joint venture by BMW Group, Ford Motor Company, Hyundai Motor Group with KIA, Mercedes-Benz AG and Volkswagen Group with Audi and Porsche. More than 110 employees are shaping the future of e-Mobility at IONITY. The company is headquartered in Munich with an additional office in Dortmund, and Oslo, Norway. IONITY is an internationally registered trademark. For further information please visit https://www.ionity2025.eu

Perhaps the greatest obstacle facing widespread adoption of EVs and e-Mobility is a lack of reliable, ubiquitous, easy-to-use, ultra-fast charging infrastructure outside of cities and metropolitan regions. This is exactly the problem IONITY is already on the road to solving. No matter where you live, how you travel, or who you are – IONITY is giving you the freedom to go wherever you want. Without compromise.

Charging station concept description

station

Several chargers are always installed on each IONITY charging station. Normally between 4 and 12 units. The most chargers have only one high power charging (CCS type 2) connector. On some charging stations there are also chargers with multiple connector types: CCS type 2, CHAdeMO, Mennekes (IEC-62196-T2) and the french domestic plug Type E.

This results in the following hierarchy for a regular charging station:

  • Charging station

    • Charger

      • Connector (CCS2)

    • …​

      • …​

    • Charger

      • Connector (CCS2)

and for a charging station with multi connector chargers:

  • Charging station

    • Charger

      • Connector

    • …​

      • …​

    • Charger

      • Connector (CCS2)

      • Connector (CHAdeMO)

      • Connector (Mennekes)

API Usage

IONITY public API provides two endpoints:

  • <URI>/stations

  • <URI>/connectors

The /stations endpoint provides extensive static data about IONITY charging stations. The data will be updated on the daily basis. In the case new charging stations will go live the appropriate update will appear only next day.

Every charging station, charger and connector has a persistent unique id so it is possible to identify the appropriate resource through the request lifecycle. These id’s will also stay persistent.

The data from the /stations endpoint is compressed using gzip algorithm. Be aware that your API client can deal with it. Please also see Response headers

The /connectors endpoint provides only short extract of the data amount that will be provided by the /stations endpoint. For details see Dynamic charging stations data . Provided data will be updated at the request time so it is always up to date.

Please be aware, that the first requests against the API can be responded with response times greater than 10 seconds. With the increasing number of requests the response times will start to decrease and will be on the average level of 400 milliseconds. Configure your clients with a max. timeout of 30 seconds.

Static charging stations data

Request example

curl -X GET https://api.ionity.eu/stations -H 'x-api-key: <your individual API key>'

Response headers

Stations endpoint
Content-Type : application/json
Content-Encoding : gzip
Connectors endpoint
Content-Type : application/json

Response description

Root object
Field name Type Description

charging_stations

ChargingStation

Array of ChargingStation objects

onsite_auth

OnsiteAuthentication

Array of OnsiteAuthentication objects.
ChargingStation
Field name Type Description

id

String

A unique persistent identifier

operator_name

String

Charge point operator name

station_name

String

IONITY charging station unique name

last_updated

String

Timestamp when the data was last updated. ISO 8601 format without milliseconds: "2019-05-10T12:30:54+02:00"

access_restriction

AccessRestriction

Restrictions to enter and / or charge at the charging station

opening_hours

OpenningHours

Operational hours of a charging station

coordinates

Coordinates

Charging station GPS coordinates

contact

Contact

Charge point operator contact data

address

Address

Charging station address

chargers

Charger

Array of charger objects
AccessRestriction
Field name Type Description

PUBLIC

String

Charging station is open for everyone

EMPLOYEES

String

Only IONITY employees have access to the charging station
OpenningHours

At the moment all IONITY public stations are opened 24/7. This is represented by following object sturcture:

{
  "opening_hours": [
    {
      "weekday": "1",
      "hour_begin": "00:00",
    },
    {
      "weekday": "7",
      "hour_end": "24:00"
    }
  ]
}
Field name Type Description

weekday

String

Indicates the day of week as following mapping (Monday = 1, Thuesday = 2 etc.)

hour_begin

String

Beginning hour in the format "00:00"

hour_end

String

End hour in the format "00:00"
Coordinates
Field name Type Description

lat

String

Field value must be valid WGS 84 latitude

lon

String

Field value must be valid WGS 84 longitude
Contact
Field name Type Description

operator_homepage

String

Charge point operator homepage

operator_customer_support

String

Charge point operator customer support phone number
Address
Field name Type Description

locality

String

City or locality name

postal_code

String

Postal code

language

String

2 letter ISO language code

country

String

2 letter ISO country code

street_name

String

String containing street name and number
Charger
Field name Type Description

id

String

Unique persistent charger id

label

String

A unique identifier printed on the sticker that is physically attached at each charger

connectors

Connector

Array of Connector objects
Connector
Field name Type Description

id

String

Unique persistent connector id

dedicated_parking

Boolean

Indicates the availability of a dedicated parking lot

last_updated

String

Timestamp when the connector status was last updated. ISO 8601 format without milliseconds: "2019-05-10T12:30:54+02:00"

auth_types

OnsiteAuthentication

Array of OnsiteAuthentication obejct id’s. May contain additional information in the future

connector_status

ConnectorStatus

Value of ConnectorStatus object

connector_type

String

ConnectorType value

reservable

Boolean

Indicates if the connector can be reserved. At the moment none of IONITY connectors can be reserved.

available_power_kw

String

Indicates the max possible outgoing charging power
OnsiteAuthentication
Field name Type Description

id

String

Unique persistent onsite authentication id

payment_required

Boolean

Indicates whether charging at the connector is free or not

types

OnsiteAuthenticationType

Array of OnsiteAuthenticationType values
OnsiteAuthenticationType
Field name Type Description

NFC_CARD

String

Customers can authenticate themselves with a NFC card and/or NFC dongle

APP

String

Customers can authenticate themselves either using the IONITY app (available at Google Play store or Apple App Store) or by using the app provided by a Mobility Service Provider

QR_CODE

String

Customers can register and / or authenticate themselves by scanning the QR code placed on the sticker using IONITY app (available at Google Play store or Apple App Store)
ConnectorStatus
Field name Type Description

AVAILABLE

String

Connector is available. Charging session is possible

UNAVAILABLE

String

Connector is currently not available. Charging session is not possible

FAULTED

String

Connector is currently not available because of technical error. Charging session is not possible

OCCUPIED

String

Connector is currently in use. Ongoing charging session

RESERVED

String

Connector is currently reserved by a customer. Charging session is only possible for the customer who placed the reservation

UNKNOWN

String

Connector status can’t be clearly determined
ConnectorType
Field name Type Description

IEC-62196-T2-COMBO

String

CCS2 https://en.wikipedia.org/wiki/Combined_Charging_System

Chademo

String

CHAdeMO https://en.wikipedia.org/wiki/CHAdeMO

IEC-62196-T2

String

MENNEKES (IEC-62196-T2) https://en.wikipedia.org/wiki/Type_2_connector

DOMESTIC-E

String

French Type E plug (CEE 7/5) https://en.wikipedia.org/wiki/CEE_7_standard_AC_plugs_and_sockets

Error Codes

HTTP error code Error message Description

403

Forbidden

Your API key is not valid or it was deactivated

429

Throttled or Quota Exceeded

Too many requests per time unit

500

Technical error occurred

Unexpected technical error

Dynamic charging stations data

Request example

curl -X GET https://api.ionity.eu/connectors -H 'x-api-key: <your individual API key>'

Response Description

Root object
Field name Type Description

status

ConnectorStatus

Array of ConnectorStatus objects
ConnectorStatus
Field name Type Description

charging_station_id

String

Charging station id from the ChargingStation object

charger_id

String

Charger id from the Charger object

connector_id

String

Connector id from the Connector object

connector_status

String

Connector status from the ConnectorStatus object

last_updated

String

Timestamp when the connector status was last updated. ISO 8601 format without milliseconds: "2019-05-10T12:30:54+02:00"

Error Codes

HTTP error code Error message Description

403

Forbidden

Your API key is not valid or it was deactivated

429

Throttled or Quota Exceeded

Too many requests per time unit

500

Technical error occurred

Unexpected technical error

JSON response examples

Stations endpoint response

{
  "charging_stations": [
    {
      "id": "e69c3faf-c725-4de5-a170-a97d70b4d4e1",
      "operator_name": "IONITY",
      "station_name": "Froyennes Sud",
      "last_updated": "2019-05-10T00:00:54+02:00",
      "access_restriction": "PUBLIC",
      "opening_hours": [
        {
          "weekday": "1",
          "hour_begin": "00:00"
        },
        {
          "weekday": "7",
          "hour_end": "24:00"
        }
      ],
      "coordinates": {
        "lon": "3.341152",
        "lat": "50.619058"
      },
      "contact": {
        "operator_homepage": "https://payment.ionity.eu",
        "operator_customer_support": "+3228997267"
      },
      "address": {
        "locality": "Tournai",
        "postal_code": "7503",
        "language": "fr",
        "country": "BE",
        "street_name": "Q8 Froyennes Sud, E429"
      },
      "chargers": [
        {
          "id": "3dc83e88-a7dc-40ed-b255-8a7b7f541a9c",
          "label": "BE*ION*E404601",
          "connectors": [
            {
              "id": "70636804-11fd-43b9-9662-b4e96ce3b3c9",
              "dedicated_parking": true,
              "last_updated": "2019-05-10T00:00:54+02:00",
              "auth_types": [
                {
                  "auth_id": "12d954ed-dd03-4869-9305-cae862995f0b"
                }
              ],
              "connectors_status": {
                "status": "AVAILABLE"
              },
              "connector_type": "IEC-62196-T2-COMBO",
              "reservable": false,
              "available_power_kw": "350"
            }
          ]
        },
        {
          "id": "07530d62-e117-45aa-9b1a-a6d9c9689fbb",
          "label": "BE*ION*E404602",
          "connectors": [
            {
              "id": "3c9a2cff-6d91-4cb9-8549-9029b962f084",
              "dedicated_parking": true,
              "last_updated": "2019-05-10T00:00:54+02:00",
              "auth_types": [
                {
                  "auth_id": "12d954ed-dd03-4869-9305-cae862995f0b"
                }
              ],
              "connector_status": {
                "status": "AVAILABLE"
              },
              "connector_type": "IEC-62196-T2-COMBO",
              "reservable": false,
              "available_power_kw": "350"
            }
          ]
        },
        {
          "id": "648b0ad4-439d-4391-a3e1-28d88d545cda",
          "label": "BE*ION*E404603",
          "connectors": [
            {
              "id": "a7deb943-f9e2-45ce-bdd9-f7a3cc7c8233",
              "dedicated_parking": true,
              "last_updated": "2019-05-10T00:00:54+02:00",
              "auth_types": [
                {
                  "auth_id": "12d954ed-dd03-4869-9305-cae862995f0b"
                }
              ],
              "connector_status": {
                "status": "AVAILABLE"
              },
              "connector_type": "IEC-62196-T2-COMBO",
              "reservable": false,
              "available_power_kw": "350"
            }
          ]
        },
        {
          "id": "6316c564-2cea-4ac6-a098-65ddc1889d43",
          "label": "BE*ION*E404604",
          "connectors": [
            {
              "id": "90bb85a0-9ef3-476f-bb8e-8cd1ed9e7006",
              "dedicated_parking": true,
              "last_updated": "2019-05-10T00:00:54+02:00",
              "auth_types": [
                {
                  "auth_id": "12d954ed-dd03-4869-9305-cae862995f0b"
                }
              ],
              "connector_status": {
                "status": "FAULTED"
              },
              "connector_type": "IEC-62196-T2-COMBO",
              "reservable": false,
              "available_power_kw": "350"
            }
          ]
        }
      ]
    }
  ],
  "onsite_auth": [
    {
      "id": "12d954ed-dd03-4869-9305-cae862995f0b",
      "payment_required": true,
      "types": ["NFC_CARD", "APP", "QR_CODE"]
    }
  ]
}

Stations endpoint response with multi connector chargers:

{
  "charging_stations": [
    {
      "id": "3a6621c8-a95b-4f8d-aa44-a396405c045e",
      "operator_name": "IONITY",
      "station_name": "Angath Nord",
      "last_updated": "2019-05-11T00:00:54+02:00",
      "access_restriction": "PUBLIC",
      "opening_hours": [
        {
          "weekday": "1",
          "hour_begin": "00:00"
        },
        {
          "weekday": "7",
          "hour_end": "24:00"
        }
      ],
      "coordinates": {
        "longitude": "12.065526",
        "latitude": "47.519215"
      },
      "contact": {
        "operator_homepage": "https://payment.ionity.eu",
        "operator_customer_support": "+4313580560"
      },
      "address": {
        "locality": "Angath",
        "postal_code": "6321",
        "language": "de",
        "country": "AT",
        "street_name": "A12 Angath"
      },
      "chargers": [
        {
          "id": "e8509076-b12d-4283-b1d5-78c6850cb8f3",
          "label": "AT*ION*E208801",
          "connectors": [
            {
              "id": "4d1e21cc-1b12-4fac-9686-13a18dc8f405",
              "dedicated_parking": true,
              "last_updated": "2019-05-11T00:00:54+02:00",
              "auth_types": [
                {
                  "auth_id": "12d954ed-dd03-4869-9305-cae862995f0b"
                }
              ],
              "connector_status": {
                "status": "AVAILABLE"
              },
              "connector_type": "IEC-62196-T2-COMBO",
              "reservable": false,
              "available_power_kw": "350"
            }
          ]
        },
        {
          "id": "a8e4cd94-9b74-44f4-8e2c-f56f8e45ec01",
          "label": "AT*ION*E208803",
          "connectors": [
            {
              "id": "0c071bbf-ffe5-479b-8f36-a0d5c0041a3a",
              "dedicated_parking": true,
              "last_updated": "2019-05-11T00:00:54+02:00",
              "auth_types": [
                {
                  "auth_id": "12d954ed-dd03-4869-9305-cae862995f0b"
                }
              ],
              "connector_status": {
                "status": "AVAILABLE"
              },
              "connector_type": "IEC-62196-T2-COMBO",
              "reservable": false,
              "available_power_kw": "350"
            }
          ]
        },
        {
          "id": "c2014385-368e-4cea-9210-a95fe31bf017",
          "label": "AT*ION*E208804",
          "connectors": [
            {
              "id": "cad4f8c9-7816-4b79-81b0-044aa5bd1b9c",
              "dedicated_parking": true,
              "last_updated": "2019-05-11T00:00:54+02:00",
              "auth_types": [
                {
                  "auth_id": "12d954ed-dd03-4869-9305-cae862995f0b"
                }
              ],
              "connector_status": {
                "status": "AVAILABLE"
              },
              "connector_type": "IEC-62196-T2-COMBO",
              "reservable": false,
              "available_power_kw": "350"
            }
          ]
        },
        {
          "id": "d67a39e9-1876-4e7a-9cbe-3f6ede7e983b",
          "label": "AT*ION*E208802",
          "connectors": [
            {
              "id": "557d8ac5-6710-4ccd-9d79-c04ffd3eed20",
              "dedicated_parking": true,
              "last_updated": "2019-05-11T00:00:54+02:00",
              "auth_types": [
                {
                  "auth_id": "12d954ed-dd03-4869-9305-cae862995f0b"
                }
              ],
              "connector_status": {
                "status": "AVAILABLE"
              },
              "connector_type": "IEC-62196-T2-COMBO",
              "reservable": false,
              "available_power_kw": "350"
            }
          ]
        },
        {
          "id": "2e7b2cbe-20a8-42ed-a09b-205181930098",
          "label": "AT*ION*E208851 AT*ION*E208852 AT*ION*E208853",
          "connectors": [
            {
              "id": "bf080ca1-da6b-4cac-8647-0f130e1b2747",
              "dedicated_parking": true,
              "last_updated": "2019-05-11T00:00:54+02:00",
              "auth_types": [
                {
                  "auth_id": "12d954ed-dd03-4869-9305-cae862995f0b"
                }
              ],
              "connector_status": {
                "status": "AVAILABLE"
              },
              "connector_type": "IEC-62196-T2",
              "reservable": false,
              "available_power_kw": "44"
            },
            {
              "id": "23a6bc95-20f1-46bb-926f-4d9dcc44cb31",
              "dedicated_parking": true,
              "last_updated": "2019-05-11T00:00:54+02:00",
              "auth_types": [
                {
                  "auth_id": "12d954ed-dd03-4869-9305-cae862995f0b"
                }
              ],
              "connector_status": {
                "status": "AVAILABLE"
              },
              "connector_type": "Chademo",
              "reservable": false,
              "available_power_kw": "50"
            },
            {
              "id": "ea920db2-51c1-433e-953b-accba97d491c",
              "dedicated_parking": true,
              "last_updated": "2019-05-11T00:00:54+02:00",
              "auth_types": [
                {
                  "auth_id": "12d954ed-dd03-4869-9305-cae862995f0b"
                }
              ],
              "connector_status": {
                "status": "AVAILABLE"
              },
              "connector_type": "IEC-62196-T2-COMBO,
              "reservable": false,
              "available_power_kw": "50"
            }
          ]
        }
      ]
    }
  ],
  "onsite_auth": [
    {
      "id": "12d954ed-dd03-4869-9305-cae862995f0b",
      "payment_required": true,
      "types": ["NFC_CARD", "APP", "QR_CODE"]
    }
  ]
}

Connectors endpoint response

{
  "status": [
    {
      "charging_station_id": "e69c3faf-c725-4de5-a170-a97d70b4d4e1",
      "charger_id": "3dc83e88-a7dc-40ed-b255-8a7b7f541a9c",
      "connector_id": "70636804-11fd-43b9-9662-b4e96ce3b3c9",
      "connector_status": "AVAILABLE",
      "last_updated": "2019-05-10T10:38:41+02:00"
    }
  ]
}

Revision history

Version Date Changes

0.1

23.05.2019

First pilot draft

0.2

16.10.2019

Updated URI to the new domain name

0.3

08.02.2021

Added response compression for /stations endpoint

0.4

20.10.2023

Added DOMESTIC-E connector type and removed host field