---
title: "Get File"
method: GET
path: "/api/v1alpha1/assistant/trademe/files/{file_id}"
tags: ["v1alpha1"]
---

# Get File

`GET /api/v1alpha1/assistant/trademe/files/{file_id}`

Metadata for one file — OpenAI's "Retrieve file" / Anthropic's "Get
File Metadata". Ownership-scoped like every other read here (wrong
member, wrong kind, and unknown file_id are indistinguishable 404s), but
reading metadata is not a "use": unlike ``GET /files/{file_id}/content``,
this never mints a signed URL and never bumps custom_time/last_used_at.

Reports ``pending`` files too (state visible), same as ``GET /files``'s
list — a client's "all files" view needs a single-file fetch that
behaves like the list it paginates, not a narrower one.

## Path parameters

- `file_id` string, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- FileResource — Metadata for one file — the shape both ``GET /files`` (list) and ``GET /files/{file_id}`` (single) return. Never carries a signed URL; resolving bytes is ``GET /files/{file_id}/content``'s job alone.
  - `fileId` string, required
  - `ref` string, required
  - `state` string, required
  - `contentType` string, required
  - `sizeBytes` integer, nullable
  - `createdAt` string, date-time, nullable
  - `caption` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/trademeai/apis/trade-me-ai-platform.md) · [All operations](https://skmtc.net/trademeai/apis/trade-me-ai-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trademeai/trade-me-ai-platform/revisions/02634860dec7/schema)