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

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": "+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