---
title: "Get File"
method: GET
path: "/files/{file_id}"
tags: ["Files"]
---

# Get File

`GET /files/{file_id}`

Returns metadata for a file owned by the authenticated user.
The response includes a permanent `ch://files/{file_id}` URL,
file name, content type, size, user-provided metadata, and timestamps.

If the file is not found or the user is not authorized, the response will be 401 Unauthorized.

## Path parameters

- `file_id` string, required

## Response `200`

File metadata

- FileResponse — Metadata describing an uploaded file in Chunkr. Returned by POST `/files` and GET `/files/{file_id}`.
  - `content_type` string, required — MIME type detected or provided for the file.
  - `created_at` string, date-time, required — Timestamp when the file was created.
  - `file_id` string, required — Unique identifier for the file.
  - `file_name` string, required — The original filename supplied by the client.
  - `file_size` integer, required — Size of the stored file in bytes.
  - `metadata` object, required — Arbitrary JSON metadata associated with the file.
  - `url` string, required — Permanent Chunkr URL. Use directly with other chunkr API requests.

## Other responses

- `401` — Unauthorized
- `404` — File not found
- `500` — Server error

---

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