Skip to main content
GET
List contacts in a contact list

Authorizations

Authorization
string
header
required

Clerk tenant API key. The organizationId encoded by the key is the exact and only tenant scope.

Path Parameters

listId
string
required

Query Parameters

limit
integer
default:100

Page size. Invalid values use 100; values above 500 are capped at 500.

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

Opaque continuation token returned by this contact-list contacts collection. Cursors are bound to this endpoint (and, for nested or sorted collections, to that parent or sort) and cannot be reused elsewhere.

Response

Tenant-scoped collection.

Standard envelope for canonical collection endpoints.

organizationId
string
required
filters
object
required

Normalized filters actually applied to the request.

data
object[]
required
pagination
object
required