> For the complete documentation index, see [llms.txt](https://anunzi-ai.gitbook.io/anunzi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://anunzi-ai.gitbook.io/anunzi-docs/api-widgets/trabajar-con-la-api-de-llamadas/assistants/list-assistants.md).

# Listar agentes

**GET**\
`https://api.anunzi.net/v2/assistants/`

Retrieve a paginated list of AI call assistants available in your Anunzi environment.

***

#### Query Parameters

| Parameter | Type   | Description                                              |
| --------- | ------ | -------------------------------------------------------- |
| `limit`   | int32  | Number of assistants displayed per page (default: `20`). |
| `offset`  | string | Starting point for listing assistants (default: `0`).    |

***

#### Example Request (cURL)

```bash
curl --request GET \
     --url 'https://api.anunzi.net/v2/assistants/?limit=1' \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer API_KEY'
```

***

#### Example Response (200 OK)

```json
{
  "status": "ok",
  "response": {
    "assistants": [
      {
        "model_id": "1726133933450x726464416010129300",
        "workspace_id": "1706297038990x776227155126255600",
        "type": "inbound",
        "name": "5idf orch",
        "description": "Manage incoming calls via phone, widget, Zapier, or GoHighLevel.",
        "phone_number": "+12345678901",
        "external_webhook_url": "",
        "is_recording": true,
        "agent": {
          "prompt": "Custom assistant script",
          "llm": "anunzi",
          "language": "en-US",
          "greeting_message": "Hey, you've called [company]. How may I assist you today?",
          "voice_id": "qZVyogWNtPPM0VPTPQQb",
          "voice_stability": 0.5,
          "voice_similarity_boost": 0.75,
          "voice_optimise_streaming_latency": 0,
          "voice_style": 0.0,
          "voice_use_speaker_boost": false,
          "voice_prompt": "",
          "allowed_idle_time_seconds": 15,
          "initial_pause_seconds": 0,
          "transcriber_keywords": [],
          "ring_pause_seconds": null,
          "patience_level": "low"
        },
        "max_duration": {
          "duration_seconds": 10,
          "is_enabled": false
        },
        "actions": [
          "1726133933800x19911334599928670",
          "1725621595471x41073123116789060",
          "1725993755979x75264904466697300"
        ]
      }
    ]
  }
}
```

***

#### Status Codes

| Code | Description                                 |
| ---- | ------------------------------------------- |
| 200  | Assistants retrieved successfully.          |
| 400  | Bad Request. Invalid or missing parameters. |
