Fetch A Composite Merge Recording - API

Fetch details of a single composite-merge transcoding job by its transcodingId. The response includes job status, the source recordingIds, the merged output file (when status is completed) and a summary of webhook delivery attempts.

HTTP method and endpoint

GET

|

https://api.videosdk.live/v2/transcodings/{transcodingId}

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

transcodingId

REQUIRED

The ID of the composite-merge transcoding job to fetch.

GET

|

https://api.videosdk.live/v2/transcodings/{transcodingId}

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/transcodings/{transcodingId}`;
const response = await fetch(url, options);
const data = await response.json();
console.log(data);

RESPONSE

{
  "id": "665fcf7f2abe9a2807e42700",
  "recordingIds": [
    "6697685c6eaaaac67ea18130",
    "6697685c6eaaaac67ea18131"
  ],
  "roomId": "abcd-efgh-ijkl",
  "sessionId": "6847c231fbaa8b416bc87014",
  "status": "completed",
  "task": "composite-merge",
  "startedAt": "2025-06-10T05:45:02.730Z",
  "stoppedAt": "2025-06-10T05:46:21.500Z",
  "file": {
    "id": "6846b93beabde2b7cbf44bb2",
    "type": "video",
    "size": 24862410,
    "meta": {
      "format": "mp4",
      "duration": 78,
      "resolution": {
        "width": 1280,
        "height": 720
      }
    },
    "filePath": "recordings/composite-merge/<USER_ID>/665fcf7f2abe9a2807e42700.mp4",
    "fileUrl": "<CDN_URL>"
  },
  "webhook": {
    "totalCount": 2,
    "successCount": 2,
    "data": [
      {
        "type": "composite-merge-started",
        "success": true
      },
      {
        "type": "composite-merge-completed",
        "success": true
      }
    ]
  }
}