---
title: "List the user's active generation jobs (Roles: user)"
method: GET
path: "/jobs"
tags: ["Jobs"]
---

# List the user's active generation jobs (Roles: user)

`GET /jobs`

## Query parameters

- `status` string
- `includeAcknowledged` boolean

## Response `200`

Success

- GenerationJob[]
  - `_id` string, required
  - `user_id` string, required
  - `task_type` 'generate_images' | 'generate_3d_images' | 'generate_refined_3d_images' | 'rig_3d_model' | 'animate_3d_model' | 'animate_3d_preset' | 'generate_images_inpainting' | 'generate_video' | 'generate_video_first_frame' | 'generate_audio' | 'generate_image_to_spritesheet' | 'generate_video_to_spritesheet' | 'generate_sprite' | 'generate_spritesheet_motion_transfer' | 'generate_edit_spritesheet' | 'generate_references_to_video' | 'generate_video_edit' | 'generate_upscale_video' | 'remove_image_background' | 'test_wait', required
  - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', required
  - `payload` object
  - `result` object
  - `error` JobError
    - `code` 'network' | 'prometheus_5xx' | 'prometheus_4xx' | 'validation' | 'timeout' | 'unknown'
    - `subcode` string
    - `message` string
    - `retriable` boolean
  - `request_id` string
  - `history_id` string
  - `worker_id` string
  - `attempts` integer
  - `credits_charged` number, float
  - `credit_feature` string
  - `credit_tier` string
  - `created_at` integer, required
  - `started_at` integer
  - `finished_at` integer
  - `heartbeat_at` integer
  - `acknowledged_at` integer
  - `description` string — User-facing label derived from the payload at enqueue time (e.g. 'Sound effect: laser zap'). Frontend uses this in the queue panel.
  - `expire_at` string, date-time

## Other responses

- `400` — Error

---

[API](https://skmtc.net/ludo/apis/ludo-ai-api.md) · [All operations](https://skmtc.net/ludo/apis/ludo-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ludo/ludo-ai-api/revisions/3af866d68651/schema)