---
title: "Read Work Queue Status"
method: GET
path: "/api/work_queues/{id}/status"
tags: ["Work Queues"]
---

# Read Work Queue Status

`GET /api/work_queues/{id}/status`

Get the status of a work queue.

## Path parameters

- `id` string, uuid, required — The work queue id

## Headers

- `x-prefect-api-version` string

## Response `200`

Successful Response

- WorkQueueStatusDetail — A base pydantic.BaseModel for all Prefect schemas and pydantic models. As the basis for most Prefect schemas, this base model usually ignores extra fields that are passed to it at instantiation. Because adding new fields to API payloads is not considered a breaking change, this ensures that any Prefect client loading data from a server running a possibly-newer version of Prefect will be able to process those new fields gracefully. However, when PREFECT_TEST_MODE is on, extra fields are forbidden in order to catch subtle unintentional testing errors.
  - `healthy` boolean, required — Whether or not the work queue is healthy.
  - `late_runs_count` integer — The number of late flow runs in the work queue.
  - `last_polled` string, date-time — The last time an agent polled this queue for work.
  - `health_check_policy` WorkQueueHealthPolicy, required — A base pydantic.BaseModel for all Prefect schemas and pydantic models. As the basis for most Prefect schemas, this base model usually ignores extra fields that are passed to it at instantiation. Because adding new fields to API payloads is not considered a breaking change, this ensures that any Prefect client loading data from a server running a possibly-newer version of Prefect will be able to process those new fields gracefully. However, when PREFECT_TEST_MODE is on, extra fields are forbidden in order to catch subtle unintentional testing errors.
    - `maximum_late_runs` integer — The maximum number of late runs in the work queue before it is deemed unhealthy. Defaults to `0`.
    - `maximum_seconds_since_last_polled` integer — The maximum number of time in seconds elapsed since work queue has been polled before it is deemed unhealthy. Defaults to `60`.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/prefecthq/apis/untitled-api-2.md) · [All operations](https://skmtc.net/prefecthq/apis/untitled-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prefecthq/untitled-api-2/revisions/29ba6c4f8837/schema)