> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lusha.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Bulk enrich up to 100 companies with POST /bulk/company/v2
> Submit up to 100 companies in one request and receive firmographics, signals, and funding data for each using the Lusha bulk company enrichment endpoint.
Use `POST /bulk/company/v2` to enrich multiple companies in a single request. Submit a list of up to 100 company objects and Lusha returns firmographics, headcount, funding, technologies, intent data, and optional signals for each one. Unlike the single-company endpoint, this endpoint supports signal sub-filters for precise signal retrieval.
**Endpoint**
```
POST https://api.lusha.com/bulk/company/v2
```
**Authentication:** Include your API key in the `api_key` request header.
## Request requirements
Each company object in the `companies` array must include an `id` (your own sequential identifier for matching results) and at least one of the following:
* `domain` - the company's web domain (recommended)
* `name` - the company name
* `companyId` - the Lusha company identifier
`signalsFilters` supports `newsEventTypes`, `hiringByDepartments`, and `hiringByLocations` sub-filters that are **not** available on the single-company `GET /v2/company` endpoint. Use this endpoint when you need filtered signal results.
## Request body fields
### `companies` array (required)
Your own unique sequential ID for this company. Used to match each result in the response back to your input. Example: `"1"`
The domain name associated with the company. Example: `lusha.com`
The name of the company. Example: `Lusha`
The Lusha company identifier. Note: values may be removed or merged over time. Example: `"1234567890"`
The fully qualified domain name of the company. Example: `www.lusha.com`
### Top-level fields
Signal types to retrieve for all companies in the request.
Allowed values: `allSignals`, `websiteTrafficIncrease`, `websiteTrafficDecrease`, `itSpendIncrease`, `itSpendDecrease`, `headcountIncrease1m`, `headcountDecrease1m`, `headcountIncrease3m`, `headcountDecrease3m`, `headcountIncrease6m`, `headcountDecrease6m`, `headcountIncrease12m`, `headcountDecrease12m`, `surgeInHiring`, `surgeInHiringByDepartment`, `surgeInHiringByLocation`, `riskNews`, `commercialActivityNews`, `corporateStrategyNews`, `financialEventsNews`, `peopleNews`, `marketIntelligenceNews`, `productActivityNews`
Start date for signal retrieval in `YYYY-MM-DD` format. Defaults to 6 months ago if not specified. Example: `"2025-03-01"`
Optional filters to narrow signal results within the requested signal types. Filter logic:
* Multi-value filters use OR logic.
* Filter values are not case-sensitive.
* Unrecognized values are silently ignored.
* Providing `state` without `country` in `hiringByLocations` returns an HTTP `400` error.
Filter news signals by specific event type. Example values: `"Funding Round"`, `"Partnership"`, `"Product Launch"`, `"Executive Hire"`, `"M&A"`, `"IPO"`.
Full list of allowed values: `Asset Investment`, `Asset Sale`, `Competitor Activity`, `Event Participation`, `Executive Departure`, `Executive Hire`, `Executive Promotion`, `Facilities Expansion`, `Facility Closure`, `Funding Round`, `Headcount Decrease`, `Headcount Increase`, `IPO`, `Lawsuit Faced`, `Lawsuit Filed`, `M&A`, `New Customer`, `New Location`, `New Vendor`, `Partnership`, `Product Development`, `Product Integration`, `Product Launch`, `Recognition`, `Security Issue`, `Strategic Investment`
Filter `surgeInHiringByDepartment` signals by department. Example values: `"Engineering & Technical"`, `"Sales"`, `"Marketing"`.
Allowed values: `Business Development`, `Consulting`, `Customer Service`, `Engineering & Technical`, `Finance`, `General Management`, `Health Care & Medical`, `Human Resources`, `Information Technology`, `Legal`, `Marketing`, `Operations`, `Other`, `Product`, `Research & Analytics`, `Sales`
Filter `surgeInHiringByLocation` signals by country and optional state. Each entry requires `country` (string, required) and optionally `state` (string).
Example: `[{"country": "United States", "state": "California"}, {"country": "Germany"}]`
Set to `true` to expand coverage by including partial company profiles when a full match is not available.
## Response fields
A successful `200` response is an object keyed by the `id` you provided for each company. Unlike `GET /v2/company`, each entry here is **flat** - firmographic and signal fields sit directly on the object rather than under a nested `data` key, and location is returned as flat `city`, `state`, `country`, `countryIso2`, `continent`, and `rawLocation` fields instead of a nested `location` object.
| Field | Type | Description |
| -------------------------------------------------------------------------- | ------ | ---------------------------------------- |
| `id` | number | Lusha's unique company identifier. |
| `name` | string | Company name. |
| `fqdn` | string | Fully qualified domain name. |
| `companySize` | array | Employee count range, e.g. `[201, 500]`. |
| `employeesInLinkedin` | number | Employee count as reported on LinkedIn. |
| `mainIndustry` / `subIndustry` | string | Industry classification. |
| `city` / `state` / `country` / `countryIso2` / `continent` / `rawLocation` | string | Flat location fields. |
| `funding` | object | Funding rounds and totals. |
| `technologies` | array | Technologies used by the company. |
| `intent` | object | Detected intent topics. |
Signal fields such as `surgeInHiring`, `surgeInHiringByDepartment`, and `financialEventsNews` are included when the corresponding signal type is requested via `signals`.
## Example request
```bash theme={null}
curl --request POST \
--url "https://api.lusha.com/bulk/company/v2" \
--header "api_key: YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"companies": [
{
"id": "1",
"domain": "lusha.com"
},
{
"id": "2",
"name": "Salesforce",
"domain": "salesforce.com"
}
],
"signals": ["surgeInHiringByDepartment", "financialEventsNews"],
"signalsStartDate": "2025-01-01",
"signalsFilters": {
"include": {
"hiringByDepartments": ["Engineering & Technical", "Sales"],
"hiringByLocations": [
{ "country": "United States", "state": "California" }
]
}
}
}'
```
## Example response
```json theme={null}
{
"1": {
"id": 33222678,
"name": "Lusha",
"fqdn": "www.lusha.com",
"companySize": [201, 500],
"mainIndustry": "Technology, Information & Media",
"subIndustry": "Software Development",
"companyType": "Private company",
"city": "Boston",
"state": "Massachusetts",
"country": "United States",
"countryIso2": "US",
"surgeInHiringByDepartment": [
{
"department": "Engineering & Technical",
"newJobsPostedLast4Weeks": 15,
"historicalAvg": 5
}
]
},
"2": {
"id": 112233,
"name": "Salesforce",
"fqdn": "www.salesforce.com",
"companySize": [10001, 100000],
"mainIndustry": "Technology, Information & Media",
"subIndustry": "Software Development",
"companyType": "Public company",
"city": "San Francisco",
"state": "California",
"country": "United States",
"countryIso2": "US",
"surgeInHiringByDepartment": [
{
"department": "Sales",
"newJobsPostedLast4Weeks": 120,
"historicalAvg": 80
}
]
}
}
```