curl https://api.tracklysms.com/api/v1/voice/queues \
-H "X-Api-Key: trk_your_api_key_here"
{
"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
}
]
}
Voice Calls (v1)
List Queues
List every voice hold queue in your account, each with its current queued count.
GET
/
v1
/
voice
/
queues
curl https://api.tracklysms.com/api/v1/voice/queues \
-H "X-Api-Key: trk_your_api_key_here"
{
"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
}
]
}
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
array
The account’s queues.
Hide Queue properties
Hide Queue properties
string
The queue’s unique identifier.
string
The queue name.
string | null
The hold-audio URL played to waiting callers.
string | null
The webhook that receives queue events.
array
The numbers this queue serves, in digits-only form (no leading
+). Numbers are assigned during onboarding, not through this API.boolean
Whether this is the account default queue for unrouted numbers.
boolean
Whether inbound calls routed here are answered automatically.
string | null
ISO 8601 timestamp when the queue was created.
integer
The number of callers currently waiting on hold in this queue.
Examples
curl https://api.tracklysms.com/api/v1/voice/queues \
-H "X-Api-Key: trk_your_api_key_here"
{
"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
}
]
}
Error Codes
| Status | Code | Meaning |
|---|---|---|
| 403 | voice_not_entitled | Voice calling is not enabled for your account. |