KYB och kundkännedom via API

Kontrollera ett svenskt bolag mot Bolagsverkets uppgifter med ett enda anrop. Organisationsnummer in, ett standardiserat bolagsobjekt ut: status, bolagsform, adress och momsnummer.

Problemet: kundkännedom ska gå att visa upp

Banker, betalföretag, fintechbolag, revisorer, advokater, fastighetsmäklare och andra verksamhetsutövare enligt penningtvättslagen (lag 2017:630 om åtgärder mot penningtvätt och finansiering av terrorism) måste känna sina kunder. Lagen kräver att kunden identifieras och att identiteten kontrolleras med registerutdrag eller andra uppgifter från en oberoende och tillförlitlig källa. För en juridisk person innebär det att ta reda på vem kunden är, att bolaget finns och är aktivt, och vilken bolagsform och adress som gäller. Uppgifterna ska dessutom kunna visas upp vid tillsyn, med datum. Det här är ingen juridisk rådgivning.

I praktiken görs det ofta för hand: någon slår upp bolaget, klistrar in uppgifter i ett formulär och kryssar i en ruta. Det är långsamt, går inte att upprepa och ger ingen spårbarhet. Med ett API blir kontrollen en del av onboardingflödet, och samma anrop kan köras om när kundrelationen ses över.

Så fungerar det

Prometiam är ett REST-API med officiella bolagsuppgifter från 18 länder. För Sverige kommer uppgifterna från Bolagsverket och uppdateras varje arbetsdag. Alla länder returnerar samma bolagsobjekt, så en svensk kund och en norsk eller finsk kund hanteras av samma kod.

  • GET /companies/search?country=SE&company_number=5560125790 hittar bolaget på organisationsnummer. Du kan också söka på name= eller vat=.
  • GET /companies/{id} ger hela bolagsobjektet. Använd det id som sökningen returnerade.
  • GET /vat/{number} kontrollerar momsnumret mot EU:s VIES.
  • POST /monitor bevakar bolaget och skickar ett webhook-larm vid ändrad status, avregistrering, sanktionsträff eller registerhändelse.
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=SE&company_number=5560125790' \
  -H 'Authorization: Bearer rk_live_...'

Exemplet slår upp Volvo (organisationsnummer 556012-5790). Skriv numret utan bindestreck i company_number.

Vad du får tillbaka

FältVad det betyder
company_nameBolagets namn i registret
company_number och identifiersOrganisationsnumret och övriga identifierare
status och local_statusStandardiserad status och registrets egen beteckning
legal_form och local_legal_formBolagsform, standardiserad och på svenska
founding_dateRegistreringsdatum
AdressfältRegistrerad adress, om registret anger den
vat_number och vat_number_sourceMomsnummer och hur det har tagits fram
leiLEI-kod när bolaget har en

Svenska momsnummer har vat_number_source satt till rule: numret är byggt av organisationsnumret (SE, nummer och 01). Formatet är rätt men registreringen är inte bekräftad av registret. Bekräfta den med GET /vat/{number} när det är viktigt.

Förändringar efter onboarding

Kundkännedom är inte en engångskontroll. Med POST /monitor med {"company_id": ..., "country": "SE"} får du ett larm när något ändras. GET /company-events/search?country=SE&company_number=... ger registerhändelserna: ändrat namn, ändrad status, ändrad bolagsform och ändrad registrerad adress. De datumsätts när ändringen först syns i registerdata, inga före den 30 september 2026.

Vad du inte får för Sverige

  • Inga styrelseledamöter, firmatecknare eller andra funktionärer: svenska bolag returneras som bolagsposter utan personer.
  • Ingen registerefterlevnadssignal.
  • Inga enskilda firmor. Enskilda näringsidkare serveras aldrig.
  • Sanktionsscreening finns som betafunktion (Professional och uppåt). PEP-screening är beta och gäller bara Spanien, alltså inte svenska kunder.
  • Verklig huvudman (UBO) ingår inte. Tjänsten ersätter därför inte hela er kundkännedomsprocess, den ger bolagsuppgifterna som underlag.

Vilken plan passar

Starter (9,99 EUR per månad, 1 000 krediter) räcker för en onboarding av måttlig volym. Professional (29,99 EUR, 10 000 krediter) lägger till full sanktionsscreening i beta och webhooks för bevakning. Scale (99,99 EUR, 50 000 krediter) ger årsredovisningar. Priserna är offentliga och årsbetalning ger två månader gratis.

Svenska uppgifter kommer från Bolagsverket. Enskilda firmor (enskilda näringsidkare) ingår aldrig i tjänsten.

Relaterade sidor

Starta 14 dagars gratis provperiod · API-dokumentation

Provperioden varar i 14 dagar och omfattar 500 krediter. Kort krävs, ingenting dras under provperioden; därefter fortsätter Starter (9,99 EUR per månad) om du inte säger upp.

Frequently asked questions

Hur kontrollerar jag ett svenskt bolag mot Bolagsverket via API?
Anropa GET /companies/search?country=SE&company_number=5560125790 med organisationsnumret utan bindestreck. Svaret är ett standardiserat bolagsobjekt med status, bolagsform, adress och momsnummer.
Räcker bolagsuppgifterna för kundkännedom enligt penningtvättslagen?
De ger underlaget om bolaget: att det finns, dess status, bolagsform och adress. Verklig huvudman och riskbedömning av kunden ingår inte, så de behöver ni hantera separat.
Ingår enskilda firmor?
Nej. Enskilda näringsidkare serveras aldrig, bara juridiska personer som bolag och föreningar som registret publicerar.
Är svenska momsnummer bekräftade?
Nej, de är byggda av organisationsnumret (vat_number_source är rule). Bekräfta registreringen med GET /vat/{number}.
Hur testar jag utan att köpa?
Provperioden varar i 14 dagar och omfattar 500 krediter. Kort krävs, ingenting dras under provperioden och sedan fortsätter Starter om du inte säger upp.