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

Building a where filter? See the Filtering contacts guide for every key, its value shapes, and end-to-end examples.

Parameters

Query parameters

where

object

Responses

200 — Successful response

Content-Type: application/json

error

boolean required

data

object required

data.count

integer required

Example

{
  "error": false,
  "data": {
    "count": 0
  }
}

400 — Request body failed validation.

Content-Type: application/json

(body)

any

401 — Missing or invalid API key.

Content-Type: application/json

(body)

any

403 — Valid key, insufficient permission.

Content-Type: application/json

(body)

any

404 — Resource does not exist.

Content-Type: application/json

(body)

any

409 — Request conflicts with the current state of the resource.

Content-Type: application/json

(body)

any

429 — Rate limit exceeded.

Content-Type: application/json

(body)

any

500 — Unexpected server error.

Content-Type: application/json

(body)

any

Code samples

curl https://api.prod.getdex.com/v1/contacts/count \
  --header 'Authorization: Bearer YOUR_API_KEY'

fetch('https://api.prod.getdex.com/v1/contacts/count', {
  headers: {
    Authorization: 'Bearer YOUR_API_KEY'
  }
})

requests.get(
    "https://api.prod.getdex.com/v1/contacts/count",
    headers={
      "Authorization": "Bearer YOUR_API_KEY"
    }
)

Find contacts by email

Look up contacts by one or more email addresses. Returns matching contacts for each email provided, useful for resolving email addresses to contact records.

List custom fields

Retrieve all custom field definitions for the authenticated user. Custom fields allow you to add structured data to contacts beyond the built-in fields.