For Signal Originators¶
Overview¶
A signal originator is an entity operating an automated system that submits real-time availability data for one or more hydrogen refuelling stations (HRS) to the H2-Stations platform. The platform uses these signals to compute per-fuelling-option availability statuses, which are displayed on the public H2-Stations Map.
Signals are sent via a REST API. Each signal covers one station at one point in time and reports the operational state of each fuelling option the station provides.
For the full field reference, request/response schemas, and interactive testing, see the H2-Stations Signal API documentation: v1.1 (current) and v1.
Getting Started¶
Becoming a signal originator requires a validation process involving the operators of the stations you intend to report on. Contact h2-stations@clean-hydrogen.europa.eu to start the onboarding process.
Organisations that want to try new features before they reach production and get involved in the development process can join the Insiders Program by contacting h2-stations@clean-hydrogen.europa.eu.
API v1.1¶
v1.1 is the current version of the Signal API. v1 keeps working unchanged and is deprecated (it receives no new features), so existing integrations need no changes. v1.1 adds:
- The 700 bar heavy-duty fuelling option, supported end to end across station data, the portal, the public map and the API.
- Light-duty and heavy-duty fuelling-option vocabulary (
700ld,350ld,700hd,350hd), which replaces the older identifiers. Send these identifiers in your signals when you report on v1.1. - A new
GET /import/v1.1/active-stationsendpoint listing the stations your token is authorised to report on, grouped intolive(your signals affect the published status) andtesting(signals are accepted but not published). Use it to confirm your token's scope and to check a station is live before relying on its status.
Browse the full v1.1 schema and try the endpoints at https://api.h2-stations.eu/import/v1.1/doc/.
If you report on a station that offers 700 bar heavy-duty refuelling, see Action Required for the steps to keep its status accurate.
Authentication¶
All requests require a Bearer token in the Authorization header:
Authorization: Bearer <your-token>
Tokens are issued by H2-Stations administrators as part of the onboarding process.
How Station Status Is Computed¶
The platform evaluates status per fuelling option. The following conditions are checked in order; the first one that applies sets the status for that fuelling option:
| Priority | Status | Condition |
|---|---|---|
| 1 | CLOSED | Station is outside its opening hours |
| 2 | UNKNOWN | No signal received in the last 30 minutes |
| 3 | UNAVAILABLE | The latest signal indicates the station is in maintenance |
| 4 | LIMITEDLY AVAILABLE | The latest signal indicates the station has limited availability |
| 5 | UNKNOWN | This fuelling option is absent from the latest signal |
| 6 | UNAVAILABLE | The latest signal reports this fuelling option as unavailable |
| 7 | AVAILABLE | The latest signal reports this fuelling option as available |
If none of these conditions applies, the previous status persists.
Recommendations¶
Send signals every minute, not only when the status changes. After 30 minutes without a signal, the platform sets all fuelling options to UNKNOWN regardless of their previous status.
Include every fuelling option in every signal. If a fuelling option is omitted from a signal, it is treated as condition 5 above and shown as UNKNOWN. Send all fuel types the station supports in each request, even if their status has not changed.
Contact¶
h2-stations@clean-hydrogen.europa.eu