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 /numbers/{phone_number_id}/calls/{call_id}/transcripts
List all transcript segments for a call, ordered by sequence number.
Path parameters
Parameter
Type
Description
phone_number_id
UUID
Unique identifier of the phone number
call_id
UUID
Unique identifier of the call
Response (200)
JSON
Error responses
Status
Description
403
Call does not belong to your organization
404
Call not found
Code examples
cURL
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
cURL
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"
JSON
cURL