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

# List jobs

`GET /jobs`

List jobs with pagination and filtering. Returns jobs belonging to the authenticated user.

## Query parameters

- `cursor` string, date-time — ISO 8601 timestamp cursor for pagination (jobs created before this time)
- `limit` integer — Number of items to return (1-1000, default: 100)
- `types` string — Comma-separated list of job types to filter (e.g., "flux,k1,externalImage")
- `status` 'backlogged' | 'queued' | 'scheduled' | 'processing' | 'sampling' | 'intermediate-complete' | 'completed' | 'failed' | 'cancelled' — Filter by job status

## Response `200`

List of jobs

- object
  - `items` object[], required
    - `job_id` string, uuid, required
    - `status` 'backlogged' | 'queued' | 'scheduled' | 'processing' | 'sampling' | 'intermediate-complete' | 'completed' | 'failed' | 'cancelled', required
    - `created_at` string, date-time, required
    - `completed_at` string, date-time
    - `result` object
      - `urls` union
        - string[]
        - object[]
          - `type` 'model' | 'preview', required
          - `url` string, uri, required
        - object
      - `style_id` string
    - `error` object
      - `code` string, required
      - `message` string
  - `next_cursor` string, nullable, required

## Other responses

- `400` — Invalid query parameters
- `401` — Unauthorized

---

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