API Reference
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.
/developer/v1/grid/demand/latestMost recent all-India demand snapshot, updated every ~15 minutes as SLDCs publish.
curl -H "X-API-Key: $ATLAS_API_KEY" \
"https://api.energymap.in/developer/v1/grid/demand/latest"{
"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 }
]
}/developer/v1/grid/demand/historyHourly demand history. History window is tier-capped (Trial: 7d, Starter: 90d, Pro: 3y, Enterprise: 10y).
statestringmaharashtra). Omit for all-India series.hoursintegerdefault: 24{
"series": [
{ "ts": "2026-04-20T00:00:00Z", "demand_mw": 198320 },
{ "ts": "2026-04-20T01:00:00Z", "demand_mw": 192840 }
],
"resolution": "hour",
"count": 24
}/developer/v1/grid/demand/15minAny API keyOne state's continuous 15-minute demand. Each block is the best value available: the state's SLDC meter, then Vidyut PRAVAH, then an Atlas estimate filling the gap. kind is actual, estimate or missing on every block; a real reading replaces an estimate when it arrives, so pulling a window again returns more actuals. The window is capped by your plan's history.
statestringmaharashtra). Required.hoursintegerdefault: 24from / tostringkindstringdefault: allactual, estimate or missing, or a comma list. summary still counts the whole window.curl -H "X-API-Key: $ATLAS_API_KEY" \
"https://api.energymap.in/developer/v1/grid/demand/15min?state=maharashtra&hours=24&kind=actual"The body is the same as the public endpoint below, inside the { data, meta } envelope; meta.count is the number of blocks returned. Never treat an estimate block as a measurement: it names its method and, while a reading can still arrive, actual_expected_by.
/api/v1/states/{state}/demand-15minNo keyThe same 15-minute ledger for the last 1 to 48 hours, public and cached for 60 seconds. state accepts a slug, name or code. 404 for an unknown state, 503 while the ledger is unavailable.
hoursintegerdefault: 24curl "https://api.energymap.in/api/v1/states/maharashtra/demand-15min?hours=24"{
"state": "Maharashtra",
"state_slug": "maharashtra",
"state_code": "MH",
"block_minutes": 15,
"latest_block_utc": "2026-11-09T09:45:00+00:00",
"latest_actual_block_utc": "2026-11-09T09:30:00+00:00",
"summary": { "blocks": 96, "actual": 93, "estimate_pending": 3, "estimate_final": 0, "missing": 0, "actual_share": 0.9688 },
"blocks": [
{ "block_start_utc": "2026-11-09T09:30:00+00:00", "block_start_ist": "2026-11-09T15:00:00+05:30",
"demand_mw": 20123.4, "kind": "actual", "tier": "backup", "source": "vidyut_pravah" },
{ "block_start_utc": "2026-11-09T09:45:00+00:00", "block_start_ist": "2026-11-09T15:15:00+05:30",
"demand_mw": 19876.1, "kind": "estimate", "tier": "estimate", "source": null,
"method": "forward_v1", "final": false, "actual_expected_by": "2026-11-09T12:00:00+00:00" }
]
}/api/v1/states/coverage/demand-15minNo keyPer state over the trailing window: how many 15-minute blocks are actual, estimated (still awaiting a reading, or for good) and missing, with the measured share. Public, cached for 60 seconds.
hoursintegerdefault: 24curl "https://api.energymap.in/api/v1/states/coverage/demand-15min?hours=24"/developer/v1/grid/frequency/latestCurrent grid frequency in Hz plus a categorical band (normal / high / low). Useful for stability monitoring dashboards.
{
"as_of": "2026-04-20T14:30:00Z",
"frequency_hz": 50.02,
"band": "normal"
}