Sign in

v3

OpenAPI 3.1.0MIT2026-07-31192456807.8 KB
Files

Retrieve file metadata

Retrieve the metadata for a single uploaded data file.

get/files/{id}

Path parameters

idstring required

The ID of the file to retrieve

Response

File retrieved successfully

idstring required

ID of the file.

object'file' required

The object type, which is always file.

created_atinteger required

The timestamp when the file was created.

filenamestring required

The name of the file as it was uploaded.

bytesinteger required

The number of bytes in the file.

purpose'fine-tune' | 'eval' | 'batch-api' required

The purpose of the file

Processedboolean required

Deprecated. Whether file has been fully uploaded.

FileType'csv' | 'jsonl' | 'parquet' required

The type of the file

processing_status'PENDING' | 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'INVALID_FORMAT'

Lifecycle state of a file in the validation pipeline. The typical progression is PENDING → QUEUED → RUNNING → COMPLETED / FAILED. INVALID_FORMAT is a terminal state for files whose contents failed validation in a user-correctable way.

Example response

{
  "filename": "my_file.jsonl",
  "purpose": "fine-tune",
  "FileType": "jsonl"
}