> ## 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.

# Search companies

> Find up to 100 companies per call by ID, name, or domain, and see what you can reveal about each match.

Search Companies looks up companies by identifier and returns a preview of each match. Use it as the first step before revealing full firmographics with [Enrich Companies](/enrichment/enrich-companies), or when you only need a lightweight profile - headcount range, industry, and location - without spending reveal credits.

<Info>
  This is a single endpoint for one company or a hundred - there's no separate "single" and "bulk" version. Send an array with 1 to 100 companies in one call.
</Info>

## Identifiers you can search by

Provide **at least one** of the following for each company in your request:

* Lusha company `id`
* `name`
* `domain`

<Tip>
  Attach your own `clientReferenceId` to each company in the request. Lusha echoes it back on the matching result, so you can line results back up with your input list.
</Tip>

## What you get back

Each result includes:

* **Preview data** - name, domain, employee count range, industry, location, and LinkedIn URL, when available.
* **`has`** - the data points already present on this profile.
* **`canReveal`** - which fields you can unlock via [Enrich Companies](/enrichment/enrich-companies), and the credit cost for each. A cost of `0` means you've already revealed that field for this account.

If a company can't be found, the result contains an `error` with a code of `NOT_FOUND`, `COMPLIANCE_RESTRICTED`, or `ENRICH_FAILED` instead of profile data.

## Filtering by recent activity

Pass a `signals` filter to narrow your results to companies with recent activity - headcount changes, hiring surges, website traffic shifts, IT spend changes, or news events. Matching results include a `signalTypes` array showing which signal fired.

## Billing

Search Companies is charged per successful result via the `api_search` action. Looking up a company that returns `NOT_FOUND` isn't charged.

## Next step

Once you have company `id` values from your search results, pass them to [Enrich Companies](/enrichment/enrich-companies) to reveal full firmographics - or use [Search and Enrich Companies](/enrichment/search-and-enrich-companies) to do both in one call next time.

For full request and response field details, see the [Search Companies API reference](/api-reference/search/search-companies).