Jump to

Transcripts

Retrieve ordered transcript segments for individual calls, or run full-text search across all transcripts for a phone number.

Transcripts are generated automatically during calls. Each segment is tagged with the speaking party (local, remote, or system) and a millisecond offset from the start of the call.

List transcripts GET

GET /calls/{call_id}/transcripts

List all transcript segments for a call, ordered by sequence number. The call may be of either origin — a dedicated number or a shared iMessage line.

Path parameters

Parameter	Type	Description
`call_id`	UUID	Unique identifier of the call

Response (200)

JSON

Error responses

Status	Description
404	Call not found

Identity-scoped API keys can only read transcripts for calls belonging to their own identity; any other call is masked as 404 Call not found.

Code examples

The number-scoped transcripts route is deprecated. Use GET /calls/{call_id}/transcripts instead of GET /numbers/{phone_number_id}/calls/{call_id}/transcripts.

Search transcripts GET

GET /numbers/{phone_number_id}/search

Full-text search across all transcript segments for a phone number. Returns matching segments ranked by relevance.

Path parameters

Parameter	Type	Description
`phone_number_id`	UUID	Unique identifier of the phone number

Query parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search query (1–500 characters)
`party`	string	No	Filter by speaking party: `"local"` or `"remote"`
`limit`	integer	No	Number of results to return (1–200, default 50)

Response (200)

JSON

Error responses

Status	Description
403	Phone number does not belong to your organization

Code examples

Transcript object

Field	Type	Description
`id`	UUID	Unique transcript segment identifier
`call_id`	UUID	Call this segment belongs to
`seq`	integer	Sequence number within the call (starts at 0)
`ts_ms`	integer	Milliseconds from the start of the call when this segment was spoken
`party`	string	Who spoke: `"local"` (your number), `"remote"` (the other party), or `"system"`
`text`	string	Transcript content
`created_at`	string	Creation timestamp (ISO 8601)