Skip to main content
GET
/
v1
/
recordings
/
{id}
/
transcript
Get Transcript
curl --request GET \
  --url https://api.example.com/v1/recordings/{id}/transcript
{
  "recordingId": "<string>",
  "duration": 123,
  "toNumber": "<string>",
  "fromNumber": "<string>",
  "createdAt": "<string>",
  "transcript": {
    "text": "<string>",
    "wordCount": 123,
    "words": [
      {}
    ]
  }
}
Returns the transcript for a recording in your preferred format.

​
Path Parameters

​
id
string
required
The recording ID

​
Query Parameters

​
format
string
default:"json"
Output format: json, text, or srt

​
Request

curl -X GET "https://app.transcord.app/api/v1/recordings/clx1234567890/transcript" \
  -H "Authorization: Bearer tr_live_your_api_key"

​
Response Formats

​
JSON Format (default)

Returns the full transcript with word-level timestamps and speaker identification.
​
recordingId
string
The recording ID
​
duration
number
Call duration in seconds
​
toNumber
string
Destination phone number
​
fromNumber
string
Caller phone number
​
createdAt
string
ISO 8601 timestamp
​
transcript
object
Response (JSON)
{
  "recordingId": "clx1234567890",
  "duration": 342,
  "toNumber": "+14155551234",
  "fromNumber": "+14155555678",
  "createdAt": "2026-01-15T10:30:00.000Z",
  "transcript": {
    "text": "Hello, this is John calling about the interview...",
    "wordCount": 847,
    "words": [
      {
        "word": "Hello,",
        "start": 0.5,
        "end": 0.9,
        "speaker": "you"
      },
      {
        "word": "this",
        "start": 1.0,
        "end": 1.2,
        "speaker": "you"
      }
    ]
  }
}

​
Plain Text Format

Returns just the transcript text without timestamps. Useful for reading or text processing.
Response (text)
Hello, this is John calling about the interview. I wanted to follow up on our conversation from last week...

​
SRT Subtitle Format

Returns the transcript as SRT subtitles, suitable for video editing software.
Response (SRT)
1
00:00:00,500 --> 00:00:05,200
Hello, this is John calling about the interview.

2
00:00:05,800 --> 00:00:10,100
I wanted to follow up on our conversation from last week.

3
00:00:11,000 --> 00:00:15,500
Hi John, thanks for calling back.

​
Transcript Not Ready

If the transcript is still being processed, you’ll receive a 202 Accepted response: 
{
  "error": "Transcript not ready",
  "status": "transcribing"
}
Poll again in a few seconds. See Working with Transcripts for status values.

​
Errors

StatusDescription
202Transcript is still processing
400Invalid format parameter
401Invalid or missing API key
404Recording not found