Grid Headroom

Nearest substation capacity, one request away.

Unified demand and generation headroom for GB distribution networks: regional launch coverage UKPN and NGED. Indicative data, not a Point of Connection offer. From £99/mo when generally available.

Open API docs Billing portal (test)

No general purchase yet. Existing test subscribers can open the Customer Portal when the API is online.

example

Request

curl -sS \
  "https://api.gridheadroom.com/v1/substation/nearest?latitude=51.5074&longitude=-0.1278" \
  -H "Authorization: Bearer gh_test_…"

Response

{
  "status": "success",
  "meta": {
    "query_coordinates": {
      "latitude": 51.5074,
      "longitude": -0.1278
    },
    "result_count": 1,
    "execution_time_ms": 3.2
  },
  "data": [
    {
      "substation_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "dno_code": "UKPN",
      "substation_ref": "UKPN-LPN-0042",
      "name": "Example Primary",
      "voltage_kv": 33.0,
      "location": {
        "latitude": 51.5092,
        "longitude": -0.1255,
        "distance_meters": 420.0
      },
      "headroom": {
        "generation": {
          "availability": "PUBLISHED",
          "value": 2.4,
          "unit": "MW",
          "not_published_reason": null
        },
        "demand": {
          "availability": "PUBLISHED",
          "value": 8.1,
          "unit": "MVA",
          "not_published_reason": null
        },
        "fault_level": {
          "availability": "NOT_PUBLISHED",
          "value": null,
          "unit": null,
          "not_published_reason": "NOT_PUBLISHED_BY_DNO"
        },
        "calculation_method": "FIRM_DERIVED",
        "status": "AVAILABLE",
        "data_freshness": "2026-07-20",
        "source_dataset": "ukpn-primary-headroom",
        "source_last_refresh": "2026-05-01",
        "confidence": "HIGH"
      }
    }
  ],
  "provenance_and_attribution": {
    "data_source_attribution": "UK Power Networks data licensed under CC BY 4.0",
    "license_url": "https://creativecommons.org/licenses/by/4.0/",
    "disclaimer": "Informational metric only. Does not constitute a formal Point of Connection offer."
  }
}