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

# Get Forecast Run

`GET /runs/{id}/`

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` 'GB' | 'ERCOT' | 'NEM' | 'DE' | 'ES' | 'CAISO' | 'NYISO' — 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.net/modoenergy/apis/modo-energy-api.md) · [All operations](https://skmtc.net/modoenergy/apis/modo-energy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modoenergy/modo-energy-api/revisions/6c4b83d3fc12/schema)