> ## Documentation Index
> Fetch the complete documentation index at: https://trigger.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve Concurrency Limit

> Retrieve a concurrency limit by name, with its bounds and live running and queued counts.



## OpenAPI

````yaml v3-openapi GET /api/v1/concurrency-limits/{name}
openapi: 3.1.0
info:
  title: Trigger.dev v3 REST API
  description: >-
    The REST API lets you trigger and manage runs on Trigger.dev. You can
    trigger a run, get the status of a run, and get the results of a run. 
  version: 2024-04
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.trigger.dev
    description: Trigger.dev API
security: []
paths:
  /api/v1/concurrency-limits/{name}:
    get:
      tags:
        - concurrency-limits
      summary: Retrieve concurrency limit
      description: >-
        Retrieve a concurrency limit by name, with its bounds and live running
        and queued counts.
      operationId: retrieve_concurrency_limit_v1
      parameters:
        - name: name
          in: path
          required: true
          schema:
            type: string
          description: The limit's name, as declared with `concurrencyLimit()`
      responses:
        '200':
          description: Concurrency limit retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConcurrencyLimitObject'
        '401':
          description: Unauthorized request
        '404':
          description: Concurrency limit not found
      security:
        - secretKey: []
      x-codeSamples:
        - lang: typescript
          source: |-
            import { concurrencyLimits } from "@trigger.dev/sdk";

            const limit = await concurrencyLimits.retrieve("openai");
components:
  schemas:
    ConcurrencyLimitObject:
      type: object
      required:
        - id
        - name
        - perKey
        - total
        - running
        - queued
      properties:
        id:
          type: string
          description: The limit's id, starting with `climit_`
          example: climit_abcdef123456
        name:
          type: string
          description: The limit's name, as declared with `concurrencyLimit()`
          example: openai
        perKey:
          type: object
          description: Caps each concurrencyKey pool; runs without a key share one pool
          properties:
            current:
              type: integer
              nullable: true
              description: >-
                Enforced right now (null = no per-key bound). Enforcement clamps
                it to the environment concurrency limit at admit time.
              example: null
            base:
              type: integer
              nullable: true
              description: The declared value an override reverts to on reset
              example: null
            override:
              type: integer
              nullable: true
              description: The overridden value, when an override is active
              example: null
            overriddenAt:
              type: string
              format: date-time
              nullable: true
              description: When the override was applied
              example: null
        total:
          type: object
          description: Caps every run holding this limit, keys or not
          properties:
            current:
              type: integer
              nullable: true
              description: >-
                Enforced right now (null = no total bound). Enforcement clamps
                it to the environment concurrency limit at admit time.
              example: 25
            base:
              type: integer
              nullable: true
              description: The declared value an override reverts to on reset
              example: 25
            override:
              type: integer
              nullable: true
              description: The overridden value, when an override is active
              example: null
            overriddenAt:
              type: string
              format: date-time
              nullable: true
              description: When the override was applied
              example: null
        running:
          type: integer
          description: Runs executing that hold this limit
          example: 14
        queued:
          type: integer
          description: Runs that are queued and must clear this limit to execute
          example: 100
        paused:
          type: boolean
          description: >-
            Whether the limit is paused. A paused limit admits no runs until
            resumed; its configured bounds are kept.
          example: false
  securitySchemes:
    secretKey:
      type: http
      scheme: bearer
      description: >
        Use a named environment API key. It starts with `tr_dev_sk_`,
        `tr_prod_sk_`, `tr_stg_sk_`, etc.


        Create a named API key in the API Keys section of your Trigger.dev
        project dashboard. Choose the narrowest access preset that supports your
        integration.


        Our TypeScript SDK will default to using the value of the
        `TRIGGER_SECRET_KEY` environment variable if it is set. If you are using
        the SDK in a different environment, you can set the key using the
        `configure` function.


        ```typescript

        import { configure } from "@trigger.dev/sdk";


        configure({ accessToken: "tr_dev_sk_1234" });

        ```

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.