---
title: "Get test run detail"
method: GET
path: "/v2/test-runs/{testRunId}"
tags: ["Test Runs"]
---

# Get test run detail

`GET /v2/test-runs/{testRunId}`

## Request

- Base URL: `https://app.aiva.works` (the document declares no server; this is the origin it was published from)
- URL: `https://app.aiva.works/v2/test-runs/{testRunId}`
- Auth: API key in header `X-API-KEY`

Returns one test run with its executed steps. A module the test runs is reported as a single step.

## Path parameters

- `testRunId` string, guid, required

## Response `200`

Test run detail with executed steps

- TestRunDetail
  - `id` string, guid, required
  - `name` string, nullable
  - `status` 'Created' | 'Enqueued' | 'Starting' | 'Running' | 'Passed' | 'Failed' | 'Stopped' | 'FailedToStart' | 'Interrupted' | 'Invalid', required
  - `startTime` string, date-time, nullable
  - `stopTime` string, date-time, nullable
  - `failReason` string, nullable
  - `comment` string, nullable
  - `testId` string, guid, nullable
  - `version` integer, nullable
  - `gatewayId` string, guid, nullable
  - `videoUrl` string, nullable
  - `steps` TestRunStep[], required
    - `type` string, nullable
    - `targetElement` string, nullable
    - `targetScreen` string, nullable
    - `targetModule` string, nullable
    - `value` string, nullable
    - `status` 'Passed' | 'Failed' | 'Skipped', required
    - `failReason` string, nullable
    - `comment` string, nullable
    - `startTime` string, date-time, nullable
    - `stopTime` string, date-time, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: User does not have permission to access test runs
- `404`: Test run with given ID not found
- `500`: Server Error

---

[API](https://skmtc.dev/aiva/apis/aiva-cloud-api.md) · [All operations](https://skmtc.dev/aiva/apis/aiva-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aiva/apis/aiva-cloud-api/revisions/70eef14d3bcd?raw)