---
title: "List runs"
method: GET
path: "/api/runs"
tags: ["Runs"]
---

# List runs

`GET /api/runs`

List job runs with optional filters for job ID and status.

## Query parameters

- `page` integer
- `limit` integer
- `jobId` string, uuid
- `status` 'queued' | 'running' | 'passed' | 'failed' | 'error' | 'blocked'

## Response `200`

Paginated list of runs

- object
  - `pagination` object
    - `total` integer
    - `page` integer
    - `limit` integer
    - `totalPages` integer
    - `hasNextPage` boolean
    - `hasPrevPage` boolean
  - `data` Run[]
    - `id` string, uuid
    - `jobId` string, uuid, nullable
    - `jobName` string, nullable
    - `jobType` 'playwright' | 'k6', nullable
    - `status` 'queued' | 'running' | 'passed' | 'failed' | 'error' | 'blocked'
    - `trigger` 'manual' | 'remote' | 'schedule'
    - `duration` string, nullable — Formatted duration string
    - `durationMs` integer, nullable — Duration in milliseconds
    - `startedAt` string, date-time, nullable
    - `completedAt` string, date-time, nullable
    - `logs` string, nullable
    - `errorDetails` string, nullable
    - `reportUrl` string, nullable — URL to the run report
    - `testCount` integer, nullable
    - `location` string, nullable
    - `projectId` string, uuid, nullable
    - `organizationId` string, uuid, nullable

## Other responses

- `401` — Authentication required or token invalid

---

[API](https://skmtc.dev/supercheck-io/apis/supercheck-api.md) · [All operations](https://skmtc.dev/supercheck-io/apis/supercheck-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supercheck-io/supercheck-api/revisions/81782deccf0e/schema)