Signals
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
startDateto customize the timeframe - Each signal type requested counts towards credit usage
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
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
List of contact IDs to retrieve signals for
Required array length:
1 - 100 elementsExample:
[115889]
Types of signals to retrieve
Available options:
allSignals, promotion, companyChange Example:
["promotion", "companyChange"]
Start date for signal retrieval (YYYY-MM-DD format)
Example:
"2025-03-01"
Maximum number of signal instances to return per signal type per entity. Optional.
Default behavior when omitted:
- No
startDateprovided: all available signals are returned startDateprovided: all signals from that date onward are returned
Example:
10
Response
Contact signals retrieved successfully
Was this page helpful?
⌘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
}