Carbon Intensity API^{Great Britain}

Introduction

This is the Official Carbon Intensity API for Great Britain developed by National Grid. You can find out more about carbon intensity at carbonintensity.org.uk.

documentation

---

API Quick Start

Base URL: api.carbonintensity.org.uk

JSON

Carbon Intensity - National

GET /intensity docs
gets current carbon intensity

GET /intensity/date docs
gets carbon intensity for today

GET /intensity/date/{date} docs
gets carbon intensity for specified date

GET /intensity/date/{date}/{period} docs
gets carbon intensity for specified date and settlement period

GET /intensity/factors docs
gets carbon intensity factors for fuel types

GET /intensity/{from} docs
gets carbon intensity for specified datetime

GET /intensity/{from}/fw24h docs
gets carbon intensity for 24h after specified datetime

GET /intensity/{from}/fw48h docs
gets carbon intensity for 48h after specified datetime

GET /intensity/{from}/pt24h docs
gets carbon intensity for 24h before specified datetime

GET /intensity/{from}/{to} docs
gets carbon intensity between specified datetimes

Statistics - National

GET /intensity/stats/{from}/{to} docs
gets carbon intensity statistics between specified datetimes

GET /intensity/stats/{from}/{to}/{block} docs
gets carbon intensity statistics in blocks between specified datetimes

Generation Mix - National^beta

GET /generation docs
gets current generation mix

GET /generation/{from}/pt24h docs
gets generation mix for 24h before specified datetime

GET /generation/{from}/{to} docs
gets generation mix between specified datetimes

Carbon Intensity - Regional^beta

GET /regional docs
gets current carbon intensity for GB regions

GET /regional/england docs
gets current carbon intensity for England

GET /regional/scotland docs
gets current carbon intensity for Scotland

GET /regional/wales docs
gets current carbon intensity for Wales

GET /regional/postcode/{postcode} docs
gets current carbon intensity for specified outward postcode

GET /regional/regionid/{regionid} docs
gets current carbon intensity for specified region

GET /regional/intensity/{from}/fw24h docs
gets carbon intensity for 24h after specified datetime for GB regions

GET /regional/intensity/{from}/fw24h/postcode/{postcode} docs
gets carbon intensity for 24h after specified datetime for specified outward postcode

GET /regional/intensity/{from}/fw24h/regionid/{regionid} docs
gets carbon intensity for 24h after specified datetime for specified region

GET /regional/intensity/{from}/fw48h docs
gets carbon intensity for 48h after specified datetime for GB regions

GET /regional/intensity/{from}/fw48h/postcode/{postcode} docs
gets carbon intensity for 48h after specified datetime for specified outward postcode

GET /regional/intensity/{from}/fw48h/regionid/{regionid} docs
gets carbon intensity for 48h after specified datetime for specified region

GET /regional/intensity/{from}/pt24h docs
gets carbon intensity for 24h before specified datetime for GB regions

GET /regional/intensity/{from}/pt24h/postcode/{postcode} docs
gets carbon intensity for 24h before specified datetime for specified outward postcode

GET /regional/intensity/{from}/pt24h/regionid/{regionid} docs
gets carbon intensity for 24h before specified datetime for specified region

GET /regional/intensity/{from}/{to} docs
gets carbon intensity between specified datetimes for GB regions

GET /regional/intensity/{from}/{to}/postcode/{postcode} docs
gets carbon intensity between specified datetimes for specified outward postcode

GET /regional/intensity/{from}/{to}/regionid/{regionid} docs
gets carbon intensity between specified datetimes for specified region

---

XML

Carbon Intensity - National

GET /xml/intensity
gets current carbon intensity

GET /xml/intensity/date
gets carbon intensity for today

GET /xml/intensity/date/{date}
gets carbon intensity for specified date

GET /xml/intensity/date/{date}/{period}
gets carbon intensity for specified date and settlement period

GET /xml/intensity/factors
gets carbon intensity factors for fuel types

GET /xml/intensity/{from}
gets carbon intensity for specified datetime

GET /xml/intensity/{from}/fw24h
gets carbon intensity for 24h after specified datetime

GET /xml/intensity/{from}/fw48h
gets carbon intensity for 48h after specified datetime

GET /xml/intensity/{from}/pt24h
gets carbon intensity for 24h before specified datetime

GET /xml/intensity/{from}/{to}
gets carbon intensity between specified datetimes

Statistics - National

GET /xml/intensity/stats/{from}/{to}
gets carbon intensity statistics between specified datetimes

GET /xml/intensity/stats/{from}/{to}/{block}
gets carbon intensity statistics in blocks between specified datetimes

Region IDs

1 North Scotland
2 South Scotland
3 North West England
4 North East England
5 South Yorkshire
6 North Wales, Merseyside and Cheshire
7 South Wales
8 West Midlands
9 East Midlands
10 East England
11 South West England
12 South England
13 London
14 South East England

15 England
16 Scotland
17 Wales

---

How do we calculate Carbon Intensity?

You can find out how we calculate both national and regional carbon intensity in our methodology papers.

Methodology: National Forecast or Regional Forecast

---

Further Information

Terms: API Terms of Use
Email: Alasdair Bruce or Lyndon Ruff
License: CC BY 4.0

---