Carbon Intensity APIGreat Britain

Introduction

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


API Quick Start

Base URL: api.carbonintensity.org.uk

JSON

Carbon Intensity - National

GET /intensity
gets current carbon intensity


GET /intensity/date
gets carbon intensity for today


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


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


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


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


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


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


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


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


Statistics - National

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


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


Generation Mix - Nationalbeta

GET /generation
gets current generation mix


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


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


Carbon Intensity - Regionalbeta

GET /regional
gets current carbon intensity for GB regions


GET /regional/england
gets current carbon intensity for England


GET /regional/scotland
gets current carbon intensity for Scotland


GET /regional/wales
gets current carbon intensity for Wales


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


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


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


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


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


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


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


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


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


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


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


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


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


GET /regional/intensity/{from}/{to}/regionid/{regionid}
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: or


Further Information

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