# Enrich Companies

Reveal full company data for companies you've already found via Search Companies.

Pass up to 100 company ids (from the search response). Each enriched result includes:
- Firmographics: size, revenue range, year founded, company type
- Industry: primary industry, sub-industry, SIC/NAICS codes
- Locations: HQ and additional office sites
- Technologies, funding rounds, buyer intent topics
- LinkedIn followers, logo URL, social links

> Billing: Charged per successful result via the reveal_company action.

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

## Request fields (application/json):

  - `ids` (array, required)
    Company IDs from search results (strings)
    Example: ["16303253","12790225"]

  - `reveal` (array)
    Additional data fields to reveal. Each field is charged separately per result.
- employeesByDepartment — breakdown of employees by department
- employeesByLocation — breakdown of employees by country/state
- employeesBySeniority — breakdown of employees by seniority level
- competitors — list of competitor company IDs
- intent — buyer intent topics
    Enum: "employeesByDepartment", "employeesByLocation", "employeesBySeniority", "competitors", "intent"

## Response 200 fields (application/json):

  - `requestId` (string)

  - `results` (array)

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

  - `results.name` (string)
    Example: "Lusha"

  - `results.alternativeName` (string)
    Example: "lusha"

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

  - `results.alternativeDomains` (array)
    Example: ["lusha.com"]

  - `results.description` (string)
    Example: "Lusha is the leader in Sales Streaming."

  - `results.companyType` (string)
    Example: "Private Company"

  - `results.yearFounded` (number)
    Example: 2016

  - `results.employeeCount` (object)

  - `results.employeeCount.exact` (integer)
    Example: 364

  - `results.employeeCount.min` (integer)
    Example: 201

  - `results.employeeCount.max` (integer)
    Example: 500

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

  - `results.subIndustry` (string)
    Example: "Software Development"

  - `results.specialities` (array)
    Example: ["data enrichment","sales intelligence"]

  - `results.industryTags` (array)
    Example: ["saas","b2b"]

  - `results.sicCodes` (array)

  - `results.sicCodes.code` (integer)
    Example: 7371

  - `results.naicsCodes` (array)

  - `results.location` (object)

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

  - `results.location.state` (string)
    Example: "England"

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

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

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

  - `results.location.zipCode` (string)
    Postal/ZIP code (present on HQ location when available)
    Example: "80904"

  - `results.additionalLocations` (array)

  - `results.socialLinks` (object)

  - `results.socialLinks.linkedin` (string)
    Example: "https://www.linkedin.com/company/lushadata"

  - `results.linkedinFollowers` (number)
    Example: 64339

  - `results.revenueRange` (object)

  - `results.funding` (any)
    Funding payload when present

  - `results.intent` (any)
    Intent payload when present

  - `results.technologies` (array)
    Example: ["react","node.js","aws"]

  - `results.popularityTier` (number)
    Example: 1

  - `results.logoUrl` (string)
    Example: "https://logo.lusha.co/logo.jpg"

  - `results.employeesByDepartment` (array)
    Breakdown of employees by department. Revealed via reveal: ["employeesByDepartment"] in Enrich Companies.
    Example: [{"department":"Engineering & Technical","count":14},{"department":"Operations","count":40},{"department":"Other","count":104}]

  - `results.employeesByDepartment.department` (string)
    Department name
    Example: "Engineering & Technical"

  - `results.employeesByDepartment.count` (integer)
    Number of employees in this department
    Example: 14

  - `results.employeesByLocation` (array)
    Breakdown of employees by country and state. Revealed via reveal: ["employeesByLocation"] in Enrich Companies.
    Example: [{"country":"United States","state":"Colorado","count":54},{"country":"United States","state":"Texas","count":44},{"country":"United States","state":null,"count":162}]

  - `results.employeesByLocation.country` (string)
    Country name
    Example: "United States"

  - `results.employeesByLocation.state` (string,null)
    State or region (null when not available)
    Example: "Colorado"

  - `results.employeesByLocation.count` (integer)
    Number of employees in this location
    Example: 54

  - `results.employeesBySeniority` (array)
    Breakdown of employees by seniority level. Revealed via reveal: ["employeesBySeniority"] in Enrich Companies.
    Example: [{"seniority":"Non-Manager","count":122},{"seniority":"Manager","count":39},{"seniority":"Vice President","count":3}]

  - `results.employeesBySeniority.seniority` (string)
    Seniority level
    Example: "Manager"

  - `results.employeesBySeniority.count` (integer)
    Number of employees at this seniority level
    Example: 39

  - `results.competitors` (array)
    List of competitor companies. Revealed via reveal: ["competitors"] in Enrich Companies. Use Enrich Companies with the returned IDs to get full firmographic data on each competitor.
    Example: [{"id":"2497917","name":"Clearbit","domain":"clearbit.com"},{"id":"9781263","name":"Hunter.io","domain":"hunter.io"},{"id":"40857684","name":"MCJ Solutions Inc","domain":"zoominfo.com"}]

  - `results.competitors.id` (string)
    Lusha company ID of the competitor
    Example: "2497917"

  - `results.competitors.name` (string)
    Company name of the competitor
    Example: "Clearbit"

  - `results.competitors.domain` (string)
    Primary domain of the competitor
    Example: "clearbit.com"

  - `results.businessModel` (array)
    Company business model classification (e.g. B2B, B2C)
    Example: ["B2B"]

  - `results.phone` (string)
    Company phone number
    Example: "(480) 729-6394"

  - `results.email` (string)
    Company contact email address
    Example: "info@cobbmechanical.com"

  - `results.keywords` (array)
    Keywords associated with the company (normalized from specialities and description)
    Example: ["construction","hvac","plumbing","mechanical system"]

  - `results.specialitiesRefactored` (array)
    Normalized version of the specialities list
    Example: ["construction","hvac","industrial piping","mechanical systems","plumbing"]

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

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