> 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.

# Quickstart

## Prerequisites

* An ISOview account with an active subscription
* Your API key from the [ISOview Portal](https://isoview.io/portal/account?tab=api)

## 1. List available regions

First, discover what regions are available for demand:

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

```python
import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.isoview.io/v1"

response = requests.get(
    f"{BASE_URL}/region/ercot/demand/list",
    headers={"X-API-Key": API_KEY},
)
regions = response.json()
for r in regions:
    print(f"{r['id']}: {r['name']} ({r['region_type']})")
```

This returns region metadata for each region in the `ercot` ISO.

## 2. Get a forecast

Fetch the latest optimized demand forecast for `ercot_total`:

```bash
curl "https://api.isoview.io/v1/region/ercot/demand/forecast?id=ercot_total" \
  -H "X-API-Key: YOUR_API_KEY"
```

The response:

```json
{
  "model": "optimized",
  "created_at": "2026-03-17T06:00:00Z",
  "units": "MW",
  "timezone": "America/Chicago",
  "time_utc": ["2026-03-17T07:00:00Z", "2026-03-17T08:00:00Z", "..."],
  "time_local": ["2026-03-17T01:00:00-06:00", "2026-03-17T02:00:00-06:00", "..."],
  "columns": [["ercot_total"]],
  "values": [[45230.5, 44892.1, "..."]]
}
```

Omit the `id` parameter to get forecasts for **all** regions in a single response. The `columns` and `values` arrays will each contain one entry per region.

## 3. Compare models

Request a specific model to compare against ISOview's optimized forecast:

```bash
# ISO's own forecast
curl "https://api.isoview.io/v1/region/ercot/demand/forecast?id=ercot_total&model=iso" \
  -H "X-API-Key: YOUR_API_KEY"

# Climate normal baseline
curl "https://api.isoview.io/v1/region/ercot/demand/forecast?id=ercot_total&model=normal" \
  -H "X-API-Key: YOUR_API_KEY"
```

## 4. Get continuous forecasts

Continuous forecasts combine historical forecasts into a seamless time series with a specified forecast creation time.

```bash
curl "https://api.isoview.io/v1/region/ercot/demand/continuous?id=ercot_total&days_ahead=1&latest_hour=10" \
  -H "X-API-Key: YOUR_API_KEY"
```

## Next steps

* Browse the full [API Reference](/api-reference) for all available endpoints
* Learn more about [Models](/models) to understand model options and ensembles
* Understand [Responses](/responses) for more information about forecast data