---
title: "Count contacts (v2)"
method: GET
path: "/v2/contacts/count"
tags: ["contacts"]
---

# Count contacts (v2)

`GET /v2/contacts/count`

Return the count of contacts matching the optional `where` filter. Returns `{ data: { count } }`.

## Query parameters

- `where` object
  - `in` union
    - string, uuid
    - string[]
  - `not_in` union
    - string, uuid
    - string[]
  - `ignore_merge` boolean
  - `is_starred` boolean
  - `is_archived` boolean
  - `has_priority_tier` union
    - integer
    - integer[]
    - boolean
  - `has_linkedin` union
    - string
    - boolean
  - `has_instagram` union
    - string
    - boolean
  - `has_twitter` union
    - string
    - boolean
  - `has_source` union
    - string
    - string[]
  - `has_name` union
    - string
    - string[]
    - object
      - `contains` string, required
    - object
      - `eq` string, required
  - `has_groups` union
    - object
      - `not` union, required
        - string
        - string[]
    - boolean
    - string, uuid
    - string[]
  - `has_groups_all` array[]
    - string[]
  - `has_frequency` union
    - string
    - boolean
  - `has_location` union
    - string
    - boolean
  - `has_location_exact` string
  - `has_job_title` union
    - string
    - boolean
    - object
      - `contains` string, required
    - object
      - `eq` string, required
  - `has_never_keep_in_touch` boolean
  - `has_created_at` object
    - `gte` string, date-time
    - `lte` string, date-time
  - `has_updated_at` object
    - `gte` string, date-time
    - `lte` string, date-time
  - `has_birthday` union
    - string, date-time
    - unknown
    - boolean
  - `has_tag` string, uuid
  - `has_tags` union
    - string[]
    - object
      - `not` union, required
        - string, uuid
        - string[]
  - `has_tags_all` array[]
    - string[]
  - `has_company` union
    - string
    - boolean
    - object
      - `contains` string, required
    - object
      - `eq` string, required
  - `has_education` union
    - string
    - boolean
    - object
      - `contains` string, required
    - object
      - `eq` string, required
  - `has_description` union
    - string
    - boolean
    - object
      - `contains` string, required
    - object
      - `eq` string, required
  - `has_linkedin_companies` union
    - string
    - boolean
    - object
      - `contains` string, required
    - object
      - `eq` string, required
  - `has_linkedin_education` union
    - string
    - boolean
    - object
      - `contains` string, required
    - object
      - `eq` string, required
  - `has_email` boolean
  - `has_phone_number` boolean
  - `not_has_name` union
    - string
    - string[]
  - `not_has_company` union
    - string
    - string[]
  - `not_has_job_title` union
    - string
    - string[]
  - `not_has_education` union
    - string
    - string[]
  - `not_has_description` union
    - string
    - string[]
  - `not_has_linkedin_companies` union
    - string
    - string[]
  - `not_has_linkedin_education` union
    - string
    - string[]
  - `has_linkedin_last_message_at` union
    - boolean
    - object
      - `gte` string, date-time
      - `lte` string, date-time
  - `has_last_seen_at` union
    - boolean
    - object
      - `gte` string, date-time
      - `lte` string, date-time
  - `has_distance` object
    - `lat` number, required
    - `lon` number, required
    - `meters` number, required
  - `has_interaction` union
    - boolean
    - object
      - `gte` string, date-time
      - `lte` string, date-time
  - `has_next_reminder` union
    - boolean
    - object
      - `gte` string, date-time
      - `lte` string, date-time
  - `custom_fields` object[]
    - `field_id` string, uuid, required
    - `operator` 'contains' | 'eq' | 'in' | 'not_in' | 'present' | 'absent' | 'gte' | 'lte', required
    - `value` union
      - string
      - string[]
  - `_or` object[]
    - `in` union
      - string, uuid
      - string[]
    - `not_in` union
      - string, uuid
      - string[]
    - `ignore_merge` boolean
    - `is_starred` boolean
    - `is_archived` boolean
    - `has_priority_tier` union
      - integer
      - integer[]
      - boolean
    - `has_linkedin` union
      - string
      - boolean
    - `has_instagram` union
      - string
      - boolean
    - `has_twitter` union
      - string
      - boolean
    - `has_source` union
      - string
      - string[]
    - `has_name` union
      - string
      - string[]
      - object
        - `contains` string, required
      - object
        - `eq` string, required
    - `has_groups` union
      - object
        - `not` union, required
          - string
          - string[]
      - boolean
      - string, uuid
      - string[]
    - `has_groups_all` array[]
      - string[]
    - `has_frequency` union
      - string
      - boolean
    - `has_location` union
      - string
      - boolean
    - `has_location_exact` string
    - `has_job_title` union
      - string
      - boolean
      - object
        - `contains` string, required
      - object
        - `eq` string, required
    - `has_never_keep_in_touch` boolean
    - `has_created_at` object
      - `gte` string, date-time
      - `lte` string, date-time
    - `has_updated_at` object
      - `gte` string, date-time
      - `lte` string, date-time
    - `has_birthday` union
      - string, date-time
      - unknown
      - boolean
    - `has_tag` string, uuid
    - `has_tags` union
      - string[]
      - object
        - `not` union, required
          - string, uuid
          - string[]
    - `has_tags_all` array[]
      - string[]
    - `has_company` union
      - string
      - boolean
      - object
        - `contains` string, required
      - object
        - `eq` string, required
    - `has_education` union
      - string
      - boolean
      - object
        - `contains` string, required
      - object
        - `eq` string, required
    - `has_description` union
      - string
      - boolean
      - object
        - `contains` string, required
      - object
        - `eq` string, required
    - `has_linkedin_companies` union
      - string
      - boolean
      - object
        - `contains` string, required
      - object
        - `eq` string, required
    - `has_linkedin_education` union
      - string
      - boolean
      - object
        - `contains` string, required
      - object
        - `eq` string, required
    - `has_email` boolean
    - `has_phone_number` boolean
    - `not_has_name` union
      - string
      - string[]
    - `not_has_company` union
      - string
      - string[]
    - `not_has_job_title` union
      - string
      - string[]
    - `not_has_education` union
      - string
      - string[]
    - `not_has_description` union
      - string
      - string[]
    - `not_has_linkedin_companies` union
      - string
      - string[]
    - `not_has_linkedin_education` union
      - string
      - string[]
    - `has_linkedin_last_message_at` union
      - boolean
      - object
        - `gte` string, date-time
        - `lte` string, date-time
    - `has_last_seen_at` union
      - boolean
      - object
        - `gte` string, date-time
        - `lte` string, date-time
    - `has_distance` object
      - `lat` number, required
      - `lon` number, required
      - `meters` number, required
    - `has_interaction` union
      - boolean
      - object
        - `gte` string, date-time
        - `lte` string, date-time
    - `has_next_reminder` union
      - boolean
      - object
        - `gte` string, date-time
        - `lte` string, date-time
    - `custom_fields` object[]
      - `field_id` string, uuid, required
      - `operator` 'contains' | 'eq' | 'in' | 'not_in' | 'present' | 'absent' | 'gte' | 'lte', required
      - `value` union
        - string
        - string[]

## Response `200`

Successful response

- object
  - `data` object, required
    - `count` integer, required

## Other responses

- `400` — Request body failed validation.
- `401` — Missing or invalid API key.
- `403` — Valid key, insufficient permission.
- `404` — Resource does not exist.
- `409` — Request body failed validation.
- `429` — Rate limit exceeded.
- `500` — Unexpected server error.

---

[API](https://skmtc.dev/getdex/apis/dex-public-api.md) · [All operations](https://skmtc.dev/getdex/apis/dex-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getdex/dex-public-api/revisions/79f990e752ad/schema)