> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.isoview.io/llms.txt.
> For full documentation content, see https://docs.isoview.io/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.isoview.io/_mcp/server.

# API Reference

The ISOview API is organized around five resource types, each providing forecast data at a different granularity.

**Base URL:** `https://api.isoview.io/v1`

## Authentication

All requests require an API key passed as the `X-API-Key` header or `api_key` query parameter. See the [Authentication guide](/authentication) for details on obtaining and managing your key.

```bash
curl "https://api.isoview.io/v1/region/pjm/demand/list" \
  -H "X-API-Key: YOUR_API_KEY"
```

## Endpoint groups

Forecasts and historical actuals for geographic areas within each ISO. Supports demand, wind, solar, outage, and population-weighted temperatures.

**Endpoints:** list, forecast, continuous, ensemble, actual, backcast, summary

**Metrics:** `demand`, `wind`, `solar`, `outage`, `poptemp`
**Access:** Core subscription. Backcast requires Enterprise.

Hourly generation forecasts for 2,000+ individual wind and solar facilities. Represents theoretical generation potential based on weather — does not account for curtailments, transmission constraints, or maintenance outages.

**Endpoints:** list, forecast, continuous, backcast

**Metrics:** `wind`, `solar`, `wind_icing`, `solar_snow`
**Access:** Advanced subscription. Backcast requires Enterprise.

Forecasts disaggregated to H3 hexagonal cells. Each cell includes a GeoJSON geometry clipped to the ISO boundary, with selectable H3 resolution (2–5).

**Endpoints:** list, forecast, continuous, backcast

**Metrics:** `demand`, `wind`, `solar`
**Access:** Advanced subscription. Backcast requires Enterprise.

Daily price forecasts for major U.S. gas trading hubs. Prices in \$/MMBtu. Incorporates weather-driven demand, storage levels, and market fundamentals.

**Endpoints:** list, forecast, continuous, backcast

**Access:** Core subscription. Backcast requires Enterprise.

Electricity price forecasts for select pricing nodes and hubs.

**Endpoints:** list, forecast, continuous

**Types:** `dalmp` (day-ahead), `rtlmp` (real-time)
**Access:** Core subscription.

## Versioning

The API is versioned using the `v1` prefix. The current version is `v1`. Backward incompatible changes will be indicated by a major version bump.