---
title: "Read Work Pool"
method: GET
path: "/api/work_pools/{name}"
tags: ["Work Pools"]
---

# Read Work Pool

`GET /api/work_pools/{name}`

## Request

- The document declares no server URL.
- Auth: none declared

Read a work pool by name

## Path parameters

- `name` string, required: The work pool name

## Headers

- `x-prefect-api-version` string

## Response `200`

Successful Response

- WorkPool: An ORM representation of a work pool
  - `id` string, uuid
  - `created` string, date-time
  - `updated` string, date-time
  - `name` string, required: The name of the work pool.
  - `description` string: A description of the work pool.
  - `type` string, required: The work pool type.
  - `base_job_template` object: The work pool's base job template.
  - `is_paused` boolean: Pausing the work pool stops the delivery of all work.
  - `concurrency_limit` integer: A concurrency limit for the work pool.
  - `status` 'READY' | 'NOT_READY' | 'PAUSED': Enumeration of work pool statuses.
  - `default_queue_id` string, uuid: The id of the pool's default queue.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/prefecthq/apis/prefect-versions-api.md) - [All operations](https://skmtc.dev/prefecthq/apis/prefect-versions-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prefecthq/apis/prefect-versions-api/revisions/a7958ce57e96?raw)