> For the complete documentation index, see [llms.txt](https://docs.systemsx.co.uk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.systemsx.co.uk/sense/api-agents-list.md).

# API Agents - List

## List Agents

<mark style="color:green;">`POST`</mark> `/v2/agents/list`

**Body**

| Name      | Type   | Description |
| --------- | ------ | ----------- |
| `api_key` | string |             |

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "success": true,
    "agents": [
        {
            "id": 1234,
            "name": "Example",
            "phone_extension": "1000",
            "department": "Sales"
        }
    ]
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid request"
}
```

{% endtab %}
{% endtabs %}