Get a test run

GET/projects/:project_id/test_runs/:test_run_id

Base URL https://test-management.testsigma.com/api/v1

Retrieves the details of a specific test run by its identifier.

Authenticate with your API key as a Bearer token in the Authorization header. Generate a key →

PATH PARAMETERS

`project_id`	Unique identifier of the project the test run belongs to.
`test_run_id`	Identifier of the test run to retrieve.

RESPONSE ATTRIBUTES

`message`	Status message for the request; may be empty.
`data.test_run.id`	Unique identifier of the test run.
`data.test_run.human_id`	Human-readable identifier for the test run.
`data.test_run.name`	Name of the test run.
`data.test_run.status`	Current status of the test run.
`data.test_run.created_at`	Unix timestamp of when the test run was created.
`data.test_run.updated_at`	Unix timestamp of the last update to the test run.
`data.test_run.results[].test_case_id`	Unique identifier of the test case in the result.
`data.test_run.results[].status`	Execution status of the individual test case.

REQUEST

curl -X GET \
  'https://test-management.testsigma.com/api/v1/projects/:project_id/test_runs/:test_run_id' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json'

const response = await fetch('https://test-management.testsigma.com/api/v1/projects/:project_id/test_runs/:test_run_id', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  }
});
const data = await response.json();

import requests

response = requests.get(
  'https://test-management.testsigma.com/api/v1/projects/:project_id/test_runs/:test_run_id',
  headers={
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  }
)
data = response.json()

RESPONSE200OK

{
  "message": "",
  "data": {
    "test_run": {
      "id": "7b2f9c14-58a1-4d2e-9f3a-6c1e8d40a2b9",
      "human_id": "DEMO-R-1",
      "name": "Regression suite — patient portal",
      "status": "IN_PROGRESS",
      "created_at": 1710675200,
      "updated_at": 1710761600,
      "results": [
        {
          "test_case_id": "9ac271b6-4e89-4c93-8c75-2d625efa0b2d",
          "status": "PASSED"
        },
        {
          "test_case_id": "1c4a6347-dec5-4f8e-8b6c-cda33c37c9ce",
          "status": "FAILED"
        }
      ]
    }
  }
}