curl https://api.bota.dev/v1/recordings/rec_abc123 \
-H "Authorization: Bearer sk_live_..."
{
"id": "rec_abc123",
"device_id": "dev_abc123",
"end_user_id": "eu_xyz789",
"name": "Product interview - Jane Doe",
"status": "uploaded",
"duration_seconds": 1800,
"file_size_bytes": 2048576,
"recorded_at": "2025-01-15T09:00:00Z",
"metadata": {
"meeting_type": "interview"
},
"upload_method": "ble",
"source": "device",
"mime_type": "audio/opus",
"content_sha256": "9b2c0f4a8e1d6c3b5a7098f6e4d2c1b0a9f8e7d6c5b4a3928172635445362718",
"audio_url": "https://bota-uploads.s3.amazonaws.com/...",
"created_at": "2025-01-15T10:00:00Z",
"updated_at": "2025-01-15T10:05:00Z"
}
Recordings
Get Recording
Retrieve a recording by ID
GET
/
recordings
/
{id}
curl https://api.bota.dev/v1/recordings/rec_abc123 \
-H "Authorization: Bearer sk_live_..."
{
"id": "rec_abc123",
"device_id": "dev_abc123",
"end_user_id": "eu_xyz789",
"name": "Product interview - Jane Doe",
"status": "uploaded",
"duration_seconds": 1800,
"file_size_bytes": 2048576,
"recorded_at": "2025-01-15T09:00:00Z",
"metadata": {
"meeting_type": "interview"
},
"upload_method": "ble",
"source": "device",
"mime_type": "audio/opus",
"content_sha256": "9b2c0f4a8e1d6c3b5a7098f6e4d2c1b0a9f8e7d6c5b4a3928172635445362718",
"audio_url": "https://bota-uploads.s3.amazonaws.com/...",
"created_at": "2025-01-15T10:00:00Z",
"updated_at": "2025-01-15T10:05:00Z"
}
Retrieve a recording. If audio has been uploaded, the response includes a short-lived
audio_url.
Authentication
Requires an API key withrecordings:read scope.
curl https://api.bota.dev/v1/recordings/rec_abc123 \
-H "Authorization: Bearer sk_live_..."
Path Parameters
string
required
The recording’s unique identifier.
Response
{
"id": "rec_abc123",
"device_id": "dev_abc123",
"end_user_id": "eu_xyz789",
"name": "Product interview - Jane Doe",
"status": "uploaded",
"duration_seconds": 1800,
"file_size_bytes": 2048576,
"recorded_at": "2025-01-15T09:00:00Z",
"metadata": {
"meeting_type": "interview"
},
"upload_method": "ble",
"source": "device",
"mime_type": "audio/opus",
"content_sha256": "9b2c0f4a8e1d6c3b5a7098f6e4d2c1b0a9f8e7d6c5b4a3928172635445362718",
"audio_url": "https://bota-uploads.s3.amazonaws.com/...",
"created_at": "2025-01-15T10:00:00Z",
"updated_at": "2025-01-15T10:05:00Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Recording identifier |
device_id | string | null | Source device |
end_user_id | string | null | Associated end user |
name | string | null | Human-readable name |
status | string | Recording status |
duration_seconds | integer | null | Audio duration in seconds |
file_size_bytes | integer | null | File size in bytes |
recorded_at | string | null | Recording timestamp |
metadata | object | Custom metadata |
upload_method | string | null | Upload method |
source | string | Recording source |
mime_type | string | null | Audio MIME type |
content_sha256 | string | null | SHA-256 hash when supplied |
audio_url | string | null | Short-lived direct download URL when audio exists |
created_at | string | Creation timestamp |
updated_at | string | Last update timestamp |
Was this page helpful?