List test runs for a test plan
GET
/projects/{project_id}/test_plans/{test_plan_id}/test_runsBase URL
https://arcus.testsigma.com/api/v1Retrieves the test runs associated with a specific test plan.
Authenticate with your API key as a
Bearer token in the Authorization header. How to authenticate →Path parameters
project_id | Unique identifier of the project that contains the test plan. |
test_plan_id | Unique identifier or human-readable ID of the test plan whose test runs are listed. |
Query parameters
page_size | Number of test runs to return per page. Default 10. |
cursor | The page_info.next or page_info.prev value from a previous page. |
Response attributes
message | Status message for the request. |
data.test_runs[].id | Unique identifier of the test run. |
data.test_runs[].title | Title of the test run. |
data.test_runs[].human_id | Human-readable identifier of the test run. |
data.test_runs[].status | ACTIVE or CLOSED. |
data.test_runs[].selection_type | STATIC or DYNAMIC. |
data.test_runs[].dynamic_selection_filters | The filters that pick a DYNAMIC run's cases. Null for a STATIC run. |
data.test_runs[].dynamic_selection_excluded_test_case_ids | Cases a DYNAMIC run leaves out. Null when there are none. |
data.test_runs[].start_date | Start date as a Unix timestamp in milliseconds. Left out when not set. |
data.test_runs[].end_date | End date as a Unix timestamp in milliseconds. Left out when not set. |
data.test_runs[].closed_at | Unix timestamp, in milliseconds, of when the run was closed. Left out until then. |
data.test_runs[].closed_by | ID of the user who closed the run. Left out until then. |
data.test_runs[].assignee_id | ID of the assigned user. Empty when no one is assigned. |
data.test_runs[].project_id | Unique identifier of the project. |
data.test_runs[].labels | Label names on the test run. |
data.test_runs[].environments | Environment IDs of the test run. |
data.test_runs[].test_plan_id | Unique identifier of the test plan. |
data.test_runs[].automation_status | Automation status of an automated run. Left out otherwise. |
data.test_runs[].test_cases_count | Number of test cases in the run. |
data.test_runs[].created_at | Unix timestamp, in milliseconds, of when the test run was created. |
data.test_runs[].updated_at | Unix timestamp, in milliseconds, of the last update to the test run. |
page_info.page_size | Number of test runs on this page. |
page_info.total_count | Total number of test runs in the test plan. |
page_info.next | Cursor for the next page. Empty on the last page. |
page_info.prev | Cursor for the previous page. Empty on the first page. |
Request
curl -X GET \
'https://arcus.testsigma.com/api/v1/projects/{project_id}/test_plans/{test_plan_id}/test_runs' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json'const response = await fetch('https://arcus.testsigma.com/api/v1/projects/{project_id}/test_plans/{test_plan_id}/test_runs', {
method: 'GET',
headers: {
'Authorization': 'Bearer <API_KEY>',
'Content-Type': 'application/json'
}
});
const data = await response.json();import requests
response = requests.get(
'https://arcus.testsigma.com/api/v1/projects/{project_id}/test_plans/{test_plan_id}/test_runs',
headers={
'Authorization': 'Bearer <API_KEY>',
'Content-Type': 'application/json'
}
)
data = response.json()Response200 OK
{
"message": "List of test runs",
"data": {
"test_runs": [
{
"id": "8756d172-0c4f-4e37-9493-30a67d321863",
"title": "Regression - Chrome",
"human_id": "HCP-R-1",
"status": "ACTIVE",
"selection_type": "STATIC",
"dynamic_selection_filters": null,
"dynamic_selection_excluded_test_case_ids": null,
"start_date": 1710374400000,
"end_date": 1712966400000,
"assignee_id": "",
"project_id": "bd57bbc6-e83e-4f09-927d-fc48b3509cdf",
"created_at": 1710370000000,
"updated_at": 1710370000000,
"labels": [],
"environments": [],
"test_plan_id": "f2a8c1d4-9e63-4b27-8a51-7c0d6e9f3b42",
"test_cases_count": 42,
"test_run_status_summary": null
},
{
"id": "c0e4b9a1-2d76-4f53-91ac-5b8e3f6d20c7",
"title": "Regression - Safari",
"human_id": "HCP-R-2",
"status": "CLOSED",
"selection_type": "STATIC",
"dynamic_selection_filters": null,
"dynamic_selection_excluded_test_case_ids": null,
"start_date": 1710374400000,
"end_date": 1712966400000,
"assignee_id": "",
"project_id": "bd57bbc6-e83e-4f09-927d-fc48b3509cdf",
"created_at": 1710370100000,
"updated_at": 1710370100000,
"labels": [],
"environments": [],
"test_plan_id": "f2a8c1d4-9e63-4b27-8a51-7c0d6e9f3b42",
"test_cases_count": 42,
"test_run_status_summary": null
}
]
},
"page_info": {
"page_size": 2,
"total_count": 5,
"next": "W3siZmllbGQiOiJjcmVhdGVkX2F0IiwidmFsdWUiOjE3MTAzNzAxMDAwMDAsImRpcmVjdGlvbiI6IkRFU0MifV0=",
"prev": ""
}
}Was this page helpful?
Thanks for the feedback.