Skip to main content
POST
Entity Check

Authorizations

X-API-Key
string
header
required

Body

application/json

Full entity check request - always runs country risk and sanctions; runs each other data source whose identifier is supplied (up to 8 total).

entity_name and country are required; identifiers (kvk_number, cbe_number, domain, iban, vat_number, wallet_address) are optional and raise confidence.

entity_name
string
required

Legal entity name

Required string length: 1 - 500
country
string
required

ISO 3166-1 alpha-2 country code

Required string length: 2
kvk_number
string | null

Dutch KVK number (8 digits)

cbe_number
string | null

Belgian CBE number (format: 0XXX.XXX.XXX)

domain
string | null

Entity website domain

Maximum string length: 253
iban
string | null

IBAN for financial validation

Maximum string length: 34
vat_number
string | null

EU VAT number

Maximum string length: 20
wallet_address
string | null

Crypto wallet address (format check only; no on-chain lookup)

Maximum string length: 100
wallet_chain
string | null

Blockchain the address is checked against (eth, base, polygon, arbitrum, btc, sol). Defaults to eth when omitted, so send btc or sol with a Bitcoin or Solana address

Response

Successful Response

Full trust intelligence response from /v1/entity/check.

trust_score
integer
required

Overall trust score

Required range: 0 <= x <= 100
trust_level
enum<string>
required
Available options:
high,
medium,
low,
critical
cluster
enum<string>
required
Available options:
established_eu_enterprise,
established_eu_sme,
verified_startup,
unverified_new,
high_risk_jurisdiction,
sanctions_flagged,
insufficient_data,
mixed_signals
recommendation
enum<string>
required
Available options:
proceed,
review,
enhanced_due_diligence,
block
confidence
number
required

Score confidence (0-1)

Required range: 0 <= x <= 1
top_factors
TopFactor · object[]
required
Maximum array length: 5
sources_checked
integer
required
Required range: x >= 0
processing_time_ms
integer
required
Required range: x >= 0
correlations
Correlations · object

Key correlations between signals

enhanced_check_hint
EnhancedCheckHint · object | null

Suggested deeper check when recommendation is review or edd

response_quality
string
default:fresh

Quality tier used for this response: cached, fresh, or enhanced

cache_hit
boolean
default:false

True if result was served from cache (cached tier)

source_data_dates
Source Data Dates · object

ISO timestamps when each data source was last retrieved

disclaimers
string[]

Legal disclaimers for data sources used in this response

version
string
default:1.0