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

# Retrieve a file

`GET /v1/files/{id}`

## Request

- Base URL: `https://api.tryleap.ai`
- URL: `https://api.tryleap.ai/v1/files/{id}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

A file's details, with a fresh signed link valid for 24 hours.

Needs an API key with the `generations:read` scope.

## Path parameters

- `id` string, required: The file's ID, `file_...`.

## Response `200`

The file.

- File: A photo, video or sound stored in your workspace, to pass as a model input.
  - `id` string, required: The file's ID, `file_...`. Pass it in a model's input.
  - `object` 'file', required
  - `content_type` string, required: The type, read from the file's bytes, such as `image/jpeg` or `video/mp4`.
  - `bytes` integer, required: The size in bytes.
  - `width` integer, nullable, required: Width in pixels; null for a sound.
  - `height` integer, nullable, required: Height in pixels; null for a sound.
  - `duration` number, nullable, required: A video's or a sound's length in seconds; null for an image.
  - `filename` string, nullable, required: The name you gave, if any.
  - `url` string, uri, required: A signed link to the file, valid for 24 hours. Read the file again for a fresh one.
  - `created_at` string, date-time, required: When it was stored.

## Other responses

- `400`: `conflicting_credentials`
- `401`: `authentication_required`
- `403`: `permission_denied`
- `404`: `resource_not_found`
- `429`: `rate_limit_exceeded`

---

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