Reference

Changelog

What changed in the API, newest first.

Changes to the API contract, newest first. The contract itself is the OpenAPI document at /v1/openapi.json; the reference renders it.

Within v1, changes are additive: new routes, new optional parameters, new fields and new enum members. Clients should ignore fields they do not know and treat an enum member they do not know as unknown.
Nothing is removed or renamed within a version, and an error code never changes meaning.

v1 · Room bands on the map feeds

2026-10

/v1/assets.geojson and the asset vector tiles carry a room band per direction, gen and dem: 3 is 20 MW (or MVA) or more, 2 from 5 to 20, 1 under 5, 0 none, null when no servable figure exists. Read from current snapshot available figures of sources whose rights allow values; still bands, never values.
held: true on an asset whose only figures come from sources we may not serve yet, so a map can say “withheld” rather than “nothing published”.
/v1/assets.geojson takes source (a comma list of source ids), and the tiles carry operator_name.

2026-09

Capacity records with direction, technology, availability type, firmness, curtailment, horizon, scenario, season and variant as dimensions, and methodology, freshness, provenance, access and decision context on every value.
/v1/capacity/search and /v1/capacity/nearby, with the comparability modes strict, best_effort (the default) and raw, fresh_after and include_withheld.
Countries, operators, sources with their rights evidence and status, methodologies, substations and other grid assets, and the postcode lookup.
History as observation intervals, as_of and the change feed (Pro and above); exports and webhooks (Business and above).
Public, key-free /v1/coverage, /v1/assets.geojson and asset vector tiles, points only.
Rights enforced on every response, failing closed: values from sources whose licence does not permit redistribution are listed with access.status: "withheld" and value: null.