Skip to main content

​
List Recordings

GET /v1/recordings
List all recordings. Filter by processing status.
​
page
integer
Page number
​
per_page
integer
Items per page
​
status
string
Filter: processing, ready, failed
Response
{
  "data": [
    {
      "id": "rec_xyz789",
      "status": "ready",
      "duration_seconds": 1820,
      "mode": "ambient",
      "created_at": "2026-06-15T14:30:00Z",
      "note_id": "note_abc123",
      "file_size_bytes": 4521984
    }
  ],
  "meta": { "page": 1, "per_page": 20, "total": 87 }
}

​
Get Recording

GET /v1/recordings/:id
Get recording details including a signed download URL (expires in 24 hours).
Response
{
  "id": "rec_xyz789",
  "status": "ready",
  "mode": "phone_call",
  "duration_seconds": 1820,
  "download_url": "https://storage.ruune.ai/rec_xyz789.wav?token=...",
  "expires_at": "2026-06-16T14:30:00Z",
  "note_id": "note_abc123",
  "created_at": "2026-06-15T14:30:00Z"
}

​
Recording Modes

ModeDescription
ambientIn-person meetings and conversations.
phone_callPhone calls — auto-detected when attached to phone during a call.
memoQuick voice memos and ideas.