India Energy Atlas

Reference

Data API Catalogue

Live data warming29 cached datasets

Live catalogue warming

Showing the cached catalogue while live metadata refreshes

Search, filters, docs links and sample requests remain available from the last-known catalogue snapshot generated 9 May 2026, 5:55 am. Freshness values update automatically once the live catalogue endpoint responds.

Check live status

Endpoint groups

Browse catalogue namespaces

Each group shows the source domain, endpoint count and live-data posture before you open a row.

47 of 47 datasets

API namespace

Grid

Demand, frequency and transmission-system operating signals.

4 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

National grid frequency, recorded continuously. Useful for ancillary-services and balancing modelling.

/api/intelligence/grid-frequency
national4-minsince 1 Jan 202428 Apr 202615m
FreeDeveloperEnterprise
direct scrapePOSOCO + NLDC SCADA
Docs

Per-state grid frequency observations from individual SLDC scrapers.

/api/intelligence/grid-frequency?state=<state>
per_state5-minsince 1 Jan 202528 Apr 202631m
DeveloperEnterprise
direct scrapeState SLDCs (PSTCL, APTRANSCO, GUJSLDC, …)
Docs

Net interstate flow (MW), in-state generation, and demand for every state. Sourced from POSOCO NPP + SRLDC publications.

/api/developer/v1/state-interchange
per_state15-minsince 1 Jan 202428 Apr 202614m
DeveloperEnterprise
direct scrapePOSOCO NPP + RLDC publications
Docs

Available Transfer Capability (ATC) revisions on inter-regional corridors, parsed from Grid-India NLDC publications. Joinable with congestion blocks for attribution.

/api/intelligence/atc-revisions
per_corridorper_eventsince 1 Oct 202514 Apr 202613d
DeveloperEnterprise
direct scrapeGrid-India NLDC
Docs

API namespace

Demand

Historical, latest and forecast load series for national and state views.

5 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

Raw 15-min metered demand directly from each state's SLDC. Includes peak, frequency, and source-document provenance.

/api/v1/electricity-demand
per_state15-minsince 1 Jan 201428 Apr 202631m
FreeDeveloperEnterprise
direct scrapeState SLDCs + POSOCO
Docs

LightGBM-modelled state demand for slots/states where the official SLDC source was unavailable. Explicitly labelled `modelled` so production users can filter.

/api/intelligence/demand-timeseries?mode=modeled
per_state15-minsince 1 Jan 20242 May 2026-5764m
DeveloperEnterprise
modelledEnergymap modelled layer
Docs

4-minute national demand from POSOCO/MERIT. Highest-cadence national demand series available.

/api/intelligence/demand/national-4min
national4-minsince 1 Jan 2024
DeveloperEnterprise
direct scrapePOSOCO MERIT
Docs

LightGBM 24-hour demand forecast for every state, refreshed hourly. Versioned forecast log accumulates from 2026-04 onwards for backtest use.

/api/intelligence/demand-forecast
per_state + nationalHourlysince 1 Jan 20262 May 2026-5764m
DeveloperEnterprise
modelledEnergymap modelled layer
Docs

Every demand-forecast vintage as it was published. Use for honest backtests against true as-of forecasts (no look-ahead).

/api/intelligence/demand-forecast/versions
per_state + nationalHourlysince 22 Apr 2026
DeveloperEnterprise
modelledEnergymap modelled layer
Docs

API namespace

IEX

DAM, RTM, area MCP, congestion and exchange-clearing datasets.

5 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

Per-area DAM market clearing prices across the current IEX bid areas, joined to the national MCP so congestion divergence can be read directly.

/api/intelligence/iex-area-prices
per-area (13 zones)15-minsince 2 Mar 2025
DeveloperEnterprise
direct scrapeIEX area-price reports
Docs

Latest Day-Ahead Market blocks: MCP, MCV, purchase bids, and sell bids at 15-minute resolution. Use market_type=DAM on the public developer endpoint.

/developer/v1/market/iex/latest?market_type=DAM
national + per-area (13 zones)15-minsince 1 Jan 201428 Apr 2026-304m
FreeDeveloperEnterprise
direct scrapeIEX iexindia.com
Docs

Latest Real-Time Market blocks: MCP, MCV, purchase bids, and sell bids at 15-minute resolution. Use market_type=RTM on the public developer endpoint.

/developer/v1/market/iex/latest?market_type=RTM
national + per-area (13 zones)15-minsince 1 Jun 202028 Apr 202611m
FreeDeveloperEnterprise
direct scrapeIEX iexindia.com
Docs

Green DAM clearing prices, volumes, REC trades, and green premium analytics. This production route is currently served from the intelligence namespace.

/api/intelligence/iex-green-market
national15-minsince 1 Apr 202228 Apr 2026-304m
FreeDeveloperEnterprise
direct scrapeIEX iexindia.com
Docs

Bid-area buy/sell volumes are collected internally, but the public HTTP route advertised earlier is not mounted today. Request a sample or use the IEX market data routes while the v1 area-volume endpoint is being mounted.

not public-mounted yet
per-area (13 zones)15-minsince 1 Feb 2024
DeveloperEnterprise
direct scrapeIEX iexindia.com
Docs

API namespace

Market

Prices, spreads, open-access charges and commercial market context.

3 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

Per-state retail tariff structures from SERC orders.

/api/v1/electricity-tariffs
per_stateper_eventsince 1 Jan 2018
FreeDeveloperEnterprise
direct scrapeSERC tariff orders
Docs

Per-state open-access wheeling, transmission, and cross-subsidy surcharges. Critical for IEX bilateral cost-stack modelling.

/api/intelligence/open-access-charges
per_stateper_eventsince 1 Jan 2020
DeveloperEnterprise
derivedSERC tariff orders + Atlas curation
Docs

Tracked public investment announcements with state, sector, value, and timeline.

/api/v1/energy-investments
per_state + nationalper_eventsince 1 Jan 2020
FreeDeveloperEnterprise
direct scrapePublic announcements
Docs

API namespace

Generation

Fuel mix, plant output and source-level generation records.

3 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

4-minute fuel-wise generation (coal, gas, hydro, nuclear, renewables) for the national grid.

/api/intelligence/fuel-mix/national-4min
national4-minsince 1 Jan 202428 Apr 202626m
DeveloperEnterprise
direct scrapePOSOCO MERIT
Docs

Per-state fuel mix at hourly cadence. Constrained allocator (not LightGBM) — splits national fuel mix across states by installed-capacity weights anchored to state-level metered totals.

/api/intelligence/fuel-mix
per_stateHourlysince 1 Jun 202428 Apr 202626m
DeveloperEnterprise
modelledEnergymap modelled layer
Docs

Plant-level and state-level generation history from NPP + CEA publications.

/api/v1/generation-timeseries
per_state + nationalDailysince 1 Jan 201828 Apr 202645m
FreeDeveloperEnterprise
direct scrapeNPP + CEA
Docs

API namespace

Carbon

Carbon-intensity estimates, factors and fuel-linked emissions views.

2 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

Per-state hourly carbon intensity (gCO2/kWh) derived from fuel-mix and emission factors.

/api/intelligence/carbon-intensity
per_stateHourlysince 1 Jun 202428 Apr 202626m
FreeDeveloperEnterprise
derivedDerived (Energymap)
Docs

15-minute average and marginal carbon intensity for every state, with explicit signal-type discrimination, audit-ready source citations, and historical restatement versioning. Average for Scope 2 disclosure; marginal for load-shift dispatch — never mixed.

/v1/carbon-intensity/latest/{state}
per-state15-minsince 1 Jan 2024
Enterprise
derivedRLDC + NLDC + IEX + CEA
Docs

API namespace

Operations

Freshness, health, PSP and reliability signals for production monitoring.

2 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

5-year daily power supply position per state and region: peak demand, peak met, energy met, shortage. Sourced from POSOCO PSP PDFs.

/api/intelligence/posoco-psp
per_state + per_regionDailysince 1 Jan 201422 Apr 20265d
FreeDeveloperEnterprise
direct scrapePOSOCO daily PSP report
Docs

Daily CEA power supply position table.

/api/v1/power-supply-position
per_state + per_regionDailysince 1 Jan 201830 Nov 2025148d
FreeDeveloperEnterprise
direct scrapeCEA
Docs

API namespace

Assets

Plant registers, renewable capacity and infrastructure reference data.

4 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

Installed-capacity inventory of power plants across India with location, fuel, commissioning year, and operator.

/api/v1/power-plants
per_state + nationalper_eventsince 1 Jan 201028 Apr 202621m
FreeDeveloperEnterprise
direct scrapeNPP + CEA installed capacity
Docs

Tabular transmission-line inventory by state. Separate from the geospatial Atlas map tiles.

/api/v1/transmission-lines
per_state + nationalper_eventsince 1 Jan 201828 Apr 202621m
FreeDeveloperEnterprise
direct scrapeNPP + Atlas imports
Docs

Operational substations by state with kV class.

/api/v1/substations
per_stateper_eventsince 1 Jan 201828 Apr 202621m
FreeDeveloperEnterprise
direct scrapeNPP + Atlas imports
Docs

Tracked renewable project pipeline by state.

/api/v1/renewable-projects
per_stateper_eventsince 1 Jan 2020
FreeDeveloperEnterprise
direct scrapeTracked project datasets
Docs

API namespace

Weather

Weather-linked features used by forecasts and grid-demand models.

1 endpoint
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

Hourly temperature, humidity, precipitation across 11+ states. Critical exogenous feature for demand forecasts.

/api/intelligence/weather
per_stateHourlysince 1 Jan 20241 May 2026-5554m
DeveloperEnterprise
direct scrapeIMD + Open-Meteo
Docs

API namespace

Derived

Modelled or joined datasets produced from multiple upstream sources.

4 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

Derived stress score combining demand, generation headroom, and frequency deviation.

/api/v1/derived/grid-stress-index
national + per_stateDailysince 1 Jun 2024
DeveloperEnterprise
derivedDerived (Energymap)
Docs

State and regional renewable-constraint proxy combining generation, transmission capacity, and investment.

/api/v1/derived/renewable-bottleneck-score
per_state + per_regionDailysince 1 Jun 2024
DeveloperEnterprise
derivedDerived (Energymap)
Docs

Rollup index of investment momentum by state.

/api/v1/derived/energy-investment-index
per_stateDailysince 1 Jun 2024
DeveloperEnterprise
derivedDerived (Energymap)
Docs

MAPE between modelled state demand and official metered demand. Quality assurance for the modelled fill.

/api/intelligence/demand-reconciliation
per_stateDailysince 1 Jun 2024
DeveloperEnterprise
derivedDerived (Energymap)
Docs

On the roadmap

14 planned
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

High-Price DAM segment block-level prices and volumes. Currently only area-volumes are scraped; block-level MCP/MCV adds ~1 day of collector work.

/api/intelligence/iex/hp-dam
per-area15-minQ2 2026 — 1 week
DeveloperEnterprise
direct scrapeIEX iexindia.complanned

Term-Ahead Market trades — weekly/monthly contracts. Not yet ingested.

/api/intelligence/iex/tam
nationalper_eventQ3 2026
DeveloperEnterprise
direct scrapeIEX iexindia.complanned

Per-category GDAM split (solar, non-solar, hydro) — currently the IEIO collector persists only aggregate columns.

/api/intelligence/iex/gdam-categories
national15-minQ2 2026 — 2 days collector work
DeveloperEnterprise
direct scrapeIEX iexindia.complanned

Dense daily TTC and ATC values for every inter-regional corridor — backfilled from Grid-India daily PDFs.

/api/intelligence/ttc-atc
per_corridorDailyQ2 2026 — slug discovery in progress
DeveloperEnterprise
direct scrapeGrid-India daily VDI/TTC publicationsplanned

Plant-level forced and planned outages from Grid-India publications.

/api/intelligence/plant-outages
per_plantper_eventQ3 2026 — 8-12 weeks
DeveloperEnterprise
direct scrapeGrid-India outage noticesplanned

Forecast solar/wind generation per state with confidence intervals.

/api/intelligence/re-forecast
per_stateHourlyQ3 2026 — 6-10 weeks
DeveloperEnterprise
modelledEnergymap modelled layerplanned

Spinning, secondary, and tertiary reserves with deployment events.

/api/intelligence/reserves
national + per_region15-minQ3 2026 — 4-6 weeks
Enterprise
direct scrapePOSOCO ancillary publicationsplanned

Domestic coal price tracker and natural gas APM/HPHT prices. Useful for unit-commitment cost stacks.

/api/intelligence/fuel-proxies
nationalDailyQ2 2026 — 4-8 weeks
DeveloperEnterprise
direct scrapeMoP, MoPNG publicationsplanned

Landed ₹/kWh for any C&I consumer location, voltage class, contract demand, and load profile — across grid retail, Green Open Access, group captive, IEX RTM, and hybrid RE+BESS modes. Each response carries a confidence score, source citations to the underlying SERC tariff order, and a regulatory-risk delta since the last revision.

/v1/landed-cost/compare
all India (state + DISCOM)per-tariff-order2026-Q3
Enterprise
derived30 SERC tariff orders + IEX/PXIL clearing pricesplanned

Real-time substation headroom plus queue depth and forward congestion forecast at every ISTS and major InSTS substation in India. Cross-referenced to land availability, solar/wind resource, and district-level open-access economics. Built as a TSP-conformant reference implementation under the IES v0.5 substation data model.

/v1/substations/{id}/headroom
all India ISTS + major InSTSHourly2026-Q4
Enterprise
derivedCTUIL connectivity + RLDC outages + STU expansion plans + IES Substation TSPplanned

P50/P90 curtailment forecasts at substation or pooling-station resolution, plus a forward capture-rate metric — the India version of the cannibalisation curve standard in PJM and CAISO analytics. Methodology version published on every response.

/v1/curtailment/forecast/{node}
per-node (substation / pooling station)annual + hourly shape2026-Q4
Enterprise
derivedISTS/InSTS topology + RE queue + dispatch simulationplanned

Time-matched clean-power accounting engine. Send a 15-min load profile and a contracted RE generation profile, receive 24/7 match %, an unmatched-block ledger with carbon impact per block, and recommended load-shift windows. Audit-ready by design.

/v1/clean-power/hourly-match
per-consumer (any India location)15-min2026-Q4
Enterprise
derivedTime-Block Carbon Intensity backbone + client-supplied load and RE profilesplanned

Forward BESS revenue projection by location, duration, and market participation strategy. Probabilistic stack with hourly dispatch shape, expected price spreads, and confidence intervals. Optimal-duration analysis compares 1hr / 2hr / 4hr / 8hr sizing on the same node. Model version on every response.

/v1/storage/revenue-stack
per-nodeannual stack + 15-min dispatch2027-Q1
Enterprise
derivedIEX/PXIL 15-min history + transmission congestion + outage eventsplanned

Hosting Capacity Score for specific feeders or distribution transformers, fusing AMI smart-meter time-series, irradiance, EV load forecasts, and physics-informed thermal models of DT behaviour. Returns dynamic envelopes by 15-min block instead of static caps. Data-quality tier declared on every response.

/v1/dt/hosting-capacity
DISCOM-partner specific (per-DT)15-min2027-Q2
Enterprise
derivedAMI smart-meter time-series + irradiance + EV load forecasts + physics-informed DT thermal modelplanned

About this catalogue

Catalogue metadata and live coverage

The India Energy Atlas API powers every dataset on this page — covering all-India and state-level demand, fuel mix, frequency, IEX per-area MCP across all 13 zones, plant-level outages, ancillary reserves, and modelled fills with explicit provenance tags. Each row carries coverage windows, source provenance, freshness probes, and tier eligibility so you know exactly what you can serve into production.

Cached catalogue snapshot · Generated 9 May 2026, 5:55 am

Live datasets

29

4 in beta

Healthy now

16/29

under 2h lag

Median freshness

21m

p50 lag across live datasets

Deepest history

16+ yr

since 2010

Free

$0

Prototype, academic work, personal dashboards.

  • Unlimited alert rules
  • 3 notifications per day
  • Email + In-app channels
  • All 7 alert domains
  • 1,000 API calls/day · 5 days history · 2 days forecast
  • 15-min data delay
  • Community support
Most popular

Starter

$19/ month

Production apps and teams on all-India aggregates.

  • Everything in Free
  • Unlimited daily notifications
  • Priority delivery + WhatsApp alerts
  • 10,000 API calls/day at 60/min
  • Real-time data, 90 days history, 7 days forecast
  • 3 API keys + IP allow-list
  • Email support, 99.0% SLA

Pro

$3,000/ year

State-level analytics, forecasting, carbon-aware workflows.

  • Everything in Starter
  • State-level data access
  • Forecasts (carbon, forward curve) — unlimited horizon
  • 100,000 API calls/day at 300/min
  • Unlimited historical data
  • 10 API keys
  • Email + chat support, 99.5% SLA

Enterprise

CustomContact sales

Custom data delivery, signed SLAs, dedicated support.

  • Everything in Pro
  • Unlimited API quota
  • Custom endpoints & data delivery (Kafka, parquet)
  • Unlimited historical data
  • Dedicated Slack support
  • Signed 99.9% SLA

Next step

Build against the catalogue

Generate an API key, test endpoint behaviour in the interactive reference, or review how the current namespaces map to the versioned API.