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

# Retrieve file

`GET /files/{file_id}`

Returns metadata about a specific file, including its size, creation time, and purpose.

## Path parameters

- `file_id` string, required

## Response `200`

File metadata.

- FileResponse — File object response (OpenAI-compatible)
  - `bytes` integer, required
  - `context_name` string, nullable — Context name: "Personal" for individual files, or the organization name
  - `context_type` string, nullable — Context type: "personal" or "organization"
  - `created_at` integer, required
  - `created_by_email` string, nullable — Email of the individual who created this file (resolved from api_key attribution)
  - `expires_at` integer, nullable
  - `filename` string, required
  - `id` string, required
  - `object` 'file', required — Object type - always "file"
  - `purpose` 'batch' | 'batch_output' | 'batch_error', required — Purpose for file
  - `source` string, nullable — Source: "sync" if ingested from an external connection, absent for uploaded files
  - `source_name` string, nullable — Name of the source connection (e.g. "prod-s3-inputs")

## Other responses

- `404` — File not found or you don't have access to it.
- `500` — An unexpected error occurred. Retry the request or contact support if the issue persists.

---

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