> 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/calls/list-calls.md).

# Listar llamadas

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

Retrieve a paginated list of phone calls handled by an AI assistant.\
⚠️ **Important:** The `model_id` parameter is **mandatory** to ensure that only calls associated with a specific assistant are retrieved.

***

#### Query Parameters

| Parameter  | Type   | Required | Description                                                      |
| ---------- | ------ | -------- | ---------------------------------------------------------------- |
| `model_id` | string | Yes      | The calls for the specified assistant model ID will be returned. |
| `limit`    | int32  | No       | Number of calls displayed per page (default: `20`).              |
| `offset`   | string | No       | Starting point for listing calls (default: `0`).                 |

***

#### Example Request (cURL)

```bash
curl --request GET \
     --url 'https://api.anunzi.net/v2/calls?model_id=13213212213s121515156' \
     --header 'accept: text/plain' \
     --header 'Authorization: Bearer API_KEY'
```

***

#### Example Response (200 OK)

```json
{
  "status": "ok",
  "response": {
    "calls": [
      {
        "call_id": "1726573895974x902342426476519400",
        "model_id": "1726573550709x928456706859452600",
        "campaign_type": "Test",
        "phone_number_from": "+10987654321",
        "phone_number_to": "+12345678910",
        "name": "test",
        "transcript": "\nbot: Hey there Jorge\nhuman: Hello.\nbot: \"Hi, Eddie! \nbot: How are you today?\" \nhuman: Doing well. And you?\nbot: \"Great to hear! \nbot: I'm Nina from FineTuner. \"",
        "duration": 13,
        "recording_url": "https://api.twilio.com/2009-10-10/Accounts/ZGH020s34b80d81c432946r34f3c99941bf/Recordings/RE9ee05467410311202811f06205227138",
        "end_call_reason": "human_pick_up_cut_off"
      },
      {
        "call_id": "1726573595193x148017636249698300",
        "model_id": "1726573550572x928481606859452600",
        "campaign_type": "Test",
        "phone_number_from": "+10987654321",
        "phone_number_to": "+12345678910",
        "name": "test",
        "transcript": "\nbot: Hey there\nhuman: Hello.\nbot: Hi, Eddie! \nbot: How are you today? \nhuman: Good. And you?\nbot: Great to hear!",
        "duration": 11,
        "recording_url": "https://api.twilio.com/2009-10-10/Accounts/ZGH0293d4b80d81cf5g946r34f3c99941bf/Recordings/RE9ee05467410311202811f06205227138",
        "end_call_reason": "human_pick_up_cut_off"
      }
    ]
  }
}
```

***

#### Response Fields

| Field               | Type   | Description                                                               |
| ------------------- | ------ | ------------------------------------------------------------------------- |
| `call_id`           | string | Unique identifier for the call.                                           |
| `model_id`          | string | ID of the assistant handling the call.                                    |
| `campaign_type`     | string | Type of call (e.g., "Inbound", "Outbound", "Test").                       |
| `phone_number_from` | string | The caller's phone number.                                                |
| `phone_number_to`   | string | The number that was dialed.                                               |
| `name`              | string | Name of the person called (if available).                                 |
| `transcript`        | string | The full conversation transcript between the assistant and the user.      |
| `duration`          | int    | Duration of the call in seconds.                                          |
| `recording_url`     | string | URL to access the audio recording of the call (if recording was enabled). |
| `end_call_reason`   | string | Reason why the call ended.                                                |

***

#### Status Codes

| Code | Description                                          |
| ---- | ---------------------------------------------------- |
| 200  | Calls retrieved successfully.                        |
| 400  | Bad Request. Missing `model_id` or other parameters. |