# Get Contact Signals by IDs

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.

: 


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


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

## Request fields (application/json):

  - `contactIds` (array, required)
    List of contact IDs to retrieve signals for
    Example: [115889]

  - `signals` (array, required)
    Types of signals to retrieve
    Enum: "allSignals", "promotion", "companyChange"

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

## Response 200 fields (application/json):

  - `contacts` (object)
    Map of contact 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-03-01"

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

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