curl https://api.tracklysms.com/api/v1/voice/agents \
-H "X-Api-Key: trk_your_api_key_here"
{
"agents": [
{
"id": "665f1e2a9c4b1a0012ab34cd",
"name": "Front Desk",
"type": "phone",
"number": "14155559876",
"createdAt": "2026-08-21T18:00:00.000000Z"
},
{
"id": "665f1e2a9c4b1a0012ab34ce",
"name": "Escalations",
"type": "phone",
"number": "14155550111",
"createdAt": "2026-08-21T18:05:00.000000Z"
}
]
}
Voice Calls (v1)
List Agents
List the voice agents configured on your account.
GET
/
v1
/
voice
/
agents
curl https://api.tracklysms.com/api/v1/voice/agents \
-H "X-Api-Key: trk_your_api_key_here"
{
"agents": [
{
"id": "665f1e2a9c4b1a0012ab34cd",
"name": "Front Desk",
"type": "phone",
"number": "14155559876",
"createdAt": "2026-08-21T18:00:00.000000Z"
},
{
"id": "665f1e2a9c4b1a0012ab34ce",
"name": "Escalations",
"type": "phone",
"number": "14155550111",
"createdAt": "2026-08-21T18:05:00.000000Z"
}
]
}
Returns every voice agent configured on your account. Each agent is a reusable, named destination you can reference by its
id in the connectTo field when placing, answering, or dequeuing a call.
Requires the voice_calls.read scope and the Voice Calls product entitlement.
Response Fields
array
Examples
curl https://api.tracklysms.com/api/v1/voice/agents \
-H "X-Api-Key: trk_your_api_key_here"
{
"agents": [
{
"id": "665f1e2a9c4b1a0012ab34cd",
"name": "Front Desk",
"type": "phone",
"number": "14155559876",
"createdAt": "2026-08-21T18:00:00.000000Z"
},
{
"id": "665f1e2a9c4b1a0012ab34ce",
"name": "Escalations",
"type": "phone",
"number": "14155550111",
"createdAt": "2026-08-21T18:05:00.000000Z"
}
]
}
Error Codes
| Status | Code | Meaning |
|---|---|---|
| 403 | voice_not_entitled | Voice calling is not enabled for your account. |