Fetch CDR Details (Basic authentication)

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.

👍

Note:

Make sure the admin setting 'API Authentication' is set to 'BASIC_AUTH', If you are using this API.

Header parameters

ParameterDescription
apiKey*Your CloudAgent account API Key
Content-Typeapplication/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
  • 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/xxxxxxxx6567.mp3",
"CallDate": "2024-12-06",
"CallID": 31733467784618213,
"CallerConfAudioFile": "",
"CallerID": "504995",
"CampaignName": "xxxxxxxx",
"Comments": "",
"ConferenceDuration": "00:00:00",
"CustomerDialStatus": "answered",
"CustomerRingTime": "00:00:00",
"DID": "90050",
"DialOutName": "",
"DialStatus": "answered",
"DialedNumber": "500994",
"Disposition": "Wrap up time exceeded :1",
"Duration": "00:00:56",
"DynamicDID": "",
"E164": "+91504995",
"EndTime": "12:20:57",
"Event": "AgentDial",
"HandlingTime": "00:00:58",
"HangupBy": "UserHangup",
"HoldDuration": "00:00:00",
"Location": "Bangalore",
"PickupTime": "12:20:01",
"Rating": 0,
"RatingComments": "",
"Skill": "General",
"StartTime": "12:20:00",
"Status": "Answered",
"TalkTime": "00:00:56",
"TimeToAnswer": "00:00:01",
"TransferType": "",
"TransferredTo": "",
"Type": "InBound",
"UCID": 31xxxxxxxx8,
"UUI": "",
"WrapUpEndTime": "12:20:59",
"WrapUpStartTime": "12:20:57",
"WrapupDuration": "00:00:02"
}
][
{
"AgentDialStatus": "answered",
"AgentID": "xxxxx",
"AgentName": "xxxxx",
"CallAudio": "https://s3.ap-southeast-1.amazonaws.com/recordings.kookoo.in/demo_user/xxxxxxxx6567.mp3",
"CallDate": "2024-12-06",
"CallID": 31733467784618213,
"CallerConfAudioFile": "",
"CallerID": "504995",
"CampaignName": "xxxxxxxx",
"Comments": "",
"ConferenceDuration": "00:00:00",
"CustomerDialStatus": "answered",
"CustomerRingTime": "00:00:00",
"DID": "90050",
"DialOutName": "",
"DialStatus": "answered",
"DialedNumber": "500994",
"Disposition": "Wrap up time exceeded :1",
"Duration": "00:00:56",
"DynamicDID": "",
"E164": "+91504995",
"EndTime": "12:20:57",
"Event": "AgentDial",
"HandlingTime": "00:00:58",
"HangupBy": "UserHangup",
"HoldDuration": "00:00:00",
"Location": "Bangalore",
"PickupTime": "12:20:01",
"Rating": 0,
"RatingComments": "",
"Skill": "General",
"StartTime": "12:20:00",
"Status": "Answered",
"TalkTime": "00:00:56",
"TimeToAnswer": "00:00:01",
"TransferType": "",
"TransferredTo": "",
"Type": "InBound",
"UCID": 31xxxxxxxx8,
"UUI": "",
"WrapUpEndTime": "12:20:59",
"WrapUpStartTime": "12:20:57",
"WrapupDuration": "00:00:02"
}
],
"message": "success",
"status": "success"
}

Passing Invalid apiKey Key / Missing apiKey key

{"status": "false","message": "Missing userName or apiKey"}

Invalid apiKey Value / Missing apiKey Value

{"status": "false","message": "userName or apiKey is Invalid"}

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"}

Language
URL
Click Try It! to start a request and see the response here!