curl https://api.bota.dev/v1/transcriptions/txn_abc123 \
-H "Authorization: Bearer sk_live_..."
{
"id": "txn_abc123",
"recording_id": "rec_abc123",
"status": "completed",
"provider": "whisper",
"language": "en",
"segments": [
{
"start": 0,
"end": 2.5,
"text": "Hello, thanks for joining us today.",
"speaker": "SPEAKER_0",
"confidence": 0.95
}
],
"full_text": "Hello, thanks for joining us today.",
"word_count": 6,
"confidence": 0.95,
"error_message": null,
"started_at": "2025-01-15T10:10:01Z",
"completed_at": "2025-01-15T10:15:00Z",
"created_at": "2025-01-15T10:10:00Z",
"updated_at": "2025-01-15T10:15:00Z"
}
AI Processing
Get Transcription
Retrieve a transcription job
GET
/
transcriptions
/
{id}
curl https://api.bota.dev/v1/transcriptions/txn_abc123 \
-H "Authorization: Bearer sk_live_..."
{
"id": "txn_abc123",
"recording_id": "rec_abc123",
"status": "completed",
"provider": "whisper",
"language": "en",
"segments": [
{
"start": 0,
"end": 2.5,
"text": "Hello, thanks for joining us today.",
"speaker": "SPEAKER_0",
"confidence": 0.95
}
],
"full_text": "Hello, thanks for joining us today.",
"word_count": 6,
"confidence": 0.95,
"error_message": null,
"started_at": "2025-01-15T10:10:01Z",
"completed_at": "2025-01-15T10:15:00Z",
"created_at": "2025-01-15T10:10:00Z",
"updated_at": "2025-01-15T10:15:00Z"
}
Retrieve the status and result of a transcription job. Poll this endpoint until
status is completed or failed.
Authentication
Requires an API key withtranscriptions:read scope.
curl https://api.bota.dev/v1/transcriptions/txn_abc123 \
-H "Authorization: Bearer sk_live_..."
Path Parameters
string
required
The transcription’s unique identifier.
Response
{
"id": "txn_abc123",
"recording_id": "rec_abc123",
"status": "completed",
"provider": "whisper",
"language": "en",
"segments": [
{
"start": 0,
"end": 2.5,
"text": "Hello, thanks for joining us today.",
"speaker": "SPEAKER_0",
"confidence": 0.95
}
],
"full_text": "Hello, thanks for joining us today.",
"word_count": 6,
"confidence": 0.95,
"error_message": null,
"started_at": "2025-01-15T10:10:01Z",
"completed_at": "2025-01-15T10:15:00Z",
"created_at": "2025-01-15T10:10:00Z",
"updated_at": "2025-01-15T10:15:00Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Transcription identifier |
recording_id | string | Source recording |
status | string | pending, processing, completed, or failed |
provider | string | null | ASR provider |
language | string | null | Language code |
segments | array | null | Transcript segments |
full_text | string | null | Full transcript text |
word_count | integer | null | Total word count |
confidence | number | null | Overall confidence score |
error_message | string | null | Failure details |
started_at | string | null | Processing start timestamp |
completed_at | string | null | Processing completion timestamp |
created_at | string | Creation timestamp |
updated_at | string | Last update timestamp |
Was this page helpful?