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

# Get File Metadata

`GET /api/v1/files/{file_id}`

Get metadata for an uploaded file.

Returns file information including size, content type, and upload timestamp.

## Path parameters

- `file_id` integer, required

## Cookies

- `wos-session` string
- `datalab_active_team` string

## Response `200`

Successful Response

- FileMetadataResponse — Response with file metadata.
  - `file_id` integer, required — Unique file ID
  - `original_filename` string, required — Original filename
  - `content_type` string, required — MIME type
  - `file_size` integer, required — File size in bytes
  - `upload_status` string, required — Upload status: pending, completed, or failed
  - `created` string, date-time, required — Upload timestamp
  - `reference` string, required — File reference in datalab://file-{id} format

## Other responses

- `422` — Validation Error

---

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