Skip to main content
POST
/
v1
/
contacts
/
filter
Filter contacts
curl --request POST \
  --url https://api.prod.getdex.com/v1/contacts/filter \
  --header 'Authorization: Bearer <token>'
{
  "error": true,
  "data": {
    "items": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "full_name": "<string>",
        "first_name": "<string>",
        "last_name": "<string>",
        "job_title": "<string>",
        "company": "<string>",
        "description": "<string>",
        "legacy_location": "<string>",
        "website": "<string>",
        "image_url": "<string>",
        "starred": true,
        "is_archived": true,
        "birthday": "<string>",
        "linkedin": "<string>",
        "twitter": "<string>",
        "facebook": "<string>",
        "instagram": "<string>",
        "frequency": "<string>",
        "source": "<string>",
        "created_at": "<string>",
        "updated_at": "<string>"
      }
    ],
    "nextCursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "count": 123
  }
}

Use cases

  • Build a dynamic contact list with user-defined filters
  • Find contacts matching specific criteria (e.g., by company, location, or tags)
  • Power saved views or segments in your application
This endpoint uses POST because filter criteria can be complex and may exceed URL length limits. The response format is identical to the List contacts endpoint.

Authorizations

Authorization
string
header
required

Use your Dex API key (e.g. dex_abc123...) as the Bearer token.

Query Parameters

take
integer
Required range: x >= 1
skip
integer
Required range: x >= 0
cursor
string<uuid>
where
object
include
object
select
object

Response

Successful response

error
boolean
required
data
object
required