Grid Headroom
Nearest substation capacity, one request away.
Unified demand and generation headroom across all six GB DNO groups, at uneven depth. Early access, not a full-UK coverage claim. Indicative planning data, not a Point of Connection offer. From £99/mo when generally available.
Request
curl -sS \
"https://api.gridheadroom.com/v1/substation/nearest?latitude=51.5074&longitude=-0.1278" \
-H "Authorization: Bearer gh_test_…"Response
{
"data": [
{
"substation_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"dno_code": "UKPN",
"substation_ref": "EXAMPLE-0001",
"name": "Example Primary",
"voltage_kv": 33.0,
"voltage_side": "UNSPECIFIED",
"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": "Example response. A real response carries the source network operator's own required attribution.",
"license_url": null,
"disclaimer": "Informational metric only. Does not constitute a formal Point of Connection offer."
}
}