Skip to main content
GET
/
v1
/
files
List files
curl --request GET \
  --url https://api.perceptron.inc/v1/files \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "bytes": 123,
      "created_at": 123,
      "filename": "<string>",
      "id": "<string>",
      "object": "<string>"
    }
  ],
  "first_id": "<string>",
  "has_more": true,
  "last_id": "<string>",
  "object": "<string>"
}
List your organization’s files. Supports purpose filtering and cursor pagination — pass the previous response’s last_id as the after parameter to fetch the next page. Compatible with OpenAI’s List files endpoint. Rate limit: 100 requests/min.

Authorizations

​
Authorization
string
header
required

Bearer token authentication using your Perceptron API key

Query Parameters

​
after
string

Cursor for pagination — the id of the last file from the previous page.

​
limit
integer<int32>

Maximum number of objects to return (1-10000, default 10000).

Required range: x >= 0
​
order
enum<string>

Sort order by created_at.

Available options:
asc,
desc
​
purpose
enum<string>

Filter files by purpose.

Available options:
vision,
user_data

Response

Page of files.

​
data
object[]
required

List of file objects.

​
first_id
string
required

ID of the first file in the returned page.

​
has_more
boolean
required

Whether more results are available.

​
last_id
string
required

ID of the last file in the returned page.

​
object
string
required

Always "list".