# Get Company Signals by IDs

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

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

## Request fields (application/json):

  - `companyIds` (array, required)
    Example: [3416]

  - `signals` (array, required)
    Enum: "allSignals", "websiteTrafficIncrease", "websiteTrafficDecrease", "itSpendIncrease", "itSpendDecrease", "headcountIncrease1m", "headcountDecrease1m", "headcountIncrease3m", "headcountDecrease3m", "headcountIncrease6m", "headcountDecrease6m", "headcountIncrease12m", "headcountDecrease12m", "surgeInHiring", "surgeInHiringByDepartment", "surgeInHiringByLocation", "riskNews", "commercialActivityNews", "corporateStrategyNews", "financialEventsNews", "peopleNews", "marketIntelligenceNews", "productActivityNews"

  - `startDate` (string)
    Example: "2025-03-01"

  - `maxResultsPerSignal` (integer)
    Example: 10

  - `filters` (object)

  - `filters.include` (object)
    Optional sub-filters to narrow results within a signal type.
- Multi-value filters use OR logic
- Filter values are not case-sensitive
- state without country in hiringByLocations returns HTTP 400

  - `filters.include.newsEventTypes` (array)
    Enum: "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"

  - `filters.include.hiringByDepartments` (array)
    Enum: "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"

  - `filters.include.hiringByLocations` (array)
    Example: [{"country":"United States","state":"California"},{"country":"Germany"}]

  - `filters.include.hiringByLocations.country` (string, required)
    Example: "United States"

  - `filters.include.hiringByLocations.state` (string)
    Example: "California"

## Response 200 fields (application/json):

  - `companies` (object)

  - `endDate` (string)
    Example: "2025-07-31"

  - `startDate` (string)
    Example: "2025-01-01"

  - `creditCharged` (integer)
    Example: 3

## Response 400 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]