🇮🇳India•IEX/State-Wise Green DAM

State-Wise Green DAM — Annual Archive

Annual state-level renewable energy benchmarks and regional green settlement history.

Annual state-level green market overview across years.
⚡1 credit per requestMarket:IEX
GET/api/v1/iex/state-gdam/yearly/list/

Headers

Pass in HTTP request headers
X-API-Keystring (header)required
X-API-Key: YOUR_API_KEY

Developer API key starting with gm_live_. Passed in the X-API-Key HTTP header.

Security & Key Usage

API keys are secret credentials revealed only once upon creation in your dashboard. Store your key in an environment variable (e.g. GRIDMAP_API_KEY) on your server or device, and pass it in the x-api-key header with each request.

Acceptstring (header)optional
Accept: application/json

Expected response format.

Query Parameters (6)

Set optional filters below to customize the query
statestring (code)required

Two-letter Indian State / UT code (e.g. KA for Karnataka, MH for Maharashtra, GJ for Gujarat, RJ for Rajasthan, TN for Tamil Nadu). Query /api/v1/iex/meta/?section=states to see all 36 supported codes.

Accepted format: KATypical default: KA
yearinteger (YYYY)optional

Exact calendar year.

Accepted format: 2024Typical default: 2024
start_yearinteger (YYYY)optional

Start year (inclusive, earliest 2021).

Accepted format: 2021
end_yearinteger (YYYY)optional

End year (inclusive).

Accepted format: 2024
pageintegeroptional

Pagination page number.

Accepted format: 1Typical default: 1
page_sizeintegeroptional

Records per page (max 100).

Accepted format: 10Typical default: 10

Response Schema Attributes

FieldTypeDescription
yearintegerCalendar year.
stateobjectState identity containing { code: "KA", identity: "Karnataka" }.
cleared_buystring (decimal MW)Annual total cleared green buy volume in MW.
cleared_sellstring (decimal MW)Annual total cleared green sell volume in MW.
price_mwhstring (decimal INR)Annual arithmetic MCP in INR/MWh.
price_kwhstring (decimal INR)Annual arithmetic MCP in INR/kWh.
weighted_price_mwhstring (decimal INR)Annual volume-weighted average price in INR/MWh.
weighted_price_kwhstring (decimal INR)Annual volume-weighted average price in INR/kWh.

Error Responses & HTTP Status Codes

Full Error Spec
StatusTrigger / ReasonResponse Envelope Schema
400 Bad RequestHistorical plan limit exceeded / invalid date or filter format{"year": ["Your Free plan allows access..."]}
401 UnauthorizedMissing credentials / Invalid gm_live_ API key / Inactive hash{"detail": "Authentication credentials were not provided."}
403 ForbiddenExpired subscription plan / Cancelled subscription{"detail": "Your Developer plan expired on 2026-11-16. Pleas..."}
429 Too Many RequestsPer-minute burst limit or daily quota exceeded (Header: Retry-After){"detail": "Per-minute rate limit of 30 requests exceeded..."}
curl "http://52.66.240.39:8000/api/v1/iex/state-gdam/yearly/list/" \
  -H "Accept: application/json" \
  -H "x-api-key: YOUR_API_KEY"
{
  "total_credits": 100,
  "used_credits": 1,
  "remaining_credits": 99,
  "credit_used": 1,
  "data": {
    "count": 3,
    "next": null,
    "previous": null,
    "results": [
      {
        "year": 2024,
        "state": {
          "code": "KA",
          "identity": "Karnataka"
        },
        "cleared_buy": "11500000.00",
        "cleared_sell": "13400000.00",
        "price_mwh": "3940.00",
        "price_kwh": "3.94",
        "weighted_price_mwh": "3980.50",
        "weighted_price_kwh": "3.9805"
      }
    ]
  },
  "status": "success"
}