Get Contact Signals by IDs - Lusha Knowledge Hub

POST

/

api

/

signals

/

contacts

curl --request POST \
  --url https://api.lusha.com/api/signals/contacts \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "contactIds": [
    115889
  ],
  "signals": [
    "promotion",
    "companyChange"
  ],
  "startDate": "2025-01-01",
  "maxResultsPerSignal": 5
}
'

{
  "contacts": {
    "115889": {
      "personId": "115889",
      "companyChange": [
        {
          "personId": "115889",
          "currentCompanyId": 8217,
          "currentCompanyName": "Callaway Golf",
          "currentDepartments": "R&D",
          "currentSeniorityLabel": "c-suite",
          "currentTitle": "Senior Manager, IT Solutions",
          "signalDate": "2025-05-01",
          "previousCompanyName": "Previous Corp",
          "previousDomain": "nextgen.com",
          "currentDomain": "vendavo.com"
        }
      ],
      "promotion": [
        {
          "personId": "115889",
          "currentCompanyId": 8217,
          "currentCompanyName": "Callaway Golf",
          "currentDepartments": "R&D",
          "currentSeniorityLabel": "c-suite",
          "currentTitle": "Senior Manager, IT Solutions",
          "signalDate": "2025-05-01",
          "previousCompanyName": "Previous Corp",
          "previousDomain": "nextgen.com",
          "currentDomain": "vendavo.com"
        }
      ]
    }
  },
  "endDate": "2025-07-31",
  "startDate": "2025-01-01",
  "creditCharged": 2
}

Authorizations

api_key

string

header

required

Your Lusha API key. You can find this in your Lusha dashboard under API settings.

Include this key in the api_key header for all requests.

Body

application/json

contactIds

integer[]

required

List of contact IDs to retrieve signals for

Required array length: 1 - 100 elements

Example:

[115889]

signals

enum<string>[]

required

Types of signals to retrieve

Available options:

allSignals,

promotion,

companyChange

Example:

["promotion", "companyChange"]

startDate

string<date>

Start date for signal retrieval (YYYY-MM-DD format)

Example:

"2025-03-01"

maxResultsPerSignal

integer

Maximum number of signal instances to return per signal type per entity. Optional.

Default behavior when omitted:

No startDate provided: all available signals are returned
startDate provided: all signals from that date onward are returned

Example:

10

Response

Contact signals retrieved successfully

contacts

object

Map of contact IDs to their signals

Show child attributes

endDate

string<date>

End date of the signal period

Example:

"2025-07-31"

startDate

string<date>

Start date of the signal period

Example:

"2025-03-01"

creditCharged

integer

Number of credits charged for this request

Example:

2

⌘I

curl --request POST \
  --url https://api.lusha.com/api/signals/contacts \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "contactIds": [
    115889
  ],
  "signals": [
    "promotion",
    "companyChange"
  ],
  "startDate": "2025-01-01",
  "maxResultsPerSignal": 5
}
'

{
  "contacts": {
    "115889": {
      "personId": "115889",
      "companyChange": [
        {
          "personId": "115889",
          "currentCompanyId": 8217,
          "currentCompanyName": "Callaway Golf",
          "currentDepartments": "R&D",
          "currentSeniorityLabel": "c-suite",
          "currentTitle": "Senior Manager, IT Solutions",
          "signalDate": "2025-05-01",
          "previousCompanyName": "Previous Corp",
          "previousDomain": "nextgen.com",
          "currentDomain": "vendavo.com"
        }
      ],
      "promotion": [
        {
          "personId": "115889",
          "currentCompanyId": 8217,
          "currentCompanyName": "Callaway Golf",
          "currentDepartments": "R&D",
          "currentSeniorityLabel": "c-suite",
          "currentTitle": "Senior Manager, IT Solutions",
          "signalDate": "2025-05-01",
          "previousCompanyName": "Previous Corp",
          "previousDomain": "nextgen.com",
          "currentDomain": "vendavo.com"
        }
      ]
    }
  },
  "endDate": "2025-07-31",
  "startDate": "2025-01-01",
  "creditCharged": 2
}