Skip to main content
GET
List Contacts

Authorizations

Authorization
string
header
required

Bearer API key issued from Settings → Developers.

Query Parameters

page
integer
default:1

Page number.

Required range: x >= 1
size
integer
default:10

Number of items per page.

Required range: 1 <= x <= 100
sort_by
enum<string> | null

Field to sort by.

Available options:
first_seen_at,
last_seen_at,
email
sort_order
enum<string>
default:asc

Sort direction.

Available options:
asc,
desc
email
string | null

Filter by email (case-insensitive exact match).

linkedin_url
string | null

Filter by LinkedIn profile URL. Matched against all known canonical variants (trailing slash, www. prefix, etc.).

contact_id
string<uuid> | null

Filter by contact ID.

company_domain
string | null

Filter by the contact's linked account domain.

first_seen_after
string<date-time> | null

Return contacts first seen strictly after this timestamp.

last_seen_after
string<date-time> | null

Return contacts last seen strictly after this timestamp.

Response

200 - application/json

Successful Response

items
PublicContactOutput · object[]
required

Records on this page.

total_count
integer
required

Total number of records matching the query.

total_pages
integer
required

Total number of pages.

has_more
boolean
required

Whether more pages remain after the current one.