# Search Multiple Contacts

Enrich multiple contacts in a single request. This endpoint allows you to submit a list of contacts 
and receive enriched data for each one, including company information.

Rate Limits: Please check your account limits for bulk operations.

Endpoint: POST /v2/person
Version: 2.0.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `contacts` (array, required)
    This is a required parameter that should contain a list of contact objects. Each contact will be processed based on the provided contact details.

  - `metadata` (object)
    Metadata for the search to filter the results

  - `metadata.refreshJobInfo` (boolean)
    Set this to true to refresh job information for the contact. This replaces any outdated job details with the most current information. By default, Lusha returns results for records that have at least one of the specified contact details (e.g., phone number or email address).
    Example: true

  - `metadata.filterBy` (string)
    Filters the results based on specific contact details. Use the following options: emailAddresses, phoneNumbers
    Example: "emailAddresses"

  - `metadata.revealEmails` (boolean)
    Indicates whether to reveal the email addresses of the contacts
    Example: true

  - `metadata.revealPhones` (boolean)
    Indicates whether to reveal the phone numbers of the contacts
    Example: true

## Response 200 fields (application/json):

  - `contacts` (object, required)
    The contacts of the bulk person output

  - `contacts.1111` (any)

  - `companies` (object, required)
    The companies of the bulk person output

  - `companies.123` (any)


## Response 400 fields

## Response 401 fields

## Response 429 fields

## Response 500 fields