Skip to main content
GET
Retrieve a file
Look up metadata for one file (filename, bytes, purpose, status) without downloading the body. Use Download file for the JSONL content. Full reference: Files API.

Authorizations

x-api-key
string
header
required

Headers

x-project-id
string

Optional project identifier. Scopes the request to a specific project when provided.

Path Parameters

file_id
string
required

Response

File object

id
string

Prefixed with file-.

object
enum<string>
Available options:
file
bytes
integer
created_at
integer
filename
string
purpose
enum<string>

Uploads use batch; batch results use batch_output.

Available options:
batch,
batch_output
status
enum<string>
Available options:
uploaded,
processed,
error
status_details
string
expires_at
integer
is_error
boolean

ZeroGPU extension. true on batch error output files only.