List Files

List files for the active org with optional filters.

GET /files/list

List Files

cURL

curl --request GET \
  --url https://api.example.com/files/list \
  --header 'Authorization: Bearer <token>'

200

{}

Lists non-archived files for the active org, newest first. Note the path — it’s /files/list, not /files.

Auth

Requires a CRM read scope and an active organization on the token. Any of contacts:read, deals:read, companies:read, or activities:read qualifies, as does any *:manage scope — manage implies read.

Response

Field	Type	Description
files	array of file objects	Same shape as file in Initiate an Upload.
offset	integer	Echoes the request’s offset.
limit	integer	Echoes the request’s limit.

There is no total-count field — there’s no X-Total-Count header either — keep incrementing offset until a page comes back shorter than limit.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

folder_id · string | null

Filter by folder. Pass 'root' to get files at the Files root (folder_id IS NULL). Omit to list all files across folders.

recursive · boolean · default: false

When true with folder_id, includes files in every descendant folder of the given folder.

tags · string | null

Comma-separated tag list; only files containing every listed tag are returned.

search · string | null

Case-insensitive substring match against the file's display name; * and ? are stripped.

source · string | null

Filter by how the file was created, e.g. upload or ai_generated.

uploaded_by · string | null

Filter by the uploader's user id.

limit · integer · default: 50

Maximum number of files to return per page.

Required range: 1 <= x <= 200

offset · integer · default: 0

Number of files to skip, for pagination.

Required range: x >= 0

Response

200

application/json

Successful Response

The response is of type Response List Files Files List Get · object.