Performs an enhanced business verification and returns detailed company
information, including associated shareholders and officers. In addition to
standard company data, this endpoint provides detailed shareholders and officer
profiles that help assess company structure and management.
registrationInfos is a list with one entry per company covered by the check. Without
ownership traversal it holds a single entry — the subject company. Each entry carries
its own layer, parentNode, mode (the LIVE or CACHE source that actually
answered for that company) and verifyResult.
layerCalls reports how many billable registry vendor calls the check consumed, split
into live and cache. It is null while status is IN_PROGRESS.
Ownership traversal
By default the response covers the subject company and its own register only.
Set maxLayer (2-10, default 2) to walk further up the ownership chain:
every corporate shareholder on a register is looked up in turn, layer by layer,
until maxLayer is reached. maxLayer counts the subject company as layer 1,
so maxLayer: 3 returns the subject, its register, and the registers of its
corporate shareholders.
Traversal runs only when mode is HYBRID, because each layer is resolved
cache-first. With LIVE or CACHE the value is accepted but no traversal is
performed.
A traversed result differs from a single-layer one in four ways:
registrationInfosgains one entry per traversed company — the subject atlayer
1, each corporate shareholder at its own depth, withparentNodepointing at the
registration number of the company that holds it.officersInfos/shareholdersInfoshold the flattened registers of every
traversed company. Each entry carrieslayerandparentNode(the
registration number of the company whose register it came from), which
together rebuild the tree. Entries read from a company atlayerN are tagged
layerN + 1.boInfosare the individuals whose ownership, multiplied along each chain and
summed across chains, reaches 25% or more.- Traversal is asynchronous. The create call usually returns
status
IN_PROGRESSwith no result payload — poll
GET /v1/business/checks/{id}untilstatusisCOMPLETED.layerCallsthen
covers every company the traversal touched, not just the subject.
A branch stops early when the corporate shareholder holds less than 25%, is
registered outside the subject company's country, has incomplete registry data,
or has already been visited on the same path.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||