---
title: "List test runs"
method: GET
path: "/v2/test-runs"
tags: ["Test Runs"]
---

# List test runs

`GET /v2/test-runs`

## 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`
- Auth: API key in header `X-API-KEY`

Lists test runs, newest first; runs that have not started yet come first. Recording and versioning runs are not listed.

## Query parameters

- `testRunIds` string[]
- `status` 'Created' | 'Enqueued' | 'Starting' | 'Running' | 'Passed' | 'Failed' | 'Stopped' | 'FailedToStart' | 'Interrupted' | 'Invalid'
- `testId` string, guid
- `batchExecutionId` string, guid
- `startedAfter` string, date-time
- `startedBefore` string, date-time
- `page` integer
- `pageSize` integer

## Response `200`

Array of test run summaries

- TestRunSummary[]
  - `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
  - `testId` string, guid, nullable
  - `version` integer, nullable
  - `failReason` string, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: User does not have permission to access test runs
- `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)