Explore Calls Report

Overview

The Explore Calls Report provides a raw log of calls, call metadata, and call recordings for voice interactions occurring in Talkdesk®. This report shows the same data as the Explore UI Default Report Calls.

Usage

Specify the explore_calls type in the Explore API path: /data/reports/explore_calls/jobs

📘
Explore Calls Report metrics

🚧
Knowledge Base Article
API Explore Calls Report: Overview

Report Example

Note: The current payload structure remains valid until May 11, 2026. The changes described in this article will apply to all requests made on or after May 11, 2026.

{
    "entries":
    [
        {
            "interaction_id": "74458c259bc04bf1988697e3c5623ae2",
            "call_type": "inbound",
            "start_time": "2022-06-30 16:42:24",
            "end_time": "2022-06-30 16:42:38",
            "talkdesk_phone_number": "+14704678413",
            "customer_phone_number": "+17753827775",
            "talk_time": 0.000069444446,
            "record": "/recordings/cads13d23123asdfa413",
            "hangup": "disconnected",
            "in_business_hours?": "TRUE",
            "callback_from_queue?": "FALSE",
            "waiting_time": 0.00005787037,
            "agent_speed_to_answer": 0.000046296296,
            "holding_time": 0.0,
            "rating": 2,
            "description": "They were not interested",
            "agent_name": "Alice Eve",
            "phone_display_name": "support",
            "disposition_code": "Not Interested",
            "transfer?": "No",
            "handling_agent": "Mark Jones",
            "tags": "agents+rg1",
            "ivr_options": "1,2,1",
            "csat_score": 1,
            "csat_survey_time": "2022-06-30 16:44:40",
            "team": "Team 2",
            "rating_reason": "dasdfdfsf",
            "agent_disconnected": "Yes"
        }   
    ],
    "total": 1
}

See below the updated JSON payload, effective May 11, 2026.

{
    "interaction_id": "a0c2e9d3b1475f68c7d9a1b2c3d4e5f6",
    "call_type": "outbound",
    "start_time": "2025-10-09 16:59:52",
    "end_time": "2025-10-09 17:00:01",
    "talkdesk_phone_number": "+12125550100",
    "customer_phone_number": "+14085550101",
    "talk_time": 8.1018516E-5,
    "record": "https://data.fauxdesk.com/interactions/a0c2e9d3b1475f68c7d9a1b2c3d4e5f6/recordings/0.mp3",
    "hangup": "disconnected",
    "in_business_hours?": "TRUE",
    "callback_from_queue?": "FALSE",
    "waiting_time": null,
    "agent_speed_to_answer": null,
    "holding_time": 0.0,
    "rating": null,
    "description": null,
    "agent_name": "Alex Johnson",
    "phone_display_name": "alex-j",
    "disposition_code": null,
    "transfer?": "No",
    "handling_agent": null,
    "tags": "alex johnson, outbound",
    "ivr_options": "",
    "csat_score": null,
    "csat_survey_time": null,
    "team": "APAC_Support_Tier1",
    "rating_reason": "",
    "agent_disconnected": "No",
    "data_status": "Valid",
    "disposition_set": null,
    "nested_disposition": "",
    "int_custom_field_n1": null,
    "int_custom_field_n2": null,
    "float_custom_field_n1": null,
    "float_custom_field_n2": null,
    "text_custom_field_n1": null,
    "text_custom_field_n2": null,
    "text_custom_field_n3": null,
    "text_custom_field_n4": null,
    "timestamp_custom_field_n1": null
}

❗️
Data and Report Availability
Up to a month of data per request.
There are no limits on the data availability regarding timeframe.

Troubleshooting

If you have questions or technical issues, please open a ticket using this form.