---
title: "List tests"
method: GET
path: "/api/tests"
tags: ["Tests"]
---

# List tests

`GET /api/tests`

List all tests in the current project with optional search and type filters.

## Query parameters

- `page` integer
- `limit` integer
- `includeScript` boolean
- `search` string
- `type` 'browser' | 'api' | 'performance' | 'database' | 'custom'

## Response `200`

Paginated list of tests

- object
  - `pagination` object
    - `total` integer
    - `page` integer
    - `limit` integer
    - `totalPages` integer
    - `hasNextPage` boolean
    - `hasPrevPage` boolean
  - `data` Test[]
    - `id` string, uuid
    - `name` string, nullable
    - `title` string
    - `description` string, nullable
    - `priority` 'low' | 'medium' | 'high' — Test priority
    - `type` 'browser' | 'api' | 'performance' | 'database' | 'custom' — Test type. `browser` = Playwright, `performance` = k6
    - `script` string, nullable — Test script content
    - `projectId` string, uuid, nullable
    - `organizationId` string, uuid, nullable
    - `tags` Tag[]
      - `id` string, uuid
      - `name` string
      - `color` string, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable

## Other responses

- `401` — Authentication required or token invalid

## Changes

> 4 revisions in range; 1 could not be searched.

- **2026-03-21** `40aeed2ccba7` — 3 breaking, 5 info
  - the response property `allOf[subschema #2]/data/items/createdAt` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/script` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/updatedAt` became nullable for the status `200`
  - added the new optional `query` request parameter `includeScript`
  - …4 more
- **2026-02-08** `78bbac89339b` — 5 warning
  - deleted the `query` request parameter `includeScript`
  - removed the optional property `allOf[subschema #2]/data/items/name` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/items/organizationId` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/items/projectId` from the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/supercheck-io/apis/supercheck-api/changes/api/tests/get.md)

---

[API](https://skmtc.dev/supercheck-io/apis/supercheck-api.md) · [All operations](https://skmtc.dev/supercheck-io/apis/supercheck-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supercheck-io/supercheck-api/revisions/81782deccf0e/schema)