Recordings API
List and fetch your recorded session files.
Endpoint: https://mediasfu.com/v1/recordings
Authenticate with Authorization: Bearer <api-username>:<api-key> from your server. Try every action and copy the request in the API Sandbox.
▶ Watch this: Rooms, recordings and AI notes, from 0:43.
List / get
GET https://mediasfu.com/v1/recordings with action: "get"
Retrieve records. Everything is optional — send as-is to list all.
No fields are required.
Optional: Filters
All optional — narrow or page the results.
| Field | Type | Description | Default |
|---|---|---|---|
name | text | Room name. Filter to recordings from a specific room. | |
subusername | text | Sub-user. Filter to a sub-user’s recordings. | |
startIndex | number | Start index | 0 |
pageSize | number (10–50) | Page size. Between 10 and 50. | 20 |
curl "https://mediasfu.com/v1/recordings?action=get" \
-H "Authorization: Bearer $MEDIASFU_API_USERNAME:$MEDIASFU_API_KEY"
Example response:
{
"success": true,
"recordings": [
{
"name": "s9x2k7mp4q81ab3c",
"type": "video",
"url": "<download URL>",
"publicAccessAllowed": false,
"addedToBucket": false,
"hlsFilesRequested": false,
"usageAmount": 12.5,
"numberOfVideoPauses": 0,
"numberOfAudioPauses": 1,
"createdAt": 1793025000000,
"subusername": null
}
],
"total": 1,
"totalCount": 1,
"startIndex": 0,
"pageSize": 20
}
See errors and response format for failure handling.