Search CDRs

API Request Description

This endpoint allows you to retrieve call detail records (CDRs) by submitting a POST request to the specified URL. The request should be in x-www-form-urlencoded format, and it supports various parameters for filtering and sorting the CDRs.

• format: The format of the response.
  
• page: The number of the page.
  
• cdrs_per_page: The amount of CDRs per page.
  
• sort_by: Sort by field.
  
• sort_direction: Sort in ascending or descending order.
  
• from: From what date to search (Default value: yesterday at 00:00:00).
  
• till: Till what date to search (Default value: now).
  
• queue: Search by queue IDs (e.g., 10,20,30...).
  
• agent: Search by agent IDs (e.g., 10,20,30...).
  
• bridged_agent: Search by bridged agent IDs (e.g., 10,20,30...).
  
• country: Search by country's ISO2 (e.g., IL,UA,US...).
  
• direction: Search by call direction.
  
• call_type: Search by call type.
  
• destination: Search by destination number.
  
• source: Search by source number.
  
• extension: Search by call type.
  
• did: Search by DID.
  
• caller_id: Search by caller id number.
  
• hangup_cause: Search by hangup cause (e.g., ANSWERED,BUSY,NO_ANSWER ...).
  
• bill_duration_from: Filter the bill duration from (in seconds).
  
• successful: Show only successful calls.
  
• completed: Show only completed calls.
  
• transferred: Show only transferred calls.
  
• shift: Search by shift ID.
  
• by_shift_hour: Search by shift ID.
  
• uniqueid: Search by unique id.
  
• id: Search by id (e.g., 5698 | 5000-6000).
  
• {custom_field}: Filter by custom fields (Key -> field name, Value -> field value).
  

API Response (JSON Schema)

{
    "type": "object",
    "properties": {
        "cdrs": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "id": {"type": "string"},
                    "call_start": {"type": "string"},
                    "call_end": {"type": "string"},
                    "duration": {"type": "string"},
                    "bill_duration": {"type": "string"},
                    "type": {"type": "string"},
                    "destination": {"type": "string"},
                    "caller_id": {"type": "string"},
                    "country_name": {"type": "string"},
                    "agent_name": {"type": "string"},
                    "agent_pbxExtension": {"type": "string"},
                    "bridged_agent_name": {"type": "string"},
                    "bridged_agent_pbxExtension": {"type": "string"},
                    "hangup_cause": {"type": "string"},
                    "waiting_time": {"type": "string"},
                    "recording_link": {"type": "string"},
                    "queue_alias": {"type": "string"},
                    "queue_name": {"type": "string"},
                    "desks": {"type": "string"},
                    "custom_fields": {"type": "string"},
                    "cost": {"type": "string"}
                }
            }
        }
    }
}