---
title: "List queues"
method: GET
path: "/queues"
tags: ["Queue Commands"]
---

# List queues

`GET /queues`

List all queues for the authenticated user.

## Query parameters

- `page[number]` integer
- `page[size]` integer

## Response `200`

Successful response with a list of queues.

- object
  - `data` Queue[]
    - `record_type` 'queue', required
    - `id` string, required — Uniquely identifies the queue
    - `name` string, required — Name of the queue
    - `created_at` string, required — ISO 8601 formatted date of when the queue was created
    - `updated_at` string, required — ISO 8601 formatted date of when the queue was last updated
    - `current_size` integer, required — The number of calls currently in the queue
    - `max_size` integer, required — The maximum number of calls allowed in the queue
    - `average_wait_time_secs` integer, required — The average time that the calls currently in the queue have spent waiting, given in seconds.
  - `meta` PaginationMeta
    - `total_pages` integer, required
    - `total_results` integer
    - `page_number` integer, required
    - `page_size` integer

## Other responses

- `401` — Unauthorized. Authentication failed - the required authentication headers were either invalid or not included in the request.
- `422` — Unprocessable entity. The request was well-formed but could not be processed due to semantic errors. This includes validation errors, invalid parameter values, call state errors, conference errors, queue errors, recording/transcription errors, and business logic violations.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/revisions/e32d46c5945b/schema)