---
title: "Submit a forecast query"
method: PUT
path: "/forecast/{testid}"
tags: ["data"]
---

# Submit a forecast query

`PUT /forecast/{testid}`

Sends a ForecastQuery payload and returns a TimeSeries response.

## Request body

- ForecastQuery
  - `point_names` string[] — List of point names.
  - `horizon` number — Forecast horizon in seconds.
  - `interval` number — Time interval between forecast points in seconds.

## Response `200`

Successful response with forecast time series.

- object
  - `message` string
  - `payload` TimeSeries — Time series response. Always includes a "time" array and any number of series arrays keyed by signal name.
    - `time` number[], required — Array of time points (epoch seconds).
  - `status` integer

## Changes

- **2025-12-18** `e979b6db7bfd` — 1 info
  - added the required property `payload/time` to the response with the `200` status
- **2025-11-18** `6f370686638c` — 1 info
  - api tag `data` added
- **2025-11-18** `60d61eda81c7` — 1 info
  - api tag `Test Execution` removed

[Change history](https://skmtc.dev/ibpsa/apis/boptest-service-api/changes/forecast/:testid/put.md)

---

[API](https://skmtc.dev/ibpsa/apis/boptest-service-api.md) · [All operations](https://skmtc.dev/ibpsa/apis/boptest-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ibpsa/apis/boptest-service-api/revisions/e979b6db7bfd?raw)