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"],
"numberAssignmentsApplicable": true,
"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"],
"numberAssignmentsApplicable": true,
"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
hosted or managed.string
The queue name.
string | null
The hold-audio URL played to waiting callers.
string | null
The webhook that receives queue events.
array
Hosted queue number assignments, in digits-only form. Managed queues return
[]; this field is not used for their inbound routing.boolean
Whether
queue.numbers participates in inbound routing. Managed queues return false; inbound calls use the account’s owned number and default managed queue.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"],
"numberAssignmentsApplicable": true,
"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. |