Search
Search Contacts
Look up contacts by identifier. Returns a non-PII preview of each profile — no emails or phone numbers.
Accepted identifiers (one required per contact):
- Lusha contact id
- linkedinUrl
- firstName + lastName + companyName or companyDomain
Up to 100 contacts per request. Each result includes:
- has — data points available on this profile
- canReveal — what you can unlock via Enrich Contacts, and the credit cost
Pass a signals filter to narrow results to contacts with recent activity (e.g. promotion, job change).
Billing: Charged per successful result via the api_search action.
post/v3/contacts/search
Request body
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"
}
],
"options": {
"includePartialProfiles": true
},
"signals": {
"types": [
"promotion",
"companyChange"
],
"startDate": "2025-01-01",
"maxResultsPerSignal": 10
}
}Response
Successful response
Example response
{
"requestId": "3c7f6d96-4a72-40cd-96c1-2efcfabeb727",
"results": [
{
"clientReferenceId": "my-ref-1",
"id": "4389064704",
"firstName": "Orit",
"lastName": "Shilvock",
"jobTitle": {
"title": "Vice President of Partnerships",
"departments": [
"Business Development"
],
"seniority": "Vice President"
},
"company": {
"id": "16303253",
"name": "Lusha",
"domain": "www.lusha.com"
},
"location": {
"country": "Israel",
"state": "Tel Aviv District",
"city": "Tel Aviv"
},
"socialLinks": {
"linkedin": "https://www.linkedin.com/in/orit-shilvock-6243bb5"
},
"has": [
"firstName",
"lastName",
"jobTitle",
"location",
"socialLinks",
"emails"
],
"canReveal": [
{
"field": "emails",
"credits": 1
}
],
"signalTypes": [
"promotion",
"companyChange"
],
"error": {
"code": "NOT_FOUND",
"message": "Contact not found"
}
}
],
"billing": {
"creditsCharged": 3,
"resultsReturned": 1
}
}