Carbon Intensity API National Intensity API is one of 5 APIs that Carbon Intensity API publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 4 JSON Schema definitions.
Tagged areas include National Intensity. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a GitHub repository, rate-limit docs, and 4 JSON Schemas.
This API exposes
9 operations
across 9 paths,
and defines 5 schemas.
It is described by OpenAPI 3.0.3, at version 2.0.
Requests are made against a single base URL, https://api.carbonintensity.org.uk.
9 operations9 paths5 schemas9 GET
Metadata
The identity and technical contract details declared by the specification.
Across 9 paths, the API surfaces 9 operations — 9 GET. Each is listed below with its method, path, parameters, and response codes.
National Intensity 9
National carbon intensity data for Great Britain
GET
/intensity
Get current national carbon intensity
getCurrentIntensity→ 200400500
GET
/intensity/date
Get national carbon intensity for today
getIntensityForToday→ 200400500
GET
/intensity/date/{date}
Get national carbon intensity for a specific date
getIntensityByDate1 param→ 200400500
GET
/intensity/date/{date}/{period}
Get national carbon intensity for a specific date and period
getIntensityByDateAndPeriod2 params→ 200400500
GET
/intensity/{from}
Get national carbon intensity from a specific datetime
getIntensityFrom1 param→ 200400500
GET
/intensity/{from}/fw24h
Get 24-hour forward forecast from a specific datetime
getIntensityForward24h1 param→ 200400500
GET
/intensity/{from}/fw48h
Get 48-hour forward forecast from a specific datetime
getIntensityForward48h1 param→ 200400500
GET
/intensity/{from}/pt24h
Get 24-hour historical data ending at a specific datetime
getIntensityPast24h1 param→ 200400500
GET
/intensity/{from}/{to}
Get national carbon intensity for a date/time range
getIntensityRange2 params→ 200400500
Schemas 5
The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are IntensityPeriod (3 properties), Intensity (3 properties), Error (2 properties), ErrorResponse (1 property). Each schema is shown below with its type and property counts.
Intensity
object
Carbon intensity measurements and forecast
3 properties
IntensityResponse
object
Response containing national carbon intensity data
1 property
ErrorResponse
object
Error response wrapper
1 property
IntensityPeriod
object
Carbon intensity data for a single half-hour period
3 properties
Error
object
Error response
2 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
