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
No response body.
401
No response body.
403
No response body.
404
No response body.
429
No response body.
500
No response body.
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.