---
title: "Get queue"
method: GET
path: "/api/v4/routing/queues/{queue_id}"
tags: ["Routing"]
---

# Get queue

`GET /api/v4/routing/queues/{queue_id}`

Returns detailed information about a specific queue.

## Path parameters

- `queue_id` integer, required

## Response `200`

OK

- object
  - `queue` Queue
    - `id` integer — The unique identifier of the queue.
    - `name` string — The name of the queue.
    - `extension` string, nullable — The phone extension used to direct calls to the queue.
    - `strategy` 'linear' | 'circular' | 'fewest_calls' | 'least_recent' | 'ring_all' — Specifies how interactions are distributed to agents.
    - `music_on_hold` MediaMusicOnHold — Music on hold Media object.
      - `type` 'music_on_hold' — The type of media.
      - `name` string — The name of the media.
    - `in_queue_announcement` object — Settings for messages played to callers waiting in queue.
      - `interval` integer — Number of seconds between replaying the in-queue announcements.
      - `voice_message` MediaVoiceMessage — Voice message Media object.
        - `type` 'voice_message' — The type of media.
        - `name` string — The name of the media.
      - `announce_position` boolean — Automatically announce the caller's position in the queue.
      - `announce_wait_time` boolean — Automatically announce the estimated wait time.
    - `failover_destination` object — Defines where to redirect if it waits in the queue longer than the configured `wait_time`.
      - `wait_time` integer — Number of seconds to wait before redirecting.
      - `destination` union — Failover destination details depending on type.
        - QueueFailoverDestinationAgent — Redirect to a specific agent.
          - `type` 'agent', required — Destination type identifier.
          - `agent` UserShort
            - `id` integer — The unique identifier of the user.
            - `name` string — The name of the user.
            - `email` string, email — The email address of the user.
        - QueueFailoverDestinationQueue — Redirect to another queue.
          - `type` 'queue', required — Destination type identifier.
          - `queue` QueueShort
            - `id` integer — The unique identifier of the queue.
            - `name` string — The name of the queue.
        - QueueFailoverDestinationTerminate — Terminate the call.
          - `type` 'terminate', required — Destination type identifier.
        - QueueFailoverDestinationVoicemail — Send to voicemail.
          - `type` 'voicemail', required — Destination type identifier.
          - `voicemail` object — Voicemail configuration for this destination.
            - `voice_message` MediaVoiceMessage — Voice message Media object.
              - …
            - `report` object — Send voicemail via email.
              - …
        - QueueFailoverDestination3rdPartyNumber — Redirect to an external phone number.
          - `type` '3rd_party_number', required — Destination type identifier.
          - `3rd_party_number` string, phone — External phone number.
    - `callback` object — Allow contacts to request a callback when an agent becomes available rather than waiting in the queue.
      - `wait_time` integer — The number of seconds to wait before offering the callback option.
      - `caller_id_group` CallerIDGroupShort — A group of Caller IDs that control which phone number is shown when dialing.
        - `id` integer — The unique identifier of the caller ID group
        - `name` string — The name of the caller ID group.
      - `offer_voice_message` MediaVoiceMessage — Voice message Media object.
        - `type` 'voice_message' — The type of media.
        - `name` string — The name of the media.
      - `confirmation_voice_message` MediaVoiceMessage — Voice message Media object.
        - `type` 'voice_message' — The type of media.
        - `name` string — The name of the media.
    - `post_call_rating` object — Allow contacts to evaluate the call by asking them to participate in a survey.
      - `notification_voice_message` MediaVoiceMessage — Voice message Media object.
        - `type` 'voice_message' — The type of media.
        - `name` string — The name of the media.
      - `instruction_voice_message` MediaVoiceMessage — Voice message Media object.
        - `type` 'voice_message' — The type of media.
        - `name` string — The name of the media.
      - `complete_voice_message` MediaVoiceMessage — Voice message Media object.
        - `type` 'voice_message' — The type of media.
        - `name` string — The name of the media.
    - `channels` object[] — Connected channels with priorities.
      - `channel` 'chat' | 'facebook' | 'instagram' | 'telegram' | 'viber' | 'whatsapp' — The name of the channel.
      - `priority` integer — The priority of the channel.
    - `skills` Skill[] — Skills associated with the queue.
      - `id` integer — The unique identifier of the skill.
      - `name` string — The name of the skill.
      - `created_at` string, date-time — Timestamp when the skill was created (ISO 8601).
      - `updated_at` string, date-time — Timestamp when the skill was last updated (ISO 8601).
    - `created_at` string, date-time — Timestamp when the queue was created (ISO 8601).
    - `updated_at` string, date-time — Timestamp when the queue was last updated (ISO 8601).

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `429` — Too many requests

---

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