Get Call Logs
Call Logs
Get Call Logs
Retrieve call history logs with filtering and pagination support
GET
Get Call Logs
Documentation Index
Fetch the complete documentation index at: https://docs.unpod.dev/llms.txt
Use this file to discover all available pages before exploring further.
Get Call Logs
Retrieve call history logs for your organization with support for filtering by date range, call type, call status, and pagination for efficient data retrieval.Prerequisites: Make sure you have your API Token and Org-Handle ready. See Authentication for details.
Headers
| Name | Type | Required | Description |
|---|---|---|---|
| Org-Handle | string | Yes | Organization domain handle |
| Authorization | string | Yes | API Key format: Token <token> |
You can get the
Org-Handle by hitting the Get All Organizations API. The domain_handle field in the response is your Org-Handle.Query Parameters
| 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 |
Response Fields
| 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 |
Call Log Object Fields
| 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) |
Common Error Codes
| 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 |
Code Examples
Best Practices
- Date Filtering: Always use
start_dateandend_dateto limit results to relevant time windows - Pagination: Use
pageandpage_sizefor large datasets to avoid timeouts - Call Status Filtering: Filter by
call_statusto focus on specific outcomes (completed, missed, failed) - Org-Handle: Ensure the correct organization handle is included — it determines which org’s logs are returned
- Duration Analysis: Use
call_durationto calculate average call durations and identify performance trends - Security: Keep API tokens secure and rotate them regularly
Authorizations
Format: Token
Headers
Organization domain handle
Example:
"unpod.tv"
Query Parameters
Example:
1
Example:
20
Example:
"2026-02-01"
Example:
"2026-02-07"
Available options:
inbound, outbound Example:
"outbound"
Available options:
completed, missed, failed Example:
"completed"
Response
List of call logs