Skip to main content
GET
/
v1
/
contacts
/
search
Search contacts
curl --request GET \
  --url https://api.prod.getdex.com/v1/contacts/search \
  --header 'Authorization: Bearer <token>'
{
  "error": true,
  "data": {
    "contacts": [
      {
        "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>"
      }
    ]
  }
}

Use cases

  • Power a real-time search bar in your contact list
  • Find contacts by partial name or email match
  • Look up contacts by company name
This performs a basic text search across common contact fields. For more advanced filtering with structured criteria, use the Filter contacts endpoint instead.

Authorizations

Authorization
string
header
required

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

Query Parameters

fullName
string
take
number
cursor
string

Response

Successful response

error
boolean
required
data
object
required