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

# List Queues

> List every voice hold queue in your account, each with its current queued count.

Returns every queue in your account, each with its current count of callers waiting on hold.

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

## Response Fields

<ResponseField name="queues" type="array">
  The account's queues.

  <Expandable title="Queue properties" defaultOpen>
    <ResponseField name="queues[].id" type="string">The queue's unique identifier.</ResponseField>
    <ResponseField name="queues[].name" type="string">The queue name.</ResponseField>
    <ResponseField name="queues[].holdAudioUrl" type="string | null">The hold-audio URL played to waiting callers.</ResponseField>
    <ResponseField name="queues[].notifyUrl" type="string | null">The webhook that receives queue events.</ResponseField>
    <ResponseField name="queues[].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="queues[].isDefault" type="boolean">Whether this is the account default queue for unrouted numbers.</ResponseField>
    <ResponseField name="queues[].autoAnswer" type="boolean">Whether inbound calls routed here are answered automatically.</ResponseField>
    <ResponseField name="queues[].createdAt" type="string | null">ISO 8601 timestamp when the queue was created.</ResponseField>
    <ResponseField name="queues[].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 \
    -H "X-Api-Key: trk_your_api_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "queues": [
      {
        "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
      },
      {
        "id": "665f1e2a9c4b1a0012ab34ce",
        "name": "Sales",
        "holdAudioUrl": null,
        "notifyUrl": null,
        "numbers": ["18005559876"],
        "isDefault": false,
        "autoAnswer": true,
        "createdAt": "2026-08-21T18:05:00.000000Z",
        "queuedCount": 0
      }
    ]
  }
  ```
</ResponseExample>

## Error Codes

| Status | Code                 | Meaning                                        |
| ------ | -------------------- | ---------------------------------------------- |
| 403    | `voice_not_entitled` | Voice calling is not enabled for your account. |