POST /prospecting/company/enrich - Enrich companies

POST

prospecting

company

enrich

Enrich Companies

curl --request POST \
  --url https://api.lusha.com/prospecting/company/enrich \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "requestId": "5ad275c8-7dd4-462a-bd45-6bc1970da64e",
  "companiesIds": [
    "1586"
  ]
}
'

import requests

url = "https://api.lusha.com/prospecting/company/enrich"

payload = {
    "requestId": "5ad275c8-7dd4-462a-bd45-6bc1970da64e",
    "companiesIds": ["1586"]
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({requestId: '5ad275c8-7dd4-462a-bd45-6bc1970da64e', companiesIds: ['1586']})
};

fetch('https://api.lusha.com/prospecting/company/enrich', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

HttpResponse<String> response = Unirest.post("https://api.lusha.com/prospecting/company/enrich")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"requestId\": \"5ad275c8-7dd4-462a-bd45-6bc1970da64e\",\n  \"companiesIds\": [\n    \"1586\"\n  ]\n}")
  .asString();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lusha.com/prospecting/company/enrich"

	payload := strings.NewReader("{\n  \"requestId\": \"5ad275c8-7dd4-462a-bd45-6bc1970da64e\",\n  \"companiesIds\": [\n    \"1586\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "requestId": "5ad275c8-7dd4-462a-bd45-6bc1970da64e",
  "companies": [
    {
      "id": 33222678,
      "name": "Lusha",
      "fqdn": "www.lusha.com",
      "description": "Lusha is the sales intelligence platform designed to help businesses get their next customers.",
      "companySize": { "min": 201, "max": 500, "employees_in_linkedin": 382 },
      "employees": "201 - 500",
      "revenueRange": [10000000, 50000000],
      "mainIndustry": "Technology, Information & Media",
      "subIndustry": "Software Development",
      "city": "Boston",
      "state": "Massachusetts",
      "country": "United States",
      "countryIso2": "US",
      "continent": "North America",
      "social": {
        "linkedin": "https://www.linkedin.com/company/lushadata",
        "crunchbase": "https://www.crunchbase.com/organization/lusha"
      },
      "funding": {
        "totalRounds": 2,
        "totalRoundsAmount": 245000000,
        "isIpo": false,
        "lastRoundType": "Private Equity Round",
        "lastRoundAmount": 205000000,
        "lastRoundDate": "Nov 10, 2021"
      },
      "technologies": [{ "name": "salesforce" }, { "name": "hubspot" }],
      "surgeInHiring": [
        {
          "newJobsPostedLastWeek": 25,
          "historicalAvg": 10,
          "changeRatePercent": 150
        }
      ]
    }
  ]
}

{
  "statusCode": 400,
  "message": "Validation failed",
  "errors": ["requestId is required"]
}

After searching for companies with POST /prospecting/company/search, use this endpoint to retrieve complete firmographic profiles for up to 100 companies at once. The response includes headcount, revenue ranges, technologies, funding history, intent signals, location details, and more. This is step 3 of the three-step prospecting flow.

Endpoint

POST https://api.lusha.com/prospecting/company/enrich

Authentication: API key (ApiKeyAuth)

Request body

string

required

The requestId returned by the Search Companies response for the same session. Example: "5ad275c8-7dd4-462a-bd45-6bc1970da64e"

string[]

required

Array of company id values from the search results you want to enrich. Minimum 1, maximum 100. Example: ["33222678"]

Example request

curl --request POST \
  --url https://api.lusha.com/prospecting/company/enrich \
  --header 'api_key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "requestId": "5ad275c8-7dd4-462a-bd45-6bc1970da64e",
    "companiesIds": ["33222678", "1586"]
  }'

{
  "requestId": "5ad275c8-7dd4-462a-bd45-6bc1970da64e",
  "companiesIds": ["33222678", "1586"]
}

Response

200 - Success

string

The requestId used in the request.

object[]

Array of enriched company objects, one per requested ID.

Show company fields

number

Lusha company identifier. Example: 33222678

string

Company name. Example: "Lusha"

string

Company description.

string

Primary domain. Example: "www.lusha.com"

object

Domain details.

Show domains fields

string

Email domain. Example: "lusha.com"

string

Homepage domain. Example: "lusha.com"

object

Employee count range.

Show companySize fields

number

Minimum employee count. Example: 11

number

Maximum employee count. Example: 50

number

LinkedIn-reported employee count. Example: 32

string

Formatted employee range string. Example: "10001 - 100000"

number[]

Revenue range in USD as [min, max]. Example: [10000000, 50000000]

string

Primary industry classification. Example: "Technology, Information & Media"

string

Sub-industry classification. Example: "Software Development"

string[]

Industry tag hierarchy, from broadest to most specific. Example: ["Technology, Information & Media", "Software Development"]

string

HQ city. Example: "Boston"

string

HQ state. Example: "Massachusetts"

string

HQ state/province code. Example: "MA"

string

HQ country. Example: "United States"

string

ISO 3166-1 alpha-2 country code. Example: "US"

string

Continent. Example: "North America"

string

Full address string.

number[]

Geo coordinates as [longitude, latitude].

string

Company email domain. Example: "lusha.com"

string

Normalized alternative company name. Example: "lusha systems"

integer

Lusha’s proprietary ranking for the company based on platform popularity.

object[]

All known office locations (not just HQ).

Show companyLocations fields

string

City name.

string

Continent name.

string

Country name.

string

ISO country code.

string | null

State or province.

string | null

State code.

number[]

Coordinates as [longitude, latitude].

Social profile URLs.

Show social fields

LinkedIn company page URL.

Crunchbase profile URL.

string

Company logo URL.

string[]

Company specialties. Example: ["data enrichment", "sales intelligence"]

string

Company type. Example: "Private company"

integer

LinkedIn follower count. Example: 1950

object

Funding history.

Show funding fields

object[]

List of funding rounds with currency, roundAmount, roundType, and roundDate.

number

Total number of funding rounds.

number

Total amount raised across all rounds.

boolean

Whether the company has gone public.

string

Type of the most recent round. Example: "Private Equity Round"

number

Amount of the most recent round.

string

Date of the most recent round.

object

Buyer intent signals.

Show intent fields

object[]

Detected intent topics with topicName, topicScore, and topicTrend.

number

Number of topics detected.

object[]

Technologies in use. Each object has a name field. Example: [{ "name": "salesforce" }]

object[]

Overall hiring surge signals with newJobsPostedLastWeek, historicalAvg, and changeRatePercent.

object[]

Department-level hiring surge signals.

object[]

Location-level hiring surge signals.

object[]

1-month headcount increase signals with baselineEmployeesCount, newEmployeesCount, and changeRatePercent.

object[]

1-month headcount decrease signals. Shares the same shape as headcountIncrease1m.

object[]

3-month headcount increase signals. Shares the same shape as headcountIncrease1m.

object[]

3-month headcount decrease signals. Shares the same shape as headcountIncrease1m.

object[]

6-month headcount increase signals. Shares the same shape as headcountIncrease1m.

object[]

6-month headcount decrease signals. Shares the same shape as headcountIncrease1m.

object[]

12-month headcount increase signals. Shares the same shape as headcountIncrease1m.

object[]

12-month headcount decrease signals. Shares the same shape as headcountIncrease1m.

object[]

Website traffic increase signals with historicalAvg, lastMonthVisits, and changeRatePercent.

object[]

Website traffic decrease signals. Shares the same shape as websiteTrafficIncrease.

object[]

IT spend increase signals with estimatedAnnualItSpend and changeRatePercent.

object[]

IT spend decrease signals. Shares the same shape as itSpendIncrease.

object[]

Partnership and go-to-market news signals.

object[]

M&A, restructuring, or strategic direction change signals. Shares the same shape as commercialActivityNews.

object[]

Funding, IPO, and investment news signals.

object[]

Hiring, layoff, or leadership change signals. Shares the same shape as commercialActivityNews.

object[]

Event participation, recognition, and competitor activity signals. Shares the same shape as commercialActivityNews.

object[]

Product launch, development, and integration news signals. Shares the same shape as commercialActivityNews.

object[]

Litigation and security risk news signals.

Error codes

Status	Meaning
`400`	Validation failed - check that `requestId` and `companiesIds` are present and valid.
`401`	Unauthorized - your API key is missing or invalid.
`429`	Too many requests - you have exceeded the rate limit.
`500`	Internal server error - retry with exponential backoff.

{
  "requestId": "5ad275c8-7dd4-462a-bd45-6bc1970da64e",
  "companies": [
    {
      "id": 33222678,
      "name": "Lusha",
      "fqdn": "www.lusha.com",
      "description": "Lusha is the sales intelligence platform designed to help businesses get their next customers.",
      "companySize": { "min": 201, "max": 500, "employees_in_linkedin": 382 },
      "employees": "201 - 500",
      "revenueRange": [10000000, 50000000],
      "mainIndustry": "Technology, Information & Media",
      "subIndustry": "Software Development",
      "city": "Boston",
      "state": "Massachusetts",
      "country": "United States",
      "countryIso2": "US",
      "continent": "North America",
      "social": {
        "linkedin": "https://www.linkedin.com/company/lushadata",
        "crunchbase": "https://www.crunchbase.com/organization/lusha"
      },
      "funding": {
        "totalRounds": 2,
        "totalRoundsAmount": 245000000,
        "isIpo": false,
        "lastRoundType": "Private Equity Round",
        "lastRoundAmount": 205000000,
        "lastRoundDate": "Nov 10, 2021"
      },
      "technologies": [{ "name": "salesforce" }, { "name": "hubspot" }],
      "surgeInHiring": [
        {
          "newJobsPostedLastWeek": 25,
          "historicalAvg": 10,
          "changeRatePercent": 150
        }
      ]
    }
  ]
}

{
  "statusCode": 400,
  "message": "Validation failed",
  "errors": ["requestId is required"]
}

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

requestId

string

required

The requestId from the Prospecting Search response

Example:

"5ad275c8-7dd4-462a-bd45-6bc1970da64e"

companiesIds

string[]

required

An array of company IDs for enrichment. Min 1, max 100.

Example:

["1586"]

Response

Enriched company data

requestId

string

The requestId used in the request

companies

object[]

Show child attributes

⌘I

Enrich Companies

curl --request POST \
  --url https://api.lusha.com/prospecting/company/enrich \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "requestId": "5ad275c8-7dd4-462a-bd45-6bc1970da64e",
  "companiesIds": [
    "1586"
  ]
}
'

import requests

url = "https://api.lusha.com/prospecting/company/enrich"

payload = {
    "requestId": "5ad275c8-7dd4-462a-bd45-6bc1970da64e",
    "companiesIds": ["1586"]
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({requestId: '5ad275c8-7dd4-462a-bd45-6bc1970da64e', companiesIds: ['1586']})
};

fetch('https://api.lusha.com/prospecting/company/enrich', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

HttpResponse<String> response = Unirest.post("https://api.lusha.com/prospecting/company/enrich")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"requestId\": \"5ad275c8-7dd4-462a-bd45-6bc1970da64e\",\n  \"companiesIds\": [\n    \"1586\"\n  ]\n}")
  .asString();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lusha.com/prospecting/company/enrich"

	payload := strings.NewReader("{\n  \"requestId\": \"5ad275c8-7dd4-462a-bd45-6bc1970da64e\",\n  \"companiesIds\": [\n    \"1586\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "requestId": "5ad275c8-7dd4-462a-bd45-6bc1970da64e",
  "companies": [
    {
      "id": 33222678,
      "name": "Lusha",
      "fqdn": "www.lusha.com",
      "description": "Lusha is the sales intelligence platform designed to help businesses get their next customers.",
      "companySize": { "min": 201, "max": 500, "employees_in_linkedin": 382 },
      "employees": "201 - 500",
      "revenueRange": [10000000, 50000000],
      "mainIndustry": "Technology, Information & Media",
      "subIndustry": "Software Development",
      "city": "Boston",
      "state": "Massachusetts",
      "country": "United States",
      "countryIso2": "US",
      "continent": "North America",
      "social": {
        "linkedin": "https://www.linkedin.com/company/lushadata",
        "crunchbase": "https://www.crunchbase.com/organization/lusha"
      },
      "funding": {
        "totalRounds": 2,
        "totalRoundsAmount": 245000000,
        "isIpo": false,
        "lastRoundType": "Private Equity Round",
        "lastRoundAmount": 205000000,
        "lastRoundDate": "Nov 10, 2021"
      },
      "technologies": [{ "name": "salesforce" }, { "name": "hubspot" }],
      "surgeInHiring": [
        {
          "newJobsPostedLastWeek": 25,
          "historicalAvg": 10,
          "changeRatePercent": 150
        }
      ]
    }
  ]
}

{
  "statusCode": 400,
  "message": "Validation failed",
  "errors": ["requestId is required"]
}

​Endpoint

​Request body

​Example request

​Response

​200 - Success

​Error codes

Authorizations

Body

Response

Endpoint

Request body

Example request

Response

200 - Success

Error codes