List calls

GET

/calls

const url = 'https://api.talki.it/v1/calls?limit=25';
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?limit=25' \
  --header 'Authorization: Bearer <token>'

Authorizations

ApiKeyAuth

Parameters

Query Parameters

updated_after

string format: date-time

Return only calls modified at or after this instant. Combine with the cursor to recover missed webhooks.

cursor

string

Opaque cursor from the previous page.

limit

integer

default: 25 >= 1 <= 100

Responses

200

A page of calls.

application/json

object

data

required

Array<object>

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

has_more

required

boolean

next_cursor

string | null

Example

{
  "data": [
    {
      "id": "call_01J8XPLACEHOLDER",
      "caller_number": "+390454159729"
    }
  ]
}

403

The credential is valid but the account’s plan does not include API access.

application/json

object

code

required

string

message

required

string

request_id

required

Quote this when contacting support.

string

Example

{
  "code": "plan_upgrade_required",
  "message": "The Talki API requires the Business plan.",
  "request_id": "req_01J8XPLACEHOLDER"
}