# Signals

With Lusha's Signals API, you can enrich your contacts and companies with timely insights that highlight key account and prospect changes. Signals help you identify moments of opportunity - from job moves and promotions to company growth and new initiatives - so you can engage prospects and customers at exactly the right time. Easily integrate signal data into enrichment flows, CRM systems, or automation workflows to keep pipelines and customer records always up to date.

## Get Signal Options

 - [GET /api/signals/filters/{objectType}](https://docs.lusha.com/apis/v2/openapi/signals/getsignaloptions.md): Retrieve available signal options for a specific entity type (contact or company).
This endpoint returns the list of signal types you can filter by when enriching contacts or companies.


  Endpoints:

    * Contacts: GET /api/signals/filters/contact
    * Companies: GET /api/signals/filters/company


  #### Available Signal Types


    #### For contacts:

    * allSignals - All available contact signal types
    * promotion - Job title promotions
    * companyChange - Company changes

    ---

    #### For companies:

      * allSignals - All available company signal types

    

    Hiring & Workforce:

    * surgeInHiring - Overall hiring activity increase
    * surgeInHiringByDepartment - Department-specific hiring surges
    * surgeInHiringByLocation - Location-specific hiring surges

    

      Headcount Trends:

    | Signal | Description |
    |--------|-------------|
    | headcountIncrease1m / headcountDecrease1m | 1-month employee count changes |
    | headcountIncrease3m / headcountDecrease3m | 3-month employee count changes |
    | headcountIncrease6m / headcountDecrease6m | 6-month employee count changes |
    | headcountIncrease12m / headcountDecrease12m | 12-month employee count changes |

    

      Technology & Digital Presence:

    * websiteTrafficIncrease - Website traffic growth
    * websiteTrafficDecrease - Website traffic decline
    * itSpendIncrease - IT spending increase
    * itSpendDecrease - IT spending decrease

    News Events:

    To retrieve company news, use one or more of the following category values:


    | Signal | Included Events |
    |--------|-----------------|
    | commercialActivityNews | Partnership, New Customer, New Vendor |
    | corporateStrategyNews | M&A, Facilities Expansion, New Location, Facility Closure, Asset Sale, Lawsuit Filed |
    | financialEventsNews | Funding Round, Asset Investment, Strategic Investment, IPO |
    | marketIntelligenceNews | Event Participation, Recognition, Competitor Activity |
    | peopleNews | Executive Hire, Executive Departure, Executive Promotion, Headcount Increase, Headcount Decrease |
    | productActivityNews | Product Launch, Product Development, Product Integration |
    | riskNews | Security Issue, Lawsuit Faced |


    > The response also includes available values for signal sub-filters:

      * newsEventTypes — available event type values for news signal filtering
      * hiringByDepartments — available department values for hiring surge filtering
      * hiringByLocations — available location values for hiring surge filtering (array of { country, state } objects)

## Get Contact Signals by IDs

 - [POST /api/signals/contacts](https://docs.lusha.com/apis/v2/openapi/signals/getcontactsignalsbyid.md): Retrieve signals data for a list of contact IDs.
This endpoint allows you to get recent activities and signals for up to 100 contacts per request.

Endpoint: (POST) https://api.lusha.com/api/signals/contacts

Default Behavior:
- Returns signals from the last 6 months by default
- Use startDate to customize the timeframe
- Each signal type requested counts towards credit usage

## Search Contact Signals

 - [POST /api/signals/contacts/search](https://docs.lusha.com/apis/v2/openapi/signals/searchcontactsignals.md): Search for contact signals using identifiers like LinkedIn URL, email, or name + company.
This endpoint combines search and signal enrichment in a single request.

Endpoint: (POST) https://api.lusha.com/api/signals/contacts/search

Search Requirements:
Each contact can be identified by:
- Contact ID
- LinkedIn URL
- Email address
- Full name + Company (name or domain)

Default Behavior:
- Returns signals from the last 6 months by default
- Contacts are matched based on provided identifiers
- Returns both contact data and associated signals

## Get Company Signals by IDs

 - [POST /api/signals/companies](https://docs.lusha.com/apis/v2/openapi/signals/getcompanysignalsbyid.md): Retrieve signals data for a list of company IDs.
This endpoint allows you to get recent activities and signals for up to 100 companies per request.

Endpoint: (POST) https://api.lusha.com/api/signals/companies

Default Behavior:
- Returns signals from the last 6 months by default
- Use startDate to customize the timeframe

## Search Company Signals

 - [POST /api/signals/companies/search](https://docs.lusha.com/apis/v2/openapi/signals/searchcompanysignals.md): Search for company signals using identifiers like domain, company name, or ID.
This endpoint combines search and signal enrichment in a single request.

Endpoint: (POST) https://api.lusha.com/api/signals/companies/search

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

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