---
title: "Returns list of historical TestRuns"
method: GET
path: "/api/v2/testruns/"
tags: ["Test runs"]
---

# Returns list of historical TestRuns

`GET /api/v2/testruns/`

Returns list of historical TestRuns

## Query parameters

- `ordering` '-started' | 'started'
- `page` integer
- `page_size` integer
- `started_after` string, date-time
- `started_before` string, date-time
- `status` 'auto_retrying' | 'error' | 'failed' | 'initialized' | 'passed' | 'paused' | 'queued' | 'recording' | 'running' | 'skipped' | 'stopped'
- `testId` string, uuid

## Response `200`

- PaginatedV2TestRunList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` 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

## 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)