v1

latestOpenAPI 3.0.02026-07-1494623.7 KB

Calls

Get detail of a specific call

get/{uuid}

Response

conversation_uuidstring uuid

The unique identifier for the conversation this call leg is part of.

direction'outbound' | 'inbound'

Possible values are outbound or inbound

durationstring

The time elapsed for the call to take place in seconds. This is only sent if status is completed.

end_timestring timestamp

The time the call started in the following format: YYYY-MM-DD HH:MM:SS. For xample, 2020-01-01 12:00:00. This is only sent if status is completed.

networkstring

The Mobile Country Code Mobile Network Code (MCCMNC) for the carrier network used to make this call. This is only sent if status is completed.

pricestring

The total price charged for this call. This is only sent if status is completed.

ratestring

The price per minute for this call. This is only sent if status is completed.

start_timestring timestamp

The time the call started in the following format: YYYY-MM-DD HH:MM:SS. For example, 2020-01-01 12:00:00. This is only sent if status is completed.

statusstring

The status of the call. See possible values

uuidstring uuid

The unique identifier for this call leg. The UUID is created when your call request is accepted by Vonage. You use the UUID in all requests for individual live calls

Example response

{
  "_links": {
    "self": {
      "href": "/calls/63f61863-4a51-4f6b-86e1-46edebcf9356"
    }
  },
  "conversation_uuid": "CON-f972836a-550f-45fa-956c-12a2ab5b7d22",
  "direction": "outbound",
  "duration": "60",
  "end_time": "2020-01-01 12:00:00",
  "from": {
    "number": "447700900001",
    "type": "phone"
  },
  "network": "65512",
  "price": "23.40",
  "rate": "0.39",
  "start_time": "2020-01-01 12:00:00",
  "status": "completed",
  "to": {
    "number": "447700900000",
    "type": "phone"
  },
  "uuid": "63f61863-4a51-4f6b-86e1-46edebcf9356"
}