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

# List jobs

`GET /jobs`

Get a list of background jobs. Returns basic job information. Use GET /jobs/{uuid} for full details including payload and result.

## Query parameters

- `status` 'pending' | 'held' | 'processing' | 'completed' | 'failed'
- `job_type` 'generate_pdf' | 'generate_microdata_resource' | 'import_microdata' | 'import_indicator_data' | 'publish_project' | 'hello_world' — Registered background job type identifier
- `user_id` integer
- `limit` integer
- `offset` integer

## Response `200`

successful operation

- JobListResponse
  - `status` string
  - `total` integer — Total number of jobs in the response
  - `found` integer — Number of jobs found
  - `limit` integer — Limit used for pagination
  - `offset` integer — Offset used for pagination
  - `jobs` JobBasic[]
    - `uuid` string
    - `job_type` 'generate_pdf' | 'generate_microdata_resource' | 'import_microdata' | 'import_indicator_data' | 'publish_project' | 'hello_world' — Registered background job type identifier
    - `status` 'pending' | 'held' | 'processing' | 'completed' | 'failed'
    - `priority` integer
    - `user_id` integer
    - `attempts` integer
    - `max_attempts` integer
    - `created_at` string, date-time
    - `started_at` string, date-time
    - `completed_at` string, date-time
    - `worker_id` string
    - `job_status_link` string, uri — URL to get full job details

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/worldbank/apis/metadata-editor-jobs-api.md) · [All operations](https://skmtc.net/worldbank/apis/metadata-editor-jobs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/worldbank/metadata-editor-jobs-api/revisions/7f334b22fc50/schema)