Skip to main content
POST
Enrich Companies
Use this endpoint to reveal full company data for companies you’ve already found via Search Companies. Pass the Lusha id from a search result. Every enriched result includes firmographics, industry codes, and locations by default; use reveal to add employee breakdowns, competitors, and intent.
Enrich Companies only works with id values returned by Search Companies. To search and reveal in one call, use Search and Enrich Companies instead.

Endpoint

Authentication

string
required
Your Lusha API key.

Request body

string[]
required
Up to 100 Lusha company IDs, from a Search Companies response.Example: ["16303253", "12790225"]
string[]
Additional data to include for each company.Allowed values: employeesByDepartment, employeesByLocation, employeesBySeniority, competitors, intent

Response

string
Unique ID for this request, in UUID format.
object[]
One entry per company id you passed in.
object
Billing: Charged per successful result via the reveal_company action.

Error codes

Example

Example response

Authorizations

api_key
string
header
required

Your Lusha API key. You can find this in your Lusha dashboard under API settings. Include this key in the api_key header for all requests.

Body

application/json
ids
string[]
required

Company IDs from search results (strings)

Required array length: 1 - 100 elements
Example:
reveal
enum<string>[]

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
  • estimatedAnnualItSpend - estimated annual IT spend.
  • monthlyWebsiteTraffic - monthly website traffic and month-over-month change.
  • openJobsTotal - reveals the total open job count. In the response, this appears as the total field inside the openJobs object.
  • openJobsByDepartment - reveals open job counts broken down by department. In the response, this appears as the byDepartment field inside the openJobs object.
  • openJobsByLocation - reveals open job counts broken down by location. In the response, this appears as the byLocation field inside the openJobs object.
  • openJobsBySeniority - reveals open job counts broken down by seniority level. In the response, this appears as the bySeniority field inside the openJobs object.
  • directParent - the company's immediate parent in its ownership tree.
  • ultimateParent - the company at the top of its ownership tree.
Available options:
employeesByDepartment,
employeesByLocation,
employeesBySeniority,
competitors,
intent,
estimatedAnnualItSpend,
monthlyWebsiteTraffic,
openJobsTotal,
openJobsByDepartment,
openJobsByLocation,
openJobsBySeniority,
directParent,
ultimateParent
Example:
tableId
string

Optional. If provided, these companies are also added to this table (if not already present) and the revealed fields' columns are populated. See the Tables API.

Example:

"583021"

Response

Successful response

requestId
string<uuid>
results
object[]
tableWrite
object

Added to a Prospecting, Enrich, Signals, or Lookalike response when tableId is passed on the request. The primary response is unaffected even if the table write fails.

billing
object

Credit usage summary for a V3 API request