KYC/KYB when opening a business account
When a company opens an account with you, you need to know who it is, where it is established and who runs it. The API brings these elements together from official sources.
The problem#
Opening an account for a company (fintech, marketplace, B2B platform, firm subject to anti-money laundering rules) means checking its identity, not copying what the applicant typed. In practice the file mixes screenshots, a PDF extract of the register and officer names typed by hand.
The API lets you build that file from the company number alone, compare what the applicant declares with what the official sources say, and bring in an analyst only for the differences.
The API data that answers it#
GET /enterprise/{num}: official name, legal form, status, legal situation, start date and registered office.GET /enterprise/{num}/denominations: every name, to link a trading name to the company that holds it.GET /enterprise/{num}/roles: officers, representatives and beneficial owners extracted from the most recent publication in the Moniteur belge (incorporation, appointment, transfer), with the reference of that publication.GET /vat/{vatNumber}: validation of the VAT number with VIES.GET /enterprise/{num}/financial: the financial summary from the accounts filed with the National Bank, when they exist.
Example request#
"tok-comment"># Identity: legal name, form, status, juridical situation, registered office
curl https://companybelgium.be/api/v2/enterprise/1033.022.383 \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
"tok-comment">
# Officers and beneficial owners extracted from the Moniteur belge
curl https://companybelgium.be/api/v2/enterprise/1033.022.383/roles \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
"tok-comment">
# VAT number through VIES
curl https://companybelgium.be/api/v2/vat/BE1033022383 \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"Excerpt of the /enterprise/{num}/roles response:
{
"success": true,
"data": {
"enterpriseNumber": "1033022383",
"status": "...",
"source": {
"refNumber": "...",
"publicationDate": "...",
"publicationTitle": "...",
"publicationType": "..."
},
"roles": [
{
"fullName": "...",
"entityType": "...",
"roles": [
"..."
],
"ownershipPercentage": "...",
"enterpriseNumber": "..."
}
],
"updatedAt": "..."
},
"timestamp": "...",
"meta": {
"responseTime": "..."
}
}The status field of this response is ok when a publication was read, no_publication when no usable publication exists and extraction_failed when reading failed. The source block lets you find the original publication in the Moniteur belge.
Recommended implementation#
- Ask for the company number first, then prefill the form from the record: the applicant corrects instead of typing.
- Compare the person opening the account with the officers returned by
/enterprise/{num}/roles; an absence is not a refusal, it is a point to check (an agent can act without being an officer). - Automatically refuse a company that is not active, and route an abnormal legal situation to an analyst.
- Archive the raw response, the publication reference and the date of the call in the client file.
Limits to know#
- Officers and owners are extracted automatically from Moniteur belge publications. This is not the UBO register kept by the FPS Finance, which remains the source to consult for your regulatory obligations.
- The extraction relies on the latest relevant publication: a change not yet published does not appear, and an extraction can fail or be incomplete.
- A company without a usable publication returns
no_publication; when the source is temporarily unreachable, the endpoint can answer 502. - The API does not verify the identity of a natural person (ID document, selfie): it documents the company, not the applicant.
- The result supports a decision; it does not take it for you and is not legal advice.
Frequently asked questions#
Does the API return the ultimate beneficial owners (UBO)?
Through GET /enterprise/{num}/roles it returns the officers and owners extracted automatically from the Moniteur belge. It is not a copy of the official UBO register of the FPS Finance.
Where does the company identity data come from?
From the official open data of the Crossroads Bank for Enterprises (BCE/KBO), published by the FPS Economy.
Can the API be used for an anti-money laundering file?
Yes, as a data source to build and document the file. The due diligence obligations remain yours, and the official UBO register must be consulted where the law requires it.
Put it into practice
Create a key in the developer portal, then follow the reference documentation for each endpoint mentioned.
Reference documentation