Skip to main content
GET
/
v1
/
files
List Files
curl --request GET \
  --url https://api.example.com/v1/files
{
  "data": [
    {
      "id": "<string>",
      "object": "<string>",
      "bytes": 123,
      "created_at": 123,
      "expires_at": 123,
      "filename": "<string>"
    }
  ],
  "first_id": "<string>",
  "last_id": "<string>",
  "has_more": true,
  "object": "list"
}

Query Parameters

​
after
string | null
​
limit
integer | null
default:10000
Required range: 1 <= x <= 10000
​
order
enum<string> | null
default:desc
Available options:
asc,
desc
​
purpose
enum<string> | null
Available options:
assistants,
assistants_output,
batch,
batch_output,
fine-tune,
fine-tune-results,
vision,
user_data

Response

Successful Response

​
data
FileObjectModel · object[]
required

A list of file objects.

​
first_id
string | null
required

The ID of the first file in the list.

​
last_id
string | null
required

The ID of the last file in the list.

​
has_more
boolean
required

Whether there are more files available after this list.

​
object
string
default:list

The object type, which is always list.

Allowed value: "list"