---
title: "Get Forecast Run"
method: GET
path: "/runs/{id}/"
tags: ["Forecasts"]
---

# Get Forecast Run

`GET /runs/{id}/`

## Request

- Base URL: `https://api.modoenergy.com/pub/v1/forecasts`
- URL: `https://api.modoenergy.com/pub/v1/forecasts/runs/{id}/`
- Auth: API key in header `X-token`

Returns detail for a single forecast run.

Poll this endpoint until `status` is `ready_for_review`, then call `GET /runs/{id}/results/{resolution}/` to retrieve results.

## Path parameters

- `id` string, uuid, required

## Response `200`

Forecast run detail.

- ForecastRunDetail
  - `created_at` string, date-time: When the run was submitted.
  - `f_model_version_used` string: The fundamentals model version used to generate this run (e.g. Jan-26).
  - `id` string, uuid: Unique ID of the forecast run.
  - `market_region` 'CAISO' | 'DE' | 'ERCOT' | 'ES' | 'GB' | 'ISONE' | 'IT' | 'MISO' | 'NEM' | 'NYISO' | 'PJM' | 'PL' | 'SPP': Market region the run was submitted for.
  - `scenario` string: Scenario name (e.g. Central, High, Low, Backtest).
  - `simulation_config` object: The exact simulation_config payload submitted at run creation.
  - `status` 'draft' | 'processing' | 'ready_for_review' | 'failed': Current status of the run. Poll GET /runs/{id}/ until `ready_for_review`, then call GET /runs/{id}/results/{resolution}/ to retrieve results.

## Other responses

- `401`: Missing or invalid X-token.
- `404`: Run not found or does not belong to your company.

---

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