Calls Report

Overview

The Calls Report provides a raw log of calls, call metadata, and call recordings for voice interactions occurring in Talkdesk®.

Usage

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

📘
Calls Report metrics

Report Example

{
  "type": "calls",
  "version": "v1",
  "entries": [
    {
      "call_id": "17378a31cf7546d3acb9621f29a4e883",
      "callsid": "CA16eb3f3ac603f3856dd91e35c573aab4",
      "type": "outbound",
      "start_at": "2026-04-23T10:22:26Z",
      "end_at": "2026-04-23T10:22:50Z",
      "talkdesk_phone_number": "+12025550102",
      "talkdesk_phone_display_name": "support",
      "contact_phone_number": "+12025550103",
      "user_id": "67b3696b5b004334e155e996",
      "user_name": "Jordan Smith",
      "user_email": "[email protected]",
      "total_time": 24,
      "talk_time": 20,
      "wait_time": 0,
      "hold_time": 0,
      "abandon_time": 0,
      "total_ringing_time": 0,
      "disposition_code": "Attempting Contact",
      "notes": null,
      "user_voice_rating": 0,
      "ring_groups": "agents",
      "ivr_options": "",
      "is_in_business_hours": true,
      "is_callback_from_queue": false,
      "is_transfer": false,
      "handling_user_id": "6214d14c79c2f9152b3c5b36",
      "handling_user_name": "Sam Rivera",
      "handling_user_email": "[email protected]",
      "recording_url": "https://api.example.com/calls/17378a31cf7546d3acb9621f29a4e883/recordings",
      "is_external_transfer": false,
      "is_if_no_answer": false,
      "is_call_forwarding": false,
      "csat_score": null,
      "csat_survey_time": "",
      "team_id": "005488465d0e434298375f2e9769ceb3",
      "team_name": "Sales Team A",
      "rating_reason": "",
      "agent_disconnected": "No",
      "data_status": "Valid",
      "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,
      "disposition_set": "Outbound",
      "nested_disposition": "No Budget"
    }
  ],
  "total": 1
}

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

📘
Calls Report @ Explore API vs Reporting API Data Availability and Data Freshness
Regarding data freshness, the Calls Report used to have a data refresh of one hour. This has been improved in the Explore API: data is refreshed every minute.

Troubleshooting

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