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

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

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

## Request fields (application/json):

  - `contactIds` (array, required)
    Example: [115889]

  - `signals` (array, required)
    Enum: "allSignals", "promotion", "companyChange"

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

  - `maxResultsPerSignal` (integer)
    Example: 10

## Response 200 fields (application/json):

  - `contacts` (object)

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

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

  - `creditCharged` (integer)
    Example: 2

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