Skip to content

Substation capacity API

Capacity per substation, from every publication that names it

Find substations by name, operator, voltage, area or distance, and read every capacity record their operators publish for them, with the asset's identifiers in each source, and its location at exactly the precision the operator gave.

API keys start with the Developer plan at €19.99 a month. Test calls from your dashboard before you choose.

One substation, several names, several files

A transmission operator and a distribution operator may both publish figures for the same site, under different names and codes. A heatmap names it one way, a queue register another. Joining them by hand means guessing, and a wrong join puts one site's headroom on another's map.

Every asset here has a stable id of our own and a list of its identities in each source, with how each was matched. Matches the resolver is unsure of go to a human; two assets on the same plot are marked related, not merged.

What an asset carries

  • Asset type (substation, node, busbar, feeder, transformer, congestion zone, connection point, grid cell or area), voltage and network level.
  • A location at the operator's precision (exact, approximate, obfuscated, municipality or region), never improved from another source.
  • Its identity in every source that names it, with the match method, and related assets on the same site.
  • A capacity summary: how many series, how many withheld, from which sources, and when they last changed.

Endpoints

MethodPathReturns
GET/v1/substationsSearch: country, operator, q, bbox, radius, voltage, has_capacity.
GET/v1/substations/{id}One asset: identities, related assets, summary.
GET/v1/substations/{id}/capacityIts current records, filterable by every dimension.
GET/v1/capacity/nearbyRecords around a point, sorted by distance.
GET/v1/assets.geojsonAsset points for a map, with room bands and no values. No key needed.

Example

Request

curl "https://api.gridcapacityapi.com/v1/substations?country=GB&voltage_min_kv=33&has_capacity=true&q=park" \  -H "Authorization: Bearer gc_live_..."

Voltage filters use the asset's published voltage. has_capacity keeps only assets with at least one capacity record, served or withheld.

Response shapeplaceholder values, not a capacity claim

{
  "data": [
    {
      "id": "sub_…",
      "type": "substation",
      "name": "…",
      "slug": "…",
      "country": "GB",
      "operator": {
        "id": "op_…",
        "slug": "…",
        "name": "…",
        "type": "DSO"
      },
      "network_level": "…",
      "voltage_kv": 33,
      "location": {
        "type": "Point",
        "coordinates": [
          0,
          0
        ],
        "precision": "exact"
      }
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null,
    "limit": 20
  },
  "meta": {
    "request_id": "req_…"
  }
}

Run it against the live API →

What the API holds today

Read from the API as this page renders. A source is listed with its rights status, because a listed source is not always a served one.

Countries the API serves
CountryStatusSources servedAssetsNewest operator date
United KingdomLive167,06214 Aug 2026
NetherlandsLive51,24830 Oct 2026
BelgiumLive41,13911 Nov 2026
FranceLive45,40621 Oct 2026
SpainLive816,49111 Nov 2026
PortugalLive246115 Oct 2026
GermanyLive1521 May 2026
AustriaLive25261 Oct 2026
DenmarkLive11601 Feb 2026
ItalyLive11101 Nov 2026
SwitzerlandLive1890not stated

What people build with it

Asset pages in your product

Link your own site records to a stable asset id and show its operators' figures beside them.

Radius screening

Every record within a radius of a candidate site, nearest first, in one call.

Maps

Plot asset points from the public GeoJSON and fetch values only for what the user clicks.

Questions

Why are some locations imprecise?
Some operators shift or withhold substation coordinates for public-safety reasons. We keep the precision they chose and say what it is; we never re-derive a location from another dataset.
Is OpenStreetMap geometry used?
Not for assets: its share-alike licence does not fit a commercial dataset. Base maps on this site use OpenStreetMap tiles, credited on the map.
Do asset ids ever change?
No. When two assets are found to be the same, the loser's id keeps resolving to the survivor.

Start building on grid-capacity data

Make test calls from your dashboard first. Keys come with a plan, from €19.99 a month.

Get API access