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

# Retrieve file

`GET /files/{id}`

Retrieves the details of an existing file.

## Path parameters

- `id` string, required

## Response `200`

A successful response

- File — A file that has been uploaded or is pending upload.
  - `content_type` string, nullable, required — The MIME type of the uploaded file (e.g., image/jpeg, video/mp4, audio/mpeg).
  - `filename` string, nullable, required — The original filename of the uploaded file, including its file extension.
  - `id` string, required — The unique identifier for the file.
  - `size` string, nullable, required — The file size in bytes. Null if the file has not finished uploading.
  - `upload_status` 'pending' | 'processing' | 'ready' | 'failed', required — The upload status of a file
  - `url` string, nullable, required — The URL for accessing the file. For public files, this is a permanent CDN URL. For private files, this is a signed URL that expires. Null if the file has not finished uploading.
  - `visibility` 'public' | 'private', required — Controls whether an uploaded file is publicly accessible or requires authentication to access.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Verification required
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/db0883548bc5/schema)