Upload Demand Data

Upload historical demand data for an existing forecast model.

Upload Demand Data

post

Authorizations

BearerAuth

AuthorizationstringRequired

Enter your PredictHQ API key. The Bearer prefix is added automatically.

When calling the API directly, send: 'Authorization: Bearer <YOUR_API_KEY>' as documented at https://docs.predicthq.com/api/overview/authenticating

Path parameters

model_idstringRequired

Header parameters

Content-Typestring · enumRequired

Content type of the uploaded payload.

Example: application/jsonPossible values:

Body

application/jsonapplication/x-ndjsontext/csv

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

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

HTTPcURLJavaScriptPython

POST /v1/forecasts/models/{model_id}/demand HTTP/1.1
Host: api.predicthq.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "demand": [
    {
      "date": "2025-12-15",
      "demand": 1
    }
  ]
}

application/jsonapplication/x-ndjsontext/csv

No content

OpenAPI Spec

The OpenAPI spec for Forecasts API can be found here.

Guides

• Getting Started with Forecasts API

• Understanding Forecast Accuracy Metrics

• Troubleshooting Guide for Forecasts API