Getting Started
What a key of each tier can call: requests per minute and per day, history depth, forecast look-ahead and state-level access. One base URL, one key format, no per-endpoint charges.
Every API key belongs to an India Energy Atlas plan. Plans and prices are on /pricing; this page lists the quotas each tier enforces.
| Sandbox | Student | Institutional | Pro | Starter | Growth | Enterprise | |
|---|---|---|---|---|---|---|---|
| Calls per minute | 3 | 10 | 30 | 10 | 60 | 300 | 600 |
| Calls per day | 100 | 100 | 5,000 | 100 | 10,000 | 100,000 | Unlimited |
| History depth | 7 days | 365 days | 365 days | 365 days | 365 days | Unlimited | Unlimited |
| Forecast look-ahead cap | 7 days | 7 days | 14 days | 7 days | 7 days | No plan cap | No plan cap |
| Rows per call | 50,000 | 50,000 | No plan cap | 50,000 | No plan cap | No plan cap | No plan cap |
| Rows per 30 days | 500,000 | 500,000 | No plan cap | 500,000 | No plan cap | No plan cap | No plan cap |
| State-level data | No | No | Yes | No | No | Yes | Yes |
| Freshness | Real-time | Real-time | Real-time | Real-time | Real-time | Real-time | Real-time |
| API keys per account | 5 | 5 | 5 | 5 | 5 | 5 | 5 |
State-level data is available to Institutional, Growth and Enterprise keys. Free tiers are licensed CC-BY 4.0: attribution is the only condition.
The forecast look-ahead cap limits how far ahead a key may ask the demand, carbon-intensity and IEX forward-curve forecasts. “No plan cap” means the plan adds no limit; it does not lengthen a forecast, and each one covers only the horizon it publishes. The IEX price forecast API (the D+1 to D+30 DAM outlook, and the G-DAM and RTM next-day curves) is a separate entitlement, for Growth and Enterprise keys: see the forecast endpoints.
Sandbox — prototype, learn the API, build personal dashboards. Free with any account.
Student and Pro — the Atlas Pro plan. Its key reads a year of history; Student is the same plan for verified Indian academic email addresses (.ac.in, .edu.in or a recognised institution).
Institutional — free for verified .gov.in, .nic.in and DISCOM teams, with state-level access.
Starter — production apps on all-India aggregates and market timing at national resolution.
Growth — state-level analytics, forecasting workflows and carbon-aware scheduling.
Enterprise — high-throughput pipelines and custom delivery.
Beyond the public tiers
Enterprise plans can include custom endpoints, bespoke historical extracts, private support channels and fixed-IP egress. Write to hello@energymap.in with a short description of your use case and expected request volume.