Fetch A Merge Recording - API

This API lets you fetch details of a single merged participant recording using the MERGE_ID. It includes channel mappings, file metadata, duration, and direct access to the final merged file.

HTTP method and endpoint

GET

|

https://api.videosdk.live/v2/recordings/participant/merge/{MERGE_ID}

Headers Parameters

Authorization

REQUIRED

values : YOUR_TOKEN_WITHOUT_ANY_PREFIX

This will be a JWT token generate using VideoSDK ApiKey and Secret.

Note that the token will not include any prefix such as "Basic " or "Bearer ". Just pass a token as value.

You can generate a new token by refering this Guide: Generate Auth token

Parameters

MERGE_ID

REQUIRED

The ID of the merged recording to fetch.

GET

|

https://api.videosdk.live/v2/recordings/participant/merge/{MERGE_ID}

NodeJS

• cURL
• NodeJS
• PHP
• Python

import fetch from 'node-fetch';
const options = {
	method: "GET",
	headers: {
		"Authorization": "$YOUR_TOKEN",
	},
};
const url= `https://api.videosdk.live/v2/recordings/participant/merge/{MERGE_ID}`;
const response = await fetch(url, options);
const data = await response.json();
console.log(data);

RESPONSE

{
  "id": "abcd-abcd-abcd-abcd-abcd",
  "channel1": [
    {
      "recordingId": "68468e4792579a9d01e6c980",
      "participantId": "abcd"
    },
    {
      "recordingId": "68468e5092579a9d01e6c982",
      "participantId": "abcd2"
    }
  ],
  "channel2": [
    {
      "recordingId": "68468e5592579a9d01e6c984",
      "participantId": "abcd3"
    }
  ],
  "start": "2025-06-09T10:36:05.896Z",
  "end": "2025-06-09T10:36:43.022Z",
  "status": "completed",
  "meetingId": "roye-pqdd-wbfl",
  "sessionId": "68468e1e999064b94e7691fc",
  "file": {
    "meta": {
      "format": "mp3",
      "duration": 58
    },
    "filePath": "<FILE_PATH>",
    "type": "audio",
    "size": 986349,
    "ratio": {
      "audio": 16905.749
    },
    "userStorage": null,
    "createdAt": "2025-06-09T10:36:43.018Z",
    "updatedAt": "2025-06-09T10:36:43.018Z",
    "fileUrl": "<CDN_URL>",
    "id": "6846b93beabde2b7cbf44bb2"
  }
}