# India Power Generation API

> India power grid: generation by fuel every few minutes, demand met, state capacity and peak demand

- Vendor: `indiapowergenerationapi` · version 1.0 · category Energy · tags india electricity api, power generation api, india grid demand api, energy data api, installed capacity api, renewable generation api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/indiapowergenerationapi
- This document: https://apiclay.com/docs/indiapowergenerationapi.md
- OpenAPI 3.1: https://apiclay.com/api/indiapowergenerationapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `indiapowergenerationapi`
- Updated: 2026-11-18

## About

## India Power Generation API

The power data behind the Central Electricity Authority of India's site: all-India generation by fuel (thermal, gas, nuclear, hydro, solar, wind) and the demand met, at about two-minute steps for any day from the MERIT India feed; the latest monthly energy requirement and supply and the peak demand and peak met by state; installed capacity by state; the monthly power-sector performance (plant load factor, conventional and renewable generation and capacity added, transmission added); and CEA's notices.

Data comes from **cea.nic.in** (https://cea.nic.in). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/generation?date=2026-11-13` and `/demand?date=2026-11-13` for a day's curve, `/performance` for the monthly headline numbers, `/peak-demand` and `/energy-supply` by state.

### Routes

#### GET `/generation` - Generation by fuel
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| date | query | string | yes | Day, `YYYY-MM-DD`, e.g. `2026-11-13`. |

Returns: Array of points: `nameOfData` (`THERMAL GENERATION`, `GAS GENERATION`, `NUCLEAR GENERATION`, `HYDRO GENERATION`, `SOLAR GENERATION`, `WIND GENERATION`), `timeStamp` (UTC; the Indian day starts at 18:30 the day before), `valueOfData` (MW). About 700 points per fuel per day.

#### GET `/demand` - Demand met
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| date | query | string | yes | Day, `YYYY-MM-DD`. |

Returns: Array of `timeStamp` and `valueOfData` (all-India demand met, MW).

#### GET `/energy-supply` - Energy supply by state
No parameters.

Returns: `month`, `categories` (36 states and utilities), `series1Data` (energy requirement, MU) and `series2Data` (energy supplied, MU) in the same order.

#### GET `/peak-demand` - Peak demand by state
No parameters.

Returns: `month`, `categories`, `series1Data` (peak demand, MW) and `series2Data` (peak demand met, MW).

#### GET `/installed-capacity` - Installed capacity by state
No parameters.

Returns: `month`, `categories` (states) and `data` (installed capacity, MW).

#### GET `/performance` - Sector performance
No parameters.

Returns: Array of recent months: `year`, `monthName`, `allIndiaPlf` (%), `conventionalGeneration` and `renewableGeneration` (BU), `energySupplied`, `peakDemandMet` (GW), capacity added (MW), `transmissionLineAddition` (ckm).

#### GET `/notices` - Notices
No parameters.

Returns: Array of CEA notices: `titleEn`, `titleHi`, `category`, `createdAt`, `filePathEn`.

### Caveats

- Figures are CEA's provisional numbers and can be revised in the monthly reports. MERIT India values are instantaneous MW, not energy.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by cea.nic.in.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /generation — Generation by fuel
- Gateway: `GET https://api.apiclay.com/v1/api/indiapowergenerationapi/generation`
- Public query params: `date` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /demand — Demand met
- Gateway: `GET https://api.apiclay.com/v1/api/indiapowergenerationapi/demand`
- Public query params: `date` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /energy-supply — Energy supply by state
- Gateway: `GET https://api.apiclay.com/v1/api/indiapowergenerationapi/energy-supply`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /peak-demand — Peak demand by state
- Gateway: `GET https://api.apiclay.com/v1/api/indiapowergenerationapi/peak-demand`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /installed-capacity — Installed capacity by state
- Gateway: `GET https://api.apiclay.com/v1/api/indiapowergenerationapi/installed-capacity`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /performance — Sector performance
- Gateway: `GET https://api.apiclay.com/v1/api/indiapowergenerationapi/performance`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /notices — Notices
- Gateway: `GET https://api.apiclay.com/v1/api/indiapowergenerationapi/notices`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/indiapowergenerationapi/generation?date=<date>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
