Read one transfer of a Call with its context note

GET /v1/calls/{call_id}/transfers/{transfer_id}

Answers one transfer attempt of a finalized Call (1.50.0, FR-telephony-6): its destination key, source, outcome and instants, and the context note the Agent wrote before the REFER. The note is content, redacted like the transcript's final text, so the route needs transcripts:read and every read is an audited content read. The transfer_id is the one the Call events of the transfer family carry; a transfer of a Call that is not finalized yet answers not_found.

Request

Set VOCAL_API to the base URL of your API and VOCAL_API_KEY to an API key with the transcripts:read scope (Authentication and keys). Replace each placeholder, such as agt_... or <name>, with your own value.

curl "$VOCAL_API/v1/calls/call_.../transfers/xfr_..." \
  -H "Authorization: Bearer $VOCAL_API_KEY"

const response = await fetch(`${process.env.VOCAL_API}/v1/calls/call_.../transfers/xfr_...`, {
  headers: {
    Authorization: `Bearer ${process.env.VOCAL_API_KEY}`,
  },
});
console.log(response.status, await response.text());

import os

import requests

response = requests.get(
    f"{os.environ['VOCAL_API']}/v1/calls/call_.../transfers/xfr_...",
    headers={
        "Authorization": f"Bearer {os.environ['VOCAL_API_KEY']}",
    },
)
print(response.status_code, response.text)

Parameters

Responses

Fields of the 200 answer

The shape is CallTransfer.