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

# Submit a results query

`PUT /results/{testid}`

Sends a ResultsQuery payload and returns a TimeSeries response.

## Request body

- ResultsQuery
  - `point_names` string[] — List of point names.
  - `start_time` number — Start time of the results query (epoch time).
  - `final_time` number — Final time of the results query (epoch time).

## Response `200`

Successful response with results 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/results/: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)
