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

# Query results.

`PUT /results/{testid}`

Returns simulation data for the given point names over a time period.
Data for control input points will be the values used for simulation,
meaning embedded default control if not overwritten or user-specified
value if overwritten.

## Request body

- ResultsQuery
  - `point_names` string[] — List of point names.
  - `start_time` number — Start time of the results query (seconds since Jan 1st, 00:00:00).
  - `final_time` number — Final time of the results query (seconds since Jan 1st, 00:00:00).

## Response `200`

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