---
title: "Query forecasts."
method: PUT
path: "/forecast/{testid}"
tags: ["Test Execution"]
---

# Query forecasts.

`PUT /forecast/{testid}`

Returns boundary condition forecasts from current time.

## 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 (seconds since Jan 1st, 00:00:00) and any number of series arrays keyed by signal name.
  - `status` integer

## Changes

- **2026-02-02** `352c81bcd71d` — 2 info
  - api tag `Test Execution` added
  - api tag `Test Simulation and Data` removed
- **2026-01-15** `cf045ca999f8` — 1 breaking
  - removed the required property `payload/time` from the response with the `200` status
- **2026-01-02** `e37b5217d73f` — 2 info
  - api tag `Test Simulation and Data` added
  - api tag `data` removed
- **2025-12-27** `9bb743194905` — 3 info
  - api tag `data` added
  - api tag `Test Execution` removed
  - added the required property `payload/time` to the response with the `200` status
- **2025-12-18** `e979b6db7bfd` — 1 info
  - added the required property `payload/time` to the response with the `200` status

[Full 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-service-production.skmtc.workers.dev/v1/apis/ibpsa/boptest-service-api/revisions/ecdfc7b011f7/schema)