---
title: "Retrieve the current status of the tests in your test suite"
method: POST
path: "/workspaces/{workspace_id}/reports/testSuiteStatus"
tags: ["Report"]
---

# Retrieve the current status of the tests in your test suite

`POST /workspaces/{workspace_id}/reports/testSuiteStatus`

Used to retrieve the current status of each test, pass rate, etc.

## Path parameters

- `workspace_id` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Request body

- TestSuiteFilterOptions
  - `application_ids` string[] — Application IDs to filter by
  - `environment_ids` string[] — Environment IDs to filter by
  - `triggering_resource_ids` string[] — Triggering resource IDs to filter by
  - `test_name` string — Test name to filter by (partial match)
  - `test_type` 'api' | 'browser' | 'performance' | 'mobile' — Type of test
  - `browser` string — The browser for the run
  - `execution_source` 'mabl_cloud' | 'external' | 'mabl_local' | 'mabl_agent' — Where the test lives
  - `mobile_platform` 'android' | 'ios' — The mobile platform associated with this object
  - `test_labels` string[] — Test labels to filter by
  - `plan_labels` string[] — Plan labels to filter by
  - `start_time` integer — The start time of the time period
  - `end_time` integer — The end time of the time period

## Response `200`

Current status of the test suite for the time range

- TestSuiteStatusResult
  - `test_status` TestStatus[] — Status of each test in the test suite
    - `workspace_id` string — The ID of the workspace
    - `test_id` string — The ID of the test
    - `test_name` string — The name of the test
    - `test_type` 'api' | 'browser' | 'performance' | 'mobile' — Type of test
    - `test_created_time` integer — The time the test was created
    - `test_updated_time` integer — The time the test was most recently updated
    - `current_pass_rate` number, double — The current pass rate for the test (percent)
    - `recent_run_id` string — The ID of the most recent test run
    - `recent_status` 'completed' | 'failed' | 'terminated' | 'no_status' — The most recent test run status
    - `recent_start_time` integer — The start time of the most recent run
    - `first_start_time` integer — The start time of the earliest run
    - `app_load_time_change` number, double — The relative change (percent) in cumulative speed index between the first and last half of the time range
    - `earliest_app_load_run_count` integer — The number of runs considered in app load time calculations from the first half of the specified date range
    - `latest_app_load_run_count` integer — The number of runs considered in app load time calculations from the second half of the specified date range
    - `response_time_change` number, double — The relative change (percent) in cumulative API response time between the first and last half of the time range
    - `earliest_response_time_run_count` integer — The number of runs considered in API response time time calculations from the first half of the specified date range
    - `latest_response_time_run_count` integer — The number of runs considered in API response time calculations from the second half of the specified date range
    - `app_load_time_ms` number, double — The average test app load time in milliseconds
    - `response_time_ms` number, double — The average test response time in milliseconds
    - `run_time_ms` number, double — The average test run time in milliseconds
    - `number_of_runs` integer — The number of test runs
  - `end_time` integer — The time at which the test statuses are current
  - `start_time` integer — The start of the timeframe for statuses like pass rate
  - `cursor` string — Cursor used for pagination

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `default` — Unexpected error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)