Sign in
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"
}

Changes

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

  • 0c4fdad774351See the full diff
    • ▲

      the validation_report/nlines response's property type/format changed from integer/int64 to integer/ for status 200

      response-property-type-changed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog