# Search Single Contact

Find and enrich a single contact using various search criteria. You can search by name, email, 
LinkedIn URL, or company information.

: You must provide either:
- LinkedIn URL OR
- Email OR
- firstName AND lastName AND (companyName OR companyDomain)


- Provide as much information as possible for better results
- Use  to get the latest employment data
- Use  parameter to specify what contact details you need

---

⚠️ 

| Parameter | Requirement |
|-----------|-------------|
|  and  | Only available to customers on the  pricing plan |
| Plan Restriction | Attempting to use these parameters on other plans will result in a  error |
| Default Behavior | When neither parameter is used, the API returns , 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"

  - `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:
- : Only return contacts with phone numbers
- : Only return contacts with email addresses

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

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

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

## Response 200 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 401 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 403 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 404 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 429 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 451 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 500 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message