---
title: "Query the status, logs and results of one or more test sessions."
method: POST
path: "/tests/status"
tags: ["Test sessions"]
---

# Query the status, logs and results of one or more test sessions.

`POST /tests/status`

## Request body

- SessionStatusRequest — Query parameters and information options for the test sessions to lookup.
  - `session` string[], required — The session identifier(s) to look up.
  - `withLogs` boolean — Whether or not the log output for each session should be returned.
  - `withReports` boolean — Whether or not the XML test case report should be returned.

## Response `200`

Test sessions' status successfully returned.

- SessionStatusResponse — Response for the test session status operation.
  - `sessions` SessionStatus[], required — The list of status information for retrieved test sessions.
    - `session` string, required — The session's unique identifier.
    - `result` 'SUCCESS' | 'FAILURE' | 'UNDEFINED', required — The session's result.
    - `startTime` string, yyyy-MM-ddTHH:mm:ssZ, required — The session start time.
    - `endTime` string, yyyy-MM-ddTHH:mm:ssZ — The session end time (if the session is completed).
    - `message` string — The resulting output message of the session.
    - `logs` string[] — The list of log entries produced by the session.
    - `report` string — The test session's XML report.

## Other responses

- `429` — Call rate limit threshold exceeded for this operation.
- `default` — The received request was invalid.

## Changes

- **2026-03-19** `7637660a4a6b` — 1 info
  - added the non-success response with the status `429`
- **2024-08-26** `47017afa7060` — 1 info
  - removed the non-success response with the status `400`
- **2022-09-29** `544aabae878f` — 2 info
  - added the new optional request property `withReports`
  - added the optional property `sessions/items/report` to the response with the `200` status
- **2022-06-27** `06f633c06bcd` — 2 warning, 2 info
  - removed the request property `withReports`
  - removed the optional property `sessions/items/report` from the response with the `200` status
  - added the non-success response with the status `400`
  - removed the non-success response with the status `429`

[Change history](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api/changes/tests/status/post.md)

---

[API](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api.md) · [All operations](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ec-jrc/interoperability-test-bed-rest-api/revisions/433b3c0ae6d4/schema)