KYB Onboarding API — Verify EU + UK Companies in 30 Lines

This use-case page shows how to build a Know Your Business (KYB) onboarding pipeline for EU and UK companies with the Prometiam Risk API. Onboarding a B2B counterparty in regulated finance means proving the company legally exists, knowing who controls it, and checking sanctions exposure. Instead of stitching together separate vendors for Spanish, French, UK, Irish, Polish and Norwegian data plus a sanctions provider, Prometiam covers the registry and sanctions legs through one REST endpoint set with usage-based pricing.

The 30-second integration

Three endpoints cover the flow, run in order: resolve the counterparty via /companies/search by NIF (Spain), SIREN (France) or company_number (UK); pull the full profile via /companies/{id}; then screen the legal entity and each current officer with /sanctions/screen. The page includes a ~30-line Python example returning a verified-or-review verdict.

What you get back

Sanctions screening fuzzy-matches names against six sources — EU, UN, OFAC, UK OFSI, French gels, and the US Consolidated Screening List (BIS Entity List, Denied Persons, ITAR) — 44,000+ active entities, with confidence scores and a tunable threshold. PEP screening is beta and Spain-only (no relatives or close associates); no adverse-media screening and no natural-person identity verification. Beneficial ownership is UK PSC only; Ireland and Poland are company-level. BORME and BODACC ingest daily; Companies House is monthly bulk plus daily delta.

Read more · Get a free API key

Frequently asked questions

What is KYB?
KYB ("Know Your Business") is the regulated process of verifying a corporate counterparty before transacting with it. It typically requires confirming legal existence (registry), beneficial ownership, sanctions exposure, and adverse media. The Prometiam Risk API covers the registry and sanctions legs in a single endpoint set.
Which countries does Prometiam KYB cover?
Spain (BORME), France (BODACC), the United Kingdom (Companies House), Ireland (CRO, company-level), Poland (KRS, company-level), and Norway (Brønnøysundregistrene, companies and officers). Use ?country=ES|FR|GB|IE|PL|NO on every endpoint.
How fast is integration?
First successful KYB call typically takes under 60 seconds from signup. The pattern is: /companies/search to resolve, /companies/{id} for detail, /sanctions/screen for screening — all bearer-token auth.
Does Prometiam KYB include sanctions screening?
Yes — the Professional tier (€29.99/mo) includes /sanctions/screen which fuzzy-matches against six sources: the EU consolidated list, UN, OFAC, UK OFSI, the French Registre des gels, plus the US Consolidated Screening List of export-control lists, in one call.
How does Prometiam KYB compare to Creditsafe or Iberinform for KYB?
For EU + UK scope, typically 50–95% cheaper at SMB and mid-market scale, with public pricing and free developer tier. Creditsafe and Iberinform both work but require sales engagement and annual contracts. See /alternatives/creditsafe and /alternatives/iberinform.
Is the data fresh enough for real-time onboarding?
BORME and BODACC are ingested daily from official gazettes. Companies House is monthly bulk plus daily delta. Check /coverage for the latest_filing date per country.