API Reference · Enterprise · Distribution

Distribution Transformer Stress API

Dynamic hosting capacity for distribution transformers and feeders, fed by AMI smart-meter data and a physics-informed thermal model. Replaces static rules with 15-minute envelopes that respect actual loading.

Status: roadmap · ETA 2027 Q2

Awaiting SMNP rollout depth and DISCOM partnerships. DISCOM-partner sandbox available on request. Product overview. DISCOM partnership is a separate motion from the standard Enterprise flow — see CTA at the foot of the product page.

Overview

Five endpoints cover the LV decision surface. Static 10 kW solar rules are replaced with 15-minute envelopes that depend on AMI loading, ambient temperature, and the DT's own thermal mass.

Authentication

X-API-Key header. Tier varies — Enterprise for CPO and integrator seats; DISCOM-partner tier for white-label deployments under {discom}.dt.energymap.in subdomains. See energymap.in/pricing.

Data quality declared on every response

No silent extrapolation

Every response carries data_quality: "ami-direct" | "ami-imputed" | "modelled-only" and the AMI coverage percent for the underlying DT. Clients can hard-block on quality tiers when the workflow demands it (e.g. DISCOM sanctioning).

Tier	Means	Typical confidence
ami-direct	AMI smart-meter data covers ≥90% of the last 30 days for this DT.	0.85–0.95
ami-imputed	AMI data partial; gaps imputed from feeder-level patterns.	0.65–0.85
modelled-only	No AMI yet on this DT; thermal model + nameplate only.	0.40–0.65

POST /v1/dt/hosting-capacity

bash

curl -X POST https://api.energymap.in/v1/dt/hosting-capacity \
  -H 'X-API-Key: $KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "dt_id": "dt-BESCOM-29481",
    "additions": [
      { "type": "ev", "kw": 300, "schedule": "23:00-05:00" }
    ]
  }'

POST /v1/feeder/stress

Thermal and voltage stress probability for a feeder under a scenario.

POST /v1/ev/site-screen

Send coordinates, station kW, and dwell pattern. Receive ranked DT candidates with timing windows.

POST /v1/rooftop/sanction-check

Reverse-power-flow risk and recommendation: approve / approve-with-curtailment / decline / defer-to-DERMS.

GET /v1/dt/{id}/load-profile

15-min average load profile for the last 30 days, with AMI coverage flag.