Score ICP fit

POST

/api/v1/icp-score

• Production

Cost: 1 credit per contact

Returns an A/B/C/D grade plus a 0-100 numeric score and a buyer-persona breakdown. Wraps LeadSonar’s AI enrichment engine. Costs 1 credit per call. Provide either an email or the full triplet of first_name + last_name + domain. The target_icp field is required — describe your ideal customer in 1-2 sentences.

Try it

curl https://app.leadsonar.io/api/v1/icp-score \
  -H "X-API-Key: $LS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jordan",
    "last_name": "Reyes",
    "title": "Head of Sales",
    "company": "Maildeck",
    "domain": "maildeck.co",
    "target_icp": "Agencies and B2B companies that run cold email outreach and need sending infrastructure"
  }'

Authorizations

• ApiKeyAuth

Request Body ^required

Provide either email or the full triplet of first_name + last_name + domain.

object

first_name

string

Example

John

last_name

string

Example

Doe

email

string

Example

john.doe@acme.com

domain

string

Example

acme.com

company

string

Example

Acme Inc

title

string

Example

VP of Engineering

industry

string

Example

fintech

target_icp

required

1-2 sentence description of your ideal customer.

string

Example

Mid-market fintech companies in North America with 50-500 employees that need payment infrastructure.

Example

{
  "first_name": "Jordan",
  "last_name": "Reyes",
  "title": "Head of Sales",
  "company": "Maildeck",
  "domain": "maildeck.co",
  "target_icp": "Agencies and B2B companies that run cold email outreach and need sending infrastructure"
}

Responses

200

ICP score result

object

grade

string

Allowed values: A B C D

Example

A

score

integer

<= 100

Example

87

fit

string

Allowed values: high medium low

Example

high

company_type

string

nullable

Example

fintech infrastructure company

their_solution

string

nullable

Example

payment processing and revenue growth

buyer_personas

string

nullable

Example

CTOs, VPs of Engineering, fintech founders

analysis

Free-form reasoning behind the score

string

nullable

cost_credits

number

Example

1

company_type_plural

string

Example

Payment Solutions Providers

industry_descriptor

string

Example

financial services and payment solutions

Example

{
  "grade": "A",
  "score": 81,
  "fit": "high",
  "company_type": "cold email infrastructure providers",
  "company_type_plural": "cold email infrastructure providers",
  "industry_descriptor": "cold email infrastructure",
  "their_solution": "scalable cold email infrastructure",
  "buyer_personas": null,
  "analysis": null,
  "cost_credits": 1
}

400

Validation error

object

error

required

Human-readable error message

string

message

Additional details

string

402

Insufficient credits

object

error

required

Human-readable error message

string

message

Additional details

string

502

AI enrichment service unavailable

object

error

required

Human-readable error message

string

message

Additional details

string