---
title: "Retrieving suite run list"
method: GET
path: "/api/v2/suiteruns/"
tags: ["Suite runs"]
---

# Retrieving suite run list

`GET /api/v2/suiteruns/`

Returns many suite runs.

## Query parameters

- `ordering` string
- `page` integer
- `page_size` integer
- `started_after` string, date-time
- `started_before` string, date-time
- `suiteId` string

## Response `200`

- PaginatedV2SuiteRunList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` V2SuiteRun[], required
    - `duration` string, nullable, required
    - `ended` string, date-time, nullable, required
    - `errorCode` string, nullable, required
    - `id` string, uuid, required
    - `name` string, required
    - `parallelRun` boolean, nullable, required
    - `parallelSlots` integer, nullable, required
    - `profileId` string, uuid, required
    - `profileName` string, required
    - `queued` string, date-time, nullable, required
    - `runMode` 'server' | 'local' | 'recording', required — * `server` - cloud * `local` - local * `recording` - recording
    - `sequence` integer, nullable, required
    - `started` string, date-time, nullable, required
    - `status` 'error' | 'passed' | 'failed' | 'running' | 'auto_retrying' | 'stopped' | 'queued' | 'paused' | 'skipped' | 'recording' | 'initialized', required — * `error` - Error * `passed` - Passed * `failed` - Failed * `running` - Running * `auto_retrying` - Auto Retrying * `stopped` - Stopped * `queued` - Queued * `paused` - Paused * `skipped` - Skipped * `recording` - Recording * `initialized` - Initialized
    - `suiteId` string, uuid, nullable, required
    - `testRuns` V2TestRun[], required
      - `browserName` string, nullable, required
      - `browserVersion` string, nullable, required
      - `browserHeight` integer, nullable, required
      - `browserWidth` integer, nullable, required
      - `stepsRuns` string, required
      - `userId` string, uuid, nullable, required
      - `duration` string, nullable, required
      - `ended` string, date-time, nullable, required
      - `errorCode` string, nullable, required
      - `extensionVersion` string, nullable, required
      - `id` string, uuid, required
      - `name` string, required
      - `osName` string, nullable, required
      - `queued` string, date-time, nullable, required
      - `runMode` 'server' | 'local' | 'recording', required — * `server` - cloud * `local` - local * `recording` - recording
      - `runProfileId` string, uuid, nullable, required
      - `screenSizeType` 'desktop' | 'mobile' | 'custom', required — * `desktop` - Desktop * `mobile` - Mobile * `custom` - Custom
      - `sequence` integer, nullable, required
      - `started` string, date-time, nullable, required
      - `status` 'error' | 'passed' | 'failed' | 'running' | 'auto_retrying' | 'stopped' | 'queued' | 'paused' | 'skipped' | 'recording' | 'initialized', required — * `error` - Error * `passed` - Passed * `failed` - Failed * `running` - Running * `auto_retrying` - Auto Retrying * `stopped` - Stopped * `queued` - Queued * `paused` - Paused * `skipped` - Skipped * `recording` - Recording * `initialized` - Initialized
      - `suiteRunId` string, uuid, nullable, required
      - `testId` string, uuid, nullable, required
      - `triggeredBy` 'user' | 'api' | 'webhook' | 'scheduler' | 'github' | 'cli' | 'agent', required — * `user` - User * `api` - Api * `webhook` - Webhook * `scheduler` - Scheduler * `github` - Github * `cli` - Cli * `agent` - Agent
      - `webappUrl` string, required
    - `triggeredBy` string, required
    - `userId` string, nullable, required
    - `webappUrl` string, required

## Other responses

- `401` — Authentication credentials were missing or invalid.

---

[API](https://skmtc.net/bugbug/apis/bugbug-io-public-api.md) · [All operations](https://skmtc.net/bugbug/apis/bugbug-io-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bugbug/bugbug-io-public-api/versions/ed479395857f/schema)