Skip to main content
Signal Score collapses a record’s active buying signals into one number you can sort and threshold on. Where Signals tells you what is happening, Signal Score tells you how much is happening - so you can rank a list rather than read it. Every score comes with the signal breakdown behind it, so a high score is always explainable.

Score Contacts

POST /v3/contacts/signal-score - up to 100 contacts per call.

Score Companies

POST /v3/companies/signal-score - up to 100 companies per call.

​
The score

signalScore is a value in [0, 1] reflecting the fraction of the record’s active signals. Alongside it you get:
  • signalTypes - the active signal breakdown
  • noActiveSignals - set when the record resolved but has nothing currently firing

​
Identifying records

Identity is resolved server-side before scoring. This is identity resolution only - no PII is revealed and no enrichment credits are spent on it.
Provide one of:
  • id - encrypted Lusha contact ID
  • linkedinUrl
  • email
  • firstName + lastName + (companyName or companyDomain)

​
Reading the results

Each entry in the response is one of three outcomes:
NOT_FOUND and NO_SCORE mean different things and deserve different handling. NOT_FOUND is an identifier problem worth retrying with a better identifier; NO_SCORE means the record is genuinely unscored right now.

​
Billing

1 credit is charged per scored record. Entries returned as NOT_FOUND or NO_SCORE are not charged.