---
title: "List runs"
method: GET
path: "/v1/runs"
tags: ["Analytics"]
---

# List runs

`GET /v1/runs`

List completed runs with filters and pagination.

## Query parameters

- `pageSize` integer
- `cursor` string
- `includeTotal` boolean
- `startDate` string, date-time
- `endDate` string, date-time
- `status` string[]
- `trigger` string[]
- `gitBranchName` string[]
- `githubRepository` string[]
- `gitlabProjectPath` string[]
- `gitCommitSha` string
- `cliVersion` string[]
- `label` string[]
- `environment` string[]
- `executionType` string[]
- `testId` string[]
- `testNameContains` string
- `directory` string[]
- `quarantined` boolean
- `recovered` boolean
- `healed` boolean
- `onlyCIRuns` boolean

## Response `200`

Success.

- ExternalRunsResponse
  - `data` object[], required
    - `id` string, required
    - `status` 'PASSED' | 'FAILED' | 'CANCELLED', required
    - `trigger` 'WEBHOOK' | 'CRON' | 'MANUAL' | 'CLI', required
    - `executionType` union, required
      - 'WEB'
      - 'ANDROID' | 'IOS'
    - `testId` string, required
    - `testName` string, required
    - `description` string, nullable, required
    - `directory` string, nullable, required
    - `environmentName` string, nullable, required
    - `labels` string[], required
    - `gitBranchName` string, nullable, required
    - `gitCommitSha` string, nullable, required
    - `gitCommitShaShort` string, nullable, required
    - `githubRepository` string, nullable, required
    - `gitlabProjectPath` string, nullable, required
    - `cliVersion` string, nullable, required
    - `pipelineId` string, nullable, required
    - `createdAt` string, date-time, required
    - `startedAt` string, date-time, required
    - `finishedAt` string, date-time, required
    - `flake` boolean, required
    - `attempts` number, required
    - `quarantined` boolean, required
    - `quarantinedReason` string, nullable, required
    - `failureReason` string, nullable, required
  - `pagination` object, required
    - `pageSize` integer, required
    - `hasMore` boolean, required
    - `nextCursor` string, nullable, required
    - `total` integer, nullable, required

## Other responses

- `400` — Error.
- `401` — Error.

---

[API](https://skmtc.dev/momentic/apis/momentic-analytics-api.md) · [All operations](https://skmtc.dev/momentic/apis/momentic-analytics-api/llms.txt) · [OpenAPI document](https://skmtc.dev/momentic/apis/momentic-analytics-api/revisions/8c11a345797d?raw)