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

# Read Concurrency Limit V2

`GET /api/v2/concurrency_limits/{id_or_name}`

## Request

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

## Path parameters

- `id_or_name` union, required: The ID or name of the concurrency limit
  - string, uuid
  - string

## Headers

- `x-prefect-api-version` string

## Response `200`

Successful Response

- GlobalConcurrencyLimitResponse: A response object for global concurrency limits.
  - `id` string, uuid
  - `created` string, date-time
  - `updated` string, date-time
  - `active` boolean: Whether the global concurrency limit is active.
  - `name` string, required: The name of the global concurrency limit.
  - `limit` integer, required: The concurrency limit.
  - `active_slots` integer, required: The number of active slots.
  - `slot_decay_per_second` number: The decay rate for active slots when used as a rate limit.

## Other responses

- `422`: Validation Error

## Changes

- **2024-05-03** `2cba68c4b535`: 2 warning, 3 info
  - removed the optional property `avg_slot_occupancy_seconds` from the response with the `200` status
  - removed the optional property `denied_slots` from the response with the `200` status
  - the response property `active_slots` became required for the status `200`
  - the `slot_decay_per_second` response's property default value changed from `0` to `2` for the status `200`
  - …1 more

[Operation history](https://skmtc.dev/prefecthq/apis/prefect-unreleased-api/changes/api/v2/concurrency_limits/:id_or_name/get.md)

---

[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)