---
title: "List queues"
method: GET
path: "/api/relay/rest/queues"
tags: ["Queues"]
---

# List queues

`GET /api/relay/rest/queues`

Returns a list of your queues.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Response `200`

The request has succeeded.

- QueueListResponse — Response containing a list of queues.
  - `links` PaginationLinks — Pagination links for list responses.
    - `self` string, required — Link to the current page.
    - `first` string, required — Link to the first page.
    - `next` string — Link to the next page. Only present when there are more results.
    - `prev` string — Link to the previous page. Only present when not on the first page.
  - `data` Queue[] — List of queues.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `project_id` string, uuid, required — Universal Unique Identifier.
    - `friendly_name` string, required — The friendly name of the queue.
    - `max_size` integer — The maximum number of callers allowed in the queue.
    - `current_size` integer — The current number of callers in the queue.
    - `average_wait_time` integer — The average wait time in seconds.
    - `uri` string — The URL of this queue.
    - `date_created` string, date-time — Timestamp when the queue was created.
    - `date_updated` string, date-time — Timestamp when the queue was last updated.

## Other responses

- `401` — Access is unauthorized.
- `422` — The request failed validation. See errors for details.
- `500` — An internal server error occurred.

---

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