Skip to main content
POST
Create Entity Report

Authorizations

X-API-Key
string
header
required

Body

application/json

Body of POST /v1/reports/entity.

Send either check_id (rebuild from a check this store already holds) or identifiers (entity_name + country plus any of the optional ones), never both. Identifier fields keep the names of POST /v1/entity/check.

check_id
string | null

Id of a check stored by an earlier /v1/reports/entity call

entity_name
string | null
Required string length: 1 - 500
country
string | null
Required string length: 2
kvk_number
string | null
cbe_number
string | null
vat_number
string | null
Maximum string length: 20
domain
string | null
Maximum string length: 253
iban
string | null
Maximum string length: 34
wallet_address
string | null

Crypto wallet address (named wallet_address, as on /v1/entity/check)

Maximum string length: 100
wallet_chain
string | null

Response

Successful Response

report_id
string
required
check_id
string
required
created_at
string
required
entity
ReportEntity · object
required
sanctions
SanctionsScreen · object
required
pep
PepScreen · object
required
risk
RiskSection · object
required
correlations
Correlations · object
required
evidence
Evidence · object
required
schema_version
string
default:1
identity
IdentityRecord · object[]
identification
Identification · object | null

How the company was identified: from the numbers found on its own website, each checked with its register. Absent when the customer gave a number or discovery was skipped; present for every other outcome, also when nothing was found or the read was refused, blocked, timed out or failed.

wallet
WalletScreen · object | null
domain
DomainSignals · object | null
financials
FinancialsSection · object | null

Financials (NL): the latest annual accounts filed with KVK.

has_filings is None whenever the source did not answer: an unavailable source never reads as "none filed".

group_structure
GroupStructure · object | null

Group structure from GLEIF Level 2 data.

Parents are not screened for sanctions (Walker, 2026-09-25): that is a separately priced add-on, so parents_screened is always False. A parent is None when GLEIF holds no parent LEI record; on any status other than ok every entity field is None, never "no parent".

group_chain
GroupChain · object | null

A Belgian company's group: the parent named in its NBB filing, chained up through GLEIF.

Read from the latest filing's consolidated-accounts declaration and shareholder structure, then each named parent's GLEIF direct and ultimate parent. The chain stops at the first missing link. Shown, never scored; parents are not screened for sanctions (Walker, 2026-09-25).

be_accounts
BeAccountsSection · object | null

Belgian annual accounts filed with the National Bank of Belgium.

Shown on the report, never scored. values maps the official account code ("70" turnover, "10/15" equity, ...) to the filed amounts; history holds the two older years a small company's second filing adds. On any status other than ok every figure field is empty, never "nothing filed". source is "consult" when read from the public Consult app; None means the web services, or a report stored before.

website_phones
ReportWebsitePhone · object[] | null
website_phones_reason
string | null
activity_evidence
ActivityEvidence · object | null

What the company's website and shop listings show about its activities.

attribution is the Amendment 2 rule's answer (business_activities.attribute): a name match and one related source, the domain's RDAP registrant, a company or VAT number on the site, or the site's own structured data (site_data); else name_city (a site name matching a trade name, same city); None: the site is not the company's as far as the sources show, and no activity is shown. registrant holds the organisation only (org, city, country, registrar_host), never a person's fields.

kbo_functions
ReportKboFunctions · object | null

The people and contact lines read from the company's public KBO search page at check time. status ok: functions is the whole "Functies" block ([] = the register lists none). Anything else: no name, never a stale or guessed one.

What the company trades as and the group it belongs to, from the websites the register lists, judged by the link check (lg-entity-link). links are the shown links only: a name alone never links.

findings
Finding · object[]
Maximum array length: 12
findings_note
string | null
sources
ReportSource · object[]
attributions
string[]