<!-- Source: https://docs.vinsi.ai/api-docs/agents -->
# Get Agents

Fetch a list of the active agents in your organization, sorted by name. Use Get Agent by ID for the full configuration, including the outbound settings and tools.

```http
GET https://dashboard.vinsi.ai/api/agents
```

## Authentication

Send your API key in the `x-api-key` header. Create keys in the VINSI dashboard under Settings → API Keys.

## Headers

| Name | Type | Required |
|---|---|---|
| Content-Type | string | yes (application/json) |
| x-api-key | string | yes |

## Example request

```bash
curl -X GET 'https://dashboard.vinsi.ai/api/agents' \
  -H 'x-api-key: YOUR_API_KEY'
```

## Example response

```json
[
  {
    "id": "cmexampleagent000000000001",
    "name": "Front Desk Agent",
    "voiceId": "exampleVoiceId0001",
    "createdAt": "2026-09-01T17:22:57.945Z",
    "updatedAt": "2026-09-10T21:14:00.000Z",
    "isActive": true,
    "isAfterHoursFallback": false,
    "defaultOutboundPhoneNumberId": "phn_1757964000123_k2j4h5g6f"
  }
]
```