Skip to main content
GET
List contacts

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Query Parameters

cursor
string

Opaque cursor for the next page (from previous response meta.pagination.cursor)

limit
integer
default:25

Number of items per page (1–200, default 25)

Required range: 1 <= x <= 200

Free-text search across name, phone, email

lifecycle_stage
string

Filter by lifecycle stage

country_code
string

Filter by country code

tags
string

Comma-separated tag filter

has_phone
boolean

Only contacts with a phone number

has_email
boolean

Only contacts with an email address

created_after
string<date-time>

Created after this date

created_before
string<date-time>

Created before this date

Response

200 - application/json

Paginated list of contacts

Paginated list of contacts

data
object[]
meta
object