curl https://api.tracklysms.com/api/v1/voice/queues/665f1e2a9c4b1a0012ab34cd \
-H "X-Api-Key: trk_your_api_key_here"
{
"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
}
}
Voice Calls (v1)
Get a Queue
Retrieve a single voice hold queue by id, including its current queued count.
GET
/
v1
/
voice
/
queues
/
{queueId}
curl https://api.tracklysms.com/api/v1/voice/queues/665f1e2a9c4b1a0012ab34cd \
-H "X-Api-Key: trk_your_api_key_here"
{
"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
}
}
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
string
required
The id of the queue to retrieve.
Response Fields
object
The requested queue.
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/665f1e2a9c4b1a0012ab34cd \
-H "X-Api-Key: trk_your_api_key_here"
{
"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
}
}
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. |