---
title: "Read Concurrency Limit"
method: GET
path: "/api/concurrency_limits/{id}"
tags: ["Concurrency Limits"]
---

# Read Concurrency Limit

`GET /api/concurrency_limits/{id}`

## Request

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

Get a concurrency limit by id.

The `active slots` field contains a list of TaskRun IDs currently using a
concurrency slot for the specified tag.

## Path parameters

- `id` string, uuid, required: The concurrency limit id

## Headers

- `x-prefect-api-version` string

## Response `200`

Successful Response

- ConcurrencyLimit: An ORM representation of a concurrency limit.
  - `id` string, uuid
  - `created` string, date-time
  - `updated` string, date-time
  - `tag` string, required: A tag the concurrency limit is applied to.
  - `concurrency_limit` integer, required: The concurrency limit.
  - `active_slots` string[]: A list of active run ids using a concurrency slot

## Other responses

- `422`: Validation Error

---

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