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

# Get Forecast Run Results

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

## Request

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

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