API Reference

Complete endpoint reference.

Every endpoint, parameter, and response schema in the Derapi REST API. Base URL: https://api.getderapi.com/v1

Authentication

All requests require a Bearer token in the Authorization header.

Authorization: Bearer sk_sandbox_your_key_here

GET

/v1/ders/interconnect

Interconnect queue position, capacity headroom, and approval timeline by ZIP or utility ID. Parameters: zip, utility_id, asset_type.

GET

/v1/ders/interconnect/bulk

Bulk query for up to 500 ZIP codes per request. Returns paginated results with queue health scores.

GET

/v1/ders/capacity

Available grid capacity headroom at a candidate site. Parameters: zip, substation_id.

GET

/v1/ders/portfolio

Aggregate DER portfolio data for a FERC zone or utility territory. Returns count, capacity, asset type breakdown, and queue status.

GET

/v1/solar/irradiance

GHI, DNI, and DHI irradiance actuals and 7-day forecast. Parameters: lat, lon, zip.

GET

/v1/tariffs/nem

Net Energy Metering tariff status, compensation rates, and capacity limits by utility territory.

GET

/v1/grid/congestion

Real-time and forecast grid congestion signals by ZIP. Updated every 15 minutes.

GET

/v1/grid/load-forecast

Distributed load forecast incorporating DER contribution. 7-day horizon with 15-minute interval granularity.

GET

/v1/permits/ahj

AHJ permit requirements, fees, and submission checklists for solar/storage installations by county and city.

GET

/v1/permits/evse

EVSE installation permit requirements by jurisdiction — fees, inspection requirements, utility notification rules.

GET

/v1/ev/v2g-eligibility

Vehicle-to-grid (V2G) program eligibility, compensation rates, and enrollment process by utility territory.

POST

/v1/webhooks/queue-change

Subscribe to interconnect queue position changes for a set of territories. Callback fires within 15 minutes of a detected change.