Skip to main content

​
Request

​
organization_id
integer
required
Your organization ID
​
api_key
string
required
Your organization API key
​
start_date
string
Start date for filtering calls (ISO 8601 format: YYYY-MM-DD)
​
end_date
string
End date for filtering calls (ISO 8601 format: YYYY-MM-DD)
​
agent_id
integer
Filter calls by specific agent ID
​
limit
integer
default:"100"
Maximum number of records to return (default: 100, max: 1000)
​
offset
integer
default:"0"
Number of records to skip for pagination

​
Examples

curl -X GET 'https://www.tabbly.io/dashboard/agents/endpoints/get-call-logs?organization_id=244&api_key=your_api_key&start_date=2025-01-01&end_date=2025-01-31&limit=50' \
-H 'Content-Type: application/json'

​
Response

​
success
boolean
Indicates if the request was successful
​
calls
array
Array of call log objects
​
total
integer
Total number of calls matching the filter criteria
​
limit
integer
Number of records returned in this response
​
offset
integer
Offset used for pagination

​
Call Log Object

​
call_id
string
Unique identifier for the call
​
agent_id
integer
ID of the agent used for the call
​
called_to
string
Destination phone number
​
call_from
string
Source phone number
​
call_duration
integer
Call duration in seconds
​
call_status
string
Status of the call (completed, failed, busy, no_answer)
​
call_outcome
string
Outcome of the call (appointment_scheduled, lead_qualified, etc.)
​
timestamp
string
Timestamp when the call was made (ISO 8601 format)
​
transcript
string
Full transcript of the call conversation
​
recording_url
string
URL to access the call recording (if available)

​
Success Response (200 OK)

{
    "success": true,
    "calls": [
        {
            "call_id": "call_123456",
            "agent_id": 33,
            "called_to": "+917359056097",
            "call_from": "+14156801215",
            "call_duration": 245,
            "call_status": "completed",
            "call_outcome": "appointment_scheduled",
            "timestamp": "2025-01-15T10:30:00Z",
            "transcript": "Agent: Hello...",
            "recording_url": "https://..."
        }
    ],
    "total": 150,
    "limit": 50,
    "offset": 0
}

​
Error Responses

​
400
object
Missing required fields or invalid parameters
​
404
object
Organization not found
​
500
object
Server error