KYB og kundekendskab med CVR via API

Et CVR-nummer ind, en standardiseret virksomhedsprofil ud: navn, status, selskabsform, adresse og momsnummer. Til kundekendskabsproceduren efter hvidvaskloven, uden at sætte sig ind i CVR-systemets egne grænseflader.

Problemet: kundekendskab skal dokumenteres

Hvidvaskloven pålægger bl.a. finansielle virksomheder, revisorer, advokater og ejendomsmæglere at gennemføre kundekendskabsprocedurer, før et kundeforhold etableres, og at opbevare oplysningerne i mindst fem år efter forretningsforbindelsens ophør (se Erhvervsstyrelsens vejledning om lovens anvendelsesområde). Omfanget afhænger af din risikovurdering. For en erhvervskunde betyder det som minimum, at du kan dokumentere, at virksomheden findes, hvad den hedder, hvilken selskabsform den har, om den er aktiv, og hvor den er hjemmehørende. Det skal ske ens hver gang, og resultatet skal kunne gemmes i kundens kundekendskabsfil. Dette er ikke juridisk rådgivning; kontrollér dine forpligtelser i loven og hos din tilsynsmyndighed.

I praksis betyder det manuelle opslag i CVR eller en integration, der er skrevet specifikt til Danmark. Hver udenlandsk kunde kræver så en ny integration for hvert register. Prometiam samler det i ét REST-API med officielle registerdata fra 18 lande, hvor en dansk virksomhed har præcis samme felter som en svensk, en norsk eller en estisk.

Sådan fungerer det

To kald dækker forløbet. Først finder du virksomheden med GET /companies/search?country=DK, enten på company_number (CVR-nummeret, otte cifre), på name eller på vat. Derefter henter du hele profilen med GET /companies/{id}, hvor du bruger det id, søgningen returnerede.

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=DK&company_number=24256790' \
  -H 'Authorization: Bearer rk_live_...'

CVR-nummer 24256790 er Novo Nordisk A/S. Svaret er det samme standardobjekt som for alle andre lande. Det betyder, at jeres onboardingflow kan bygges én gang og bruges til danske, svenske og norske kunder.

Det får du for en dansk virksomhed

FeltHvad det betyder
company_nameVirksomhedens navn i CVR
company_number, identifiersCVR-nummeret og øvrige identifikatorer
status, local_statusStandardiseret status og registerets egen betegnelse, herunder om virksomheden er under konkurs
legal_form, local_legal_formSelskabsform, fx ApS eller A/S, standardiseret og som registeret skriver den
founding_dateStiftelsesdato
AdressefelterRegistreret adresse
vat_number, vat_number_sourceMomsnummer. For Danmark er det rule: DK + CVR-nummer, formatet er rigtigt, men registreringen er ikke bekræftet

Netop fordi momsnummeret er udledt af CVR-nummeret, kan du bekræfte registreringen med GET /vat/DK24256790, som slår nummeret op i EU's VIES. Brug det, hvis momsregistreringen har betydning for jeres vurdering.

Sanktionsscreening og løbende overvågning

Kundekendskab slutter ikke ved oprettelsen. Med POST /monitor og {"company_id": ..., "country": "DK"} får du en webhook, når virksomhedens status ændres, når den opløses, ved et sanktionstræf, og når registeret viser en ændring i navn, status, selskabsform eller registreret adresse. Ændringerne dateres den dag, de første gang optræder i registerdata, og findes kun fra 30. september 2026. Sanktionsscreening (GET /sanctions/screen?name=...) er i beta og hører til Professional-abonnementet sammen med webhooks.

curl -X POST 'https://api.prometiam.com/functions/v1/risk-api/monitor' \
  -H 'Authorization: Bearer rk_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"company_id": 123, "country": "DK"}'

Hvad du gemmer i kundekendskabsfilen

Gem det svar, du handlede på, sammen med tidspunktet for opslaget og CVR-nummeret. Stemmer navnet, selskabsformen eller adressen ikke med det, kunden har oplyst, så notér afvigelsen og afklar den med kunden, før forholdet etableres. Vis status og local_status i sagen, så det fremgår, om virksomheden var aktiv, da du kontrollerede.

Det får du ikke

  • Danske data er virksomhedsdata. API'et returnerer ikke direktion, bestyrelse eller reelle ejere for Danmark; dem må du hente fra kilden eller fra kunden.
  • Ingen registerets compliance-signal og ingen oplysninger om selskabskapital.
  • Enkeltmandsvirksomheder og dødsboer udleveres aldrig.
  • Screening af personer sker kun mod de navne, du selv sender; API'et kender ikke danske ledelsesmedlemmer.
  • PEP-screening er en beta og findes kun for Spanien.

Se omfanget samlet på forsiden for Danmark og i API-dokumentationen. Opdateringer fra CVR kommer hver arbejdsdag.

Hvilket abonnement passer

Starter (9,99 EUR om måneden, 1.000 kreditter) dækker opslag og profiler. Professional (29,99 EUR, 10.000 kreditter) tilføjer sanktionsscreening i beta og webhooks til overvågning. Scale (99,99 EUR, 50.000 kreditter) giver adgang til regnskaber. Priserne er offentlige, og du behøver ikke tale med en sælger; årlig betaling giver to måneder gratis. Prøveperioden varer 14 dage med 500 kreditter; der kræves kort, men der trækkes ingen penge i perioden.

Relaterede sider

Start 14 dages gratis prøveperiode · API-dokumentation

Prøveperioden varer 14 dage og omfatter 500 kreditter. Kort kræves, og der trækkes ingen penge i prøveperioden; derefter fortsætter Starter-abonnementet (9,99 EUR om måneden), medmindre du opsiger det.

Frequently asked questions

Hvilke oplysninger kan jeg bruge til kundekendskab efter hvidvaskloven?
Du får virksomhedens navn, CVR-nummer, status, selskabsform, stiftelsesdato og registrerede adresse som standardiserede felter. Det dokumenterer, at virksomheden findes og er aktiv. Reelle ejere og ledelse leveres ikke for Danmark, så den del af kundekendskabet skal dokumenteres på anden vis.
Kan jeg søge på CVR-nummer?
Ja. Brug GET /companies/search?country=DK&company_number= med de otte cifre. Du kan også søge på name eller på vat.
Er sanktionsscreening med?
Ja, i beta, i Professional-abonnementet og op. Den sammenligner navne med flere officielle sanktionslister. Den er en støtte til din vurdering, ikke en afgørelse.
Får jeg besked, hvis en kunde bliver opløst eller går konkurs?
Ja. Overvåg kunden med POST /monitor, så sendes en webhook ved statusændring, opløsning, sanktionstræf og registerændringer. Konkurs vises i statusfeltet.
Er enkeltmandsvirksomheder med?
Nej. Enkeltmandsvirksomheder og dødsboer udleveres aldrig fra de danske data.