Use this API to retrieve Call Detail Records (Detailed View) for any specific day within the past 15 days from the time of the request, based on the Unique Call ID (UCID).

📘
APIs Domain Name
For domestic ccaas - enter the domain: in1-ccaas-api.ozonetel.com
For international ccaas - enter the domain: api.ccaas.ozonetel.com
For Partners - enter the respective URL

👍
Note:
This API supports both GET and POST request methods.

To use this API with the help of a token, follow these steps:

Generate the Token: Use the 'Generate Token' API to obtain an authentication token.
Enter the Token ID: Navigate to the right section of this page, under the 'AUTHORIZATION' tab. Here, input the generated token ID.
With the token entered, pass the below header and body parameters:

Header parameters

Parameter	Description
Content-Type	application/json

Body Params

Pass the body params in the format:

{
"fromDate": "YYYY-MM-DD HH:MM:SS",
"toDate": "YYYY-MM-DD HH:MM:SS",
"userName": "xxxx",
"ucid": "123",
"campaignName": "xxxxxxxxx",
"monitorUCID": "17xxxxxxx9372",
"callType": "Progressive",
"status": "NotAnswered"
}

❗️
Note:

Mandatory Parameters are:

fromDate

toDate

username

ucid

Rate limit: Maximum of 2 requests per minute.

The API provides data for a single day within the last 15 days from the time of the request.

Possible responses


Success Response	{ "details": [ { "AgentDialStatus": "answered", "AgentID": "xxxxx", "AgentName": "xxxxx", "CallAudio": "https://s3.ap-southeast-1.amazonaws.com/recordings.kookoo.in/demo_user/xxxxxxxx.mp3", "CallDate": "2024-12-06", "CallID": 35133465203835951, "CallerConfAudioFile": "", "CallerID": "+918xxxxxxx2", "CampaignName": "Inbound_919xxxxxx01", "Comments": "", "ConferenceDuration": "00:00:00", "CustomerDialStatus": "answered", "CustomerRingTime": "00:00:00", "DID": "919xxxxxx01", "DialOutName": "", "DialStatus": "answered", "DialedNumber": "98xxxxxx1", "Disposition": "", "Duration": "00:00:03", "DynamicDID": "", "E164": "+91807xxxxxxx2", "EndTime": "11:37:12", "Event": "AgentDial", "HandlingTime": null, "HangupBy": "AgentHangup", "HoldDuration": "00:00:00", "Location": "Hyd", "PickupTime": "11:37:09", "Rating": 0, "RatingComments": "", "Skill": "offline_hyd", "StartTime": "11:36:52", "Status": "Answered", "TalkTime": "00:00:03", "TimeToAnswer": "00:00:17", "TransferType": "", "TransferredTo": "", "Type": "InBound", "UCID": 35xxxxxxxxxxxxx4, "UUI": "Hyderabad", "WrapUpEndTime": null, "WrapUpStartTime": null, "WrapupDuration": null } ][ { "AgentDialStatus": "answered", "AgentID": "xxxxx", "AgentName": "xxxxx", "CallAudio": "https://s3.ap-southeast-1.amazonaws.com/recordings.kookoo.in/demo_user/xxxxxxxx.mp3", "CallDate": "2024-12-06", "CallID": 35133465203835951, "CallerConfAudioFile": "", "CallerID": "+918xxxxxxx2", "CampaignName": "Inbound_919xxxxxx01", "Comments": "", "ConferenceDuration": "00:00:00", "CustomerDialStatus": "answered", "CustomerRingTime": "00:00:00", "DID": "919xxxxxx01", "DialOutName": "", "DialStatus": "answered", "DialedNumber": "98xxxxxx1", "Disposition": "", "Duration": "00:00:03", "DynamicDID": "", "E164": "+91807xxxxxxx2", "EndTime": "11:37:12", "Event": "AgentDial", "HandlingTime": null, "HangupBy": "AgentHangup", "HoldDuration": "00:00:00", "Location": "Hyd", "PickupTime": "11:37:09", "Rating": 0, "RatingComments": "", "Skill": "offline_hyd", "StartTime": "11:36:52", "Status": "Answered", "TalkTime": "00:00:03", "TimeToAnswer": "00:00:17", "TransferType": "", "TransferredTo": "", "Type": "InBound", "UCID": 35xxxxxxxxxxxxx4, "UUI": "Hyderabad", "WrapUpEndTime": null, "WrapUpStartTime": null, "WrapupDuration": null } ], "message": "success", "status": "success" }
if Token Expired	"{ ""status"": ""false"", ""message"": ""Token Expired"", ""data"": null }"
Invalid userName Key/ Missing userName key / Missing userName Value	{"status": "false","message": "Missing userName or apiKey"}
Invalid userName Value	{"status": "false","message": "userName or apiKey is Invalid"}
Invalid fromDate Key / Missing fromDate key / Missing fromDate Value / Invalid toDate Key / Missing toDate key / Missing toDate Value	{"message": "Missing fromDate and toDate","status": "fail"} {"message": "Missing fromDate and toDate","status": "fail"}
Invalid fromDate Value / Invalid toDate Value	{"message": "Invalid fromDate format. Please pass the date in the format yyyy-MM-dd HH:mm:ss","status": "fail"}
Invalid campaignName	"{""message"": ""Invalid campaignName"", ""status"": ""fail""}"
If future dates passed	{"message": "fromDate and toDate should not be future dates","status": "fail"}
When passed a range of dates Like FromDate: 2024-09-01 toDate : 2024-09-10	{"message": "fromDate and toDate should be same date","status": "fail"}
When more than 2 hits per minute are made	{"message": "API rate limit has been exceeded","status": "error"}
When passed invalid or wrong JSON.	{"status": "false","message": "Invalid Json Pass Valid Json"}