---
title: "Get the most recent forecast"
method: GET
path: "/v3/forecast"
tags: ["GET Forecast"]
---

# Get the most recent forecast

`GET /v3/forecast`

Returns the most recently generated forecast for the specified `region` and `signal_type`. Forecasts are
generated periodically (e.g. at 5-minute frequency, this frequency is described in the `generated_at_period_seconds`
metadata), and there is a `data` list made up of `point_time` and `value` pairs in the forecast horizon (e.g. a
24-hr forecast horizon with 5-min frequency results in 288 values). Each forecast response is valid starting from its
`generated_at` time until it is superseded by a new forecast with a new `generated_at` time, and each `point_time`
in the `data` list is valid from its `point_time` for the duration described in `data_point_period_seconds`.

## Query parameters

- `region` string, required — Region abbreviation associated with location, from result of query to `/v3/region-from-loc`
- `signal_type` union, required — Use to select any available `signal_type` which is authorized for your account
  - 'co2_moer' | 'health_damage'
  - unknown
- `model` string, date, nullable — Use to return different models from defaults.
- `horizon_hours` integer — Length of forecast horizon in hours. Setting this parameter to `0` will return a single value of the most recently produced forecast

## Response `200`

Successful Response

- V3SingleForecastResponse
  - `data` BaseAPIV3ResponseFormat[], required
    - `point_time` string, date-time, required
    - `value` number, required
  - `meta` V3SingleForecastMetadata, required
    - `data_point_period_seconds` integer, required
    - `region` string, required
    - `signal_type` union, required
      - unknown
      - 'co2_moer' | 'health_damage'
    - `units` string, required
    - `warnings` WarningType[], required
      - `type` string, required
      - `message` string, required
    - `model` V3ModelMetadata
      - `date` string, date, required
      - `type` 'interchange' | 'average' | 'binned_regression' | 'heatrate' | 'proxy' | 'synthetic_proxy' | 'forecast'
    - `generated_at_period_seconds` integer, required
    - `generated_at` string, date-time, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `422` — Unprocessable Entity

---

[API](https://skmtc.dev/watttime/apis/watttime-data-api.md) · [All operations](https://skmtc.dev/watttime/apis/watttime-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/watttime/watttime-data-api/revisions/2c85341b2839/schema)