List All Recordings - Riverside Business API Documentation

HTTP Method: GET URL: /api/v3/recordings Authentication: Requires API Key in the request header. Query Parameters:

Parameter	Type	Description
`studioId`	string	Filter recordings by studio ID
`projectId`	string	Filter recordings by project ID
`start_date`	string	Return recordings created on or after this date (Format: YYYY-MM-DD)
`end_date`	string	Return recordings created on or before this date (Format: YYYY-MM-DD)
`page`	number	Page number for pagination (starts at 0, defaults to 0)

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 1 second (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.com
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": 0,
  "next_page_url": "https://platform.riverside.fm/api/v3/recordings?studioId=studio123&page=1",
  "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

Field	Type	Description
`page`	number	Current page number
`next_page_url`	string \| null	URL to fetch next page, null if on last page
`total_items`	number	Total number of recordings matching the query
`total_pages`	number	Total number of pages available
`data`	array	Array of recording objects

⌘I