Skip to main content
GET
List files

Authorizations

Authorization
string
header
required

An API key from Settings → API keys, sent as Authorization: Bearer yk_live_…. Scopes: transfers:read, transfers:write, collections:read, collections:write, contacts:read, contacts:write, webhooks:read, webhooks:write. A write scope implies read of the same resource.

Path Parameters

id
string
required

Collection id. Never a slug — see the Concepts page.

Query Parameters

folderId
string

Omit for every file. Pass root for the top level, or a folder id.

limit
integer

Page size, 1–1000. Omit it to get every file in one response.

Required range: 1 <= x <= 1000
cursor
string

The nextCursor from the previous page, unchanged. Opaque: never build one.

Response

Files, oldest first, and nextCursor (null on the last page).

files
object[]
required
nextCursor
string | null
required

Pass back unchanged for the next page. Null on the last page.