Skip to main content
GET
/
recordings
curl "https://api.bota.dev/v1/recordings?status=completed&limit=10" \
  -H "Authorization: Bearer sk_live_..."

{
  "data": [
    {
      "id": "rec_abc123",
      "device_id": "dev_abc123",
      "end_user_id": "eu_xyz789",
      "status": "completed",
      "duration_ms": 1800000,
      "file_size_bytes": 2048576,
      "mime_type": "audio/wav",
      "started_at": "2025-01-15T09:00:00Z",
      "ended_at": "2025-01-15T09:30:00Z",
      "transcription_id": "txn_abc123",
      "metadata": {
        "meeting_type": "interview"
      },
      "created_at": "2025-01-15T10:00:00Z",
      "uploaded_at": "2025-01-15T10:05:00Z"
    },
    {
      "id": "rec_def456",
      "device_id": "dev_abc123",
      "end_user_id": "eu_xyz789",
      "status": "completed",
      "duration_ms": 900000,
      "file_size_bytes": 1024000,
      "mime_type": "audio/wav",
      "started_at": "2025-01-14T14:00:00Z",
      "ended_at": "2025-01-14T14:15:00Z",
      "transcription_id": "txn_def456",
      "metadata": null,
      "created_at": "2025-01-14T15:00:00Z",
      "uploaded_at": "2025-01-14T15:02:00Z"
    }
  ],
  "has_more": true
}
​
limit
integer
default:"25"
Maximum number of items to return (1-100).
​
offset
integer
default:"0"
Number of items to skip for pagination.
​
device_id
string
Filter recordings by device.
​
end_user_id
string
Filter recordings by end user.
​
status
string
Filter by status: pending, uploaded, processing, completed, or failed.
curl "https://api.bota.dev/v1/recordings?status=completed&limit=10" \
  -H "Authorization: Bearer sk_live_..."

{
  "data": [
    {
      "id": "rec_abc123",
      "device_id": "dev_abc123",
      "end_user_id": "eu_xyz789",
      "status": "completed",
      "duration_ms": 1800000,
      "file_size_bytes": 2048576,
      "mime_type": "audio/wav",
      "started_at": "2025-01-15T09:00:00Z",
      "ended_at": "2025-01-15T09:30:00Z",
      "transcription_id": "txn_abc123",
      "metadata": {
        "meeting_type": "interview"
      },
      "created_at": "2025-01-15T10:00:00Z",
      "uploaded_at": "2025-01-15T10:05:00Z"
    },
    {
      "id": "rec_def456",
      "device_id": "dev_abc123",
      "end_user_id": "eu_xyz789",
      "status": "completed",
      "duration_ms": 900000,
      "file_size_bytes": 1024000,
      "mime_type": "audio/wav",
      "started_at": "2025-01-14T14:00:00Z",
      "ended_at": "2025-01-14T14:15:00Z",
      "transcription_id": "txn_def456",
      "metadata": null,
      "created_at": "2025-01-14T15:00:00Z",
      "uploaded_at": "2025-01-14T15:02:00Z"
    }
  ],
  "has_more": true
}