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 /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": "t1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "call_id": "c1d2e3f4-a5b6-7890-cdef-012345678901",
    "seq": 0,
    "ts_ms": 1200,
    "party": "remote",
    "text": "Hello, how can I help you today?",
    "created_at": "2026-03-10T12:00:06Z"
  },
  {
    "id": "t2b3c4d5-e6f7-8901-bcde-f12345678901",
    "call_id": "c1d2e3f4-a5b6-7890-cdef-012345678901",
    "seq": 1,
    "ts_ms": 3800,
    "party": "local",
    "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": "t1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "call_id": "c1d2e3f4-a5b6-7890-cdef-012345678901",
    "seq": 1,
    "ts_ms": 3800,
    "party": "local",
    "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	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)

Agent signup API

Agent identity API

Agent2Agent API

Mail API

Phone API

iMessage 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