Skip to main content
GET
curl

Authorizations

Authorization
string
header
required

An API key (sig_...), or a session token from the web app.

Path Parameters

agentId
string<uuid>
required

The agent's id.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

callId
string<uuid>
required

The call's id in Signal (not the platform's call id).

Response

The call.

object
enum<string>
required
Available options:
call
id
string<uuid>
required

The call's id in Signal.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

providerCallId
string
required

The call's id on the voice platform. Unique within an agent, not across agents.

version
integer | null
required

The agent version that took the call.

startedAt
string<date-time> | null
required
Example:

"2026-10-02T14:03:07.120Z"

endedAt
string<date-time> | null
required
Example:

"2026-10-02T14:03:07.120Z"

durationMs
integer | null
required
direction
string | null
required

inbound or outbound, as the platform reports it.

disconnectionReason
string | null
required

Why the call ended, in the platform's words (user_hangup, agent_hangup, ...).

outcome
enum<string> | null
required

How the call ended for the caller. Null until the call is analysed.

Available options:
resolved,
unresolved,
transferred,
abandoned,
no_contact,
null
objective
string | null
required

One line, in the caller's terms, of what they were trying to do. Null until analysed.

intent
object | null
required

The intent the analysis gave the call. Null until analysed.

useCase
object | null
required

What the caller wanted, from the use case classification. Null when not classified.

subUseCase
object | null
required

The narrower use case under useCase, when there is one.

callerPersona
object | null
required

The kind of caller the call was read as. Null when not classified.

caller
object
required

Who called, from facts alone. The phone number itself is never returned.

counts
object
required
signalCodes
string[] | null
required

Codes of the signals detected on the call, sorted. A signal is a symptom noticed on a call, not a diagnosed issue; what to fix is on the issues. Null until analysed, empty when nothing was noticed.

analysis
object | null
required

The call's analysis. Null until the call is analysed.

alsoAsked
object[]
required

Use cases the caller asked for besides useCase.

traits
object[]
required

The caller's traits as classified: who they are to the business, demeanour, speech, surroundings, language.

coverage
object
required

Whether the agent was built for what this caller wanted.

audio
object | null
required

What the recording measured on the caller's side. Null when it was not read.

issues
object[]
required

Open issues this call is evidence for, highest priority first. Resolved and withdrawn issues are left out.