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 includes the call side (local or remote), a nullable phone_number, and a capture timestamp in Unix epoch milliseconds. text contains the spoken words.

List transcripts

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

[
  {
    "id": "a1a2b3c4-d5e6-4890-abcd-ef1234567890",
    "call_id": "c1d2e3f4-a5b6-7890-cdef-012345678901",
    "seq": 0,
    "ts_ms": 1773144006000,
    "party": "remote",
    "phone_number": "+12125550199",
    "text": "Hello, how can I help you today?",
    "created_at": "2026-03-10T12:00:06Z"
  },
  {
    "id": "a2b3c4d5-e6f7-4901-bcde-f12345678901",
    "call_id": "c1d2e3f4-a5b6-7890-cdef-012345678901",
    "seq": 1,
    "ts_ms": 1773144009000,
    "party": "local",
    "phone_number": "+14155550100",
    "text": "I'd like to schedule an appointment.",
    "created_at": "2026-03-10T12:00:09Z"
  }
]

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

curl -X GET "https://inkbox.ai/api/v1/phone/calls/CALL_ID/transcripts" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch(
  `https://inkbox.ai/api/v1/phone/calls/${callId}/transcripts`,
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const transcripts = await response.json();

import requests

response = requests.get(
    f"https://inkbox.ai/api/v1/phone/calls/{call_id}/transcripts",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
transcripts = response.json()

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 /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

[
  {
    "id": "a2b3c4d5-e6f7-4901-bcde-f12345678901",
    "call_id": "c1d2e3f4-a5b6-7890-cdef-012345678901",
    "seq": 1,
    "ts_ms": 1773144009000,
    "party": "local",
    "phone_number": "+14155550100",
    "text": "I'd like to schedule an appointment.",
    "created_at": "2026-03-10T12:00:09Z"
  }
]

Error responses

Status	Description
403	Phone number does not belong to your organization

Code examples

curl -X GET "https://inkbox.ai/api/v1/phone/numbers/PHONE_NUMBER_ID/search?q=appointment&party=local" \
  -H "X-API-Key: YOUR_API_KEY"

const params = new URLSearchParams({ q: "appointment", party: "local" });
const response = await fetch(
  `https://inkbox.ai/api/v1/phone/numbers/${phoneNumberId}/search?${params}`,
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const results = await response.json();

import requests

response = requests.get(
    f"https://inkbox.ai/api/v1/phone/numbers/{phone_number_id}/search",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"q": "appointment", "party": "local"},
)
results = response.json()

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	Capture timestamp in Unix epoch milliseconds
`party`	string	Call side: `"local"` (your number) or `"remote"` (a remote participant). Multiple speakers can share a side.
`phone_number`	string \| null	This turn’s line number in E.164 format. Shared local lines and unknown attribution return `null`.
`text`	string	Spoken content. Historical text is preserved unchanged.
`created_at`	string	Creation timestamp (ISO 8601)

Older responses can omit phone_number; handle an absent field like null. ts_ms is an absolute capture time, not elapsed time since the call began. For remote turns, phone_number identifies the human line that spoke, including an added conference participant. For local turns, it is the agent’s dedicated line number. Local turns on a shared line always return null. For older turns without a stored number, verified parent-call facts can supply the dedicated local line or, on a non-conference call, the original remote line. If these rules cannot establish the line, phone_number remains null. Do not substitute the original caller’s number for an unknown conference participant. The same nullable phone_number accompanies turns in call webhooks and contact correspondence. Abridgment markers have no phone number. Do not infer a missing number from a name prefix in historical text.

Agent signup API

Agent identity API

Agent2Agent API

Message retries

Mail API

Phone API

iMessage API

Slack API

Webhooks API

Tunnels API

Contacts API

Notes API

Vault API

Billing API

List transcripts

Path parameters

Response (200)

Error responses

Code examples

Search transcripts

Path parameters

Query parameters

Response (200)

Error responses

Code examples

Transcript object

​List transcripts

​Path parameters

​Response (200)

​Error responses

​Code examples

​Search transcripts

​Path parameters

​Query parameters

​Response (200)

​Error responses

​Code examples

​Transcript object

List transcripts

Path parameters

Response (200)

Error responses

Code examples

Search transcripts

Path parameters

Query parameters

Response (200)

Error responses

Code examples

Transcript object