---
title: "Get queue status"
method: GET
path: "/jobs/status"
tags: ["Jobs"]
---

# Get queue status

`GET /jobs/status`

## Request

- Base URL: `https://localhost/index.php/api`
- URL: `https://localhost/index.php/api/jobs/status`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/worldbank/apis/metadata-editor-jobs-api/docs/jobs/status/get.ts> (a function with typed inputs; its response is checked against the schema)

Get overall queue statistics including counts by status. Optionally filter by user_id (admin only, or own stats for regular users).

## Query parameters

- `user_id` integer

## Response `200`

successful operation

- QueueStatusResponse
  - `status` string
  - `queue` object: Overall queue statistics
    - `pending` integer: Number of pending jobs
    - `held` integer: Number of held jobs (paused, not processed by worker)
    - `processing` integer: Number of jobs currently processing
    - `completed` integer: Number of completed jobs
    - `failed` integer: Number of failed jobs
    - `total` integer: Total number of jobs
  - `user_stats` object: User-specific statistics (if user_id filter provided)
    - `pending` integer
    - `held` integer
    - `processing` integer
    - `completed` integer
    - `failed` integer
    - `total` integer

## Other responses

- `400`: Bad request

## Changes

- **2026-05-24** `1ff58dcd71a4`: 2 info
  - added the optional property `queue/held` to the response with the `200` status
  - added the optional property `user_stats/held` to the response with the `200` status

[Operation history](https://skmtc.dev/worldbank/apis/metadata-editor-jobs-api/changes/jobs/status/get.md)

---

[API](https://skmtc.dev/worldbank/apis/metadata-editor-jobs-api.md) - [All operations](https://skmtc.dev/worldbank/apis/metadata-editor-jobs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/worldbank/apis/metadata-editor-jobs-api/revisions/755536b6492e?raw)