# 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/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 Event Categories          

    Each category includes the following event types:

    | Category | Event Types |
    |----------|------------|
    | businessMilestones | product launch, partnership, product development, product integration, signs new client, new client of |
    | corporateExpansion | acquires, acquired, facilities expansion, new location, new offices |
    | financialGrowth | funding, invests into assets, invests into, ipo, receives investment |
    | peopleAndLeadership | executive appointment, executive departure, executive promotion, headcount increase |
    | recognition | event attendance, recognition, award |
    | risk | vulnerability issue, office closure, sells assets, sues, sued |
  -->

## Get Contact Signals by IDs

 - [POST /api/signals/contacts](https://docs.lusha.com/apis/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/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/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/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