Skip to main content
GET
List files
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
Example:

"vision"

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".