# Inbound Call Summary Statistics

## <span style="color: rgb(2, 106, 73);">**API: inbound\_summary\_stats**</span>

### **Description**

This endpoint provides a summarized report of inbound call activity for a given date range, optionally filtered by tenant. It returns daily metrics including total calls, queued calls, abandoned calls (split by those that waited more than 20 seconds), handled calls, and average hold and handle times.

## 🔗 **URL**

#### https://**DOMAIN**.croco-dial.net/goAPIv2/goReports/goAPI.php

<p class="callout info align-left">**Note:** Replace `DOMAIN` with the specific domain you want to query.</p>

### **📝 Required Parameters**

<table border="1" id="bkmrk-parameter-value-desc" style="border-collapse: collapse; width: 100%; height: 149.934px;"><colgroup><col style="width: 23.0008%;"></col><col style="width: 28.0062%;"></col><col style="width: 48.9811%;"></col></colgroup><thead><tr style="height: 29.7167px;"><td style="height: 29.7167px;">**Parameter**</td><td style="height: 29.7167px;">**Value**</td><td style="height: 29.7167px;">**Description**</td></tr></thead><tbody><tr style="height: 29.7167px;"><td style="height: 29.7167px;">goAction</td><td style="height: 29.7167px;">**inbound\_summary\_stats**</td><td style="height: 29.7167px;">Action to perform. Name of endpoint</td></tr><tr style="height: 29.7167px;"><td style="height: 29.7167px;">goUser</td><td style="height: 29.7167px;">MyUser</td><td style="height: 29.7167px;">API authorized user.</td></tr><tr style="height: 29.7167px;"><td style="height: 29.7167px;">goPass</td><td style="height: 29.7167px;">MyPass</td><td style="height: 29.7167px;">Authorized user's password.</td></tr><tr><td style="height: 31.0667px;">responsetype</td><td style="height: 31.0667px;">json/xml</td><td style="height: 31.0667px;">Format of the response (`json` recommended).</td></tr></tbody></table>

### **Optional Parameters**

<table border="1" id="bkmrk-parameter-value-desc-1" style="border-collapse: collapse; width: 100%; height: 121.719px;"><colgroup><col style="width: 23.0036%;"></col><col style="width: 28.0095%;"></col><col style="width: 48.9869%;"></col></colgroup><thead><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Parameter**</td><td style="height: 29.7969px;">**Value**</td><td style="height: 29.7969px;">**Description**</td></tr></thead><tbody><tr style="height: 31.0625px;"><td style="height: 31.0625px;">fromDate</td><td style="height: 31.0625px;">`YYYY-MM-DD`</td><td style="height: 31.0625px;"><span class="_fadeIn_m1hgl_8">The </span><span class="_fadeIn_m1hgl_8">start </span><span class="_fadeIn_m1hgl_8">date </span><span class="_fadeIn_m1hgl_8">for </span><span class="_fadeIn_m1hgl_8">the </span><span class="_fadeIn_m1hgl_8">report.</span></td></tr><tr style="height: 31.0625px;"><td style="height: 31.0625px;">toDate</td><td style="height: 31.0625px;">`YYYY-MM-DD`</td><td style="height: 31.0625px;">The end date for the report.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">tenant</td><td style="height: 29.7969px;">\["AAA", "BBB"\]</td><td style="height: 29.7969px;">Array of tenant identifiers to restrict data.</td></tr></tbody></table>

**Note:** This endpoint uses body parameters for authentication instead of tokens or headers.

### **Request Examples:**

#### **GET:**

```bash
curl -X GET "https://DOMAIN.croco-dial.net/goAPIv2/goReports/goAPI.php?goAction=inbound_summary_stats&goUser=MyUser&goPass=MyPass&responsetype=json&fromDate=2025-05-25&toDate=2025-05-30"
```

#### **POST (Form Data)**

If you prefer to send the data as form parameters:

```bash
curl -X POST "https://DOMAIN.croco-dial.net/goAPIv2/goReports/goAPI.php" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "goAction=inbound_summary_stats" \
  --data-urlencode "goUser=MyUser" \
  --data-urlencode "goPass=MyPass" \
  --data-urlencode "responsetype=json" \
  --data-urlencode "tenant[]=TTY" \
  --data-urlencode "fromDate=2025-05-20" \
  --data-urlencode "toDate=2025-05-30"
```

####  **Example Response**

```json
{
    "result": "success",
    "data": {
        "rows": [
            {
                "calldate": "2025-05-28",
                "total_calls": "693",
                "queued_calls": "424",
                "abandon1": "38",
                "abandon2": "61",
                "handled_calls": "372",
                "avg_hold_time": "67.78",
                "avg_handle_time": "469.33"
            },
            {
                "calldate": "2025-05-29",
                "total_calls": "716",
                "queued_calls": "507",
                "abandon1": "42",
                "abandon2": "57",
                "handled_calls": "448",
                "avg_hold_time": "38.84",
                "avg_handle_time": "544.30"
            },
            {
                "calldate": "2025-05-30",
                "total_calls": "308",
                "queued_calls": "204",
                "abandon1": "54",
                "abandon2": "24",
                "handled_calls": "130",
                "avg_hold_time": "147.03",
                "avg_handle_time": "423.23"
            },
        ],
        "headers": [
           ...
        ]
    }
}
```

### <span class="_fadeIn_m1hgl_8">📌 </span>**<span class="_fadeIn_m1hgl_8">Response </span><span class="_fadeIn_m1hgl_8">Fields</span>**

<table border="1" id="bkmrk-field-description-ca" style="border-collapse: collapse; border-color: rgb(206, 212, 217); border-width: 1px;"><thead><tr><th style="border-color: rgb(206, 212, 217);">**Field**</th><th style="border-color: rgb(206, 212, 217);">**Description**</th></tr></thead><tbody><tr><td style="border-color: rgb(206, 212, 217);">`calldate`</td><td style="border-color: rgb(206, 212, 217);">The date of the call activity (`YYYY-MM-DD`).</td></tr><tr><td style="border-color: rgb(206, 212, 217);">`total_calls`</td><td style="border-color: rgb(206, 212, 217);">Total inbound calls received.</td></tr><tr><td style="border-color: rgb(206, 212, 217);">`queued_calls`</td><td style="border-color: rgb(206, 212, 217);">Calls that entered the queue.</td></tr><tr><td style="border-color: rgb(206, 212, 217);">`abandon1`</td><td style="border-color: rgb(206, 212, 217);">Calls abandoned *after* waiting more than 20 seconds.</td></tr><tr><td style="border-color: rgb(206, 212, 217);">`abandon2`</td><td style="border-color: rgb(206, 212, 217);">All abandoned calls, including those under 20 seconds.</td></tr><tr><td style="border-color: rgb(206, 212, 217);">`handled_calls`</td><td style="border-color: rgb(206, 212, 217);">Calls successfully answered by an agent.</td></tr><tr><td style="border-color: rgb(206, 212, 217);">`avg_hold_time`</td><td style="border-color: rgb(206, 212, 217);">Average hold time (in seconds).</td></tr><tr><td style="border-color: rgb(206, 212, 217);">`avg_handle_time`</td><td style="border-color: rgb(206, 212, 217);">Average handle time (in seconds).</td></tr></tbody></table>