Skip to main content
GET
Permission Required: project:read-runs
Retrieve a paginated list of test plan executions for your project.

Query Parameters

test_plan_id
string
Filter by test plan ID
build_id
string
Filter by build ID
status
string
Filter by execution status: completed, in_progress, or queued
sort_by
string
default:"start_time"
Field to sort by: start_time, test_plan_name, or build_name
sort_order
string
default:"desc"
Sort direction: asc or desc
page
integer
default:"0"
Page number (0-indexed)
page_size
integer
default:"20"
Results per page (1-100)

Response

data
TestPlanExecutionSummary[]
required
Array of test plan execution summary objects
pagination
object
required
Pagination information

TestPlanExecutionSummary Object

id
string
required
Execution ID
test_plan_id
string
ID of the test plan that was executed
test_plan_name
string
Name of the test plan
build_id
string
ID of the build used
build_name
string
Name of the build used
status
string
required
Current execution status: completed, in_progress, or queued
started_at
string
ISO 8601 timestamp when the execution started
started_by
string
Who started the execution
completed_at
string
ISO 8601 timestamp when the execution completed
total_tests
integer
required
Total number of tests in this execution
test_status
object
required
Breakdown of test statuses
duration_ms
number
Total execution duration in milliseconds

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

test_plan_id
string<uuid>

Filter by test plan ID

build_id
string<uuid>

Filter by build ID

status
enum<string>

Filter by execution status

Available options:
completed,
in_progress,
queued
sort_by
enum<string>
default:start_time

Field to sort by

Available options:
start_time,
test_plan_name,
build_name
sort_order
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
page
integer
default:0

Page number (0-indexed)

page_size
integer
default:20

Results per page (1-100)

Required range: 1 <= x <= 100

Response

Successful response

data
object[]
pagination
object