A first KYB check in one call: what to ask, what to keep
Onboarding forms collect a company name, a website or a registration number. Before anything else happens, you want to know whether this is a real legal entity and which one. That first step is a lookup, and a few design choices decide whether it is reliable.
What to send
Send whatever the customer gave you: a name, a website domain, a registry number, an LEI or a VAT number. The lookup works out which kind it is and asks the official register behind it. If you know the country, pass country to search one register only; it is faster and removes false friends from other countries.
curl "https://api.ambolt.dev/v1/entity-resolve?query=Nokia%20Oyj&country=FI&free=1"
What to store
Keep the facts you will need to explain the decision later:
- the legal name, legal form and status,
- the register, the registry number and the date you looked it up,
- the match score and match reason,
- the LEI if the company has one.
A match comes with a score and a reason such as exact normalised name or id match, so you can tell an exact hit from a close one.
Three situations to handle in code
- A strong match. A score of 90 or more, or an
id match, can go straight through your flow. - A weak match. Scores under 90 are suggestions. A hit that came only from guessing a company name out of a website's domain is marked
domain name only (weak evidence)and scored below 90: show it to a person, do not accept it silently. - An ambiguous name. When another, different legal entity carries the same name, the response has
ambiguous: trueand a note. Ask the customer for the registration number or the country.
What this does not do
It confirms that a legal entity exists and what the register says about it. It does not tell you who owns or controls the company, whether it is creditworthy or sanctioned, or whether the person filling in the form is entitled to act for it. Officers and sole traders are not returned. Treat the lookup as the first input to your own KYB process, not as the process.
From a form to an Actor or a tool
The same lookup runs as a free web tool, and as an MCP tool for agents. Failed lookups are never charged. See the EntityResolve page for the registers connected today, and what KYB means for the background.
More from the blog
- Look up a Brazilian company by CNPJ without scraping
- The CRA reporting duty is live: what to prepare before you need it
- Live SSL, domain and vulnerability badges for your README
- Check an npm or PyPI package for known vulnerabilities before you install
- All tools and prices
- Guides
Data and prices change; every API response states its source and date. Informational only, not financial, legal or tax advice.