Skip to main content
HTTP Method: GET URL: /api/v2/recordings Authentication: Requires API Key in the request header. Query Parameters: You may optionally filter by one of the following parameters:
  • studioId: ID of the studio to filter recordings
  • projectId: ID of the studio to filter recordings
  • start_date: Return recordings created on or after this date (Format: YYYY-MM-DD)
  • end_date: Return recordings created on or before this date (Format: YYYY-MM-DD)
Notes:
  • Providing only start_date returns all recordings from that date forward; providing only end_date returns all recordings up to that date.
  • Use both start_date and end_date to filter by a date range.
  • Date filtering works in combination with studioId or projectId.
  • If no parameter is provided, the response will include recordings from all studios in the account.
Response: List of recordings objects Rate limit: once every 30 seconds for unique request (e.g. different pages not limited) Sorting: Lists objects in order of “newest created first” Pagination: By default every response is capped at 20 recordings Response:
  • page page you are viewing
  • next_page_url
  • total_items
  • total_pages
Request:
  • page page that you want to receive (optional, defaults to page 0)
Status Codes:
  • 200 OK Recordings retrieval successful.
  • 401 Unauthorized Authentication failed.

​
Sample Request

GET /api/v2/recordings?studioId=1 HTTP/1.1
Host: platform.riverside.fm
Authorization: BEARER YOUR_API_KEY

​
Sample Request with pagination

GET /api/v2/recordings?studioId=1&page=4 HTTP/1.1
Host: platform.riverside.fm
Authorization: BEARER YOUR_API_KEY

​
Sample Request with date range

GET /api/v2/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": "/api/v2/recordings?studioId=1&page=1",
  "total_items": 200,
  "total_pages": 2,
  "data": [{
      "recording_id": "rec123",
      "name": "Recording 1",
      "project_id": "640479c9-1222-4161-1234-dee0d855e685",
      "project_name": "Project 1",
      "studio_id": "640479c9-1222-4161-1234-dee0d855e685",
      "studio_name": "Studio 1", 
      "status": "ready",
      "created_date": "2024-04-28T12:00:00Z",
      "tracks": [{
          "id": "track123",
          "type": "participant",
          "status": "done",
          "files": [{
              "type": "compressed_audio",
              "download_url": "https://api.riverside.fm/downloads/audio123.mp3"
          }]
      }, {
          "id": "track456",
          "type": "screenshare",
          "status": "done",
          "files": [{
              "type": "raw_video",
              "download_url": "https://example.com/downloads/video456.mp4"
          }]
       }]
    }, {
      "recording_id": "rec456",
      "name": "Recording 2",
      "project_id": "640479c9-1222-4161-1234-dee0d855e685",
      "project_name": "Project 1",
      "studio_id": "640479c9-1222-4161-1234-dee0d855e685",
      "studio_name": "Studio 1", 
      "status": "uploading",
      "created_date": "2024-04-27T10:30:00Z",
      "tracks": [{
          "id": "track789",
          "type": "media board",
          "status": "processing",
          "files": []
      }]
   }, {
       .....
   }]
}
⌘I