Sign in

v27

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-2193427579.9 KB
Files

List files

List files

get/v1/files

Query parameters

afterstring nullable

A cursor for pagination. Returns files after this ID.

A cursor for pagination. Returns files after this ID.

limitinteger nullable

Maximum number of files to return (1-10,000).

Maximum number of files to return (1-10,000).

order'asc' | 'desc'

Sort order for paginated responses.

Sort order by created_at timestamp ('asc' or 'desc').

purpose'assistants' | 'assistants_output' | 'batch' | 'batch_output' | 'evals' | 'fine-tune' | 'fine-tune-results' | 'vision' | 'user_data'

Valid purpose values on the OpenAI File response object.

Filter files by purpose.

Response

The list of files.

has_moreboolean required

Whether there are more files available beyond this page.

first_idstring required

The ID of the first file in the list for pagination.

last_idstring required

The ID of the last file in the list for pagination.

object'list'

The object type, which is always 'list'.