Skip to main content
GET
Page through a list's contacts

Authorizations

Authorization
string
header
required

Project API key (sk_api_…).

Path Parameters

listId
string<uuid>
required

Query Parameters

q
string

Case-insensitive substring match on name and phone. Values in attributes are not searched.

limit
integer
default:50

Rows read per page. Values above 100 are clamped to 100; anything non-numeric or below 1 falls back to 50 instead of erroring.

cursor
string

The previous page's nextCursor. Opaque — do not construct one.

Response

One page, ordered by contactId as text rather than import order, so +92… rows come before 03… ones. There is no sort parameter.

contacts
object[]
nextCursor
string

Pass back as cursor to read the next page. Absent on the last page.