---
title: "Retrieve test run summaries for a workspace"
method: POST
path: "/journeyRuns/workspace/{workspace_id}/querySummarys"
tags: ["TestRun"]
---

# Retrieve test run summaries for a workspace

`POST /journeyRuns/workspace/{workspace_id}/querySummarys`

Used to query test run summaries for a workspace

## Path parameters

- `workspace_id` string, required

## Request body

- TestRunSummaryFilterOptions — Filter options for querying testRunSummarys
  - `status` string[] — A test run status to filter by
  - `test_type` 'api' | 'browser' | 'performance' | 'mobile' — Type of test
  - `mobile_platform` 'android' | 'ios' — The mobile platform associated with this object
  - `application_ids` string[] — the application_ids to filter by
  - `triggering_resource_ids` string[] — the triggering_resource_ids to filter by
  - `triggering_resource_types` TriggeringResourceTypeEnum[] — The triggering_resource_types to filter by. Combine with triggering_resource_ids to scope the filter to a particular kind of resource — for example, type=user + id=<userId> to find runs a specific user triggered manually, since the same id slot is used for non-user resources under other types.
  - `environment_id` string — the environment_id to filter by
  - `journey_invariant_ids` string[] — the journey_invariant_ids to filter by
  - `plan_ids` string[] — the plan_ids to filter by
  - `failure_category_id` string — the failure_category_id to filter by
  - `browsers` string[] — the browser to filter by
  - `labels` string[] — the labels to filter by
  - `source_control_revision` string — the source_control_revision to filter by
  - `device_emulation_preset_types` string[] — the device preset types to filter by
  - `earliest_start_time` integer — the earliest start time[millis] to filter by, start_time >= earliest_start_time
  - `latest_start_time` integer — the latest start time[millis] to filter by, start_time <= latest_start_time
  - `execution_source` 'mabl_cloud' | 'external' | 'mabl_local' | 'mabl_agent' — Where the test lives
  - `exclude_default_tests` boolean — If true, exclude test runs from mabl-created (default) tests. Defaults to false (all tests included).
  - `limit` integer — The limit to use for pagination
  - `cursor` string — The offset to use for pagination

## Response `200`

Array of test scripts matching the query

- TestRunSummaryQueryResult — result envelope for test run status query results
  - `test_run_summarys` TestRunSummary[] — All test run status objects that matched the query
    - `application_id` string — the application id
    - `browser` string — runtime browser type
    - `browser_version` string — runtime browser version
    - `created_time` integer — the time the journeyRun object was created
    - `credentials_id` string — ID of the credential set used for this test run, if any.
    - `end_time` integer — the time the run ended
    - `environment_id` string — the environment id
    - `failure_category_id` string — the failure category id
    - `is_ad_hoc_run` boolean — true if the run was ad hoc
    - `test_type` 'api' | 'browser' | 'performance' | 'mobile' — Type of test
    - `test_name` string — the test name
    - `test_description` string — the test description
    - `test_is_default` boolean — the test was created by mabl
    - `journey_id` string — the test id
    - `journey_invariant_id` string — the test invariant id
    - `journey_run_id` string — the test run id
    - `labels` string[] — the test labels
    - `plan_id` string — the plan id
    - `plan_run_id` string — the plan run id
    - `source_control_revision` string — the source control revision
    - `start_time` integer — the time the run started
    - `status` string — the run's status
    - `trigger_type` string — the trigger type
    - `triggering_resource_id` string — the triggering resource id
    - `triggering_resource_type` string — the triggering resource type
    - `workspace_id` string — the workspace id
    - `execution_runner_version` string — the version of the runner the execution occurred on
    - `emulation_mode` string — desktop or mobile web emulation used for run
    - `device_emulation_id` string — device ID, if any, for an emulated device run
    - `device_emulation_preset_type` 'blackberry_playbook' | 'blackberry_z30' | 'galaxy_fold' | 'galaxy_note_3' | 'galaxy_note_ii' | 'galaxy_s5' | 'galaxy_s6' | 'galaxy_s8' | 'galaxy_s21' | 'galaxy_s22' | 'galaxy_s23' | 'galaxy_s_iii' | 'galaxy_tab_s7' | 'ipad' | 'ipad_air_2020' | 'ipad_mini' | 'ipad_mini_4' | 'ipad_pro' | 'ipad_ten_point_two' | 'iphone_11_pro_max' | 'iphone_11' | 'iphone_12' | 'iphone_12_pro_max' | 'iphone_13_mini' | 'iphone_13' | 'iphone_13_pro' | 'iphone_13_pro_max' | 'iphone_14' | 'iphone_14_pro' | 'iphone_14_plus' | 'iphone_14_pro_max' | 'iphone_15' | 'iphone_15_plus' | 'iphone_15_pro' | 'iphone_15_pro_max' | 'iphone_4' | 'iphone_5_se' | 'iphone_6_7_8' | 'iphone_6_7_8_plus' | 'iphone_x' | 'jiophone_2' | 'kindle_fire_hdx' | 'laptop_with_hidpi_screen' | 'laptop_with_mdpi_screen' | 'laptop_with_touch' | 'lg_optimus_l70' | 'microsoft_lumia_550' | 'microsoft_lumia_950' | 'moto_g4' | 'nexus_4' | 'nexus_5' | 'nexus_5x' | 'nexus_6' | 'nexus_6p' | 'nexus_7' | 'nexus_10' | 'nokia_lumia_520' | 'nokia_n9' | 'pixel_2' | 'pixel_2_xl' | 'pixel_6' | 'surface_duo' — device preset type, if any, for an emulated device run
    - `device_emulation_name` string — device name if an emulated device run
    - `device_emulation_orientation` 'portrait_primary' | 'portrait_secondary' | 'landscape_primary' | 'landscape_secondary' — orientation used if an emulated device run
    - `cumulative_speed_index` number, double — cumulative load time in millis for all the steps
    - `functionally_completed` boolean — test execution functionally completed
    - `api_concurrent_user_count` integer — performance tests only, concurrent api users
    - `api_average_response_time` integer — performance tests only, average api response time
    - `api_request_count` integer — performance tests only, count of all requests
    - `api_error_rate` number, double — performance tests only, api request error rate
    - `load_start_time` integer — performance tests only, start time of load
    - `load_ramp_up_end_time` integer — performance tests only, end of the ramp-up period
    - `load_end_time` integer — performance tests only, end time of load
    - `functional_test_run_count` integer — performance tests only, count of total functional test runs
    - `functional_failure_rate` number, double — performance tests only, percentage of functional test runs that failed
    - `mobile_platform` 'android' | 'ios' — The mobile platform associated with this object
    - `mobile_device_name` string — name of the device used for the mobile run
    - `mobile_os_version` string — OS version of the device used for the mobile run
    - `mobile_app_file_id` string — Mobile app file ID of the app used for the mobile run
    - `mobile_app_file_name` string — Name of the mobile app file (build) used for the mobile run, resolved from mobile_app_file_id, e.g. mabl-v1.2.3.apk
    - `mobile_app_file_version` string — Version of the mobile app file (build) used for the mobile run, resolved from mobile_app_file_id. Optional and unconstrained, so it may be absent or blank even when mobile_app_file_name is set.
    - `advanced_ai` boolean — This run includes the use of features in the advanced AI package
    - `step_features` string[] — Feature IDs for features used in this test run
    - `execution_source` 'mabl_cloud' | 'external' | 'mabl_local' | 'mabl_agent' — Where the test lives
    - `user_variables_json` string — JSON-serialized user variables including scenario information
    - `source_control_tag` string — the source control tag (branch name) associated with this test run
    - `failure_metadata` TestRunFailureSummary — Information useful for diagnosing test run failures
      - `flow_id` string — ID of the flow in which the failure occurred
      - `flow_name` string — Name of the flow in which the failure occurred, if any
      - `step_number` integer — Step number within the flow where the failure occurred
      - `step_id` string — ID of the step (with respect to the flow) where the failure occurred
      - `step_id_in_test` string — ID of the step (with respect to the test) where the failure occurred
      - `step_display_number` string — Display number of the failing step in nested dotted notation (e.g. "2.7" or "2.7.3"). Null when unavailable; only populated for runs executed after this field shipped (not present on backfilled historical runs).
      - `error` string — Unexpected error or formatted assertion failure that was recorded
      - `image_uri` string — URL of an image showing the error
      - `image_href` string — URL of an image showing the error
      - `image_artifact_url` string — API url of the image that will redirect to a newly signed image url
      - `assert_failure` AssertFailure — Details about assert failure
        - `reason` string — Assert failure description without expected/found values to eliminate the need for parsing downstream
        - `expected` string — Expected value where applicable
        - `found` string — Value actually found during test execution
  - `cursor` string — Cursor used for pagination

## Other responses

- `401` — User not authenticated
- `403` — User not authorized
- `default` — Unknown 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)
