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
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?

