Registrer deg

Bruksområde · KYB

KYB og kundekontroll av norske selskaper via API

Verifiser norske selskaper ved onboarding med noen få linjer kode: organisasjonsnummer inn, status, roller og sanksjonsscreening (beta) ut. Samme kall virker med NIF, SIREN og company_number i de andre landene.

Problemet

Å onboarde en B2B-motpart i regulert europeisk finans betyr å bevise fire ting før du handler: at selskapet faktisk finnes juridisk, at du vet hvem som kontrollerer det, at ingen av partene er sanksjonert, og at det ikke finnes et åpenbart negativt signal. Standardverktøyet for dette er fragmentert — én leverandør for spanske data, en annen for franske, en tredje for britiske Companies House, en fjerde for sanksjoner, ofte en femte for negativ presseomtale. Hver kontrakt er årlig, uklart priset, og krever et salgsmøte.

For en fintech som onboarder noen hundre B2B-kunder i måneden er denne leverandørstabelen kostbar og treg å integrere. Prometiam-API-et erstatter register- og sanksjonsleddene med ett REST-endepunktsett og forutsigbar bruksbasert prising — inkludert Norge, som de fleste registerleverandører ikke dekker sammen med resten av Europa.

Integrasjon på 30 sekunder

Tre endepunkter dekker register- og sanksjonsflyten i KYB. Kjør dem i denne rekkefølgen:

# 1. Slå opp motparten på organisasjonsnummer (Norge)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?company_number=923609016&country=NO' \
  -H 'Authorization: Bearer rk_live_...'

# 2. Hent hele selskapsprofilen (roller, kapital, registerdata)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/923609016' \
  -H 'Authorization: Bearer rk_live_...'

# 3. Screen selskapsnavnet og hvert gjeldende rolleinnehavernavn mot sanksjonslister
curl 'https://api.prometiam.com/functions/v1/risk-api/sanctions/screen?name=Equinor&threshold=85' \
  -H 'Authorization: Bearer rk_live_...'

For Norge er id-en i steg 2 selve organisasjonsnummeret — Prometiam bruker ingen intern forskyvning for norske selskaper, så tallet du søkte med i steg 1 er det samme du bruker i /companies/{id}. Pakk inn de tre kallene i én funksjon, kall den fra onboarding-skjemaet, og integrasjonen kjører på under en time.

Et reelt Python-eksempel

import os, requests

API = 'https://api.prometiam.com/functions/v1/risk-api'
HEAD = {'Authorization': f'Bearer {os.environ["PROMETIAM_API_KEY"]}'}

def kyb_sjekk(orgnr: str, country: str = 'NO'):
    # Slå opp selskapet
    s = requests.get(f'{API}/companies/search', params={'company_number': orgnr, 'country': country}, headers=HEAD).json()
    if not s.get('data'): return {'status': 'not_found'}
    company = s['data'][0]

    # Hele profilen (roller + registerdata)
    detail = requests.get(f'{API}/companies/{company["id"]}', headers=HEAD).json()['data']

    # Sanksjoner på den juridiske enheten
    legal_hits = requests.get(f'{API}/sanctions/screen',
                              params={'name': detail['company_name'], 'threshold': 85},
                              headers=HEAD).json()['data']

    # Sanksjoner på hvert gjeldende rolleinnehaver
    officer_hits = []
    for c in detail.get('contacts', []):
        if not c.get('is_current'): continue
        h = requests.get(f'{API}/sanctions/screen',
                         params={'name': c['full_name'], 'threshold': 85, 'entity_type': 'person'},
                         headers=HEAD).json()['data']
        if h: officer_hits.append({'rolle': c['full_name'], 'treff': h})

    return {
        'status': 'verifisert' if (not legal_hits and not officer_hits) else 'til_gjennomgang',
        'company': detail,
        'sanksjoner': {'juridisk': legal_hits, 'roller': officer_hits},
    }

30 linjer inkludert importene. En KYB-applikasjon bygget på dette returnerer et verifisert-eller-til-gjennomgang-svar på godt under et sekund på hurtiglagrede resultater.

Hva du faktisk får tilbake

Responsen fra /companies/{id} inneholder det en compliance-ansvarlig trenger for å fylle ut en onboarding-fil:

  • Identitet: firmanavn, organisasjonsnummer / NIF / SIREN / company_number, organisasjonsform, adresse, stiftelsesdato
  • Registerdata: NACE-næringskode og NACE-etikett for Norge; tomo/libro/folio/hoja for Spania; greffe d'immatriculation for Frankrike; Companies House-registrering for Storbritannia
  • Roller: styremedlemmer, styreleder og daglig leder, merket gjeldende eller tidligere — men for Norge er appointment_date og end_date alltid null, siden Brønnøysunds rollefil publiserer gjeldende roller uten oppnevningsdato
  • Status: aktiv, oppløst, under avvikling, oppdatert daglig
  • Kapital: registrert aksjekapital (capital_amount + capital_currency, NOK for Norge)

Responsen fra /sanctions/screen returnerer treff med et konfidensscore (0–100), kildeliste (EU / FN / OFAC / UK / Australia (DFAT) / FR gels / US CSL) og eventuelle alias. Du setter terskelen selv per kall for å styre andelen falske positive.

Skjermbilde av kundedashbordet: en selskapsprofil med identifikatorer og signalerSkjermbilde av kundedashbordet: en selskapsprofil med identifikatorer og signaler
Samme post i dashbordet: identifikatorer, forretningsadresse og signalene for insolvens, sanksjoner (beta) og register på én side. Vist for et britisk selskap. Åpne i dashbordet

Norge: åpne data — og hva Prometiam legger til

Vær ærlig om utgangspunktet: Brønnøysundregistrene publiserer Enhetsregisteret som gratis åpne data uten registrering (se vår guide til hva Enhetsregisteret er). Et enkelt organisasjonsnummer kan slås opp gratis direkte hos Brreg, eller hos en norsk tjeneste som Proff.no (se Proff-alternativet). Du kan også prøve oppslaget gratis i organisasjonsnummer-søket.

Det Prometiam legger til er ikke tilgangen til norske data i seg selv, men at Norge kommer i samme skjema som alle de andre landene API-et dekker — én API-nøkkel, ett svarformat, ?country=NO på hvert endepunkt — pluss endepunkter Brønnøysund ikke har: sanksjonsscreening, grenseoverskridende konkursvarsler og LEI-oppslag i samme kall. Norge har ingen kunngjøringstjeneste tilsvarende BORME eller BODACC, så endepunktene for selskapshendelser returnerer bare registerendringer (navn, status, selskapsform og forretningsadresse) fra 14. oktober 2026. Norske konkursvarsler er derimot en del av innsolvensdekningen, som spenner seksten markeder totalt (FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE, ES, LV, EE, SG).

Etter onboarding følger løpende kontroll: POST /monitor varsler med webhook om statusendring, oppløsning, sanksjonstreff og registerendringer for norske selskaper. På Scale-planen henter du dessuten de tre siste godkjente årsregnskapene fra Regnskapsregisteret med GET /companies/{id}/financials (uten antall ansatte; 10 kall i måneden på de andre planene).

Prispasning

For en fintech som onboarder 500 B2B-motparter i måneden er et typisk KYB-kall omtrent 5 API-kall per motpart (oppslag + detalj + 3 sanksjonsscreeninger for selskapet og de viktigste rolleinnehaverne). Det blir 2 500 kall i måneden, omtrent 5 500 kreditter (11 per motpart: 1 for oppslaget, 1 for detaljen, 3 per screening) — godt innenfor Professional-planen (29,99 €/måned, 10 000 kreditter i måneden), som også dekker sanksjonsscreeningen dette mønsteret bruker. Ved 4 000 motparter i måneden (rundt 44 000 kreditter) passer Scale-planen (99,99 €/måned, 50 000 kreditter i måneden) uten problemer.

Den gratis prøveperioden på 14 dager gir 500 kreditter uten belastning før prøveperioden er over — nok til å teste hele mønsteret, inkludert norske organisasjonsnummer, før du velger plan.

Implementeringsmønstre

Cache hyppige oppslag. De fleste B2B-fintecher onboarder de samme morselskapene gjentatte ganger. Cache /companies/{id}-responsen i 24 timer; oppdater ved behov eller via en daglig bakgrunnsjobb.

Overvåking av norske motparter. POST /monitor med webhook-varsler dekker kun Spania, Storbritannia, Irland, Polen, Norge, Finland, Sverige, Belgia, Kroatia, Danmark, Estland, Slovakia, Sveits, Latvia, Kypros, Romania, Litauen, Canada, Australia, Japan, Israel, Singapore, Colombia, Taiwan, Tsjekkia, Tyskland, Argentina, Ukraina, Serbia, Ecuador, Nederland, Brasil og USA. Norge har overvåking (POST /monitor) med status, oppløsning, sanksjonstreff og registerendringer fra 14. oktober 2026 (ingen kunngjøringstjeneste); konkursvarsler hentes separat.

Justering av sanksjonsterskel. Start på 85 (standardverdien), juster deretter etter kostnaden ved falske positive. For høyrisiko-onboarding (kreditt, betalingsformidling) er 80 det tryggere valget. For lav risiko (nyhetsbrev, gratis verifisering) reduserer 90 støyen.

Grenser i dekningen, sagt rett ut

  • Innsolvensvarsler gjelder kun selskaper, seksten markeder totalt (FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE, ES, LV, EE, SG); spanske konkursprosedyrer ligger på GET /search, ikke på /insolvency/search.
  • Overvåking (POST /monitor) dekker alle landene unntatt Frankrike og Chile, Norge inkludert: webhook-varsel ved statusendring, oppløsning, sanksjonstreff og registerendringer (alle planer; 250 selskaper på Professional).
  • Sanksjonsscreening er i beta.
  • PPE-screening (politisk eksponerte personer) er i beta og kun for Spania, uten nærstående personer (RCA).
  • Irland og Polen er på selskapsnivå — ingen roller ennå.
  • Selskapshendelser er bare registerendringer, fra 14. oktober 2026 (Norge har ingen kunngjøringstjeneste).
  • Norske roller mangler oppnevningsdato: appointment_date og end_date er alltid null for Norge.
  • Reelt eierskap (beneficial ownership) dekkes kun via det britiske PSC-registeret; rolledata fra de andre registrene — inkludert norske styremedlemmer og daglig leder — er ikke det samme som reelle rettighetshavere.

Ofte stilte spørsmål

Hva er KYB?
KYB («Know Your Business») er den regulerte prosessen for å kontrollere en forretningsmotpart før du handler med den. Den forutsetter vanligvis å bekrefte juridisk eksistens (register), reelt eierskap, sanksjonseksponering og negativ presseomtale. Prometiam-API-et dekker register- og sanksjonsleddene i ett endepunktsett.

Hvilke land dekker Prometiam KYB?
Spania (BORME), Frankrike (BODACC), Storbritannia (Companies House), Irland (CRO, selskapsnivå), Polen (KRS, selskapsnivå), Norge (Brønnøysundregistrene / Enhetsregisteret, selskaper og roller), Finland (PRH/YTJ), Sverige (Bolagsverket), Belgia (KBO), Kroatia (Sudski registar), Danmark (CVR), Estland (Äriregister), Slovakia (RPO), Sveits (Zefix), Latvia (Uzņēmumu reģistrs), Kypros (DRCOR) og Romania (ONRC) og USA; Finland, Sverige, Belgia, Kroatia, Danmark, Estland, Slovakia, Sveits, Latvia, Kypros, Romania, Litauen, Canada, Australia, Japan, Israel, Singapore, Colombia, Taiwan, Tyskland, Argentina, Ukraina, Serbia, Ecuador, Chile, Mexico, Nederland, Brasil og USA leverer kun selskapsdata. Bruk ?country=ES|FR|GB|IE|PL|NO|FI|SE|BE|HR|DK|EE|SK|CH|LV|CY|RO|US|LT|CA|AU|JP|IL|SG|CO|TW|BR|CZ|DE|AR|UA|RS|EC|NL|CL|NL|MX på hvert endepunkt.

Inkluderer Prometiam KYB sanksjonsscreening?
Ja — Professional-planen (29,99 €/måned) inkluderer /sanctions/screen, som fuzzy-matcher mot sju kilder: EUs konsoliderte liste, FN, OFAC, UK, Australia (DFAT), det franske Registre des gels, samt hele US Consolidated Screening List av eksportkontrollister, i ett kall. Sanksjonsscreening er i beta.

Er ikke Brønnøysundregistrene allerede gratis og åpent?
Jo. Enhetsregisteret publiseres som gratis åpne data uten registrering, og et enkelt organisasjonsnummer kan slås opp direkte hos Brreg. Det Prometiam legger til er at Norge kommer i samme skjema og samme API-nøkkel som alle de andre landene API-et dekker, pluss endepunkter Brønnøysund ikke har, som sanksjonsscreening og grenseoverskridende konkursvarsler.

Er dataene ferske nok til sanntids-onboarding?
Norske data oppdateres daglig, i likhet med spanske, franske, irske og polske data. Storbritannia oppdateres i månedlig bulk pluss daglig delta.

Relatert