List runs

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"

Query Parameters

branch

string

Filter runs by branch name.

Example:

"main"

status

enum<string>

Filter runs by status. Current status of the run.

Available options:

running,

passed,

failed,

passing,

failing,

timedOut,

interrupted

Example:

"passed"

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 15 runs per page (maximum 50).

runs

object[]

Hide child attributes

runs.id

string

Unique identifier of the run.

Example:

"kftwnab"

runs.commit_id

string

SHA of the commit the run was triggered for.

Example:

"9fceb02e1d2c4bb6a1f3f6b0c8e7d5a1b2c3d4e5"

runs.created_at

string<date-time>

Time at which the run was created.

Example:

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

runs.commit_name

string

Commit message associated with the run.

Example:

"Fix flaky checkout spec"

runs.status

enum<string>

Current status of the run.

Available options:

running,

passed,

failed,

passing,

failing,

timedOut,

interrupted

Example:

"passed"

runs.duration

number | null

Total duration of the run in seconds.

Example:

182.45

runs.ci_build_id

string

Identifier of the CI build that reported the run.

Example:

"gh-actions-4821"

runs.branch

string | null

Branch the run was executed on.

Example:

"main"

runs.author

string | null

Author of the commit.

Example:

"Oliver Smith"

runs.tags

string[]

Tags associated with the run.

Example:

["smoke", "nightly"]

runs.is_running

boolean

Whether the run is still in progress.

Example:

false

runs.run_statistics

object[]

Aggregated count of tests grouped by their status.

Hide child attributes

runs.run_statistics.name

string

Humanized status name.

Example:

"Passed"

runs.run_statistics.value

integer

Number of tests with this status.

Example:

38

Example:

[
  { "name": "Passed", "value": 38 },
  { "name": "Failed", "value": 2 },
  { "name": "Flaky", "value": 1 }
]

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