# Search Single Contact

Find and enrich a single contact using various search criteria. You can search by name, email,
LinkedIn URL, or Person Id.
>##### Endpoint
  
GET https://api.lusha.com/v2/person
  


>##### Search Requirements
You must provide either:
- personId OR
- email OR
- linkedinUrl OR
- firstName AND lastName AND (companyName OR companyDomain)

>##### Notes:
- Provide as much information as possible for better results
- Using personId provides the most direct way to retrieve contact information, as it uniquely identifies a contact in Lusha's database.
- Use refreshJobInfo=true to get the latest employment data
- Use filterBy parameter to specify what contact details you need
- Include the signals parameter to retriever contact signals (If no signals data is found for the specified period, the signals object will be empty but still present in the response.)
  - When requesting signals, you can optionally specify a start date using signalsStartDate.
  - Signals data is optional. If you don't include the signals parameter, no signals data will be returned.



---

⚠️ Important Notice - Unified Credits Plan Required

| Parameter | Requirement |
|-----------|-------------|
| revealEmails and revealPhones | Only available to customers on the Unified Credits pricing plan |
| Plan Restriction | Attempting to use these parameters on other plans will result in a 403 Unauthorized error |
| Default Behavior | When neither parameter is used, the API returns both email addresses and phone numbers, if available |

---

Endpoint: GET /v2/person
Security: ApiKeyAuth

## Query parameters:

  - `firstName` (string)
    The first name of the person
    Example: "Dustin"

  - `lastName` (string)
    The last name of the person
    Example: "Moskovitz"

  - `personId` (string)
    The unique person identifier in Lusha
    Example: "4183886134"

  - `companyName` (string)
    The name of the company the person works at
    Example: "Lusha"

  - `companyDomain` (string)
    The domain name of the company
    Example: "lusha.com"

  - `email` (string)
    The email address of the person
    Example: "dustin@lusha.com"

  - `linkedinUrl` (string)
    The LinkedIn URL of the person
    Example: "https://www.linkedin.com/in/dustin/"

  - `refreshJobInfo` (boolean)
    Set to true to refresh and update the job details for the person.
This ensures that outdated job information is replaced with the most recent data.
    Example: true

  - `filterBy` (string)
    Filters results based on specific contact details. Available options:
- phoneNumbers: Only return contacts with phone numbers
- emailAddresses: Only return contacts with email addresses

By default, results will include contacts with at least one contact detail.
    Enum: "phoneNumbers", "emailAddresses"

  - `revealEmails` (boolean)
    Set revealEmails=true to retrieve only the email address of the contact.
    Example: true

  - `revealPhones` (boolean)
    Set revealPhones=true to retrieve only the phone number of the contact.
    Example: true

  - `signals` (array)
    Array of signal types to retrieve for the contact.
- allSignals: All available signal types
- promotion: Promotion signals
- companyChange: Company change signals
    Enum: "allSignals", "promotion", "companyChange"

  - `signalsStartDate` (string)
    Start date for signal retrieval in YYYY-MM-DD format. Defaults to 6 months ago if not specified.
    Example: "2025-03-01"

  - `partialProfile` (boolean)
    Search for a single contact with the option to receive a partial profile.
    Example: true

## Response 200 fields (application/json):

  - `contact` (object, required)

  - `contact.error` (object, required)

  - `contact.error.code` (number)
    The code of the contact error
    Example: 3

  - `contact.error.name` (string)
    The name of the contact error
    Example: "EMPTY_DATA"

  - `contact.error.message` (string)
    The message of the contact error
    Example: "Could not find requested data"

  - `contact.isCreditCharged` (boolean, required)
    Example: true

  - `contact.data` (object)

  - `contact.data.companyId` (number, required)
    Example: 123

  - `contact.data.firstName` (string, required)
    Example: "Dustin"

  - `contact.data.lastName` (string, required)
    Example: "Moskovitz"

  - `contact.data.fullName` (string, required)
    Example: "Dustin Moskovitz"

  - `contact.data.emails` (array)
    Simple array of email addresses (deprecated - use emailAddresses)
    Example: ["john.doe@example.com"]

  - `contact.data.emailAddresses` (array)
    Detailed email addresses with metadata

  - `contact.data.emailAddresses.email` (string)
    The email address (alternative to 'address')
    Example: "dustin@lusha.com"

  - `contact.data.emailAddresses.address` (string)
    The email address (alternative to 'email')
    Example: "dustin@lusha.com"

  - `contact.data.emailAddresses.emailType` (string)
    The type of email address (alternative to 'type')
    Enum: "work", "private"

  - `contact.data.emailAddresses.emailConfidence` (string)
    The confidence level of the email address
    Example: "A+"

  - `contact.data.emailAddresses.updateDate` (string)
    The update date of the email address
    Example: "2020-01-01"

  - `contact.data.phones` (string)
    Simple array of phone numbers (deprecated - use phoneNumbers)
    Example: "+1 555-123-4567"

  - `contact.data.phoneNumbers` (array)
    Detailed phone numbers with metadata

  - `contact.data.phoneNumbers.number` (string)
    The phone number
    Example: "+1234567890"

  - `contact.data.phoneNumbers.phoneType` (string, required)
    The type of phone number
    Enum: "Mobile", "Direct", "Phone"

  - `contact.data.phoneNumbers.doNotCall` (boolean, required)
    Indicates whether the phone number is listed as "Do Not Call" (DNC).

  - `contact.data.phoneNumbers.updateDate` (string, required)
    The update date of the phone number
    Example: "2020-01-01"

  - `contact.data.personId` (number)
    Example: 123456

  - `contact.data.location` (object)

  - `contact.data.location.country` (string, required)
    The country where the person is located.
    Example: "Israel"

  - `contact.data.location.countryIso2` (string, required)
    The ISO 3166-1 alpha-2 country code of the person.
    Example: "IL"

  - `contact.data.location.country_iso2` (string)
    The ISO 3166-1 alpha-2 country code of the person.
    Example: "IL"

  - `contact.data.location.continent` (string, required)
    The continent where the person is located.
    Example: "Asia"

  - `contact.data.location.rawLocation` (string, required)
    The detailed address.
    Example: "800 Boylston St, Suite 1410, Boston, MA 02199, US"

  - `contact.data.location.region` (string)
    The region where the person is located.
    Example: "Tel Aviv"

  - `contact.data.location.city` (string)
    The city where the person is located.
    Example: "Tel Aviv"

  - `contact.data.location.cityId` (number)
    The ID of the city where the person is located.
    Example: 123

  - `contact.data.location.state` (string)
    The state where the person is located.
    Example: "Tel Aviv"

  - `contact.data.location.stateCode` (string)
    The state code of the person.
    Example: "IL"

  - `contact.data.location.state_code` (string)
    The state code of the person.
    Example: "IL"

  - `contact.data.location.street` (string)
    The street where the person is located.
    Example: "123 Main St"

  - `contact.data.location.locationCoordinates` (array)
    The coordinates of the person.
    Example: [32.0853,34.7818]

  - `contact.data.location.isEuContact` (boolean)
    Indicates whether the person is in the EU.
    Example: true

  - `contact.data.jobTitle` (object)

  - `contact.data.jobTitle.seniority` (string, required)
    Example: "Director"

  - `contact.data.jobTitle.title` (string, required)
    Example: "Director of Platform"

  - `contact.data.jobTitle.departments` (array, required)
    Example: ["Engineering","Operations"]

  - `contact.data.socialLinks` (object)

  - `contact.data.socialLinks.linkedin` (string, required)
    Example: "https://www.linkedin.com/in/dustin/"

  - `contact.data.socialLinks.xUrl` (string)
    Example: "https://twitter.com/dustin"

  - `contact.data.jobStartDate` (string)
    Example: "2020-01-01"

  - `contact.data.previousJob` (object)

  - `contact.data.previousJob.jobTitle` (object, required)

  - `contact.data.previousJob.company` (object, required)

  - `contact.data.previousJob.company.name` (string)
    The name of the company, Required if no domain.
    Example: "Lusha"

  - `contact.data.previousJob.company.domain` (string)
    The domain of the company, Required if no name.
    Example: "lusha.com"

  - `contact.data.previousJob.company.isCurrent` (boolean, required)
    Indicates whether this is the person's current company
    Example: true

  - `contact.data.previousJob.company.jobTitle` (string)
    The job title of the person at the company
    Example: "Software Engineer"

  - `contact.data.previousJob.company.fqdn` (string)
    The fully qualified domain name of the company
    Example: "https://lusha.com"

  - `contact.data.previousJob.company.companySocialId` (string)
    The social ID associated with the company (if available)
    Example: "1234567890"

  - `contact.data.contactTags` (array)

  - `contact.data.contactTags.id` (string, required)
    Example: "123"

  - `contact.data.contactTags.name` (string, required)
    Example: "Prospect"

  - `contact.data.contactTags.color` (string, required)
    Example: "#000000"

  - `contact.data.updateDate` (string)
    Example: "2020-01-01"

  - `contact.data.linkedinFollowersCount` (integer)
    Example: 1250

  - `contact.data.linkedinConnectionsCount` (integer)
    Example: 500

  - `contact.data.linkedinCertifications` (array)

  - `contact.data.linkedinCertifications.companyId` (integer)
    Example: 1035

  - `contact.data.linkedinCertifications.companyName` (string)
    Example: "Microsoft"

  - `contact.data.linkedinCertifications.credentialId` (string)
    Example: "abc123"

  - `contact.data.linkedinCertifications.dateMonth` (any)
    Example: 6

  - `contact.data.linkedinCertifications.dateYear` (any)
    Example: 2020

  - `contact.data.linkedinCertifications.expireDateMonth` (any)
    Example: 6

  - `contact.data.linkedinCertifications.expireDateYear` (any)
    Example: 2025

  - `contact.data.linkedinCertifications.linkedinCompanyId` (integer,null)
    Example: 1441

  - `contact.data.linkedinCertifications.summary` (string,null)
    Example: "Azure fundamentals certification covering cloud concepts"

  - `contact.data.linkedinCertifications.title` (string)
    Example: "Microsoft Certified: Azure Fundamentals"

  - `contact.data.linkedinCertifications.verifyUrl` (string,null)
    Example: "https://www.youracclaim.com/badges/5ccf865c-dd6e-4dcc-9184-c8999d31f83d"

  - `contact.data.linkedinCourses` (array)

  - `contact.data.linkedinCourses.activities` (string,null)

  - `contact.data.linkedinCourses.degree` (string,null)

  - `contact.data.linkedinCourses.endDateMonth` (any)

  - `contact.data.linkedinCourses.endDateYear` (any)

  - `contact.data.linkedinCourses.fieldOfStudy` (object,null)

  - `contact.data.linkedinCourses.fieldOfStudy.id` (string,null)

  - `contact.data.linkedinCourses.fieldOfStudy.name` (string,null)

  - `contact.data.linkedinCourses.grade` (string,null)

  - `contact.data.linkedinCourses.school` (object,null)

  - `contact.data.linkedinCourses.school.id` (string,null)

  - `contact.data.linkedinCourses.school.logoUrl` (string,null)

  - `contact.data.linkedinCourses.school.name` (string,null)

  - `contact.data.linkedinCourses.startDateMonth` (any)

  - `contact.data.linkedinCourses.startDateYear` (any)

  - `contact.data.linkedinCourses.linkedinSchoolId` (number,null)

  - `contact.data.linkedinAwards` (array)

  - `contact.data.linkedinAwards.companyName` (string,null)
    Example: "Columbia Southern University"

  - `contact.data.linkedinAwards.dateDay` (any)
    Example: 15

  - `contact.data.linkedinAwards.dateMonth` (any)
    Example: 7

  - `contact.data.linkedinAwards.dateYear` (any)
    Example: 2023

  - `contact.data.linkedinAwards.linkedinCompanyId` (string,null)

  - `contact.data.linkedinAwards.summary` (string,null)
    Example: "Certificate of Recognition for Exceptional Teaching"

  - `contact.data.linkedinAwards.title` (string)
    Example: "Raising the Bar Award"

  - `contact.data.linkedinSkills` (array)
    Example: ["Microsoft Office","Project Management","Strategic Planning"]

  - `contact.data.company` (object, required)

  - `contact.data.company.name` (string, required)
    Example: "Lusha"

  - `contact.data.company.description` (string)
    Example: "Lusha is a company that provides a platform for companies to find and connect with potential customers."

  - `contact.data.company.domains` (object)

  - `contact.data.company.domains.homepage` (string)
    Example: "https://www.lusha.com"

  - `contact.data.company.domains.email` (string)
    Example: "contact@lusha.com"

  - `contact.data.company.homepageUrl` (string)
    Example: "https://www.lusha.com"

  - `contact.data.company.fqdn` (string, required)
    Example: "lusha.com"

  - `contact.data.company.location` (object)

  - `contact.data.company.companySize` (array)
    Example: [100,1000]

  - `contact.data.company.revenueRange` (array)
    Example: [1000000,10000000]

  - `contact.data.company.industryPrimaryGroup` (string)
    Example: "Software"

  - `contact.data.company.logoUrl` (string)
    Example: "https://www.lusha.com/logo.png"

  - `contact.data.company.social` (object)

  - `contact.data.company.social.linkedin` (string)
    Example: "https://www.linkedin.com/in/dustin/"

  - `contact.data.company.social.crunchbase` (string)
    Example: "https://www.crunchbase.com/person/dustin-moskovitz"

  - `contact.data.company.social.twitter` (string)
    Example: "https://twitter.com/dustin"

  - `contact.data.company.social.facebook` (string)
    Example: "https://www.facebook.com/dustin"

  - `contact.data.company.specialities` (array)
    Example: ["Software","Sales"]

  - `contact.data.company.technologies` (array)
    Example: [{"name":"JavaScript"},{"name":"Python"}]

  - `contact.data.company.technologies.name` (string, required)
    Example: "salesforce"

  - `contact.data.company.funding` (object)

  - `contact.data.company.funding.totalRounds` (number, required)
    Example: 10

  - `contact.data.company.funding.totalRoundsAmount` (number)
    Example: 1000000

  - `contact.data.company.funding.currency` (string, required)
    Example: "USD"

  - `contact.data.company.funding.isIpo` (boolean, required)
    Example: true

  - `contact.data.company.funding.lastFundingEventDate` (string)
    Example: "2020-01-01"

  - `contact.data.company.funding.lastFundingEventAmount` (number)
    Example: 1000000

  - `contact.data.company.funding.lastFundingEventName` (string)
    Example: "Series A"

  - `contact.data.company.funding.rounds` (array)

  - `contact.data.company.funding.rounds.announcedOn` (string)
    Example: "2020-01-01"

  - `contact.data.company.funding.rounds.leadInvestors` (array)
    Example: ["Investor 1","Investor 2"]

  - `contact.data.company.funding.rounds.currency` (string, required)
    Example: "USD"

  - `contact.data.company.funding.rounds.title` (string, required)
    Example: "Series A"

  - `contact.data.company.funding.rounds.moneyRaised` (number)
    Example: 1000000

  - `contact.data.company.industry` (object)

  - `contact.data.company.industry.mainIndustry` (string, required)
    Example: "Software"

  - `contact.data.company.industry.subIndustry` (string, required)
    Example: "Sales"

  - `contact.data.company.intent` (object)

  - `contact.data.company.intent.topicCount` (integer, required)
    Example: 6

  - `contact.data.company.intent.detectedTopics` (array, required)

  - `contact.data.company.intent.detectedTopics.topicName` (string, required)
    Example: "Remote Sales"

  - `contact.data.company.intent.detectedTopics.metadata` (object, required)

  - `contact.data.company.intent.detectedTopics.metadata.topicScore` (number, required)
    Example: 83

  - `contact.data.company.intent.detectedTopics.metadata.topicTrend` (string, required)
    Example: "-5"

  - `contact.data.company.industryPrimaryGroupDetails` (object)

  - `contact.data.company.industryPrimaryGroupDetails.sicCodes` (array)

  - `contact.data.company.industryPrimaryGroupDetails.sicCodes.sicCodes` (number)
    Example: 1234

  - `contact.data.company.industryPrimaryGroupDetails.sicCodes.description` (string, required)
    Example: "Software Publishing"

  - `contact.data.company.industryPrimaryGroupDetails.naicsCodes` (array)

  - `contact.data.company.industryPrimaryGroupDetails.naicsCodes.naicsCodes` (number)
    Example: 541511

  - `contact.data.company.industryPrimaryGroupDetails.naicsCodes.description` (string, required)
    Example: "Custom Computer Programming Services"

## Response 400 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]