Substation Capacity

API

Capacity records for nearby feeders and substations, ready for use in your own analysis workflow.

curl "https://utility-capacity.onrender.com/v1/substations/nearby?lat=42.6526&lng=-73.7562&radius_miles=1" -H "X-API-Key: YOUR_KEY"

# response
{
  "query": { "lat": 42.6526, "lng": -73.7562, "radius_miles": 1.0 },
  "count": 1,
  "results": [{
    "available_capacity_mw": 32.646626,
    "circuit_code": "NG_SUB_RIVERSIDE_TB_2",
    "utility_slug": "national_grid",
    "utility_name": "National Grid",
    "snapshot_date": "2026-04-01",
    "season": "summer",
    "distance_miles": 0.37,
    "capacity_metric_type": "electrification_headroom",
    "data_quality_tier": "A",
    "is_feeder_derived": false,
    "raw_context": { "raw_context_type": "national_grid", "headroom_mw": 32.6 }
  }]
}

Field guide

FieldMeaning
available_capacity_mwPublished or derived available capacity, where the source supplies an MW value.
capacity_metric_typeThe type of figure: load_serving_headroom, ev_hosting_capacity, electrification_headroom, not_capacity_data, or unconfirmed. Not every utility field is load-serving headroom.
is_feeder_derivedTrue when the substation value is a sum of feeder values.
raw_contextSource-specific context retained with the record.

Coverage and freshness

Sources are checked weekly. A source's own data can lag or stay unchanged.

Access

Send your key in the X-API-Key header. The limit is 60 requests per minute. The first request after idle can take 30 to 60 seconds. Request a key.