Score

Score

curl --request POST \
  --url https://api.opennous.cloud/v2/score \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifier": "<string>",
  "identifiers": [
    "<string>"
  ],
  "intent": "<string>"
}
'

import requests

url = "https://api.opennous.cloud/v2/score"

payload = {
    "identifier": "<string>",
    "identifiers": ["<string>"],
    "intent": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({identifier: '<string>', identifiers: ['<string>'], intent: '<string>'})
};

fetch('https://api.opennous.cloud/v2/score', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.opennous.cloud/v2/score",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'identifier' => '<string>',
    'identifiers' => [
        '<string>'
    ],
    'intent' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.opennous.cloud/v2/score"

	payload := strings.NewReader("{\n  \"identifier\": \"<string>\",\n  \"identifiers\": [\n    \"<string>\"\n  ],\n  \"intent\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	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))

}

HttpResponse<String> response = Unirest.post("https://api.opennous.cloud/v2/score")
  .header("Content-Type", "application/json")
  .body("{\n  \"identifier\": \"<string>\",\n  \"identifiers\": [\n    \"<string>\"\n  ],\n  \"intent\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.opennous.cloud/v2/score")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"identifier\": \"<string>\",\n  \"identifiers\": [\n    \"<string>\"\n  ],\n  \"intent\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

POST

score

Score

curl --request POST \
  --url https://api.opennous.cloud/v2/score \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifier": "<string>",
  "identifiers": [
    "<string>"
  ],
  "intent": "<string>"
}
'

import requests

url = "https://api.opennous.cloud/v2/score"

payload = {
    "identifier": "<string>",
    "identifiers": ["<string>"],
    "intent": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({identifier: '<string>', identifiers: ['<string>'], intent: '<string>'})
};

fetch('https://api.opennous.cloud/v2/score', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.opennous.cloud/v2/score",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'identifier' => '<string>',
    'identifiers' => [
        '<string>'
    ],
    'intent' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.opennous.cloud/v2/score"

	payload := strings.NewReader("{\n  \"identifier\": \"<string>\",\n  \"identifiers\": [\n    \"<string>\"\n  ],\n  \"intent\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	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))

}

HttpResponse<String> response = Unirest.post("https://api.opennous.cloud/v2/score")
  .header("Content-Type", "application/json")
  .body("{\n  \"identifier\": \"<string>\",\n  \"identifiers\": [\n    \"<string>\"\n  ],\n  \"intent\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.opennous.cloud/v2/score")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"identifier\": \"<string>\",\n  \"identifiers\": [\n    \"<string>\"\n  ],\n  \"intent\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Score any person or company against your workspace’s ICP model and current intent, then write the result into the context graph so every other agent reads the same number. Built for a list you keep somewhere else, a spreadsheet, a Clay column, a CRM export. The list stays where it is. Nous returns the score. This is the leaner counterpart to /v2/context. Where context returns the whole account, score returns just the ICP fit and intent, so it fits a spreadsheet cell or a Clay column.

score needs a scoring model. Build one first with build_icp_model, then this endpoint returns live scores.

Request

curl -X POST https://api.opennous.cloud/v2/score \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "identifier": "sarah@acme.com" }'

Body

string

One lead. Accepts an email, domain, LinkedIn URL, or entity UUID. Required unless you pass identifiers.

string[]

A batch of leads, max 100 per call. The response is a results array in the same order.

string

Optional note on why you’re scoring. Recorded, does not change the score.

Response

A scored lead returns the ICP fit and intent, and the fit prediction is staked onto the account:

{
  "resolved": true,
  "scored": true,
  "entity_id": "a1b2c3d4-...",
  "icp": {
    "score": 84,
    "fit": true,
    "tier": "tier_1",
    "reason": "matches B2B SaaS, 50–200, already on Apollo",
    "scored_at": "2026-07-09T12:00:00Z"
  },
  "intent": { "score": 64, "band": "Warm" }
}

A lead Nous already knows but has not enriched yet returns awaiting_enrichment, so you know to enrich before acting:

{ "resolved": true, "scored": false, "reason": "awaiting_enrichment", "entity_id": "..." }

A lead that is not in the graph returns unknown_identifier, so nothing is fabricated:

{ "resolved": false, "reason": "unknown_identifier" }

Batch

With identifiers, each result carries its own identifier alongside the same fields:

{
  "results": [
    { "identifier": "sarah@acme.com", "resolved": true, "scored": true, "icp": { "score": 84, "tier": "tier_1" }, "intent": { "score": 64, "band": "Warm" } },
    { "identifier": "tom@globex.io", "resolved": true, "scored": false, "reason": "awaiting_enrichment" }
  ]
}

Fields

Field	Values	Meaning
`icp.score`	`0` – `100`	ICP fit score
`icp.tier`	`tier_1` / `tier_2` / `tier_3` / `not_icp`	The actionable class that drives the play
`icp.fit`	boolean	`true` when the score is 70 or above
`intent.score`	`0` – `100`	How warm the account is right now. Decays over time
`intent.band`	`Red-hot` / `Hot` / `Warm` / `Aware` / `Dormant`	Intent as a band

Scores that keep moving

score reads the live score. When an account has never been scored, it stakes one on demand, so you get a number now. After that the score keeps evolving on its own as new signals land, so a weekly re-score reflects the latest state. Calling score again never stacks duplicate predictions.

Call it from a spreadsheet

Because the request is one row in and a small object out, you can call score straight from a sheet with a short script. Point the fetch at this endpoint, pass the cell as identifier, and read back icp.score, icp.tier, and intent.score. Clay, n8n, and Make can call it the same way, one row per record.

When to call it

You have a list built somewhere else and want each row’s ICP fit and intent in the graph
On a cadence over your sheet to keep every score current
For a whole list in one call, use /v2/lead-lists/attach

Dedup GTM Profile

Overview

Account Context

Observations

People

Leads

Search

Workspace

Notes

Triggers

Request

Body

Response

Batch

Fields

Scores that keep moving

Call it from a spreadsheet

When to call it

​Request

​Body

​Response

​Batch

​Fields

​Scores that keep moving

​Call it from a spreadsheet

​When to call it

Request

Body

Response

Batch

Fields

Scores that keep moving

Call it from a spreadsheet

When to call it