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

# List all test cases

`GET /v1/test-cases/list`

List all test cases belonging to your organization.

    **Query Parameters:**
    - `category` (optional): Filter test cases by category ID

    **Returns:**
    - Array of test cases with their category and latest completed run
    - Empty object `{}` if no test cases found

    **Includes:**
    - Test case details (id, name, status)
    - Category information (if assigned)
    - Latest completed test run (if any)

## Query parameters

- `category` string, nullable

## Headers

- `x-api-key` string

## Response `200`

Successfully retrieved test cases

- union
  - object
  - TestCaseItem[]
    - `id` string, required — Test case ID
    - `name` string, required — Test case name
    - `status` string, required — Test case status
    - `category` CategoryReference — Reference to a category
      - `id` string, required — Category ID
      - `name` string, required — Category name
    - `latest_completed_run` TestRunItem — Test run information for latest completed run
      - `id` string, required — Test run ID
      - `link` string, required — URL to view test run details
      - `app` AppFileReference, required — Reference to an application file
        - `id` string, required — Application file ID
        - `app_name` string, required — Application name
      - `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-service-production.skmtc.workers.dev/v1/apis/qualgent/qualgent-api-service/revisions/2372ed4904a6/schema)