Skip to main content
GET
Authentication: Any authenticated API key
Retrieve a paginated list of test cases for your project, optionally filtered to a single folder. The response is intentionally lean so it can be used for scanning or building selectors — fetch Get Test for the full body of a specific test.
When neither folder_path nor folder_id is supplied, every test in the project is returned (including tests in nested folders). Specifying a folder returns only the tests directly inside that folder — recursion is not performed.

Query Parameters

folder_path
string
Folder path (e.g. "regression/smoke"). "/" or omitting the field means root. Mutually exclusive with folder_id — supplying both returns 400.
folder_id
string
Pre-resolved folder UUID. Mutually exclusive with folder_path.
page
integer
default:"0"
Page number (0-indexed)
page_size
integer
default:"25"
Results per page (1-100)

Response

data
TestSummary[]
required
Array of test summary objects
pagination
object
required
Pagination metadata (page, page_size, total_count, total_pages)

TestSummary Object

id
string
required
Unique identifier for the test (UUID)
name
string
required
Test name
type
string
required
Test kind: verification, discovery, or task
folder_id
string
Folder UUID, or null if the test is at the project root
folder_path
string
required
Resolved folder path string (e.g. "regression/smoke"). "/" if at root.

Authorizations

X-Api-Key
string
header
required

API key for authentication

Path Parameters

projectId
string
required

The project ID. You can copy it from the project settings page or the project URL in the dashboard.

Query Parameters

folder_path
string

Folder path filter (mutually exclusive with folder_id). "/" or omitted means root.

folder_id
string<uuid>

Folder UUID filter (mutually exclusive with folder_path)

page
integer
default:0

Page number (0-indexed)

page_size
integer
default:25

Results per page (1-100)

Required range: 1 <= x <= 100

Response

Successful response

data
object[]
pagination
object