Skip to main content

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.

FieldTypeDescriptionDefault
nametextRoom name. Filter to recordings from a specific room.
subusernametextSub-user. Filter to a sub-user’s recordings.
startIndexnumberStart index0
pageSizenumber (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.