---
title: "List Run Date Ranges"
method: GET
path: "/date-ranges/"
tags: ["Forecasts"]
---

# List Run Date Ranges

`GET /date-ranges/`

## Request

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

Returns the date bounds a run must fall inside, per market region and run type.

Bound the dates in your `simulation_config` by the row matching your region and scenario — the `backtest` row when `scenario` is `Backtest`, the `forecast` row otherwise. `earliest_date` and `latest_date` are inclusive delivery days. Because `end_date` is exclusive, its largest accepted value is the day after `latest_date`. `POST /runs/` rejects a date range outside these bounds.

Rolling bounds move daily and any of them can change without an API release, so read this endpoint rather than hardcoding a window. A region with no row of a given `run_type` does not support that kind of run.

Filter with `?market_region=` (uppercase, e.g. `DE`) and `?run_type=` (lowercase).

## Query parameters

- `market_region` 'CAISO' | 'DE' | 'ERCOT' | 'ES' | 'GB' | 'ISONE' | 'IT' | 'MISO' | 'NEM' | 'NYISO' | 'PJM' | 'PL' | 'SPP'
- `run_type` 'forecast' | 'backtest'
- `limit` integer
- `offset` integer

## Response `200`

Paginated list of resolved run date ranges.

- PaginatedRunDateRangeResponse
  - `count` integer: Total number of results.
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` RunDateRange[]
    - `earliest_date` string, date: Earliest day a run of this type may start on, inclusive.
    - `latest_date` string, date: Latest day a run of this type may cover, inclusive.
    - `market_region` 'CAISO' | 'DE' | 'ERCOT' | 'ES' | 'GB' | 'ISONE' | 'IT' | 'MISO' | 'NEM' | 'NYISO' | 'PJM' | 'PL' | 'SPP'
    - `run_type` 'forecast' | 'backtest'

## 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)