GET - Get a call log
 

Purpose

Use this API to get a single call log.

 

Authorization

HeaderKey

Description

Authorization*

Zoho-oauthtoken<space><ACCESS_TOKEN>

Accept*

Set to application/json.

Request URL

Method: GET

https://voice.zoho.com/rest/json/zv/logs/{logId}

Scope: ZohoVoice.call.READ

Parameters:

Param Name

Data Type

Description

uuid*

String

Represents the log ID of the call log.


Example: 4031966c-2252-4d91-9e18-fae1eb18b4d4

Sample Request

Copiedcurl --location \
'https://voice.zoho.com/rest/json/zv/logs/4031966c-2252-4d91-9e18-fae1eb18b4d4' \

Sample Response - Success

Copied{
  "meta": {
    "total": 2
  },
  "logs": [
    {
      "answer_time": "1764831299000",
      "sip_hangup_disposition": "send_bye",
      "agent_number": "John",
      "number_id": "198000002125031",
      "isBlocked": false,
      "did_number": "+1 2342316236",
      "destination_name": "Telnyx",
      "hangup_cause_displayname": "Successful call",
      "duration": "00:54",
      "caller_id_number": "+1 7208914892",
      "zsoid": "862937118",
      "department": "zohotest",
      "call_type": "incoming",
      "caller_id_name": "Zoho",
      "destination_number": "+1 2342316236",
      "call_recording_transcription_status": "not_initiated",
      "end_time": "1764831353000",
      "is_test_call": false,
      "user_number": "+1 7208914892",
      "disconnected_by": "agent",
      "start_time": "1764831298000",
      "hangup_cause_description": "Call was accepted by the user and got connected successfully.",
      "bridged_agent": {
        "agent": "John",
        "domain": "voice.zoho.com",
        "time": "1764831302000",
        "uuid": "62d0b713-caaf-455d-8579-a7ff950502fb",
        "user_agent": "web"
      },
      "voice_credits": {
        "voice": 0,
        "free_minutes": 1,
        "total": 0
      },
      "voicemail_read_by": false,
      "service": 58399000000003016,
      "logid": "c3d87e71-70bc-4ebd-a1d1-b625b2d0848f",
      "hangup_cause": "NORMAL_CLEARING"
    },
    {
      "answer_time": "1764831273000",
      "sip_hangup_disposition": "send_bye",
      "agent_number": "John",
      "number_id": "198000002125031",
      "isBlocked": false,
      "did_number": "+1 2342316236",
      "hangup_cause_displayname": "Successful call",
      "duration": "00:16",
      "caller_id_number": "+1 2342316236",
      "zsoid": "862937118",
      "department": "zohotest",
      "call_type": "outgoing",
      "caller_id_name": "Telnyx",
      "destination_number": "+1 3026012351",
      "call_recording_transcription_status": "not_initiated",
      "end_time": "1764831289000",
      "is_test_call": false,
      "user_number": "+1 3026012351",
      "disconnected_by": "agent",
      "start_time": "1764831272000",
      "hangup_cause_description": "Call was accepted by the user and got connected successfully.",
      "voice_credits": {
        "voice": 0,
        "free_minutes": 1,
        "total": 0
      },
      "voicemail_read_by": false,
      "service": 58399000000003016,
      "logid": "ce723535-bdf2-4fd3-b9bd-870e9d12988c",
      "hangup_cause": "NORMAL_CLEARING"
    }
  ],
  "status": "200"
}

Sample Response - Error

Copied{
  "code": "ZVT010",
  "message": "Extra parameter found.",
  "status": "ERROR"
}