Skip to main content
GET
List contacts

Authorizations

Authorization
string
header
required

API Key authentication. Secret keys (sk_*) are required for all endpoints except /v1/track. Public keys (pk_*) only work with the /v1/track endpoint for client-side event tracking. Workspaces can have multiple active keys, and sender-domain operations enforce per-key domain scope when configured.

Query Parameters

limit
integer
default:20

Maximum items per page

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

Pagination cursor

subscribed
boolean

Filter by subscription status

Search by email

Response

200 - application/json

List of contacts

data
object[]
cursor
string | null

Cursor for next page

hasMore
boolean
total
integer

Total count (only included on first page)