Files

Get a file

Retrieve details of a single file by its ID.

get/files/{id}

Request

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

Path parameters

idstring required
Example:507f1f77bcf86cd799439011

File ID

Query parameters

include'metadata'
Example:metadata

Additional data to include in the response

Response

File details

idstring

Unique file identifier

namestring nullable

File name

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

File type

folderIdstring nullable

ID of the folder containing this file. Only present if the file is in a folder.

createdAtstring date-time nullable

File creation timestamp

resolutionstring

Video resolution (e.g., "1920x1080"). Only present when include=metadata is requested.

frameRatenumber

Video frame rate in fps. Only present when include=metadata is requested.

bitrateMbpsnumber

Video bitrate in Mbps. Only present when include=metadata is requested.

durationSecnumber

File duration in seconds. Only present when include=metadata is requested.

sizeBytesinteger

File size in bytes. Only present when include=metadata is requested.

videoCodecstring

Video codec name. Only present when include=metadata is requested.

audioCodecstring

Audio codec name. Only present when include=metadata is requested.

Example response

{
  "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"
}

Changes

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