Skip to main content
HTTP Method: GET URL: /api/v3/recordings Authentication: Requires API Key in the request header. Query Parameters:
ParameterTypeDescription
studioIdstringFilter recordings by studio ID
projectIdstringFilter recordings by project ID
start_datestringReturn recordings created on or after this date (Format: YYYY-MM-DD)
end_datestringReturn recordings created on or before this date (Format: YYYY-MM-DD)
pagenumberPage number for pagination (starts at 1, defaults to 1)
  • Providing only start_date returns all recordings from that date forward
  • Providing only end_date returns all recordings up to that date
  • Use both to filter by a specific date range
  • Date filtering works in combination with studioId or projectId
  • If no filter is provided, returns recordings from all studios in the account
Response: Paginated list of recording objects Rate limit: Once every 10 seconds (unique requests with different pages are not limited) Sorting: Lists objects in order of “newest created first” Pagination: Default page size is 20 recordings Status Codes:
  • 200 OK Recordings retrieval successful.
  • 401 Unauthorized Authentication failed.
  • 429 Too Many Requests Rate limit exceeded.

​
Sample Request

GET /api/v3/recordings?studioId=studio123 HTTP/1.1
Host: platform.riverside.fm
Authorization: Bearer YOUR_API_KEY

​
Sample Request with pagination

GET /api/v3/recordings?studioId=studio123&page=2 HTTP/1.1
Host: platform.riverside.fm
Authorization: Bearer YOUR_API_KEY

​
Sample Request with date range

GET /api/v3/recordings?start_date=2025-05-01&end_date=2025-06-30 HTTP/1.1
Host: platform.riverside.fm
Authorization: Bearer YOUR_API_KEY

​
Sample Response

{
  "page": 1,
  "next_page_url": "https://platform.riverside.fm/api/v3/recordings?studioId=studio123&page=2",
  "total_items": 45,
  "total_pages": 3,
  "data": [
    {
      "recording_id": "rec123",
      "name": "Episode 12 - Interview with Jane",
      "project_id": "proj789",
      "project_name": "Season 1",
      "studio_id": "studio456",
      "studio_name": "Main Studio",
      "status": "ready",
      "created_date": "2025-01-15T14:30:00Z",
      "tracks": [
        {
          "id": "track001",
          "type": "participant",
          "status": "done",
          "files": [
            {
              "type": "raw_audio",
              "download_url": "https://platform.riverside.fm/api/v3/download/file/file001"
            },
            {
              "type": "raw_video",
              "download_url": "https://platform.riverside.fm/api/v3/download/file/file002"
            }
          ]
        }
      ],
      "transcription": {
        "status": "done",
        "files": [
          {
            "type": "srt",
            "download_url": "https://platform.riverside.fm/api/v3/download/transcription/rec123?type=srt"
          },
          {
            "type": "txt",
            "download_url": "https://platform.riverside.fm/api/v3/download/transcription/rec123?type=txt"
          }
        ]
      }
    }
  ]
}

​
Response Fields

FieldTypeDescription
pagenumberCurrent page number
next_page_urlstring | nullURL to fetch next page, null if on last page
total_itemsnumberTotal number of recordings matching the query
total_pagesnumberTotal number of pages available
dataarrayArray of recording objects