---
title: "Get list of all stored files"
method: GET
path: "/v1/files"
tags: ["API", "File Management"]
---

# Get list of all stored files

`GET /v1/files`

Get the list of all stored files for an account, ordered by creation time - descending. Can return command output files or stored files. Will not return deleted files or input files.

## Query parameters

- `limit` integer — Maximum number of files to return
- `offset` integer — Number of files to skip before starting to collect the result set

## Response `200`

Successful Response

- RendiBaseStoredFile[]
  - `file_id` string, required — Unique identifier for the stored file
  - `environment_name` string, nullable — The environment this file was stored in (e.g., 'main', 'test', 'dev').
  - `storage_url` string, nullable — URL where the file is stored
  - `status` 'QUEUED' | 'DOWNLOADING' | 'DOWNLOADED' | 'UPLOADED' | 'FAILED' | 'STORED'
  - `rendi_store_type` 'INPUT' | 'OUTPUT' | 'STORED_FILE'
  - `error_status` string, nullable — Status of any error that occurred during file processing
  - `external_error_message` string, nullable — Error details if the file failed to be processed
  - `is_deleted` boolean, nullable — Whether the file has been deleted
  - `size_mbytes` number, nullable — Size of the output file or folder in megabytes
  - `file_count` integer, nullable — Number of files in the output folder/playlist
  - `size_compressed_mbytes` number, nullable — Size of the output compressed folder in megabytes
  - `is_private` boolean, nullable — Whether the file is stored privately. Private files are accessible via their `storage_url` only if you request a presigned URL by passing `presigned_ttl_seconds` on `GET /v1/files/{file_id}` (for a single file) or `GET /v1/commands/{command_id}` (for a command's output files) to receive a time-limited downloadable URL. Not available on free plans.

## Other responses

- `401` — Invalid API key
- `422` — Invalid request
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/rendi/apis/ffmpeg-command-api.md) · [All operations](https://skmtc.dev/rendi/apis/ffmpeg-command-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rendi/ffmpeg-command-api/revisions/d3136dbf90f0/schema)