---
title: "List all test runs"
method: GET
path: "/v1/jobs/list"
tags: ["jobs"]
---

# List all test runs

`GET /v1/jobs/list`

## Request

- Base URL: `https://api.qualgent.ai`
- URL: `https://api.qualgent.ai/v1/jobs/list`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/qualgent/apis/qualgent-api-service/docs/v1/jobs/list/get.ts> (a function with typed inputs; its response is checked against the schema)

List all test runs (jobs) for your organization.

    **Returns:**
    - Array of test runs with status and execution details
    - Empty object `{}` if no test runs found

    **Includes:**
    - Test run status, priority, and progress
    - Associated test case and application file
    - Device and user execution details
    - Direct link to view test run

## Headers

- `x-api-key` string

## Response `200`

Successfully retrieved test runs

- union
  - object
  - TestRunStatusItem[]
    - `id` string, required: Test run ID
    - `link` string, required: URL to view test run details
    - `test_case` TestCaseReference, required: Reference to a test case
      - `id` string, required: Test case ID
      - `name` string, required: Test case name
    - `app` AppReference, required: Reference to an application file
      - `id` string, required: Application file ID
      - `name` string, required: Original filename
    - `status` string, required: Test run status
    - `priority` string, required: Test run priority
    - `progress` integer, nullable: Test run progress percentage
    - `executed_by` ExecutedByUser, required: User who executed the test run
      - `id` string, required: User ID
      - `name` string, required: User full name
      - `email` string, required: User email address
    - `device` string, nullable: Device name

## Other responses

- `401`: Invalid or missing API key
- `422`: Validation Error
- `500`: Internal server error

---

[API](https://skmtc.dev/qualgent/apis/qualgent-api-service.md) - [All operations](https://skmtc.dev/qualgent/apis/qualgent-api-service/llms.txt) - [OpenAPI document](https://skmtc.dev/qualgent/apis/qualgent-api-service/revisions/e04a6e95240e?raw)