Quickstart

Prerequisites

• An ISOview account with an active subscription
• Your API key from the ISOview Portal

1. List available regions

First, discover what regions are available for demand:

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

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

2. Get a forecast

Fetch the latest optimized demand forecast for ercot_total:

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

The response:

1
{
2
  "model": "optimized",
3
  "created_at": "2026-03-17T06:00:00Z",
4
  "units": "MW",
5
  "timezone": "America/Chicago",
6
  "time_utc": ["2026-03-17T07:00:00Z", "2026-03-17T08:00:00Z", "..."],
7
  "time_local": ["2026-03-17T01:00:00-06:00", "2026-03-17T02:00:00-06:00", "..."],
8
  "columns": [["ercot_total"]],
9
  "values": [[45230.5, 44892.1, "..."]]
10
}

3. Compare models

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

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

$
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 for all available endpoints
• Learn more about Models to understand model options and ensembles
• Understand Responses for more information about forecast data