API Reference

Grid

All-India and state-wise grid telemetry: live demand, historical demand, and grid frequency. Sourced from State Load Despatch Centres (SLDCs) and POSOCO feeds.

State-level detail is included in every response from Pro onwards. On Trial and Starter, states is omitted and only national is returned.

GET/developer/v1/grid/demand/latest

Most recent all-India demand snapshot, updated every ~15 minutes as SLDCs publish.

bash

curl -H "X-API-Key: $ATLAS_API_KEY" \
  "https://api.energymap.in/developer/v1/grid/demand/latest"

json

{
  "as_of": "2026-04-20T14:30:00Z",
  "national": { "demand_mw": 218450, "frequency_hz": 50.02 },
  "states": [
    { "slug": "maharashtra", "demand_mw": 24810 },
    { "slug": "uttar-pradesh", "demand_mw": 21340 }
  ]
}

GET/developer/v1/grid/demand/history

Hourly demand history. History window is tier-capped (Trial: 7d, Starter: 90d, Pro: 3y, Enterprise: 10y).

Query parameters

statestring
State slug (e.g. maharashtra). Omit for all-India series.
hoursintegerdefault: 24
Lookback window in hours. Capped to your tier's max history.

json

{
  "series": [
    { "ts": "2026-04-20T00:00:00Z", "demand_mw": 198320 },
    { "ts": "2026-04-20T01:00:00Z", "demand_mw": 192840 }
  ],
  "resolution": "hour",
  "count": 24
}

GET/developer/v1/grid/frequency/latest

Current grid frequency in Hz plus a categorical band (normal / high / low). Useful for stability monitoring dashboards.

json

{
  "as_of": "2026-04-20T14:30:00Z",
  "frequency_hz": 50.02,
  "band": "normal"
}