---
title: "Get a file"
method: GET
path: "/files/{id}"
tags: ["Files"]
---

# Get a file

`GET /files/{id}`

## Request

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

Retrieve details of a single file by its ID.

## Path parameters

- `id` string, required

## Query parameters

- `include` 'metadata'

## Response `200`

File details

- File: A media file in the user's library
  - `id` string: Unique file identifier
  - `name` string, nullable: File name
  - `type` 'video' | 'image' | 'audio', nullable: File type
  - `folderId` string, nullable: ID of the folder containing this file. Only present if the file is in a folder.
  - `createdAt` string, date-time, nullable: File creation timestamp
  - `issues` object: Compatibility issues detected for video files. Only present for video type files. Thresholds are plan-tier-aware.
    - `errors` string[]: Critical issues that will prevent successful streaming (e.g. bitrate_too_high, resolution_too_high, fps_exceeds_limit, unsupported_video_codec).
    - `warnings` string[]: Non-critical issues that may affect quality (e.g. high_bitrate, high_resolution).
  - `encoding` object: Encoding status. Only present when encoding is in progress.
    - `status` 'in_queue' | 'in_progress': Current encoding status
    - `progress` integer: Encoding progress percentage
  - `resolution` string: Video resolution (e.g., "1920x1080"). Only present when include=metadata is requested.
  - `frameRate` number: Video frame rate in fps. Only present when include=metadata is requested.
  - `bitrateMbps` number: Video bitrate in Mbps. Only present when include=metadata is requested.
  - `durationSec` number: File duration in seconds. Only present when include=metadata is requested.
  - `sizeBytes` integer: File size in bytes. Only present when include=metadata is requested.
  - `videoCodec` string: Video codec name. Only present when include=metadata is requested.
  - `audioCodec` string: Audio codec name. Only present when include=metadata is requested.

## Other responses

- `400`: Invalid request (bad ID format or invalid include value)
- `401`: Authentication failed
- `404`: File not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/livereacting/apis/livereacting-api.md) · [All operations](https://skmtc.dev/livereacting/apis/livereacting-api/llms.txt) · [OpenAPI document](https://skmtc.dev/livereacting/apis/livereacting-api/revisions/17a9f1677fbf?raw)