Skip to main content
HTTP Method: GET URL: /api/v3/edits Authentication: Requires API Key in the request header. Authorization: Only edits belonging to the account associated with the API token are returned. When studioId or projectId filters are supplied, the studio/project must belong to the account. Query Parameters:
ParameterTypeDescription
studioIdstringFilter edits by studio ID
projectIdstringFilter edits by project ID
start_datestringOnly return edits created on or after this date (ISO-8601). Example: 2025-10-01T00:00:00Z
end_datestringOnly return edits created on or before this date (ISO-8601). Must be greater than or equal to start_date.
pageintegerPage number (starts from 1)
Response: Paginated list of edit objects for the account. Rate limit: Once every 1 second for unique requests. Pagination: This endpoint uses page-based pagination with a fixed page size of 20 edits. To iterate through all results:
  1. Make the first request without a page parameter (defaults to page 1).
  2. If next_page_url is not null, request the next page (either follow next_page_url or increment page).
  3. Repeat until next_page_url is null.
Status Codes:
  • 200 OK Edits retrieved successfully.
  • 401 Unauthorized Authentication failed (missing or invalid API token).
  • 429 Too Many Requests This endpoint is rate limited.
  • 500 Internal Server Error Unexpected server error.

​
Sample Request

GET /api/v3/edits HTTP/1.1
Host: platform.riverside.fm
Authorization: Bearer YOUR_API_KEY

​
Sample Request with filters

GET /api/v3/edits?studioId=640479c9-1222-4161-1234-dee0d855e685&start_date=2025-10-01T00:00:00Z&end_date=2025-10-31T23:59:59Z&page=2 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/edits?page=2",
  "total_items": 200,
  "total_pages": 10,
  "data": [
    {
      "clip_id": "6618c2e4f2a9b8001234abcd",
      "name": "Episode 12 – Final",
      "project_id": "6618c2e4f2a9b800123424tt",
      "studio_id": "6618c2e4f2a9b80012342444",
      "created_date": "2025-10-05T12:00:00Z",
      "status": "exported",
      "download_url": "https://platform.riverside.fm/api/v3/download/export/6618c2e4f2a9b8001234abcd"
    },
    {
      "clip_id": "6618c2e4f2a9b80012342460",
      "name": "Episode 11 – Draft",
      "project_id": "6618c2e4f2a9b800123424tt",
      "studio_id": "6618c2e4f2a9b80012342444",
      "created_date": "2025-10-05T12:00:00Z",
      "status": "draft",
      "download_url": null
    }
  ]
}