Skip to main content
POST
Scores a lead against your ICP. Needs an ICP first. Create one or train one from closed deals. icp is the 0 to 100 fit and its tier. intent is how warm the account is now. layered splits the score into fit, pain, intent, and ability. A layer listed in missing is unknown, not zero.

Authorizations

​
Authorization
string
header
required

Workspace API key. Create one in Settings → API keys.

Body

application/json
​
identifier
string

One lead in the graph. Email, domain, LinkedIn URL, or entity UUID.

​
identifiers
string[]

Up to 100 graph leads.

Maximum array length: 100
​
attributes
object

A lead that is not in Nous. Aliases in brackets are accepted.

​
leads
object[]

Up to 1000 cold leads, scored inline. Add ref or id to a lead to get it echoed back. A lead may also be {ref, attributes}.

Maximum array length: 1000
​
intent
string

Reserved. Accepted and ignored today. It does not change the score.

Response

One result, or {results} for batches. leads batches also return persisted: false.

​
resolved
boolean
​
scored
boolean
​
reason
string

Why nothing was scored: unknown_identifier, ambiguous, awaiting_enrichment, partial, no_attributes, or no_model.

​
entity_id
string<uuid>
​
source
string

Present when scored from attributes.

Allowed value: "inline"
​
persisted
boolean

False for inline scores. Nothing was written.

​
icp
object
​
intent
object
​
layered
object

The layered ICP read. A layer missing from layers is unknown, never zero.

​
candidates
object[]
​
identifier
string

Echoed in identifiers batches.

​
ref
any

Echoed in leads batches when the lead had a ref or id.