curl "https://api.bota.dev/v1/recordings?status=uploaded&limit=10" \
-H "Authorization: Bearer sk_live_..."
{
"data": [
{
"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",
"created_at": "2025-01-15T10:00:00Z",
"updated_at": "2025-01-15T10:05:00Z"
}
],
"has_more": false,
"next_cursor": null
}
Recordings
List Recordings
List recordings in the current project
GET
/
recordings
curl "https://api.bota.dev/v1/recordings?status=uploaded&limit=10" \
-H "Authorization: Bearer sk_live_..."
{
"data": [
{
"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",
"created_at": "2025-01-15T10:00:00Z",
"updated_at": "2025-01-15T10:05:00Z"
}
],
"has_more": false,
"next_cursor": null
}
List recordings with cursor pagination and optional filters.
The Node.js recording-list example
demonstrates bounded pagination, an optional end-user filter and selected metadata
output. It does not fetch audio or modify recordings.
See Get Recording for recording field descriptions.
Authentication
Requires an API key withrecordings:read scope.
curl "https://api.bota.dev/v1/recordings?status=uploaded&limit=10" \
-H "Authorization: Bearer sk_live_..."
Query Parameters
integer
Maximum number of recordings to return.
string
Cursor from a previous response.
string
Filter by end user.
string
Filter by device.
string
Filter by recording status.
string
Filter recordings created at or after this ISO 8601 timestamp.
string
Filter recordings created before this ISO 8601 timestamp.
Response
Returns a paginated list of recording objects.{
"data": [
{
"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",
"created_at": "2025-01-15T10:00:00Z",
"updated_at": "2025-01-15T10:05:00Z"
}
],
"has_more": false,
"next_cursor": null
}
Was this page helpful?