---
title: "List jobs"
method: GET
path: "/api/jobs"
tags: ["Jobs"]
---

# List jobs

`GET /api/jobs`

List all jobs in the current project with pagination.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Paginated list of jobs

- object
  - `pagination` object
    - `total` integer
    - `page` integer
    - `limit` integer
    - `totalPages` integer
    - `hasNextPage` boolean
    - `hasPrevPage` boolean
  - `data` Job[]
    - `id` string, uuid
    - `name` string
    - `description` string, nullable
    - `cronSchedule` string, nullable
    - `status` 'pending' | 'running' | 'passed' | 'failed' | 'error'
    - `alertConfig` JobAlertConfig
      - `enabled` boolean
      - `notificationProviders` string[]
      - `alertOnFailure` boolean
      - `alertOnSuccess` boolean
      - `alertOnTimeout` boolean
      - `failureThreshold` integer
      - `recoveryThreshold` integer
      - `customMessage` string
    - `tests` Test[] — Tests associated with this job
      - `id` string, uuid
      - `name` string, nullable
      - `title` string
      - `description` string, nullable
      - `priority` 'low' | 'medium' | 'high' — Test priority
      - `type` 'browser' | 'api' | 'performance' | 'database' | 'custom' — Test type. `browser` = Playwright, `performance` = k6
      - `script` string, nullable — Test script content
      - `projectId` string, uuid, nullable
      - `organizationId` string, uuid, nullable
      - `tags` Tag[]
        - `id` string, uuid
        - `name` string
        - `color` string, nullable
      - `createdAt` string, date-time, nullable
      - `updatedAt` string, date-time, nullable
    - `lastRun` JobLastRun
      - `id` string, uuid
      - `status` 'queued' | 'running' | 'passed' | 'failed' | 'error' | 'blocked'
      - `errorDetails` string, nullable
      - `durationMs` integer, nullable
      - `startedAt` string, date-time, nullable
      - `completedAt` string, date-time, nullable
    - `testCount` integer, nullable
    - `lastRunAt` string, date-time, nullable
    - `nextRunAt` string, date-time, nullable
    - `scheduledJobId` string, nullable
    - `jobType` 'playwright' | 'k6', nullable
    - `organizationId` string, uuid, nullable
    - `projectId` string, uuid, nullable
    - `createdByUserId` string, uuid, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable

## Other responses

- `401` — Authentication required or token invalid

## Changes

> 4 revisions in range; 1 could not be searched.

- **2026-03-21** `40aeed2ccba7` — 4 breaking, 6 warning, 22 info
  - the response property `allOf[subschema #2]/data/items/createdAt` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/description` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/updatedAt` became nullable for the status `200`
  - the `allOf[subschema #2]/data/items/alertConfig` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - …28 more
- **2026-02-08** `78bbac89339b` — 2 breaking, 21 warning, 7 info
  - the response property `allOf[subschema #2]/data/items/alertConfig` became nullable for the status `200`
  - the `allOf[subschema #2]/data/items/alertConfig` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - removed the optional property `allOf[subschema #2]/data/items/createdByUserId` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/data/items/jobType` from the response with the `200` status
  - …26 more

[Change history](https://skmtc.dev/supercheck-io/apis/supercheck-api/changes/api/jobs/get.md)

---

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