GET
Retrieve a file

Authorizations

Authorization
string
header
required

Provide your API key in the Authorization header using Bearer auth

Path Parameters

file_id
string
required

File ID (file- prefix)

Response

OK

File (OpenAI File object)

id
string

File ID (file- prefix)

object
string

Always file

Example:

"file"

bytes
integer<int64>

Size in bytes

created_at
integer<int64>

Created at (Unix seconds)

expires_at
integer<int64>

Expires at (Unix seconds); null if it never expires

filename
string

File name

purpose
enum<string>

Purpose: vision / user_data

Available options:
vision,
user_data
status
enum<string>

Status: uploaded / processed / error

Available options:
uploaded,
processed,
error
status_details
string

Status details (deprecated as in OpenAI, always null)