Skip to main content
GET
/
api
/
v1
/
transcriptions
/
{id}
Get a transcription by ID
curl --request GET \
  --url https://www.api.vook.ai/api/v1/transcriptions/{id}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Team weekly sync",
  "status": "completed",
  "has_transcription": true,
  "diarize": false,
  "created_at": "2024-01-15T10:30:00.000Z",
  "language": "en",
  "speaker_count": 2,
  "word_count": 1250,
  "submitted_at": "2024-01-15T10:30:00.000Z",
  "folder": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Client calls"
  }
}

Path Parameters

​
id
string
required

Transcription ID

Response

200 - application/json

Transcription metadata

​
id
string
required

Transcription (prediction) ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
name
string
required

Display name

Example:

"Team weekly sync"

​
status
enum<string>
required

Lifecycle status

Available options:
queued,
processing,
completed,
empty,
failed
Example:

"completed"

​
has_transcription
boolean
required

Whether the transcript is available to fetch/export

Example:

true

​
diarize
boolean
required

Whether diarization was requested

Example:

false

​
created_at
string<date-time>
required

When the transcription was created

Example:

"2024-01-15T10:30:00.000Z"

​
language
string | null

Spoken language code, when known

Example:

"en"

​
speaker_count
number | null

Number of detected speakers, when diarized

Example:

2

​
word_count
number | null

Total word count, when available

Example:

1250

​
submitted_at
string<date-time> | null

When the transcription was submitted

Example:

"2024-01-15T10:30:00.000Z"

​
folder
object

Folder the transcription belongs to, if any