# Enrich Contacts

Reveal full contact data for contacts you've already found via Search Contacts.

Pass up to 100 contact ids (from the search response). Use the reveal field to control what gets unlocked:
- emails — work and personal email addresses
- phones — mobile and direct phone numbers
- Omit reveal to get both by default

> Tip: If canReveal.credits is 0 in the search response, that data has already been revealed for your account — re-enriching it is free.

> Billing: Charged per revealed field (email or phone) via per-datapoint pricing.

Endpoint: POST /v3/contacts/enrich
Security: ApiKeyAuth

## Request fields (application/json):

  - `ids` (array, required)
    Example: ["4389064654","4389064624"]

  - `reveal` (array)
    Enum: "emails", "phones"

## Response 200 fields (application/json):

  - `requestId` (string)

  - `results` (array)

  - `results.id` (string)
    Example: "4389064704"

  - `results.firstName` (string)
    Example: "Orit"

  - `results.lastName` (string)
    Example: "Shilvock"

  - `results.fullName` (string)
    Example: "Orit Shilvock"

  - `results.jobTitle` (object)

  - `results.jobTitle.title` (string)
    Example: "Vice President of Partnerships"

  - `results.jobTitle.departments` (array)
    Example: ["Business Development"]

  - `results.jobTitle.seniority` (string)
    Example: "Vice President"

  - `results.location` (object)

  - `results.location.country` (string)
    Example: "Israel"

  - `results.location.countryIso2` (string)
    Example: "IL"

  - `results.location.state` (string)
    Example: "Tel Aviv District"

  - `results.location.city` (string)
    Example: "Tel Aviv"

  - `results.location.continent` (string)
    Example: "Asia"

  - `results.location.coordinates` (array)
    Example: [34.78057098388672,32.08087921142578]

  - `results.location.isEuContact` (boolean)

  - `results.tags` (array)

  - `results.tags.name` (string)

  - `results.tags.color` (string)
    Example: "#FF5733"

  - `results.emails` (array)

  - `results.emails.email` (string)
    Example: "orit.shilvock@lusha.com"

  - `results.emails.type` (string)
    Enum: "work", "private", "unknown"

  - `results.emails.confidence` (string,null)
    Example: "A+"

  - `results.emails.updateDate` (string)
    Example: "2026-04-23"

  - `results.phones` (array)

  - `results.phones.number` (string)
    Example: "+14155551234"

  - `results.phones.doNotCall` (boolean)

  - `results.company` (object)

  - `results.company.domain` (string)
    Example: "www.lusha.com"

  - `results.company.industry` (string)
    Example: "Technology, Information & Media"

  - `results.socialLinks` (object)

  - `results.socialLinks.linkedin` (string)
    Example: "https://www.linkedin.com/in/orit-shilvock-6243bb5"

  - `results.socialLinks.xUrl` (string)
    Example: "https://twitter.com/lushaofficial"

  - `results.previousEmployment` (array)

  - `results.error` (object)
    Per-item error in a batch response

  - `results.error.code` (string)
    Enum: "NOT_FOUND", "COMPLIANCE_RESTRICTED", "ENRICH_FAILED"

  - `results.error.message` (string)
    Example: "Contact not found"

  - `billing` (object)
    Credit usage summary for a V3 API request

  - `billing.creditsCharged` (integer)
    Total credits charged for this request
    Example: 3

  - `billing.resultsReturned` (integer)
    Number of successful results returned
    Example: 1

## 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"]

## Response 401 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"]

## Response 402 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"]

## Response 403 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"]

## Response 429 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"]