---
title: "List all queues"
method: GET
path: "/api/v1/queues"
tags: ["queues"]
---

# List all queues

`GET /api/v1/queues`

List all queues in your environment with pagination support.

## Query parameters

- `page` integer
- `perPage` integer

## Response `200`

Successful request

- ListQueuesResult
  - `data` QueueObject[], required — An array of queue objects
    - `id` string, required — The queue ID, e.g., `queue_1234`
    - `name` string, required — The queue name. For task queues, this is the task ID. For custom queues, this is the name you specified.
    - `type` 'task' | 'custom', required — The type of queue: - `task`: Created automatically for each task - `custom`: Created explicitly in your code using `queue()`
    - `running` integer, required — The number of runs currently executing
    - `queued` integer, required — The number of runs currently queued
    - `paused` boolean, required — Whether the queue is paused. When paused, no new runs will start.
    - `concurrencyLimit` integer, nullable — The current concurrency limit of the queue
    - `concurrency` object — Detailed concurrency information
      - `current` integer, nullable — The effective/current concurrency limit
      - `base` integer, nullable — The base concurrency limit defined in code
      - `override` integer, nullable — The override concurrency limit (if set)
      - `overriddenAt` string, date-time, nullable — When the concurrency limit was overridden
      - `overriddenBy` string, nullable — Who overrode the concurrency limit (null if via API)
  - `pagination` object, required
    - `currentPage` integer — The current page number
    - `totalPages` integer — The total number of pages
    - `count` integer — The total number of queues

## Other responses

- `401` — Unauthorized request

---

[API](https://skmtc.net/winsenlabs/apis/trigger-dev-v3-rest-api.md) · [All operations](https://skmtc.net/winsenlabs/apis/trigger-dev-v3-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/winsenlabs/trigger-dev-v3-rest-api/versions/737c498e605b/schema)