Call logs

Read-only records of the voice calls your assistants handled.

Call logs are the record of voice calls answered by your voice integrations. Each log captures who called, a summary, how long it lasted, and what it cost — and, per call, the full transcript. Call logs are read-only: they are produced by the platform as calls happen; there is no create, update, or delete.

Logs are scoped to the account in X-Account-Id.

Listing call logs

GET /v1/call-logs

Returns the account’s calls, newest first. Optional query filters narrow the results (an unknown filter value simply returns nothing rather than erroring):

FilterEffect
organizationIdOnly calls for workspaces in this organization.
workspaceIdOnly calls for this workspace.
after / beforeRestrict to a time range.
limit / offsetPage through the results.

Each row contains:

FieldMeaning
idThe call id — also how you address the detail route below.
customerNumberThe caller’s phone number.
summaryAn auto-generated summary of the call.
durationSecondsCall length in seconds.
costCost breakdown: total, speechToText, languageModel, textToSpeech, platform.
workspaceIdThe workspace that handled the call.
assistantThe underlying assistant id, included only when present.
createdAtWhen the call took place.

Any numeric field can be null when the call legitimately has no value for it.

Getting a single call

GET /v1/call-logs/{callId}

Returns the same fields as the list row, plus the live transcript fetched at request time.

The turn-by-turn messages array can be large, so it is omitted by default. Request it explicitly:

GET /v1/call-logs/{callId}?include=messages

transcript and messages are fetched live from the voice provider when you read a single call. If the provider cannot be reached, the request fails rather than returning partial data — 502 when the provider is unreachable or errors, 500 when it is not configured on our side. On a successful response these fields may still be null (or messages an empty array) when the call legitimately has none — for example a very short call — which is real data, not an error.