---
title: "Inbound calls per dialed number and number label"
description: "Inbound calls grouped by the workspace number that was dialed and that number's label (Settings → Contact Center → Inbound numbers). Counts calls the platform recorded: team or built-in Voice AI calls by Twilio call ID, and Voice AI provider calls by provider call ID. Integration-reported rows without a verifiable call ID are returned separately as `unverified` and are never added to `calls`. A label stamped when the call came in is kept; other calls use the number's current label. Workspace admins and owners only; agents receive 403. Reads pre-computed facts refreshed every 2 hours (7:45 AM–9:45 PM ET) and nightly. `verifiedBookings` counts non-deleted appointments with an exact saved call ID, grouped by inbound call time. Reschedules count once; later cancellations remain included. Bookings without an exact link are excluded. No conversion rate is inferred.\n"
---

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

Path: Channel Automation API › Analytics

`GET /api/analytics/inbound-calls-by-number`

Inbound calls grouped by the workspace number that was dialed and that number's label (Settings → Contact Center → Inbound numbers). Counts calls the platform recorded: team or built-in Voice AI calls by Twilio call ID, and Voice AI provider calls by provider call ID. Integration-reported rows without a verifiable call ID are returned separately as `unverified` and are never added to `calls`. A label stamped when the call came in is kept; other calls use the number's current label. Workspace admins and owners only; agents receive 403. Reads pre-computed facts refreshed every 2 hours (7:45 AM–9:45 PM ET) and nightly. `verifiedBookings` counts non-deleted appointments with an exact saved call ID, grouped by inbound call time. Reschedules count once; later cancellations remain included. Bookings without an exact link are excluded. No conversion rate is inferred.

## Query parameters

- `workspace_id` (`get/api/analytics/inbound-calls-by-number.query.workspace_id`; string, optional)
- `fromDate` (`get/api/analytics/inbound-calls-by-number.query.fromDate`; string, optional) — Inclusive start instant (viewer-local day start, ISO 8601).
  - format `date-time`
- `toDate` (`get/api/analytics/inbound-calls-by-number.query.toDate`; string, optional) — Exclusive end instant (ISO 8601). Range up to 400 days.
  - format `date-time`

## Code samples

### cURL

```bash
curl --request GET \
  --url https://api.channelautomation.com/api/analytics/inbound-calls-by-number
```

### TypeScript

```typescript
const url = 'https://api.channelautomation.com/api/analytics/inbound-calls-by-number';
const options = {method: 'GET'};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.channelautomation.com/api/analytics/inbound-calls-by-number"

response = requests.get(url)

print(response.text)
```

## Responses

### 200

`{ success, data }`. `data.available=false` with a `reason` when the report is not deployed or temporarily unavailable. Otherwise `data` has `totals`, `byNumber[]`, `byLabel[]`, `unknownNumber`, `numbersWithNoCalls[]`, `numbersRoutedElsewhere`, `labeledNumbersRoutedElsewhere` and `lastRefreshedAt`. `verifiedBookingsAvailable` is false before the first booking-aware refresh; booking values are then null. When true, `totals`, each line/label row and `unknownNumber` include `verifiedBookings`.

### 400

Missing workspace or invalid date range.

### 401

Authentication required

#### Example

```json
{
  "error": "Authentication required",
  "success": false
}
```

- `error` (`get/api/analytics/inbound-calls-by-number.response.401.error`; string, optional)
  - example `"Authentication required"`
- `success` (`get/api/analytics/inbound-calls-by-number.response.401.success`; boolean, optional)
  - example `false`

### 403

Not a workspace admin or owner, or a different workspace was requested.


Source: https://developer.channelautomations.com/api/get-api-analytics-inbound-calls-by-number/index.md