Signals
Score Companies by Signal Activity
Score companies by their active buying signals. Returns the aggregate Signal Score - a [0, 1] value reflecting the fraction of the company's active signals - plus the active signal breakdown.
Accepts up to 100 companies, each identified by exactly one of id, domain, name, or email. All identifiers are resolved to Lusha company IDs server-side before scoring.
Each result is one of:
- A scored entry - signalScore, signalTypes, and noActiveSignals.
- A NOT_FOUND entry - the company service could not resolve the supplied identifier.
- A NO_SCORE entry - the company resolved, but the scoring engine returned nothing for it.
Billing: 1 credit is charged per scored row via signal_score_company_reveal. This action is currently limited-availability - while it isn't yet seeded on an account's pricebook, the endpoint stays free (billing.creditsCharged is 0). Error rows (NOT_FOUND / NO_SCORE) are never charged.
post/v3/companies/signal-score
Request body
Example request
{
"companies": [
{
"clientReferenceId": "ref-1",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345",
"domain": "www.microsoft.com",
"name": "Apple",
"email": "jane@acme.com"
}
]
}Response
Successful response
Example response
{
"requestId": "5d6f13d2-f6b0-4e55-85d5-04e17f932c1a",
"results": [
{
"clientReferenceId": "ref-1",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345",
"name": "Acme Corp",
"domain": "www.acmecorp.io",
"signalScore": 0.42,
"signalTypes": [
"hiringSignalIncrease",
"websiteVisit"
],
"error": {
"code": "NOT_FOUND",
"message": "Contact not found"
}
}
],
"billing": {
"creditsCharged": 3,
"resultsReturned": 1
}
}