Quickstart

1. Get an API key

The fastest path is the Data API Catalogue: click Create API Key, drop in your email, and your free-tier key arrives in your inbox in under a minute. The same email also includes a one-tap link to set a password and (optionally) connect Google or LinkedIn for one-click sign-in.

Already signed in? Open Settings → API Keys, click Generate key, give it a name, and copy the secret shown once. You won't be able to see it again — store it in your secrets manager, CI vault, or a .env file that is not committed to git.

2. Make your first request

All endpoints live under https://api.energymap.in/developer/v1/. The grid/demand/latest endpoint is available on every tier and returns the most recent all-India and state-wise demand snapshot.

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

3. Inspect the response

Every successful response is JSON with an as_of timestamp (ISO 8601, UTC) indicating when the underlying source data was captured. For most endpoints that will be within the last 10–15 minutes.

{
  "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 },
    { "slug": "gujarat", "demand_mw": 18920 }
  ]
}

4. Check your quota

Every response carries your current quota state in the following headers. Use them to back off gracefully instead of waiting for a 429.

X-RateLimit-Limit-Minute: 60
X-RateLimit-Remaining-Minute: 58
X-RateLimit-Limit-Day: 10000
X-RateLimit-Remaining-Day: 9842
X-Tier: starter

Where to go next

1. Read Authentication to learn about IP allow-lists and key rotation.
2. Browse the interactive explorer to try every endpoint live from your browser.
3. See Carbon-aware scheduling for an end-to-end example that combines multiple endpoints.