contacts

List Contacts

List contacts attached to the authenticated organization.

Requires the contacts:read scope on the API key.

get/v1/contacts

Query parameters

pageinteger

Page number.

sizeinteger

Number of items per page.

sort_by'first_seen_at' | 'last_seen_at' | 'email'

Field to sort by.

sort_order'asc' | 'desc'

Sort direction.

emailstring nullable

Filter by email (case-insensitive exact match).

linkedin_urlstring nullable

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

contact_idstring uuid nullable

Filter by contact ID.

company_domainstring nullable

Filter by the contact's linked account domain.

first_seen_afterstring date-time nullable

Return contacts first seen strictly after this timestamp.

last_seen_afterstring date-time nullable

Return contacts last seen strictly after this timestamp.

Successful Response

total_countinteger required

Total number of records matching the query.

total_pagesinteger required

Total number of pages.

has_moreboolean required

Whether more pages remain after the current one.

Changed in 3 of the 12 revisions of this API.3

Aug 7, 20266e9ca9d5acac1See the full diff
- ○
  added the optional property items/items/account_id to the response with the 200 status
  response-optional-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 5, 2026b390cd1c4e2a1See the full diff
- ○
  added the new optional query request parameter company_domain
  new-optional-request-parameter
Aug 4, 2026467ce2bf692b1See the full diff
- ○
  added the optional property items/items/owner to the response with the 200 status
  response-optional-property-added