Riittääkö rekisterihaku asiakkaan tuntemisen velvoitteeseen?

Ei yksin. Rekisteritieto todistaa, että yritys on olemassa ja missä tilassa se on, mutta rahanpesulaki edellyttää myös tosiasiallisten edunsaajien selvittämistä ja riskiperusteista arviota. Rajapinta hoitaa rekisteriosan ja tallentaa todisteen; muut vaiheet kuuluvat omaan prosessiisi.

Löytyykö vastauksesta hallituksen jäsenet tai toimitusjohtaja?

Ei. Suomessa palvelu tarjoaa yritystason tiedot. Roolitiedot saa vain Espanjasta, Ranskasta, Britanniasta ja Norjasta.

Kuinka usein tiedot päivittyvät?

Suomen tiedot päivittyvät joka arkipäivä. Rekisterimuutokset ilmestyvät tapahtumiin ja seurannan hälytyksiin, kun ne ensimmäisen kerran näkyvät rekisteritiedoissa.

Mistä ALV-numero tulee?

Kun rekisteri vahvistaa ALV-rekisteröinnin, numero on muotoa FI + numerot ja vat_number_source on register. Jos yritys ei ole ALV-rekisterissä, kenttä on tyhjä. EU-tason tarkistuksen saa GET /vat/{numero} -kutsulla.

Mitä teen, jos Y-tunnuksella ei löydy yritystä?

Tarkista ensin tunnuksen muoto (0112038-9: seitsemän numeroa, väliviiva ja tarkistenumero). Jos tunnus on oikea mutta hakutulos on tyhjä, tunnus ei ehkä kuulu yritykselle, jonka tiedot rajapinta palvelee. Tarkista tunnus asiakkaan omista asiakirjoista. Älä tee tunnistamista tyhjän tuloksen varassa, vaan pyydä asiakkaalta rekisteriote.

Tarvitaanko kokeiluun kortti?

Kyllä. Kokeilu kestää 14 päivää ja sisältää 500 krediittiä; korttia ei veloiteta kokeilun aikana, ja sen jälkeen jatkuu Starter, ellet peru.

KYB-tunnistaminen Y-tunnuksella

Kun uusi yritysasiakas antaa Y-tunnuksensa, saat PRH:n kaupparekisterin mukaiset perustiedot, tilan, VAT-numeron ja konkurssimerkinnät yhdellä rajapinnalla. Sama vastausrakenne toimii 18 maassa.

Ongelma: asiakkaan tunteminen on dokumentoitava

Rahanpesulaki (laki rahanpesun ja terrorismin rahoittamisen estämisestä, 444/2017) edellyttää, että ilmoitusvelvolliset, kuten luottolaitokset, tilintarkastajat ja kiinteistönvälittäjät, tuntevat asiakkaansa. Yritysasiakkaan osalta se tarkoittaa tunnistamista, tosiasiallisten edunsaajien selvittämistä ja tietojen pitämistä ajan tasalla koko asiakassuhteen ajan. Käytännössä kaupparekisteritiedot on haettava, tallennettava ja tarkistettava uudelleen asiakassuhteen aikana. Käsin se on hidasta: joku kirjoittaa Y-tunnuksen YTJ-hakuun, kopioi tulokset lomakkeelle ja unohtaa katsoa, onko yhtiö samaan aikaan asetettu konkurssiin.

Kun tarkistus tehdään rajapinnalla, sen voi liittää suoraan rekisteröitymis- tai tarjousprosessiin. Jokainen tarkistus palauttaa saman rakenteisen vastauksen, jonka voi tallentaa asiakastietoihin todisteeksi siitä, mitä rekisteri kertoi tarkistushetkellä.

Näin se toimii

Prometiamin REST-rajapinta palauttaa suomalaisen yrityksen tiedot Patentti- ja rekisterihallituksen (PRH) kaupparekisterin ja YTJ:n pohjalta. Hae yritys Y-tunnuksella tai nimellä, avaa koko profiili palautetulla id-arvolla ja pyydä tarvittaessa konkurssimerkinnät samassa kutsussa. Y-tunnuksen voi ensin kokeilla ilmaisella Y-tunnus-haulla.

# 1. Hae yritys Y-tunnuksella (esimerkki: Nokia Oyj)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=FI&company_number=0112038-9' \
  -H 'Authorization: Bearer rk_live_...'

# 2. Avaa koko profiili ja liitä mukaan konkurssimerkinnät
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/{id}?include=insolvency' \
  -H 'Authorization: Bearer rk_live_...'

# 3. Tarkista ALV-numero VIES-rekisteristä
curl 'https://api.prometiam.com/functions/v1/risk-api/vat/FI01120389' \
  -H 'Authorization: Bearer rk_live_...'

Korvaa {id} haun palauttamalla id-arvolla. Vastaus on kaikissa maissa samanmuotoinen, joten Suomen jälkeen voit lisätä esimerkiksi Ruotsin tai Viron samalla koodilla vaihtamalla country-parametrin. Täydellinen parametriluettelo on API-dokumentaatiossa.

Mitä vastauksessa on

Kenttä	Mitä se tarkoittaa
`company_name`	Toiminimi rekisterissä
`company_number`, `identifiers`	Y-tunnus ja muut tunnisteet
`status`, `local_status`	Vakioitu tila ja rekisterin oma tilatieto
`legal_form`, `local_legal_form`	Yhtiömuoto vakioituna ja rekisterin omin sanoin
`founding_date`	Perustamis- tai rekisteröintipäivä
`vat_number`, `vat_number_source`	ALV-numero, kun rekisteri vahvistaa ALV-rekisteröinnin (`register`); tyhjä, jos yritys ei ole ALV-rekisterissä
`activity_code`	Toimialaluokka, kun rekisteri julkaisee sen
osoitekentät	Rekisteröity osoite

Seuranta tunnistamisen jälkeen

Tunnistaminen ei pääty ensimmäiseen tarkistukseen. POST /monitor tilaa webhook-hälytykset, kun asiakkaan tila muuttuu, yritys puretaan tai rekisteriin ilmestyy muutos: nimi, tila, yhtiömuoto tai rekisteröity osoite. Muutokset ajoitetaan sen päivän mukaan, jona ne ensimmäisen kerran näkyvät rekisteritiedoissa, aikaisintaan 30.9.2026 alkaen. Hälytykset ovat Professional-paketissa. Sama käy GET /company-events/search-kutsulla, jos haluat kysellä itse.

Mitä Suomen osalta ei saa

Ei toimitusjohtajia, hallituksen jäseniä eikä muita rooleja: Suomesta saa vain yritystason tiedot. Edustajien nimet pitää pyytää asiakkaalta ja tarkistaa muuta kautta.
Ei rekisterin vaatimustenmukaisuussignaalia, jollainen on Espanjalle, Britannialle, Irlannille ja Norjalle.
Ei tosiasiallisten edunsaajien tietoja.
Pakotelistaseulonta (GET /sanctions/screen) on beta-vaiheessa ja kuuluu Professional-pakettiin. Se ei korvaa omaa rahanpesulain mukaista riskiarviota.

Mitä tallentaa asiakastietoihin

Tallenna jokaisesta tarkistuksesta koko GET /companies/{id} -vastaus aikaleimalla sekä käyttämäsi hakuehto. Silloin voit myöhemmin osoittaa, mitä rekisteri kertoi sinä päivänä, kun asiakassuhde syntyi tai tiedot päivitettiin. Vertaa vastausta asiakkaan itse ilmoittamiin tietoihin: jos nimi, yhtiömuoto tai osoite poikkeaa rekisteristä, älä korjaa eroa hiljaa, vaan kirjaa se ja pyydä asiakkaalta selvitys, esimerkiksi uusi rekisteriote tai tieto nimenmuutoksesta. Tallenna erikseen ne tiedot, joita rajapinta ei anna, kuten edustajat ja tosiasialliset edunsaajat, sekä niiden lähde.

Lähde: Contains data from the Finnish Patent and Registration Office (PRH), CC BY 4.0.

Sopiva paketti

Starter (9,99 € kuukaudessa, 1 000 krediittiä) riittää perustunnistamiseen. Professional (29,99 €, 10 000 krediittiä) lisää pakotelistaseulonnan (beta) ja webhookit. Scale (99,99 €) lisää tilinpäätöstiedot. Hinnat ovat julkiset, eikä myyntipuhelua tarvita; vuosilaskutuksella saa kaksi kuukautta ilmaiseksi. Katso hinnoittelu.

Aiheeseen liittyvät sivut

Aloita 14 päivän ilmainen kokeilu · API-dokumentaatio

Kokeilu kestää 14 päivää ja sisältää 500 krediittiä. Kortti vaaditaan, kokeilun aikana ei veloiteta mitään; sen jälkeen jatkuu Starter-paketti (9,99 € kuukaudessa), ellet peru.

Frequently asked questions

Riittääkö rekisterihaku asiakkaan tuntemisen velvoitteeseen?: Ei yksin. Rekisteritieto todistaa, että yritys on olemassa ja missä tilassa se on, mutta rahanpesulaki edellyttää myös tosiasiallisten edunsaajien selvittämistä ja riskiperusteista arviota. Rajapinta hoitaa rekisteriosan ja tallentaa todisteen; muut vaiheet kuuluvat omaan prosessiisi.
Löytyykö vastauksesta hallituksen jäsenet tai toimitusjohtaja?: Ei. Suomessa palvelu tarjoaa yritystason tiedot. Roolitiedot saa vain Espanjasta, Ranskasta, Britanniasta ja Norjasta.
Kuinka usein tiedot päivittyvät?: Suomen tiedot päivittyvät joka arkipäivä. Rekisterimuutokset ilmestyvät tapahtumiin ja seurannan hälytyksiin, kun ne ensimmäisen kerran näkyvät rekisteritiedoissa.
Mistä ALV-numero tulee?: Kun rekisteri vahvistaa ALV-rekisteröinnin, numero on muotoa FI + numerot ja vat_number_source on register. Jos yritys ei ole ALV-rekisterissä, kenttä on tyhjä. EU-tason tarkistuksen saa GET /vat/{numero} -kutsulla.
Mitä teen, jos Y-tunnuksella ei löydy yritystä?: Tarkista ensin tunnuksen muoto (0112038-9: seitsemän numeroa, väliviiva ja tarkistenumero). Jos tunnus on oikea mutta hakutulos on tyhjä, tunnus ei ehkä kuulu yritykselle, jonka tiedot rajapinta palvelee. Tarkista tunnus asiakkaan omista asiakirjoista. Älä tee tunnistamista tyhjän tuloksen varassa, vaan pyydä asiakkaalta rekisteriote.
Tarvitaanko kokeiluun kortti?: Kyllä. Kokeilu kestää 14 päivää ja sisältää 500 krediittiä; korttia ei veloiteta kokeilun aikana, ja sen jälkeen jatkuu Starter, ellet peru.