ICP Fit Score
Score Companies by ICP Fit
Score how well each company fits 1-3 of your Target Profiles, from 0 to 1.
Accepts 1-100 companies, each identified by exactly one of id, domain, name, or email, plus an optional clientReferenceId. targetProfileIds must be active profiles you own or that are shared with your account - get them from List Target Profiles.
Each result is one of:
- A scored entry -
icpFitScore(the best fit),topProfile(the profile it fits best), andprofileScores(the score per profile, only when more than one profile is requested). - A
NOT_FOUNDentry - the supplied identifier could not be resolved to a company. - A
NO_SCOREentry - the company resolved, but no ICP fit score is available for it.
Billing: 1 credit per scored company, regardless of how many profiles it’s scored against. A score of
0is charged. Error rows (NOT_FOUND/NO_SCORE) are never charged.
POST
/
v3
/
companies
/
icp-fit-score
Score Companies by ICP Fit
curl --request POST \
--url https://api.lusha.com/v3/companies/icp-fit-score \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"targetProfileIds": [
"3fbaaaa7-700f-4419-a0c6-56f9f3fca391",
"a49d9e05-eb62-4c00-8186-e74ba237a0ad"
],
"companies": [
{
"clientReferenceId": "ref-1",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345"
},
{
"clientReferenceId": "ref-2",
"domain": "www.microsoft.com"
},
{
"clientReferenceId": "ref-3",
"name": "Apple"
}
]
}
'import requests
url = "https://api.lusha.com/v3/companies/icp-fit-score"
payload = {
"targetProfileIds": ["3fbaaaa7-700f-4419-a0c6-56f9f3fca391", "a49d9e05-eb62-4c00-8186-e74ba237a0ad"],
"companies": [
{
"clientReferenceId": "ref-1",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345"
},
{
"clientReferenceId": "ref-2",
"domain": "www.microsoft.com"
},
{
"clientReferenceId": "ref-3",
"name": "Apple"
}
]
}
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({
targetProfileIds: ['3fbaaaa7-700f-4419-a0c6-56f9f3fca391', 'a49d9e05-eb62-4c00-8186-e74ba237a0ad'],
companies: [
{clientReferenceId: 'ref-1', id: 'v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345'},
{clientReferenceId: 'ref-2', domain: 'www.microsoft.com'},
{clientReferenceId: 'ref-3', name: 'Apple'}
]
})
};
fetch('https://api.lusha.com/v3/companies/icp-fit-score', 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/companies/icp-fit-score")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"targetProfileIds\": [\n \"3fbaaaa7-700f-4419-a0c6-56f9f3fca391\",\n \"a49d9e05-eb62-4c00-8186-e74ba237a0ad\"\n ],\n \"companies\": [\n {\n \"clientReferenceId\": \"ref-1\",\n \"id\": \"v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345\"\n },\n {\n \"clientReferenceId\": \"ref-2\",\n \"domain\": \"www.microsoft.com\"\n },\n {\n \"clientReferenceId\": \"ref-3\",\n \"name\": \"Apple\"\n }\n ]\n}")
.asString();package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/companies/icp-fit-score"
payload := strings.NewReader("{\n \"targetProfileIds\": [\n \"3fbaaaa7-700f-4419-a0c6-56f9f3fca391\",\n \"a49d9e05-eb62-4c00-8186-e74ba237a0ad\"\n ],\n \"companies\": [\n {\n \"clientReferenceId\": \"ref-1\",\n \"id\": \"v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345\"\n },\n {\n \"clientReferenceId\": \"ref-2\",\n \"domain\": \"www.microsoft.com\"\n },\n {\n \"clientReferenceId\": \"ref-3\",\n \"name\": \"Apple\"\n }\n ]\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))
}{
"requestId": "5d6f13d2-f6b0-4e55-85d5-04e17f932c1a",
"results": [
{
"clientReferenceId": "ref-1",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345",
"name": "Acme Corp",
"domain": "acmecorp.io",
"icpFitScore": 0.92,
"topProfile": {
"id": "3fbaaaa7-700f-4419-a0c6-56f9f3fca391",
"name": "Mid-market SaaS"
},
"profileScores": [
{
"id": "3fbaaaa7-700f-4419-a0c6-56f9f3fca391",
"name": "Mid-market SaaS",
"score": 0.92
},
{
"id": "a49d9e05-eb62-4c00-8186-e74ba237a0ad",
"name": "Enterprise",
"score": 0.1
}
]
},
{
"clientReferenceId": "ref-2",
"id": "v1.6789ZyXwVuTsRqPoNmLkJiHgFeDcBa01",
"name": "Microsoft",
"domain": "microsoft.com",
"icpFitScore": 0,
"topProfile": {
"id": "3fbaaaa7-700f-4419-a0c6-56f9f3fca391",
"name": "Mid-market SaaS"
},
"profileScores": [
{
"id": "3fbaaaa7-700f-4419-a0c6-56f9f3fca391",
"name": "Mid-market SaaS",
"score": 0
},
{
"id": "a49d9e05-eb62-4c00-8186-e74ba237a0ad",
"name": "Enterprise",
"score": 0
}
]
},
{
"clientReferenceId": "ref-3",
"name": "Apple",
"error": {
"code": "NOT_FOUND",
"message": "Company not found"
}
}
],
"billing": {
"creditsCharged": 2,
"resultsReturned": 2,
"lowBalance": false
}
}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
1-3 Target Profile IDs to score against. Each must be an active profile you own or that is shared with your account - get them from List Target Profiles.
Required array length:
1 - 3 elementsExample:
[
"3fbaaaa7-700f-4419-a0c6-56f9f3fca391",
"a49d9e05-eb62-4c00-8186-e74ba237a0ad"
]
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
Was this page helpful?
⌘I
Score Companies by ICP Fit
curl --request POST \
--url https://api.lusha.com/v3/companies/icp-fit-score \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"targetProfileIds": [
"3fbaaaa7-700f-4419-a0c6-56f9f3fca391",
"a49d9e05-eb62-4c00-8186-e74ba237a0ad"
],
"companies": [
{
"clientReferenceId": "ref-1",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345"
},
{
"clientReferenceId": "ref-2",
"domain": "www.microsoft.com"
},
{
"clientReferenceId": "ref-3",
"name": "Apple"
}
]
}
'import requests
url = "https://api.lusha.com/v3/companies/icp-fit-score"
payload = {
"targetProfileIds": ["3fbaaaa7-700f-4419-a0c6-56f9f3fca391", "a49d9e05-eb62-4c00-8186-e74ba237a0ad"],
"companies": [
{
"clientReferenceId": "ref-1",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345"
},
{
"clientReferenceId": "ref-2",
"domain": "www.microsoft.com"
},
{
"clientReferenceId": "ref-3",
"name": "Apple"
}
]
}
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({
targetProfileIds: ['3fbaaaa7-700f-4419-a0c6-56f9f3fca391', 'a49d9e05-eb62-4c00-8186-e74ba237a0ad'],
companies: [
{clientReferenceId: 'ref-1', id: 'v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345'},
{clientReferenceId: 'ref-2', domain: 'www.microsoft.com'},
{clientReferenceId: 'ref-3', name: 'Apple'}
]
})
};
fetch('https://api.lusha.com/v3/companies/icp-fit-score', 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/companies/icp-fit-score")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"targetProfileIds\": [\n \"3fbaaaa7-700f-4419-a0c6-56f9f3fca391\",\n \"a49d9e05-eb62-4c00-8186-e74ba237a0ad\"\n ],\n \"companies\": [\n {\n \"clientReferenceId\": \"ref-1\",\n \"id\": \"v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345\"\n },\n {\n \"clientReferenceId\": \"ref-2\",\n \"domain\": \"www.microsoft.com\"\n },\n {\n \"clientReferenceId\": \"ref-3\",\n \"name\": \"Apple\"\n }\n ]\n}")
.asString();package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/companies/icp-fit-score"
payload := strings.NewReader("{\n \"targetProfileIds\": [\n \"3fbaaaa7-700f-4419-a0c6-56f9f3fca391\",\n \"a49d9e05-eb62-4c00-8186-e74ba237a0ad\"\n ],\n \"companies\": [\n {\n \"clientReferenceId\": \"ref-1\",\n \"id\": \"v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345\"\n },\n {\n \"clientReferenceId\": \"ref-2\",\n \"domain\": \"www.microsoft.com\"\n },\n {\n \"clientReferenceId\": \"ref-3\",\n \"name\": \"Apple\"\n }\n ]\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))
}{
"requestId": "5d6f13d2-f6b0-4e55-85d5-04e17f932c1a",
"results": [
{
"clientReferenceId": "ref-1",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345",
"name": "Acme Corp",
"domain": "acmecorp.io",
"icpFitScore": 0.92,
"topProfile": {
"id": "3fbaaaa7-700f-4419-a0c6-56f9f3fca391",
"name": "Mid-market SaaS"
},
"profileScores": [
{
"id": "3fbaaaa7-700f-4419-a0c6-56f9f3fca391",
"name": "Mid-market SaaS",
"score": 0.92
},
{
"id": "a49d9e05-eb62-4c00-8186-e74ba237a0ad",
"name": "Enterprise",
"score": 0.1
}
]
},
{
"clientReferenceId": "ref-2",
"id": "v1.6789ZyXwVuTsRqPoNmLkJiHgFeDcBa01",
"name": "Microsoft",
"domain": "microsoft.com",
"icpFitScore": 0,
"topProfile": {
"id": "3fbaaaa7-700f-4419-a0c6-56f9f3fca391",
"name": "Mid-market SaaS"
},
"profileScores": [
{
"id": "3fbaaaa7-700f-4419-a0c6-56f9f3fca391",
"name": "Mid-market SaaS",
"score": 0
},
{
"id": "a49d9e05-eb62-4c00-8186-e74ba237a0ad",
"name": "Enterprise",
"score": 0
}
]
},
{
"clientReferenceId": "ref-3",
"name": "Apple",
"error": {
"code": "NOT_FOUND",
"message": "Company not found"
}
}
],
"billing": {
"creditsCharged": 2,
"resultsReturned": 2,
"lowBalance": false
}
}