---
title: "Get file metadata and download URL"
method: GET
path: "/files/{fileId}"
tags: ["Files"]
---

# Get file metadata and download URL

`GET /files/{fileId}`

## Request

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

## Response `200`

File metadata

- StoredFile: Probe results, populated once the file is stored.
  - `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

## Other responses

- `401`: Missing or invalid API key
- `404`: Resource not found
- `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)
