Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Returns The GET v0/{accountKey}/calls/{callGuid} endpoint returns information about an active or completed call. Specify the required call in the query string parameter, callGuid. Use during the call or for up to 24 hours after the call.

Panel
borderColor#eeeeee
bgColorwhite
titleColorwhite
borderWidth1
titleBGColorblack
borderStylesolid
titleIn this page

Table of Contents

Insert excerpt
_ExcerptRequestSchemeExcerptAPICloud
_ExcerptRequestSchemeExcerptAPICloud
nopaneltrue

Request Uri

GET v{v#}/{accountKey}/calls/{callGuid}

Request Headers

Header Parameters

This endpoint requires the following headers:

Authorization (required)

This header requires an OAuth bearer token. For information on the bearer token, see How to use your bearer access token.

...

Accept 

application/json;version=3

Indicates that the media type required from the server is JavaScript Object Notation (JSON) client will accept a JSON response and that version 3 6 of the API should be used.

Examples

...

Request/Response Examples

Get call details for a valid call identifier - where the call failed

Code Block
languagepowershell
themeMidnight
curl -X GET "https://***.newvoicemedia.com/v0/a1b2c3d4e5/calls/94e5928c-7f7e-4645-ad72-61010f906449" 
-H "Authorization: Bearer <ACCESS_TOKEN>" 
-H "Accept: application/json; version=3"

Returns

...

HTTP

...

status

...

code

...

of

...

200,

...

containing

...

the

...

following

...

message.

...

Code Block
languagejs
themeMidnight
{
  "id": "94e5928c-7f7e-4645-ad72-61010f906449",

...


  "links": [

...


    {

...


      "href": "https://***.newvoicemedia.com/v0/a1b2c3d4e5/Calls/94e5928c-7f7e-4645-ad72-61010f906449",

...


      "rel": "_self"

...


    }

...


  ],

...


  "from": {

...


    "telephoneNumber": "02072068888",

...


    "agentId": "10"

...


  },

...


  "to": {

...


    "telephoneNumber": "02072068888"

...


  },

...


  "status": null,

...


  "recordingStatus": null,

...


  "result": {

...


    "code": "Failure",

...


    "party": "Originator",

...


    "reason": "NoAnswer"

...


  },

...


  "dispositionCode": "Wrong Number"

...


}

Get call details for a call with a specified Presented CLID

Code Block
languagepowershell
themeMidnight
curl -X 

...

GET "https://***.newvoicemedia.com/v0/a1b2c3d4e5/calls/94e5928c-7f7e-4645-ad72-61010f906449
-H "Authorization: Bearer <ACCESS_TOKEN>" 
-H "Accept: application/json;version=3"

Returns HTTP Status 200 and the following response:

Code Block
languagejs
themeMidnight
{

...


  "id": "94e5928c-7f7e-4645-ad72-61010f906449",

...


  "links": [

...


    {

...


      "href": "https://***.newvoicemedia.com/v0/a1b2c3d4e5/Calls/94e5928c-7f7e-4645-ad72-61010f906449",

...


      "rel": "_self"

...


    }

...


  ],

...


  "from": {

...


    "presentedCLID": "08008888888",

...


    "agentId": "10"

...


  },

...


  "to": {

...


    "telephoneNumber": "02072068888"

...


  },

...


  "status": null,

...


  "recordingStatus": null,

...


  "dispositionCode": "Sale"

...


...

}

Get call details for an invalid call identifier

Code Block
languagepowershell
themeMidnight
curl -X GET "https://***.newvoicemedia.com/v0/a1b2c3d4e5/calls/24e5948c-4f4e-6646-cd77-91010f903889" 
-H "Authorization: Bearer <ACCESS_TOKEN>" 
-H "Accept: application/json; version=3"

Returns HTTP status code of 404, containing the following message.

Code Block

...

languagejs
themeMidnight
{
 "message": "The requested resource was not found."

...


}

...

Possible response parameters:

  • status

...

  • Call status. Either "Active" or null if the call is disconnected.
  • recordingStatus

...

  • On an active call this can be "Started", "Stopped" or "Paused". This is null on an inactive call.
  • result

...

  • Included only when a call fault is recorded. 

      ...

        • code.

      ...

        •  Overall result. "Failure" or "Success".

      ...

        • party.

      ...

        •  Which party in the call raised the result."Originator" if the fault occurred requesting the call. "Recipient" if the destination triggered the fault.

      ...

        • reason.

      ...

        •  Reasons: "CallFailed", "CallRejected", "NoAnswer", "Normal", "NumberBusy", "NumberChanged", "Unknown".
      • dispositionCode

      ...

      • The disposition code set for the call. dispositionCode is null if no disposition code is set.