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-v2

Authentication

All requests require a valid API key associated with your organization.

Required Parameters

Parameter	Type	Description
api_key	string	Your organization's API key for authentication
organization_id	string	The ID of your organization

Optional Parameters

Parameter	Type	Description
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": "[phone]",
      "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://tabblyrecordings.sfo3.cdn.digitaloceanspaces.com/merged-YW4zUAhSB8oxkwccccNT3Dt5.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