latestOpenAPI 3.0.0Dex Terms of Service2026-08-2114811009.4 KB

af2dcc7aff5c

contacts

Count contacts

Return the total number of contacts for the authenticated user. Useful for displaying counts in dashboards without fetching full contact records.

get/v1/contacts/count

Query parameters

ignore_mergeboolean

Filter by the ignore_merge flag (excluded from merge suggestions).

is_starredboolean

Match starred (true) or non-starred (false) contacts.

is_archivedboolean

Match archived (true) or active (false) contacts. Defaults to false when omitted.

has_user_created_groupsboolean

Non-system group membership: true for at least one user-created group; false for no user-created groups, including contacts with zero memberships or only Dex system-group memberships.

has_grouping_signaltrue

Internal organize prefilter: title, company, location, or LinkedIn summary is non-null and non-empty. Whitespace-only values are removed by the organize serializer.

has_location_exactstring

Location: exact string match (not fuzzy).

has_never_keep_in_touchboolean

Filter by the never_keep_in_touch flag.

has_tagstring uuid

Match contacts carrying this single tag id.

has_emailboolean

Match contacts that have (true) or lack (false) at least one email.

has_phone_numberboolean

Match contacts that have (true) or lack (false) at least one phone number.

Response

Successful response

errorboolean required