Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Carbon Intensity API Statistics API

Carbon intensity statistics and aggregations

Carbon Intensity API Statistics 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 Statistics. 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 2 operations across 2 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.

2 operations 2 paths 5 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0
Base URL
https://api.carbonintensity.org.uk
Terms of Service
Resource Areas
1

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

Statistics 2

Carbon intensity statistics and aggregations

GET
/intensity/stats/{from}/{to}
Get carbon intensity statistics for a date/time range
getIntensityStats 2 params → 200400500
GET
/intensity/stats/{from}/{to}/{block}
Get blocked carbon intensity statistics for a date/time range
getIntensityStatsBlocked 3 params → 200400500

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are IntensityStats (4 properties), IntensityStatsPeriod (3 properties), Error (2 properties), ErrorResponse (1 property). Each schema is shown below with its type and property counts.

IntensityStatsResponse
object
Response containing aggregated carbon intensity statistics
1 property
IntensityStatsPeriod
object
Carbon intensity statistics for a time period
3 properties
IntensityStats
object
Aggregated carbon intensity statistics
4 properties
ErrorResponse
object
Error response wrapper
1 property
Error
object
Error response
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

carbon-intensity-statistics-api-openapi.yml Raw ↑

Other APIs Carbon Intensity API publishes across the network.

Carbon Intensity API Factors API
Carbon Intensity API Generation Mix API
Carbon Intensity API National Intensity API
Carbon Intensity API Regional API