Skip to main content
POST
KYB Check

Authorizations

X-API-Key
string
header
required

Body

application/json

Request model for KYB verification.

entity_id
string
required

Internal entity identifier

registration_number
string
required

KVK (NL) or KBO/CBE (BE) company number. For other countries it is not checked against a company register; it is only used to find the company's LEI in GLEIF (group_structure)

country
string
required

ISO 3166-1 alpha-2 country code

Required string length: 2
entity_name
string | null

Legal entity name (optional, used for sanctions)

vat_number
string | null

VAT number for VIES verification

domain
string | null

Company domain for web presence check

Response

KYB result

Response body of POST /v1/kyb/check.

entity_id
string
required

The entity_id sent in the request

registration_number
string
required

The registration_number sent in the request

country
string
required

ISO 3166-1 alpha-2 country code, upper case

verified
boolean
required

True when trust_score is 60 or more. It is a score threshold, not a register match: it can be true when no company register was checked. See register_verified.

register_verified
boolean
required

True only when the company register in register_checked found the company (KVK for NL, KBO for BE). False when it did not, when the lookup failed, and when register_checked is null.

register_checked
enum<string> | null
required

The company register this check asked: KVK (NL) or KBO (BE). Null when none was asked: the country is not NL or BE, a BE check had no CBE number, or the register was busy and skipped.

Available options:
KVK,
KBO
sanctions_flagged
boolean
required

True when the sanctions screen matched the entity

kyb_status
string
required

One of approved, review_required, edd_required or rejected

trust_score
integer
required

0-100 trust score. Higher = more trustworthy

Required range: 0 <= x <= 100
trust_level
string
required

Trust level derived from trust_score

cluster
string
required

Entity cluster classification

recommendation
string
required

Action recommendation

confidence
number
required

Confidence in the assessment (0-1)

Required range: 0 <= x <= 1
top_factors
TopFactor · object[]
required

Top factors behind the score

sources_checked
integer
required

Number of data sources that answered

processing_time_ms
integer
required

Time taken to produce the answer

risk_flags
string[]
required

Negative factors and register flags, as source: signal

correlations
Correlations · object
required

Cross-source correlation scores

findings
Finding · object[]
required

What to do about each correlation

group_structure
Group Structure · object
required

LEI and parents from GLEIF; informational, never scored

group_chain
Group Chain · object | null
required

Belgian parent chain from the NBB filing; null otherwise

company_profile
CompanyProfile · object | null
required

What the KVK register says about the company; null when it has no record

response_quality
string
required

The tier this answer was served at

disclaimers
string[]
required

Notes about this answer, e.g. a retired tier