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

# List Concurrency Limits

> List the environment's declared concurrency limits (anonymous inline limits
appear under their derived `task/<task-id>` names), with each limit's bounds
and its live running and queued counts. Results are ordered by the underlying
row name, so named limits sort before `task/`-derived inline limits.




## OpenAPI

````yaml v3-openapi GET /api/v1/concurrency-limits
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:
    get:
      tags:
        - concurrency-limits
      summary: List concurrency limits
      description: >
        List the environment's declared concurrency limits (anonymous inline
        limits

        appear under their derived `task/<task-id>` names), with each limit's
        bounds

        and its live running and queued counts. Results are ordered by the
        underlying

        row name, so named limits sort before `task/`-derived inline limits.
      operationId: list_concurrency_limits_v1
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: perPage
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 25
            maximum: 100
      responses:
        '200':
          description: Concurrency limits retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/ConcurrencyLimitObject'
                  pagination:
                    type: object
                    properties:
                      currentPage:
                        type: integer
                      totalPages:
                        type: integer
                      count:
                        type: integer
        '401':
          description: Unauthorized request
      security:
        - secretKey: []
      x-codeSamples:
        - lang: typescript
          source: >-
            import { concurrencyLimits } from "@trigger.dev/sdk";


            const limits = await concurrencyLimits.list({ page: 1, perPage: 20
            });
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.