---
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}`

## 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

[Change history](https://skmtc.dev/prefecthq/apis/untitled-api-2/changes/api/v2/concurrency_limits/:id_or_name/get.md)

---

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