This subscription is marked as deprecated and will be removed at the end of December 2021. After that date the subscription will no longer be available and unexpected behaviour may occur. See deprecations for more information.
Subscribe to station updates
If a route is calculated and it includes several stations, you might want to receive status updates from these stations. To prevent you from making too many requests, you can make use of the station updates
subscription. This service will let you know whenever a station's availability has changed or when a review was added.
Subscription
To use the subscription service you will need a station id
that can be obtained from queries like stations or route details.
Arguments
The station ID
Frequently used fields
Unique ID of a station
Name of a charging station
Street/block name and house number if available
Coordinates of a location
EVSEs that belong to a station
Information about an operator
Amenities located at this location
Other fields
Review of a station
ISO-3166 alpha-2 country code of a station
CPO ID of a CPO that 'owns' this station (following the ISO-15118 standard)
Defines if a location may be published on a website or app etc. When this is set to false, only tokens identified in the field: publish_allowed_to are allowed to show this location. When the same location has EVSEs that may be published and may not be published, two 'locations' should be created
City or town
Postal code of a location, may only be omitted when a location has no postal code: in some countries charging locations at highways don’t have postal codes.
State or province of a location, only to be used when relevant
ISO 3166-1 alpha-3 code for the country of this station
Geographical location of related points relevant to a user
Type of parking at a charge point location
Human-readable directions on how to reach a station
Information about a suboperator if applicable
Information about an owner if available
Facilities a charging station belongs to
Value from the IANA time zone database representing the time zone of a location. Examples: "Europe/Oslo", "Europe/Zurich". (http://www.iana.org/time-zones)
Times when an EVSEs at a location can be accessed for charging
Indicates if the EVSEs are still charging outside the opening hours. E.g. when a parking garage closes its barriers overnight, is it allowed to charge till the next morning? Default: true
Links to images related to a location such as photos or logos
Details of the energy supplied at a location
Timestamp when a location, or one of its EVSEs or Connectors were last updated (or created)
ID provided by a station data source
GeoJSON location of a charging station
Elevation (altitude) level
Groups of EVSEs by power and type
Enriched information about the physical address of a station
Optional object where you can store custom data you need in your application. This extends the current functionalities we offer
A flag that indicates if a station has real-time information about the availability of its connectors
A flag that indicates if a station is on private property
Connectors grouped by power
Station availability
Predicted station occupancy
Charging speed for a station
Global status for a station
Response
If successful, the HTTP status code in the response header is
200
and the response body contains the attributes you
requested.