Skip to content
Docs
Arcus
Popular questions
↑↓ to navigate↵ to selectesc to close
Book a demo

List test runs for a test plan

GET/projects/{project_id}/test_plans/{test_plan_id}/test_runs
Base URL https://arcus.testsigma.com/api/v1

Retrieves 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 →
project_idUnique identifier of the project that contains the test plan.
test_plan_idUnique identifier or human-readable ID of the test plan whose test runs are listed.
page_sizeNumber of test runs to return per page. Default 10.
cursorThe page_info.next or page_info.prev value from a previous page.
messageStatus message for the request.
data.test_runs[].idUnique identifier of the test run.
data.test_runs[].titleTitle of the test run.
data.test_runs[].human_idHuman-readable identifier of the test run.
data.test_runs[].statusACTIVE or CLOSED.
data.test_runs[].selection_typeSTATIC or DYNAMIC.
data.test_runs[].dynamic_selection_filtersThe filters that pick a DYNAMIC run's cases. Null for a STATIC run.
data.test_runs[].dynamic_selection_excluded_test_case_idsCases a DYNAMIC run leaves out. Null when there are none.
data.test_runs[].start_dateStart date as a Unix timestamp in milliseconds. Left out when not set.
data.test_runs[].end_dateEnd date as a Unix timestamp in milliseconds. Left out when not set.
data.test_runs[].closed_atUnix timestamp, in milliseconds, of when the run was closed. Left out until then.
data.test_runs[].closed_byID of the user who closed the run. Left out until then.
data.test_runs[].assignee_idID of the assigned user. Empty when no one is assigned.
data.test_runs[].project_idUnique identifier of the project.
data.test_runs[].labelsLabel names on the test run.
data.test_runs[].environmentsEnvironment IDs of the test run.
data.test_runs[].test_plan_idUnique identifier of the test plan.
data.test_runs[].automation_statusAutomation status of an automated run. Left out otherwise.
data.test_runs[].test_cases_countNumber of test cases in the run.
data.test_runs[].created_atUnix timestamp, in milliseconds, of when the test run was created.
data.test_runs[].updated_atUnix timestamp, in milliseconds, of the last update to the test run.
page_info.page_sizeNumber of test runs on this page.
page_info.total_countTotal number of test runs in the test plan.
page_info.nextCursor for the next page. Empty on the last page.
page_info.prevCursor 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?