v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB
Search & Enrich

Search and Enrich Contacts

Find contacts and reveal their full data in a single call. Combines Search and Enrich into one request.

Provide contact identifiers the same way you would for Search Contacts. Use the reveal field to control what gets unlocked (emails, phones, or both).

Up to 100 contacts per request.

Billing: Two charges apply — one for the search (api_search) and one per revealed field. The billing.creditsCharged in the response reflects the total.

post/v3/contacts/search-and-enrich

Request body

revealstring[]

Example request

{
  "contacts": [
    {
      "clientReferenceId": "my-ref-1",
      "id": "12345",
      "linkedinUrl": "https://www.linkedin.com/in/orit-shilvock-6243bb5",
      "email": "orit.shilvock@lusha.com",
      "firstName": "Orit",
      "lastName": "Shilvock",
      "companyName": "Lusha",
      "companyDomain": "lusha.com"
    }
  ],
  "reveal": [
    "emails",
    "phones"
  ],
  "options": {
    "includePartialProfiles": true
  }
}

Response

Successful response

requestIdstring uuid

Example response

{
  "results": [
    {
      "id": "4389064704",
      "firstName": "Orit",
      "lastName": "Shilvock",
      "fullName": "Orit Shilvock",
      "jobTitle": {
        "title": "Vice President of Partnerships",
        "departments": [
          "Business Development"
        ],
        "seniority": "Vice President"
      },
      "location": {
        "country": "Israel",
        "countryIso2": "IL",
        "state": "Tel Aviv District",
        "city": "Tel Aviv",
        "continent": "Asia",
        "coordinates": [
          34.78057098388672,
          32.08087921142578
        ]
      },
      "tags": [
        {
          "color": "#FF5733"
        }
      ],
      "emails": [
        {
          "email": "orit.shilvock@lusha.com",
          "type": "work",
          "confidence": "A+",
          "updateDate": "2026-04-23"
        }
      ],
      "phones": [
        {
          "number": "+14155551234",
          "type": "mobile",
          "updateDate": "2026-04-23"
        }
      ],
      "company": {
        "id": "16303253",
        "name": "Lusha",
        "domain": "www.lusha.com",
        "industry": "Technology, Information & Media"
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/in/orit-shilvock-6243bb5",
        "xUrl": "https://twitter.com/lushaofficial"
      },
      "updateDate": "2026-04-23",
      "error": {
        "code": "NOT_FOUND",
        "message": "Contact not found"
      },
      "clientReferenceId": "my-ref-1"
    }
  ],
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}