Sign in
batch

Retrieve a file

Read a file's metadata: size, purpose, and when it expires. Use the /content endpoint for the bytes.

get/v1/files/{file_id}

Path parameters

file_idstring required

The file_ prefixed id of the file whose metadata you want.

Example:file_9c2c1c3e-5b6a-4f0e-8d0f-2a1b3c4d5e6f

Identifies the file to read.

Response

File metadata.

idstring required

File identifier, file_ prefixed. Pass it as input_file_id when creating a batch.

objectstring required

Object type, always file.

bytesinteger required

Size of the file in bytes.

created_atinteger required

Unix timestamp (seconds) for when the file was uploaded.

expires_atinteger nullable required

Unix timestamp (seconds) for when the file and its content are deleted. Defaults to 30 days after upload (24 hours on zero-data-retention accounts).

filenamestring required

The filename you uploaded, or the generated name for batch output and error files.

purpose'batch' | 'batch_output' required

batch for files you upload; batch_output for the output and error files a batch produces.

status'uploaded' | 'processed' | 'error' required

Deprecated OpenAI field, kept for SDK compatibility. Always uploaded.

Example response

{
  "id": "file_9c2c1c3e-5b6a-4f0e-8d0f-2a1b3c4d5e6f",
  "object": "file",
  "bytes": 48211,
  "created_at": 1780000000,
  "expires_at": 1782592000,
  "filename": "requests.jsonl",
  "purpose": "batch",
  "status": "uploaded"
}

Changes

Changed in 1 of the 3 revisions of this API.1