Skip to main content
HTTP Method: GET URL: /api/v3/download/file/{id} Authentication: Requires API Key in the request header. Path Parameters:
ParameterTypeDescription
idstringThe unique identifier of the file to download
Response: Redirects (301) to the actual file download URL Rate limit: Once every 10 seconds Status Codes:
  • 301 Moved Permanently Redirects to the file download URL.
  • 401 Unauthorized Authentication failed.
  • 404 Not Found File not found or not accessible.
  • 429 Too Many Requests Rate limit exceeded.

​
Sample Request

GET /api/v3/download/file/file001 HTTP/1.1
Host: platform.riverside.fm
Authorization: Bearer YOUR_API_KEY

​
Sample Response

HTTP/1.1 301 Moved Permanently
Location: https://storage.riverside.fm/signed-url/file001.wav?token=...

​
Usage Example

Most HTTP clients will automatically follow the redirect. If you’re using curl: 
curl -L -H "Authorization: Bearer YOUR_API_KEY" \
  "https://platform.riverside.fm/api/v3/download/file/file001" \
  -o downloaded_file.wav
The -L flag tells curl to follow redirects.