---
title: "Get Queue Status"
method: GET
path: "/api/v0/queue-status"
tags: ["Queue Status"]
---

# Get Queue Status

`GET /api/v0/queue-status`

## Query parameters

- `tasks_offset` integer
- `tasks_limit` integer
- `workers_offset` integer
- `workers_limit` integer

## Response `200`

Successful Response

- QueueStatusResponse — Live Hyrex queue depth and worker health for the activity dashboard.
  - `queues` QueueStatusEntry[], required — Per-queue task counts (live depth + recent terminal).
    - `queue` string, required — Hyrex queue name.
    - `queued` integer — Tasks waiting to be picked up.
    - `running` integer — Tasks currently executing.
    - `waiting` integer — Tasks blocked on dependencies or a start time.
    - `succeeded_recent` integer — Tasks that succeeded in the last 24h.
    - `failed_recent` integer — Tasks that failed in the last 24h.
    - `lost_recent` integer — Tasks lost to dead workers in the last 24h.
  - `workers` WorkerStatus[], required — Recently-active workers, newest heartbeat first.
    - `name` string, required — Executor name.
    - `worker_name` string, required — Worker host/process identifier.
    - `status` string, required — Executor status: RUNNING, LOST, SHUTDOWN, …
    - `queues` string[] — Queues this worker pulls from.
    - `started` string, date-time, nullable — When the worker started.
    - `last_heartbeat` string, date-time, nullable — Most recent heartbeat from the worker.
    - `seconds_since_heartbeat` number, nullable — Age of the last heartbeat, in seconds.
  - `live_workers` integer, required — Workers whose heartbeat is within the live threshold.
  - `workers_total` integer — Total recently-active workers (for pagination).
  - `tasks` QueueTaskRun[] — The current user's in-flight + recent individual task runs.
    - `task_name` string, required — Hyrex task name (e.g. process_page).
    - `queue` string, required — Queue the task ran on.
    - `status` string, required — Hyrex run status.
    - `attempt_number` integer, nullable — Attempt index.
    - `page_number` integer, nullable — Page index, for per-page tasks.
    - `job_id` string, uuid, required — Public ID of the owning job status.
    - `document_id` string, uuid, nullable — Public ID of the associated document, if any.
    - `document_name` string, nullable — Name of the associated document, if any.
    - `queued` string, date-time, nullable — When enqueued.
    - `started` string, date-time, nullable — When started.
    - `finished` string, date-time, nullable — When finished.
    - `duration_seconds` number, nullable — finished - started, in seconds.
  - `tasks_total` integer — Total of the user's task runs (for pagination).

## Other responses

- `422` — Validation Error

---

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