Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation
Theme

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Retrieve file

files.retrieve(file_id) -> FileObject
GET
/files/{file_id}

Returns information about a specific file.

Parameters
file_id: str
Returns
class FileObject: …

The File object represents a document that has been uploaded to OpenAI.

id: str

The file identifier, which can be referenced in the API endpoints.

bytes: int

The size of the file, in bytes.

created_at: int

The Unix timestamp (in seconds) for when the file was created.

formatunixtime
filename: str

The name of the file.

object: Literal["file"]

The object type, which is always file.

purpose: Literal["assistants", "assistants_output", "batch", 5 more]

The intended purpose of the file. Supported values are assistants, assistants_output, batch, batch_output, fine-tune, fine-tune-results, vision, and user_data.

status: Literal["uploaded", "processed", "error"]

Deprecated.

Deprecated. The current status of the file, which can be either uploaded, processed, or error.

expires_at: Optional[int]

The Unix timestamp (in seconds) for when the file will expire.

formatunixtime
status_details: Optional[str]

Deprecated.

Deprecated. For details on why a fine-tuning training file failed validation, see the error field on fine_tuning.job.

Retrieve file

from openai import OpenAI
client = OpenAI()

client.files.retrieve("file-abc123")
Response example
{
  "id": "file-abc123",
  "object": "file",
  "bytes": 120000,
  "created_at": 1677610602,
  "expires_at": 1680202602,
  "filename": "mydata.jsonl",
  "purpose": "fine-tune",
  "status": "processed"
}
Returns Examples
Response example
{
  "id": "file-abc123",
  "object": "file",
  "bytes": 120000,
  "created_at": 1677610602,
  "expires_at": 1680202602,
  "filename": "mydata.jsonl",
  "purpose": "fine-tune",
  "status": "processed"
}