Contact Signals
Contact Signals
Retrieve signal events for a list of contacts - job changes and promotions.
Pass up to 100 contact ids. Use signalTypes to specify which events to return (promotion, companyChange, or allSignals). Optionally set a startDate to limit results to recent activity.
Billing: Charged per matched signal per result via the
showSignalsContactaction.
Persisting to a table: Pass
tableIdto also add these contacts to an existing table and populate the Signals column. See Contacts Tables.
POST
/
v3
/
contacts
/
signals
Contact Signals
curl --request POST \
--url https://api.lusha.com/v3/contacts/signals \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"ids": [
"4389064624",
"4389064654"
],
"signalTypes": [
"allSignals"
],
"startDate": "2025-01-01"
}
'import requests
url = "https://api.lusha.com/v3/contacts/signals"
payload = {
"ids": ["4389064624", "4389064654"],
"signalTypes": ["allSignals"],
"startDate": "2025-01-01"
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ids: ['4389064624', '4389064654'],
signalTypes: ['allSignals'],
startDate: '2025-01-01'
})
};
fetch('https://api.lusha.com/v3/contacts/signals', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.lusha.com/v3/contacts/signals")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"ids\": [\n \"4389064624\",\n \"4389064654\"\n ],\n \"signalTypes\": [\n \"allSignals\"\n ],\n \"startDate\": \"2025-01-01\"\n}")
.asString();package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/contacts/signals"
payload := strings.NewReader("{\n \"ids\": [\n \"4389064624\",\n \"4389064654\"\n ],\n \"signalTypes\": [\n \"allSignals\"\n ],\n \"startDate\": \"2025-01-01\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"results": [
{
"id": "115889",
"companyChange": [
{
"id": "115889",
"signalDate": "2025-02-01",
"previousCompany": "ZoomInfo",
"newCompany": "Lusha"
}
],
"promotion": []
}
],
"startDate": "2025-01-01",
"endDate": "2025-03-01",
"billing": {
"creditsCharged": 1,
"resultsReturned": 1
}
}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
Required array length:
1 - 100 elementsExample:
["4389064624", "4389064654"]
Available options:
allSignals, promotion, companyChange Example:
["allSignals"]
Example:
"2025-01-01"
Required range:
1 <= x <= 100Example:
10
Optional. If provided, these contacts are also added to this table (if not already present) and the Signals column is populated. See the Tables API.
Example:
"482910"
Response
Successful response
Show child attributes
Show child attributes
Added to a Prospecting, Enrich, Signals, or Lookalike response when tableId is passed on the request. The primary response is unaffected even if the table write fails.
Show child attributes
Show child attributes
Credit usage summary for a V3 API request
Show child attributes
Show child attributes
Request ID, for support and tracing
Was this page helpful?
⌘I
Contact Signals
curl --request POST \
--url https://api.lusha.com/v3/contacts/signals \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"ids": [
"4389064624",
"4389064654"
],
"signalTypes": [
"allSignals"
],
"startDate": "2025-01-01"
}
'import requests
url = "https://api.lusha.com/v3/contacts/signals"
payload = {
"ids": ["4389064624", "4389064654"],
"signalTypes": ["allSignals"],
"startDate": "2025-01-01"
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ids: ['4389064624', '4389064654'],
signalTypes: ['allSignals'],
startDate: '2025-01-01'
})
};
fetch('https://api.lusha.com/v3/contacts/signals', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.lusha.com/v3/contacts/signals")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"ids\": [\n \"4389064624\",\n \"4389064654\"\n ],\n \"signalTypes\": [\n \"allSignals\"\n ],\n \"startDate\": \"2025-01-01\"\n}")
.asString();package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/contacts/signals"
payload := strings.NewReader("{\n \"ids\": [\n \"4389064624\",\n \"4389064654\"\n ],\n \"signalTypes\": [\n \"allSignals\"\n ],\n \"startDate\": \"2025-01-01\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"results": [
{
"id": "115889",
"companyChange": [
{
"id": "115889",
"signalDate": "2025-02-01",
"previousCompany": "ZoomInfo",
"newCompany": "Lusha"
}
],
"promotion": []
}
],
"startDate": "2025-01-01",
"endDate": "2025-03-01",
"billing": {
"creditsCharged": 1,
"resultsReturned": 1
}
}