Query parameters
-
Only return files with the given purpose.
-
A limit on the number of objects to be returned. Limit can range between 1 and 10,000, and the default is 10,000.
Default value is
10000
. -
Sort order by the
created_at
timestamp of the objects.asc
for ascending order anddesc
for descending order.Values are
asc
ordesc
. Default value isdesc
. -
A cursor for use in pagination.
after
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
GET
/files
curl \
--request GET 'https://api.openai.com/v1/files' \
--header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
"object": "list",
"data": [
{
"id": "string",
"bytes": 42,
"created_at": 42,
"expires_at": 42,
"filename": "string",
"object": "file",
"purpose": "assistants",
"status": "uploaded",
"status_details": "string"
}
],
"first_id": "file-abc123",
"last_id": "file-abc456",
"has_more": false
}