List test entities

Headers

X-Api-Key

string

required

Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.

enum<string>

default:application/json

required

Specifies the expected response format. Must be set to application/json for proper API communication.

Available options:

application/json

Path Parameters

project_id

string

required

Id of the project. You can get project_id by listing your projects using the List projects API.

Example:

"pdqmxlz"

run_id

string

required

Id of the run. You can get run_id by listing runs using the List runs API.

Example:

"kftwnab"

Query Parameters

kind

enum<string>

default:spec

Kind of test entity to list. Defaults to spec.

Available options:

spec,

test

Example:

"spec"

status

enum<string>[]

Filter by status. Accepts one or more statuses as a comma-separated list.

Available options:

passed,

failed,

skipped,

interrupted,

timed_out,

flaky

Example:

["failed", "flaky"]

page_number

integer

default:1

Page of results to retrieve, starting from 1. Defaults to 1 when omitted.

Example:

1

page_size

integer

Number of records returned per page. Each endpoint applies its own default and maximum value.

Example:

15

Response

200 - application/json

OK - Request succeeded. Defaults to 25 test entities per page (maximum 100).

test_entities

object[]

Hide child attributes

test_entities.id

string

Unique identifier of the test entity.

Example:

"vhrscje"

test_entities.title

string

Title of the test entity. For specs this is the file name.

Example:

"cart.spec.ts"

test_entities.duration

number | null

Duration of the test entity in seconds.

Example:

12.83

test_entities.started_at

string<date-time> | null

Time at which the test entity started executing.

Example:

"2026-06-28T09:14:25.000Z"

test_entities.tests_count

integer

Number of tests under this entity.

Example:

6

test_entities.status

string

Aggregated status of the test entity.

Example:

"passed"

pagination

object

Hide child attributes

pagination.total_records

integer

Total number of records across all pages.

Example:

42

pagination.total_pages

integer

Total number of pages available.

Example:

3

pagination.current_page_number

integer

Current page number.

Example:

1

pagination.page_size

integer

Number of records per page.

Example:

15

Getting Started

Projects

Insights

Runs

Test Entities

Result Histories

Traces

Top Errors

Headers

Path Parameters

Query Parameters

Response