---
title: "List stored files"
method: GET
path: "/files"
tags: ["Files"]
---

# List stored files

`GET /files`

## Request

- Base URL: `https://renderio.dev/api/v1`
- URL: `https://renderio.dev/api/v1/files`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

File list

- FileListResponse
  - `files` StoredFile[], required
    - `size_mbytes` number, nullable
    - `duration` number, nullable
    - `file_type` string, nullable
    - `file_format` string, nullable
    - `codec` string, nullable
    - `pixel_format` string, nullable
    - `mime_type` string, nullable
    - `width` integer, nullable
    - `height` integer, nullable
    - `frame_rate` number, nullable
    - `bitrate_video_kb` number, nullable
    - `bitrate_audio_kb` number, nullable
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded — retry after the `Retry-After` interval

---

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