Skip to main content
POST
/
v1
/
contacts
/
search
Search contacts with advanced filters
curl --request POST \
  --url https://openapi.enginy.ai/v1/contacts/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "page": 1,
  "pageSize": 25,
  "search": "<string>",
  "include": {},
  "exclude": {},
  "fields": []
}
'
{
  "data": [
    {
      "id": 123,
      "firstName": "<string>",
      "lastName": "<string>",
      "jobTitle": "<string>",
      "linkedInProfileUrl": "<string>",
      "professionalEmail": "<string>",
      "personalEmails": "<string>",
      "mobilePhone": "<string>",
      "phones": "<string>",
      "imageUrl": "<string>",
      "companyId": 123,
      "company": {
        "id": 123,
        "name": "<string>",
        "domain": "<string>",
        "companyLinkedInUrl": "<string>"
      },
      "emailVerificationStatus": "<string>",
      "contactCountry": "<string>",
      "linkedInHeadline": "<string>",
      "numberOfConnections": 123,
      "contactCRMId": "<string>",
      "leadCRMId": "<string>",
      "isInCRM": true,
      "createdAt": "2023-12-25",
      "updatedAt": "2023-12-25",
      "smartFieldExplanations": {}
    }
  ],
  "meta": {
    "page": 123,
    "pageSize": 123,
    "total": 123
  }
}

Authorizations

x-api-key
string
header
required

Body

application/json
page
integer
default:1

Page number for pagination. Minimum value is 1.

Required range: x >= 1
pageSize
integer
default:25

Number of items per page. Minimum is 1, maximum is 100.

Required range: 1 <= x <= 100

Search term for full-text search across contact fields.

include
object

Filter conditions to include. Supports: campaigns, leadsGroup, isInCRM, enrichments, and all contact/company fields.

exclude
object

Filter conditions to exclude. Same structure as include.

fields
string[]

Specific contact fields to include in the response.

Response

200 - application/json

Successful response with paginated contacts

data
object[]
required
meta
object
required