Get Call Logs
This API endpoint allows you to retrieve call logs for your organization. It provides flexible filtering options and pagination to help you access the specific data you need.
Endpoint
GET https://www.tabbly.io/dashboard/agents/endpoints/call-logs
Authentication
All requests require a valid API key associated with your organization.
Required Parameters
api_key
string
Your organization's API key for authentication
organization_id
string
The ID of your organization
Optional Parameters
date_from
string
Start date for filtering records (format: YYYY-MM-DD)
date_to
string
End date for filtering records (format: YYYY-MM-DD)
call_status
string
Filter by call status (e.g., "call answered", "voicemail")
campaign_id
string
Filter by specific campaign ID
use_agent_id
string
Filter by agent ID
limit
integer
Maximum number of records to return (default: 100)
offset
integer
Number of records to skip for pagination (default: 0)
Response Format
The API returns data in JSON format.
Success Response
jsonCopy{
"status": "success",
"message": "Call logs retrieved successfully",
"total_records": 150,
"filtered_records": 50,
"page_size": 50,
"page_offset": 0,
"data": [
{
"id": "123",
"called_to": "+15551234567",
"use_agent_id": "45123",
"called_time": "2025-03-12 14:30:00",
"organization_id": "org_xyz789",
"called_by_account": "account_123",
"campaign_id": "campaign_456",
"call_recording": "https://tabbly.io/recordings/call123.mp3",
"call_duration": "245",
"call_sentiment": "positive",
"call_transcript": "Transcript of the call...",
"call_json_output": "{\"key\":\"value\"}",
"call_summary": "Summary of the call...",
"call_status": "completed",
"telco_pricing": "0.015",
"agent_minute_price": "0.08",
"total_call_cost": "0.98"
},
// Additional records...
]
}
Error Responses
Missing Required Parameters
jsonCopy{
"status": "error",
"message": "API key and organization ID are required"
}
Invalid API Key
jsonCopy{
"status": "error",
"message": "Invalid API key"
}
Invalid Date Format
jsonCopy{
"status": "error",
"message": "Invalid date_from format. Use YYYY-MM-DD"
}
Database Connection Error
jsonCopy{
"status": "error",
"message": "Database connection failed"
}
Example Requests
Basic Request (Latest 100 Call Logs)
GET https://www.tabbly.io/dashboard/agents/endpoints/call-logs?api_key=YOUR_API_KEY&organization_id=YOUR_ORG_ID
Filtered Request (Date Range and Status)
GET https://www.tabbly.io/dashboard/agents/endpoints/call-logs?api_key=YOUR_API_KEY&organization_id=YOUR_ORG_ID&date_from=2025-01-01&date_to=2025-03-14&call_status=completed
Paginated Request (50 Records, Page 2)
GET https://www.tabbly.io/dashboard/agents/endpoints/call-logs?api_key=YOUR_API_KEY&organization_id=YOUR_ORG_ID&limit=50&offset=50
Notes
Results are sorted by ID in descending order (newest first)
For large datasets, use the pagination parameters to improve performance
Last updated