Retrieve a call

GET

/calls/{call_id}

const url = 'https://api.talki.it/v1/calls/example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.talki.it/v1/calls/example \
  --header 'Authorization: Bearer <token>'

Authorizations

ApiKeyAuth

Parameters

Path Parameters

call_id

required

string

Responses

200

The call.

application/json

object

required

string

account_id

required

string

started_at

required

string format: date-time

ended_at

When the call tore down. May disagree with duration_seconds by a second or two — that is expected. duration_seconds is the billing source of truth; never derive it from these two timestamps.

string | null format: date-time

duration_seconds

required

integer

caller_number

string

summary

The agent’s summary of the conversation. Verbatim transcripts are never exposed.

string | null

Example

{
  "id": "call_01J8XPLACEHOLDER",
  "caller_number": "+390454159729"
}

404

No such call in this account.