Curtailment & Capture-Rate Risk API

Overview

Five endpoints surface curtailment risk and capture-rate distributions at three resolutions — single node, portfolio, and region. methodology_version is on every response so a buyer can replay any past projection against any future model.

Authentication

X-API-Key header, Enterprise tier. See energymap.in/pricing.

GET /v1/curtailment/forecast/{node}

curl https://api.energymap.in/v1/curtailment/forecast/node-Bhadla-PS1 \
  -H 'X-API-Key: $KEY'

{
  "node": "node-Bhadla-PS1",
  "horizon_years": 5,
  "annual": [
    { "year": 2026, "curtailment_pct": { "p50": 0.04, "p90": 0.07 } },
    { "year": 2027, "curtailment_pct": { "p50": 0.06, "p90": 0.10 } },
    { "year": 2028, "curtailment_pct": { "p50": 0.11, "p90": 0.18 } }
  ],
  "drivers": ["transmission_bound", "ramp_bound"],
  "methodology_version": "ccr-v0.3",
  "trained_on_period": { "from": "2021-04-01", "to": "2026-03-31" }
}

POST /v1/capture-rate/forward

Capture-rate distribution by node, technology, and horizon, with explicit cannibalisation curve.

POST /v1/portfolio/cannibalisation

Portfolio-level cannibalisation curve across multiple assets. Returns the marginal incremental capacity that would tip same-region capture rates below a threshold.

GET /v1/dispatch/risk-screen/{region}

Near-term curtailment alerts for operating assets in a region. Refresh: 5-min.

POST /v1/bid/curtailment-adjusted-tariff

Send a tariff, technology, node, and horizon. Returns the curtailment-adjusted IRR and the implied tariff floor for credit committee.

Methodology versioning

Every response carries methodology_version. We publish the version-increment policy and the replay-against-old-version contract so a buyer can hold prior diligence to its original assumptions.