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 Generation Mix API

Electricity generation mix data (beta)

Carbon Intensity API Generation Mix 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 Generation Mix. 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.

Generation Mix 2

Electricity generation mix data (beta)

GET
/generation
Get current national generation mix
getCurrentGeneration → 200400500
GET
/generation/{from}/{to}
Get national generation mix for a date/time range
getGenerationRange 2 params → 200400500

Schemas 5

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

GenerationMixItem
object
Generation percentage for a single fuel type
2 properties
GenerationPeriod
object
Generation mix data for a single half-hour period
3 properties
GenerationResponse
object
Response containing national generation mix data
1 property
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-generation-mix-api-openapi.yml Raw ↑

Other APIs Carbon Intensity API publishes across the network.

Carbon Intensity API Factors API
Carbon Intensity API National Intensity API
Carbon Intensity API Regional API
Carbon Intensity API Statistics API