> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracklysms.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a Queue

> Retrieve a single voice hold queue by id, including its current queued count.

Retrieves a single queue by id, including its current count of callers waiting on hold.

Requires the `voice_calls.read` scope and the **Voice Calls** product entitlement.

## Path Parameters

<ParamField path="queueId" type="string" required>
  The id of the queue to retrieve.
</ParamField>

## Response Fields

<ResponseField name="queue" type="object">
  The requested queue.

  <Expandable title="Queue properties" defaultOpen>
    <ResponseField name="queue.id" type="string">The queue's unique identifier.</ResponseField>
    <ResponseField name="queue.name" type="string">The queue name.</ResponseField>
    <ResponseField name="queue.holdAudioUrl" type="string | null">The hold-audio URL played to waiting callers.</ResponseField>
    <ResponseField name="queue.notifyUrl" type="string | null">The webhook that receives queue events.</ResponseField>
    <ResponseField name="queue.numbers" type="array">The numbers this queue serves, in digits-only form (no leading `+`). Numbers are assigned during onboarding, not through this API.</ResponseField>
    <ResponseField name="queue.isDefault" type="boolean">Whether this is the account default queue for unrouted numbers.</ResponseField>
    <ResponseField name="queue.autoAnswer" type="boolean">Whether inbound calls routed here are answered automatically.</ResponseField>
    <ResponseField name="queue.createdAt" type="string | null">ISO 8601 timestamp when the queue was created.</ResponseField>
    <ResponseField name="queue.queuedCount" type="integer">The number of callers currently waiting on hold in this queue.</ResponseField>
  </Expandable>
</ResponseField>

## Examples

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.tracklysms.com/api/v1/voice/queues/665f1e2a9c4b1a0012ab34cd \
    -H "X-Api-Key: trk_your_api_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "queue": {
      "id": "665f1e2a9c4b1a0012ab34cd",
      "name": "Support",
      "holdAudioUrl": "https://cdn.example.com/audio/hold.wav",
      "notifyUrl": "https://hooks.example.com/voice/queue",
      "numbers": ["18005551234"],
      "isDefault": true,
      "autoAnswer": true,
      "createdAt": "2026-08-21T18:00:00.000000Z",
      "queuedCount": 3
    }
  }
  ```
</ResponseExample>

## Error Codes

| Status | Code                 | Meaning                                        |
| ------ | -------------------- | ---------------------------------------------- |
| 403    | `voice_not_entitled` | Voice calling is not enabled for your account. |
| 404    | `queue_not_found`    | No queue with this id exists in your account.  |