---
title: "Get all jobs."
method: GET
path: "/v2/jobs"
tags: ["Api", "Jobs"]
---

# Get all jobs.

`GET /v2/jobs`

## Query parameters

- `limit` number
- `cursor` string, uuid
- `status` 'pending' | 'created' | 'succeeded' | 'canceled' | 'failed' | 'running'

## Response `200`

- GetJobsResponseV2
  - `items` JobListItem[], required — List of jobs. Sorted by creation date, descending. Does not include output data.
    - `id` string, required
    - `status` string, required
    - `createdAt` string, date-time, required
  - `nextCursor` string, nullable, required — Cursor to pass as `cursor` query param to get the next page. Null if there are no more results.

## Other responses

- `400` — Invalid request
- `402` — Subscription is required
- `429` — Too many requests

---

[API](https://skmtc.dev/pyannote/apis/pyannoteai-api.md) · [All operations](https://skmtc.dev/pyannote/apis/pyannoteai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pyannote/pyannoteai-api/revisions/9d61c3f2d6bb/schema)
