Skip to main content
POST
Lead Verify

Authorizations

X-API-Key
string
header
required

Body

application/json

One NL or BE lead: a company number or a name, plus whatever else is known.

country
enum<string>
required

Country of the company register: NL (KVK) or BE (KBO).

Available options:
NL,
BE
Example:

"NL"

company_number
string | null

8-digit KVK number (NL) or 10-digit KBO/CBE enterprise number (BE).

Maximum string length: 32
Example:

"68750110"

name
string | null

Company name as the lead gave it. Required for NL without a company_number.

Maximum string length: 200
Example:

"Test BV Donald"

vat_number
string | null

EU VAT number, checked with VIES.

Maximum string length: 20
Example:

"NL123456789B01"

email
string | null

Contact email; only its domain is checked (mail server, disposable).

Maximum string length: 254
Example:

"sales@example.nl"

domain
string | null

Company website domain.

Maximum string length: 253
Example:

"example.nl"

address
LeadAddress · object | null

Address the lead gave; compared with the registered address.

iban
string | null

IBAN the lead gave; validated locally, never echoed (last 4 only).

Maximum string length: 42
Example:

"NL91ABNA0417164300"

phone
string | null

Phone number the lead gave; compared with the numbers the company publishes, never echoed. Not accepted yet: a phone is rejected with 422 until website phone lookup is switched on.

Maximum string length: 40
Example:

"+31 20 123 4567"

Response

Successful Response

One verdict and a 0-100 lead score, with each check that went into it.

verdict
enum<string>
required
Available options:
real_active,
real_inactive,
not_found,
ambiguous,
unverifiable,
sanctioned
lead_score
integer
required
company
CompanyBlock · object
required
vat
VatBlock · object
required
iban
IbanBlock · object
required
sanctions
SanctionsBlock · object
required
email
EmailBlock · object
required
flags
enum<string>[]
required
Available options:
name_mismatch,
address_mismatch,
iban_invalid,
iban_foreign,
vat_invalid,
vat_owner_mismatch,
no_mail_server,
disposable_email,
recently_registered,
inactive,
business_stopped,
dormant_shell_signals
findings
Finding · object[]
required
sources_checked
integer
required
checked_at
string
required
schema_version
string
default:lead-verify-v1
Allowed value: "lead-verify-v1"
reason
string | null
correlations
LeadCorrelations · object

Cross-checks that inform, never change the lead score.

website_phones
WebsitePhone · object[]
website_phones_reason
string | null