> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nixflex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List agents

> GET /v1/agents

Returns all agents for your account.

## Request

```bash theme={null}
curl https://api.nixflex.com/v1/agents \
  -H "Authorization: Bearer KEY_ID:KEY_SECRET"
```

## Query parameters

| Parameter   | Type | Default | Notes                   |
| ----------- | ---- | ------- | ----------------------- |
| `limit`     | int  | 25      | Max 100                 |
| `offset`    | int  | 0       | For pagination          |
| `is_active` | bool | —       | Filter by active status |

## Response

`200 OK`:

```json theme={null}
{
  "agents": [
    {
      "agent_id": "agent_125207e452f8714a",
      "name": "Acme Dental Receptionist",
      "language": "en",
      "voice_id": "Dennis",
      "is_active": true,
      "created_at": "2026-05-17T03:45:12Z"
    }
  ],
  "count": 1,
  "limit": 25,
  "offset": 0
}
```

Sorted by `created_at` descending.

## Empty result

Returns an empty array (not 404) if you have no agents yet:

```json theme={null}
{
  "agents": [],
  "count": 0
}
```