---
title: "List Market Regions"
method: GET
path: "/market-regions/"
tags: ["Forecasts"]
---

# List Market Regions

`GET /market-regions/`

## Request

- Base URL: `https://api.modoenergy.com/pub/v1/forecasts`
- URL: `https://api.modoenergy.com/pub/v1/forecasts/market-regions/`
- Auth: API key in header `X-token`

Returns the market regions available on the public API.

Use the `value` field to select a region when creating a run via `POST /runs/`. Config schemas at `GET /config-schemas/{market_region}/` are keyed by the GDM region name instead — list them via `GET /config-schemas/`.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Paginated list of market regions.

- PaginatedMarketRegionResponse
  - `count` integer: Total number of results.
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` MarketRegion[]
    - `label` string: Human-readable market region name.
    - `value` 'CAISO' | 'DE' | 'ERCOT' | 'ES' | 'GB' | 'ISONE' | 'IT' | 'MISO' | 'NEM' | 'NYISO' | 'PJM' | 'PL' | 'SPP': Market region identifier. Use this value for `simulation_config.market_region` in `POST /runs/` and `?market_region=` on `GET /runs/`.

## Other responses

- `401`: Missing or invalid X-token.

---

[API](https://skmtc.dev/modoenergy/apis/modo-energy-forecasts-api.md) - [All operations](https://skmtc.dev/modoenergy/apis/modo-energy-forecasts-api/llms.txt) - [OpenAPI document](https://skmtc.dev/modoenergy/apis/modo-energy-forecasts-api/revisions/24a95c4b710c?raw)