API for developers
Last updated 23 September 2026.
Every published entry in the register is available over a read-only API. The free endpoints need no key and cover the public entry: what happened, the technology, the country, the year, the severity, the contributing factors, the lessons and the sources. The licensed endpoints add the full record behind each entry. Attribution is required on both.
Base address
https://energyincidentregister.com/api/v1
Responses are JSON. Every response carries an X-Attribution header, and is cached for ten minutes.
Free endpoints
| Call | Returns |
|---|---|
GET /api/v1/incidents | Published entries, up to 50 per call. |
GET /api/v1/incidents/EIR-0012 | One entry by its reference. |
GET /api/v1/stats | Totals: entries, countries, and counts by technology, severity, region and year. |
Filters
| Parameter | Example | Notes |
|---|---|---|
asset_type | bess | bess, solar_pv, wind_onshore, wind_offshore, grid_infrastructure, hybrid_colocated |
year | 2025 | The year the incident happened, not the year it was published. |
region | uk | uk, europe, north_america, apac, other |
severity | major | near_miss, minor, significant, major |
limit | 50 | Up to 50 free, up to 500 with a licence key. |
offset | 50 | Paging through results. |
Examples
GET https://energyincidentregister.com/api/v1/incidents?asset_type=solar_pv®ion=uk&limit=5 GET https://energyincidentregister.com/api/v1/incidents/EIR-0012 GET https://energyincidentregister.com/api/v1/stats
Each entry comes back with its reference, its page address on this site, and its source link, so anything you show can be checked.
Licensed endpoints
An Enterprise licence key unlocks the full record behind each entry and raises the limit to 500 records per call. Send the key in the x-api-key header.
GET https://energyincidentregister.com/api/v1/verified?limit=500&offset=0 GET https://energyincidentregister.com/api/v1/verified/EIR-0012
The full record adds the site, operator, owner, manufacturer, integrator and contractor where the sources name them, the capacity, the dates, the root cause, the part that failed, the response, injuries, downtime, loss and regulatory outcome where a public source states them, and every source used.
Rules
- Attribution. Wherever the data is shown, credit "Energy Incident Register" and link the entry. The reference, for example EIR-0012, identifies it.
- No republishing in bulk without a licence. The free API is for looking things up, not for copying the register.
- Corrections. If an entry is wrong, tell us and it is corrected free of charge, for anyone, with no conditions.
- Fair use. The free API is rate limited. If you need more, take a licence rather than working around it.
The full terms are in the data licence.
Prices
The free API costs nothing. Licensed access starts at £12,000 a year, and the tiers are set out on the Enterprise and API page. Data vendors and platforms that want to include the data in their own product need the Data partner tier.
Getting a key
Email info@energyincidentregister.com with your organisation, what you would use the data for, and how it would appear to your users. A sample extract and a short proposal come back within two working days.
What the API does not do
- It does not write: the register is read-only over the API. Incidents are submitted through the submission form.
- It does not carry the benchmarks, which are delivered as weekly files on the Enterprise tiers.
- It never exposes anything from a confidential submission beyond the anonymised public entry.