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

# List run groups

`GET /v1/run-groups`

List completed run groups 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[]
- `executionType` string[]

## Response `200`

Success.

- ExternalRunGroupsResponse
  - `data` object[], required
    - `id` string, required
    - `status` 'PASSED' | 'FAILED' | 'CANCELLED', required
    - `trigger` 'WEBHOOK' | 'CRON' | 'MANUAL' | 'CLI', required
    - `createdAt` string, date-time, required
    - `startedAt` string, date-time, required
    - `finishedAt` string, date-time, required
    - `gitBranchName` string, nullable, required
    - `gitCommitSha` string, nullable, required
    - `gitCommitShaShort` string, nullable, required
    - `githubRepository` string, nullable, required
    - `gitlabProjectPath` string, nullable, required
    - `pipelineId` string, nullable, required
    - `ciProvider` string, nullable, required
    - `cliVersion` string, nullable, required
    - `suite` object, nullable, required
      - `id` string, required
      - `name` string, required
    - `localSuiteName` string, nullable, required
    - `labels` string[], required
    - `runCounts` object, required
      - `total` integer, required
      - `passed` integer, required
      - `failed` integer, required
      - `cancelled` integer, 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)