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

> List the voice agents configured on your account.

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

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

  <Expandable title="Agent properties" defaultOpen>
    <ResponseField name="agents[].id" type="string">The agent's unique identifier. Use this value in `connectTo`.</ResponseField>
    <ResponseField name="agents[].name" type="string">The agent's label.</ResponseField>
    <ResponseField name="agents[].type" type="string">The destination type. Currently always `phone`.</ResponseField>
    <ResponseField name="agents[].number" type="string">The normalized destination number.</ResponseField>
    <ResponseField name="agents[].createdAt" type="string | null">ISO 8601 timestamp when the agent was created.</ResponseField>
  </Expandable>
</ResponseField>

## Examples

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.tracklysms.com/api/v1/voice/agents \
    -H "X-Api-Key: trk_your_api_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "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"
      }
    ]
  }
  ```
</ResponseExample>

## Error Codes

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