---
title: "Retrieve a call queue"
method: GET
path: "/queues/{queue_name}"
tags: ["Queue Commands"]
---

# Retrieve a call queue

`GET /queues/{queue_name}`

Retrieve an existing call queue

## Path parameters

- `queue_name` string, required

## Response `200`

Successful response with details about a queue.

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

## Other responses

- `404` — Resource not found. The requested resource does not exist. Common causes include: invalid call_control_id, conference not found, audio file not found, or recording not found.

---

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