Retrieve call history logs with filtering and pagination support
| Name | Type | Required | Description |
|---|---|---|---|
| Org-Handle | string | Yes | Organization domain handle |
| Authorization | string | Yes | API Key format: Token <token> |
Org-Handle by hitting the Get All Organizations API. The domain_handle field in the response is your Org-Handle.| Name | Type | Required | Description |
|---|---|---|---|
| page | integer | No | Page number for pagination (default = 1) |
| page_size | integer | No | Number of records per page (default = 20) |
| start_date | string | No | Filter calls from this date (ISO 8601 format) |
| end_date | string | No | Filter calls until this date (ISO 8601 format) |
| call_type | string | No | Filter by call direction: inbound or outbound |
| call_status | string | No | Filter by status: completed, missed, or failed |
| Field | Type | Description |
|---|---|---|
| count | integer | Total number of call logs |
| status_code | integer | HTTP status code |
| message | string | Response message |
| data | array | Array of call log objects |
| Field | Type | Description |
|---|---|---|
| source_number | string | The number that initiated the call |
| destination_number | string | The number that received the call |
| call_type | string | Direction of call: outbound, inbound |
| call_status | string | Outcome: completed, missed, failed |
| creation_time | string | Timestamp when the call was created/scheduled |
| start_time | string | Timestamp when the call was answered (null if missed) |
| end_time | string | Timestamp when the call ended (null if missed) |
| call_duration | integer | Duration of the call in seconds |
| end_reason | string | Reason the call ended (e.g., caller_hangup, no_answer) |
| Status Code | Description |
|---|---|
| 200 | Success - Call logs fetched successfully |
| 400 | Bad Request - Invalid filter parameters |
| 401 | Unauthorized - Invalid or missing API token |
| 403 | Forbidden - Invalid organization handle |
| 404 | Not Found - Organization not found |
| 500 | Internal Server Error - Server-side error |
start_date and end_date to limit results to relevant time windowspage and page_size for large datasets to avoid timeoutscall_status to focus on specific outcomes (completed, missed, failed)call_duration to calculate average call durations and identify performance trendsFormat: Token
Organization domain handle
"unpod"
1
20
inbound, outbound "outbound"
completed, failed, no-answer "completed"
List of call logs