List Forecast Runs

get

https://api.modoenergy.com/pub/v1/forecasts/runs/

Returns a paginated list of forecast runs for your company, ordered newest first by default.

Each item includes the original simulation_config submitted at creation. Use GET /runs/{id}/results/{resolution}/ to retrieve results for a completed run.

Filtering: combine any of the query parameters below — they are AND'd together. *__in parameters accept comma-separated values. Date filters accept any ISO 8601 datetime, e.g. 2026-01-01T00:00:00Z.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

created_at_after

date-time

Only return runs created at or after this ISO 8601 datetime.

created_at_before

date-time

Only return runs created at or before this ISO 8601 datetime.

status

string

enum

Filter to runs with this exact status.

Allowed:

status__in

string

Comma-separated list of statuses to include. Allowed values: draft, processing, ready_for_review, failed.

market_region

string

enum

Filter to runs in this market region.

Allowed:

market_region__in

string

Comma-separated list of market regions to include. Allowed values: GB, ERCOT, NEM, DE, ES, WECC, NYISO.

scenario

string

Filter to runs with this exact scenario name (e.g. Central, High, Low, Backtest).

scenario__in

string

Comma-separated list of scenarios to include (e.g. Central,High).

run_name

string

Case-insensitive substring match on run_name.

f_model_version_used

string

Filter to runs generated with this fundamentals model version (e.g. Jan-26). When this parameter is provided, runs without a recorded version are excluded; they remain visible in the unfiltered list.

f_model_version_used__in

string

Comma-separated list of fundamentals model versions to include (e.g. Jan-26,Feb-26).

ordering

string

enum

Sort order. created_at is oldest first; -created_at is newest first. Defaults to newest first.

Allowed:

limit

integer

≤ 100

Defaults to 50

Number of results per page.

offset

integer

Defaults to 0

Offset for pagination.

Responses

401

Missing or invalid X-token.

200Paginated list of forecast runs.