Contacts
Count contacts
Return the count of contacts matching the optional `where` filter. Returns `{ data: { count } }`.
GET /v2/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
data
object required
data.count
integer required
Example
{
"data": {
"count": 0
}
}
400
No response body.
401
No response body.
403
No response body.
404
No response body.
409
No response body.
429
No response body.
500
No response body.
Code samples
curl https://api.prod.getdex.com/v2/contacts/count \
--header 'Authorization: Bearer YOUR_API_KEY'
fetch('https://api.prod.getdex.com/v2/contacts/count', {
headers: {
Authorization: 'Bearer YOUR_API_KEY'
}
})
requests.get(
"https://api.prod.getdex.com/v2/contacts/count",
headers={
"Authorization": "Bearer YOUR_API_KEY"
}
)
Create a contact
Create ONE contact. The common case — TanStack DB optimistic mutations, mobile add-contact, MCP tools. **Requires `Idempotency-Key`.** Returns `{ data: { contact: {...} } }` with status 201. For bulk
Filter contacts
List contacts with filters sent in the request body. Accepts a Prisma-shaped `where` clause, an optional geographic `near` radius, and pagination. Returns the same shape as `GET /v2/contacts/` with an