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

# Get Forecast Run Results

`GET /runs/{id}/results/{resolution}/`

Returns results for a completed forecast run at the requested resolution.

Results are returned in column-oriented format: each entry in `columns` has a `label`, a `display_label`, and a `data` array of length `periods`. Timestamps are implicit — derive them from `data_start`, the resolution, and the array index.

Use `?columns=` to request a subset of columns by label. Omit the parameter to return all available columns.

Returns 404 if the run has not yet completed. Poll `GET /runs/{id}/` until `status` is `ready_for_review` before calling this endpoint.

## Path parameters

- `id` string, uuid, required
- `resolution` 'monthly' | 'annual', required

## Query parameters

- `columns` string

## Response `200`

Results for the requested resolution.

- RunResults
  - `columns` ResultsColumn[] — Result columns. Each column covers all periods for this resolution.
    - `data` number[] — Ordered array of values, one per period from `data_start`. Length equals `periods` for every column in the response.
    - `display_label` string — Human-readable label suitable for chart axes and table headers (e.g. `Total Revenue (£)`).
    - `label` string — Machine-readable column identifier (e.g. `total_revenue`, `avg_cycles_per_day`).
  - `data_start` string — Start of the results data. `YYYY-MM` format for monthly (e.g. `2025-01`); `YYYY` format for annual (e.g. `2025`).
  - `periods` integer — Number of periods in the data. Equal to the length of every `data` array.
  - `resolution` 'monthly' | 'annual' — The resolution of the returned data, matching the path parameter.

## Other responses

- `400` — Unknown column label in `?columns`.
- `401` — Missing or invalid X-token.
- `404` — Run not found, results not yet available, or invalid resolution.

---

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