For Data Users¶
Overview¶
The H2-Stations export API provides read-only access to European hydrogen refuelling station (HRS) data. It exposes:
- Static station data — location, operator, opening hours, fuel types, and more
- Real-time availability status — current availability per station and per fuelling option
- Events — ongoing and upcoming planned events affecting availability
- Photos — station images where available
The API powers applications such as map.h2-stations.eu and is suitable for building maps, dashboards, research tools, or any application that consumes HRS data.
Getting Started¶
Request an API token by writing to h2-stations@clean-hydrogen.europa.eu.
Once you have a token, explore the endpoints interactively at https://api.h2-stations.eu/v1/doc.
Authentication¶
All requests require a bearer token in the Authorization header:
Authorization: Bearer <your-token>
Tokens are issued by H2-Stations administrators. A missing or invalid token returns HTTP 401.
What You Can Query¶
| Endpoint group | Description |
|---|---|
GET /hrs |
List all registered HRS with full static details |
GET /hrs/{hrs_id} |
Retrieve a single station by its five-letter ID (e.g. ABCDE) |
GET /hrs/status |
Real-time availability status for all stations in one response |
GET /hrs/{hrs_id}/status |
Real-time availability status for a single station |
GET /hrs/{hrs_id}/events |
Ongoing and upcoming events for a station |
GET /hrs/{hrs_id}/photo |
Station photo (binary image, usually JPEG) |
GET /fuel-type |
List of fuelling options monitored by the system |
Static station data includes: name, address, geolocation, entrance geolocation, operator, owner, opening hours (OpenStreetMap format), site amenities, fuel types with dispenser count, capacity, access restrictions, payment and authorisation methods, and contact information.
Understanding Availability Statuses¶
Each fuelling option at a station has an independent status. The status field in /hrs/status and /hrs/{hrs_id}/status takes one of five values:
| Status | Meaning |
|---|---|
available |
The station is open and the fuelling option is available for refuelling. |
limitedly-available |
Refuelling is possible but subject to delays, restrictions, or on-site technician assistance. Check events for details, or contact the operator in advance. |
unavailable |
Refuelling is not possible. Check events for the reason and expected recovery time. |
closed |
Refuelling is not possible — the station is currently outside its opening hours. |
unknown |
The station is accessible, but the system has no current availability information for this fuelling option. |
The last_update_datetime field indicates when the status was last updated. Ongoing events (included in the status response) may provide additional context for limitedly-available or unavailable states.
Rate Limiting¶
Poll status endpoints at most once per minute. No hard rate limit is currently enforced, but this may change.