# Search Company Signals

Search for company signals using identifiers like domain, company name, or ID.
This endpoint combines search and signal enrichment in a single request.

: 


Each company must have at least one identifier:
- Company ID (as string)
- Company name
- Company domain


- Returns signals from the last 6 months by default
- Companies are matched based on provided identifiers


Endpoint: POST /api/signals/companies/search
Security: ApiKeyAuth

## Request fields (application/json):

  - `companies` (array, required)
    List of company identifiers to search for

  - `companies.id` (string, required)
    A unique sequential ID to associate with the company object in the API response
    Example: "12345"

  - `companies.name` (string)
    Company name
    Example: "Lusha"

  - `companies.domain` (string)
    Company domain
    Example: "lusha.com"

  - `signals` (array, required)
    Types of signals to retrieve
    Enum: "allSignals", "headcountGrowth", "newJobsOpen", "totalJobsOpen"

  - `startDate` (string)
    Start date for signal retrieval (YYYY-MM-DD format)
    Example: "2025-03-01"

## Response 200 fields (application/json):

  - `companies` (object)
    Map of company IDs to their signals

  - `endDate` (string)
    End date of the signal period
    Example: "2025-07-31"

  - `startDate` (string)
    Start date of the signal period
    Example: "2025-02-01"

  - `creditCharged` (integer)
    Number of credits charged for this request
    Example: 3

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 401 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 403 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 429 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message