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

# Retrieve a file

`GET /v1/files/{file_id}`

File metadata without downloading the JSONL body.

## Path parameters

- `file_id` string, required

## Headers

- `x-project-id` string

## Response `200`

File object

- File
  - `id` string — Prefixed with `file-`.
  - `object` 'file'
  - `bytes` integer
  - `created_at` integer
  - `filename` string
  - `purpose` 'batch' | 'batch_output' — Uploads use `batch`; batch results use `batch_output`.
  - `status` 'uploaded' | 'processed' | 'error'
  - `status_details` string
  - `expires_at` integer
  - `is_error` boolean — ZeroGPU extension. `true` on batch error output files only.

## Other responses

- `404` — File not found

---

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