Skip to main content
GET
List Files
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

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

Successful Response

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