---
title: "Get Forecast"
method: GET
path: "/v1/forecasts/models/{model_id}/forecast"
tags: ["Forecasts"]
---

# Get Forecast

`GET /v1/forecasts/models/{model_id}/forecast`

Returns the generated forecast results for a trained model. Each result includes a date and predicted demand value. Supports filtering by date range.

## Path parameters

- `model_id` string, required

## Query parameters

- `date.gt` string, date
- `date.gte` string, date
- `date.lt` string, date
- `date.lte` string, date
- `include` string[]
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- SearchModelForecastResponse
  - `errors` string[] — List of error messages, if any.
  - `warnings` string[] — List of warning messages, if any.
  - `count` integer, required — Total number of results matching the query.
  - `next` string, nullable — URL for the next page of results. Null if no more results.
  - `previous` string, nullable — URL for the previous page of results. Null if on the first page.
  - `results` PublicForecast[] — Array of forecast results for the current page.
    - `date` string, date, required — The date of the forecast value.
    - `forecast` number, required — The predicted demand value for the date.
    - `phq_explainability` PhqExplainability — List of the top events impacting demand on each date. Use this to help understand the context of how and why events are impacting your demand.
      - `events` Event[] — List of events impacting demand on the associated date, ordered by impact.
        - `id` string, required — Unique identifier of the event.
        - `category` string, required — Category classification of the event (e.g. `conferences`, `sports`, `concerts`).
        - `title` string, required — Display name of the event as it appears in the PredictHQ event catalog.
        - `start_local` string, date-time, required — Start date and time of the event in local time.
        - `end_local` string, date-time, required — End date and time of the event in local time.
        - `phq_rank` integer — PHQ Rank score from 0–100 indicating the predicted attendance impact of the event.
        - `local_rank` integer, nullable — Local Rank score from 0–100 indicating relative local significance. Null for non-attended events.
    - `phq_features` Feature[] — List of the features (from our Features API) that were shown to have an impact on the demand. These features were used in training the model and for forecasting.
      - `name` string, required — Name of the demand intelligence feature.
      - `value` number, required — Numeric value of the feature's contribution to the forecast.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.dev/predicthq/apis/predicthq-events-api.md) · [All operations](https://skmtc.dev/predicthq/apis/predicthq-events-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/predicthq/predicthq-events-api/revisions/66cd8ff349dd/schema)