---
title: "Get Demand Data"
method: GET
path: "/v1/forecasts/models/{model_id}/demand"
tags: ["Demand Data"]
---

# Get Demand Data

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

Returns the demand data that has been uploaded to the model. Supports filtering by date range.

By setting the `Accept` header, you can specify the format of the response. The default is JSON.
Supported formats: `application/json`, `text/csv`, `application/x-ndjson`.

## Path parameters

- `model_id` string, required

## Query parameters

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

## Response `200`

Successful Response

- SearchDemandResponse
  - `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` PublicDemand[] — Array of demand data results for the current page.
    - `date` string, date, required — The date of the demand data point.
    - `demand` number, required — The demand value for the date.

## Other responses

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

---

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