Skip to content
GridCapacityAPI.com

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 · The grid-capacity routes

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.