One-call KYB check for EU companies
Short answer: Call POST https://api.wsystem.dev/kyb/check with {"company": "FR40303265045"} (a VAT ID, CC:name, or an object with name, vatNumber, country, registryId). The API validates the VAT number in VIES, finds the company in the official register, screens the name against four sanctions lists and returns verdict: pass, review or fail, with reasons.
Key facts
- Verdict rules: fail on an invalid VAT number, a company marked inactive in the register, or a strong sanctions match (score ≥ 90); review on a possible match, VIES/register name mismatch, company not found or a source being unavailable; pass otherwise.
- Each section (vat, registry, sanctions) is returned in full so you can show evidence.
- MCP tool: kyb_check. Apify Actor: wsystem/kyb-company-check.
- Not a full AML/KYC solution: no UBO, PEP, document or ID verification.
Examples
KYB by VAT ID
curl -X POST https://api.wsystem.dev/kyb/check -H 'Content-Type: application/json' \
-d '{"company":"FR40303265045"}'Real response (live data, 2026-10-17):
{
"input": "FR40303265045",
"company_name": "SA SODIMAS",
"country": "FR",
"verdict": "pass",
"reasons": [],
"vat": {
"vat": "FR40303265045",
"status": "valid",
"valid": true,
"name": "SA SODIMAS",
"address": "11 RUE AMPERE, 26600 PONT DE L ISERE",
"consultation_number": "WAPIAAAAaFIeJ-ZE",
"request_date": "2026-10-17T06:07:14.329Z",
"error": null
},
"registry": {
"status": "found",
"error": null,
"match": {
"country": "FR",
"registry_id": "303265045",
"name": "SODIMAS",
"legal_form": "5599",
"status": "A",
"active": true,
"address": "11 RUE AMPERE 26600 PONT-DE-L'ISERE",
"postal_code": "26600",
"city": "PONT-DE-L'ISERE",
"registration_date": "1975-08-21",
"vat_id": "FR40303265045",
"activity_code": "28.22Z",
"activity": null,
"website": null,
"employees": "32",
"lei": null,
"source": "INSEE Sirene / recherche-entreprises.api.gouv.fr",
"source_url": "https://annuaire-entreprises.data.gouv.fr/entreprise/303265045",
"status_normalized": "active",
"status_raw": {
"etat_administratif": "A",
"date_fermeture": null
}
}
},
"sanctions": {
"status": "no_match",
"top_score": 0,
"matches": [],
"lists_date": "2026-10-17T08:14:13Z"
}
}Pricing
| Channel | Price |
|---|---|
| Free tier | 20 calls/day per IP, no key |
| x402 POST /kyb/check | $0.045 USDC per company |
| Apify Actor wsystem/kyb-company-check | $0.045 per company + $0.005 per run |
Questions and answers
What is a KYB check?
Know Your Business: confirming a company exists, is active, has a valid tax ID and is not sanctioned before you trade with it.
Does this cover beneficial owners (UBO)?
No. UBO registers in the EU mostly require legitimate-interest access since the 2022 CJEU ruling.
Can an AI agent run KYB?
Yes, via the MCP tool kyb_check at https://api.wsystem.dev/mcp/.
Related
- Sanctions screening API (EU, UN, OFAC SDN, UK)
- European company registry API
- EU VAT number validation API (VIES)
- API reference (OpenAPI)
Facts and competitor details checked 2026-10-17. W System Hungary Kft. is the maker of this product. Not affiliated with the European Commission. Not legal or tax advice.