Files

List files

List files from the user's media library with optional filters.

When no folderId is provided, returns all files across all folders. When folderId is set to null, returns only root-level files (not in any folder). When folderId is a folder ID, returns only files in that specific folder.

Folders are included in the response only when include=folders is set (and type is provided with folderId omitted or null).

get/files

Request

  • Base URL: https://api.livereacting.com/v1/external
  • URL: https://api.livereacting.com/v1/external/files
  • Auth: HTTP bearer

Query parameters

type'video' | 'image' | 'audio'

Filter by file type

folderIdstring

Filter by folder. Omit to return all files. Set to null for root-level files only. Set to a folder ID to filter by that folder.

searchstring

Search files by name (min 3 characters)

limitinteger

Number of files to return

offsetinteger

Number of files to skip (for pagination)

include'metadata' | 'folders' | 'metadata,folders' | 'folders,metadata'

Include additional data in the response (comma-separated). Use metadata to include resolution, frameRate, bitrateMbps, durationSec, sizeBytes, videoCodec, and audioCodec. Use folders to include a folders array (requires type and folderId omitted or null).

Response

List of files (folders are included only when include=folders)

totalinteger

Total number of files matching the filter

limitinteger
offsetinteger

Example response

{
  "files": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "intro-video.mp4",
      "type": "video",
      "folderId": "507f1f77bcf86cd799439012",
      "createdAt": "2026-01-25T09:00:00Z",
      "issues": {
        "errors": [
          "bitrate_too_high"
        ],
        "warnings": []
      },
      "resolution": "1920x1080",
      "frameRate": 30,
      "bitrateMbps": 5.42,
      "durationSec": 120.5,
      "sizeBytes": 52428800,
      "videoCodec": "h264",
      "audioCodec": "aac"
    }
  ],
  "folders": [
    {
      "id": "507f1f77bcf86cd799439012",
      "name": "Intros",
      "type": "video",
      "fileCount": 15,
      "createdAt": "2026-01-20T10:00:00Z"
    }
  ],
  "total": 42,
  "limit": 100
}

Changes

No recorded changes to this operation across all 1 revision of this API.