# Search Contacts

Search for contacts using various filters. This is step 2 of the prospecting process.


Endpoint: POST /prospecting/contact/search
Security: ApiKeyAuth

## Request fields (application/json):

  - `pages` (object)

  - `pages.page` (number)
    Page number (0-1000)

  - `pages.size` (number)
    Page size (10-40)

  - `filters` (object, required)

  - `filters.contacts` (object)

  - `filters.contacts.include` (object)

  - `filters.contacts.include.departments` (array)
    Example: ["Engineering & Technical"]

  - `filters.contacts.include.seniority` (array)
    Example: ["2"]

  - `filters.contacts.include.existing_data_points` (array)
    Example: ["phone","work_email"]

  - `filters.contacts.include.locations` (array)

  - `filters.contacts.include.locations.continent` (string)
    Example: "North America"

  - `filters.contacts.include.locations.country` (string)
    Example: "United States"

  - `filters.contacts.include.locations.city` (string)
    Example: "New York"

  - `filters.contacts.include.locations.state` (string)
    Example: "New York"

  - `filters.contacts.include.locations.country_grouping` (string)
    Example: "na"

  - `filters.contacts.exclude` (object)
    Same structure as include, for exclusion filters

  - `filters.companies` (object)

## Response 200 fields (application/json):

  - `requestId` (string)
    The unique request ID used for subsequent enrichment requests

  - `currentPage` (number)
    The current page of the search results

  - `totalResults` (number)
    The total number of search results

  - `contacts` (array)

  - `contacts.contactId` (string)
    A unique serial contact ID generated for each search response

  - `contacts.isShown` (boolean)
    Indicates whether the contact was already revealed by any of the account users

  - `contacts.name` (object)

  - `contacts.name.raw` (string)
    Example: "Dustin Moskovitz"

  - `contacts.name.full` (string)
    Example: "Dustin Moskovitz"

  - `contacts.name.first` (string)
    Example: "Dustin"

  - `contacts.name.last` (string)
    Example: "Moskovitz"

  - `contacts.jobTitle` (string)
    The job title held by the person at their current company

  - `contacts.companyId` (number)
    A unique identifier for a Lusha company

  - `contacts.companyName` (string)
    The name of the company where the person currently works

  - `contacts.fqdn` (string)
    The fqdn of the company

  - `contacts.companyDescription` (string)
    A description of the company

  - `contacts.logoUrl` (string)
    The URL of the company's logo

  - `contacts.hasCompanyEmployeesCount` (boolean)

  - `contacts.hasCompanyRevenue` (boolean)

  - `contacts.hasCompanyMainIndustry` (boolean)

  - `contacts.hasCompanySubIndustry` (boolean)

  - `contacts.hasCompanyFunding` (boolean)

  - `contacts.hasCompanyIntent` (boolean)

  - `contacts.hasCompanyTechnologies` (boolean)

  - `contacts.hasDepartment` (boolean)

  - `contacts.hasSeniority` (boolean)

  - `contacts.hasContactLocation` (boolean)

  - `contacts.hasSocialLink` (boolean)

  - `contacts.hasEmails` (boolean)

  - `contacts.hasWorkEmail` (boolean)

  - `contacts.hasPrivateEmail` (boolean)

  - `contacts.hasPhones` (boolean)

  - `contacts.hasMobilePhone` (boolean)

  - `contacts.hasDirectPhone` (boolean)

  - `contacts.hasCompanyCity` (boolean)

  - `contacts.hasCompanyCountry` (boolean)

## Response 400 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 429 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