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

: 


- Returns signals from the last 6 months by default
- Use  to customize the timeframe


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

## Request fields (application/json):

  - `companyIds` (array, required)
    List of company IDs to retrieve signals for
    Example: [3416]

  - `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