Get a call

GET a call details from a specific voice channel.

Get channel call

Get a channel call

GET/workspaces/{workspaceId}/channels/{channelId}/calls/{callId}
Authorization
Path parameters
workspaceId*string (uuid)

The ID of the workspace

callId*string (uuid)

The ID for a call

channelId*string (uuid)

The ID for a channel

Response

OK

Body
id*Id-2 (string (uuid))
channelId*ChannelId (string (uuid))
from*string
to*string
originator*ChannelCallOriginatorOrReceiver
receiver*ChannelCallOriginatorOrReceiver
parentIdId-2 (string (uuid))
direction*Direction (enum)
incomingoutgoing
status*Status-4 (enum)
acceptedstartingringingongoingcompletedno-answerbusyfailedcancelledscheduled
reasonstring
type*Type-2 (enum)
pstnsipwebrtc
durationinteger
hangupCauseCodeinteger
hangupSourcenullable HangupSource (enum)
calleecallerapitimeoutmedia-timeoutnone
hangupSipCodestring
createdAt*string (date-time)
updatedAt*string (date-time)
ringingAtstring (date-time)
answeredAtstring (date-time)
endedAtstring (date-time)
scheduledForstring (date-time)
callFlowCallFlow
notificationCallNotification
qualityInsightsqualityInsights
sipInsightssignallingInsights
amdResultAmdResult
sipTypeSIPType (enum)
elasticbyocforward
tagsTags-2 (array of Name-3 (string))

Tags to associate with the call. Tags are converted to lower case and tags that do not exist are automatically created. You can view your created tags in the UI. You can specify up to 10 tags per call.

Request
const response = await fetch('/workspaces/{workspaceId}/channels/{channelId}/calls/{callId}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer jwt"
    },
});
const data = await response.json();
Response
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "channelId": "123e4567-e89b-12d3-a456-426614174000",
  "from": "text",
  "to": "text",
  "originator": {
    "contact": {
      "id": "text",
      "identifierKey": "text",
      "identifierValue": "text"
    },
    "number": {
      "type": "pstn",
      "number": "text",
      "anonymous": false,
      "callerIdName": "text",
      "identity": "text",
      "countryIsoCode": "text",
      "pstnNumberType": "text"
    }
  },
  "receiver": {
    "contact": {
      "id": "text",
      "identifierKey": "text",
      "identifierValue": "text"
    },
    "number": {
      "type": "pstn",
      "number": "text",
      "anonymous": false,
      "callerIdName": "text",
      "identity": "text",
      "countryIsoCode": "text",
      "pstnNumberType": "text"
    }
  },
  "parentId": "123e4567-e89b-12d3-a456-426614174000",
  "direction": "incoming",
  "status": "accepted",
  "reason": "text",
  "type": "pstn",
  "duration": 0,
  "hangupCauseCode": 0,
  "hangupSource": "callee",
  "hangupSipCode": "text",
  "createdAt": "2024-12-21T11:38:16.981Z",
  "updatedAt": "2024-12-21T11:38:16.981Z",
  "ringingAt": "2024-12-21T11:38:16.981Z",
  "answeredAt": "2024-12-21T11:38:16.981Z",
  "endedAt": "2024-12-21T11:38:16.981Z",
  "scheduledFor": "2024-12-21T11:38:16.981Z",
  "callFlow": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "commands": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "callId": "123e4567-e89b-12d3-a456-426614174000",
        "callFlowId": "123e4567-e89b-12d3-a456-426614174000",
        "status": "text",
        "command": "text"
      }
    ]
  },
  "notification": {
    "url": "text"
  },
  "qualityInsights": {
    "mos": "text",
    "pdd": "text"
  },
  "sipInsights": {
    "hangupSipCode": "text",
    "edgeRegion": "text",
    "providerName": "text",
    "userAgent": "text",
    "remoteSignallingIp": "text",
    "remoteMediaIp": "text"
  },
  "amdResult": {
    "result": "human",
    "speech": "text",
    "locale": "text"
  },
  "sipType": "elastic",
  "tags": [
    "text"
  ]
}

Example 1: Get a call from a workspace and a channel

curl "/workspaces/{workspaceId}/channels/{channelId}/calls/{channelId}" \
     -H 'Authorization: Bearer {Token}'

Last updated