Call v2 GET

Call v2 GET
GET /api/v2/call/{id}

Retrieve detailed information for a single call.

Result Code

200

OK

401

Unauthorized

404

Call not found

406

SSL must be used

500

Server Error

 

Result Body

idThe unique call id. This will be needed when calling other api functions.
startdatetimeThe time that the call began. The time is reported in the timezone configured for the authenticated user.
startdatetimeutcThe time that the call began. The time is reported as UTC.
typeThe type of call. Either ‘recorded’, ‘discarded’, ‘unanswered’ or ‘uploading’.
typediscardedreasonIf the call was discarded, an explanation of the reason.
answerdelaymsIf the call was recorded, the delay in milliseconds between ringing and answer.
directionThe direction of the call. Either ‘incoming’, ‘outgoing’, ‘internal’ or ‘unknown’.
durationsecondsThe duration of the call in seconds.
caller
phonenumberThe caller party phone number.
nameThe caller name.
macaddressThe MAC address of the caller device.
mediaendpointThe IP address/port of the caller audio stream.
sentimentanalysisThe sentiment analysis of the caller. Either ‘unknown’, ‘positive’, neutral’ or ‘negative’.
destination
phonenumberThe destination party phone number.
nameThe destination name.
macaddressThe MAC address of the destination device.
mediaendpointThe IP address/port of the destination audio stream.
sentimentanalysisThe sentiment analysis of the destination. Either ‘unknown’, ‘positive’, neutral’ or ‘negative’.
subjectThe subject of the call.
ratingThe rating of the call. Values are in the range of 0 – 5.
tagsAn array of selected tags.
audiourlA url containing the location of the audio.
audiocontenttypeThe mime content type of the audio. e.g. ‘audio/mpeg’ or ‘audio/wav’.
audiolengthbytesThe length of the audio recording in bytes.
audiomd5hashThe md5 hash of the call audio. This can be used to compare a reproduction at a later time for authenticity.

 

 

Example request

Example;-
GET
https://api.calln.com/api/v2/call/32155584

Result;-
200 (OK)

{"id":32155584,"startdatetimeutc":"2017-04-11 5:41:30","startdatetime":"2017-04-11 15:41:30","type":"recorded","typediscardedreason":"","answerdelayms":4688,"direction":"incoming","durationseconds":188,"caller":{"phonenumber":"0401111111","name":"Finance Incoming Call","macaddress":"843DC621FA44","mediaendpoint":"","keypresses":[],"sentimentanalysis":"unknown"},"destination":{"phonenumber":"0393196600","name":"Lee Smart","macaddress":"0004F2BEA5B4","mediaendpoint":"","keypresses":[],"sentimentanalysis":"unknown"},"subject":"","rating":0,"tags":[],"audiourl":"https://api.calln.com/api/v2/callaudio/32155584","audiocontenttype":"audio/mpeg","audiolengthbytes":565531,"audiomd5hash":"fa2b36223f6b6364f5b7aa8b6c37a226"}

Using Curl

curl "https://api.calln.com/api/v2/call/{callid}" -H "Authorization: Basic username:password | base64" -X GET 

Calculate your CallN Costs in 60 Seconds

  • Accurate details are needed in order to use the right pricing tier information.
  • The calculator will give you the total cost of the plan according to the total months you specify
  • Accurate details are needed in order to use the right pricing tier information.
  • The calculator will give you the total cost of the plan according to the total months you specify
  • After you sign up, this will be used for your Calln domain.
  • A Team member will contact you on this number.
  • A summary of your calculations will be sent to this email address.
  • You may review our terms and conditions and privacy policies by clicking on the links above.