PRH julkaisee yritystiedot avoimena datana. Tässä oppaassa kerrotaan, mitä saat sieltä ilmaiseksi ja mitä Prometiam lisää, kun tarvitset useita maita, seurantaa, konkurssi-ilmoituksia tai tilinpäätöksiä.
Patentti- ja rekisterihallitus (PRH) ylläpitää kaupparekisteriä ja julkaisee yritystiedot avoimena datana lisenssillä CC BY 4.0. Datan haku YTJ:n kautta ja PRH:n avoimen datan rajapinnat ovat ilmaisia; ehdot, päivitystiheys ja tekniset tiedot löytyvät PRH:n omilta sivuilta, ja ne kannattaa lukea ensin. PRH tarjoaa myös tilinpäätöksiä digitaalisesti toimittaneista yrityksistä, mutta tällaisia on vain noin yksi kahdestakymmenestä. Jos tarvitset vain suomalaisia yrityksiä ja ehdit rakentaa integraation PRH:n rajapintaan, sen käyttö suoraan on täysin järkevää. Yksittäisen haun voit tehdä ilman koodia Y-tunnushaulla, ja YTJ ja kaupparekisteri selittää rekisterit.
Prometiam ei myy suomalaista dataa halvemmalla. Maksat siitä, mikä on datan ympärillä: yksi vastausmuoto kaikille maille, seuranta, konkurssi-ilmoitukset ja tilinpäätökset samalla avaimella.
company_name, company_number, status, legal_form, osoite ja activity_code. Vaihdat vain country-parametrin.status saa kiinteitä arvoja, ja local_status näyttää rekisterin omat sanat.vat_number on mukana, kun rekisteri vahvistaa ALV-rekisteröinnin, muuten null. GET /vat/{number} tarkistaa tunnuksen VIES-palvelusta.Hae ensin Y-tunnuksella ja pyydä sitten koko profiili haun palauttamalla id-arvolla. Vastaus on data-kentässä. Yhdysmerkki on valinnainen, ja virheellinen tarkiste palauttaa 400-validointivirheen.
# 1. Haku Y-tunnuksella curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=FI&company_number=0112038-9' \ -H 'Authorization: Bearer rk_live_...' # 2. Koko profiili curl 'https://api.prometiam.com/functions/v1/risk-api/companies/<id haun vastauksesta>' \ -H 'Authorization: Bearer rk_live_...'
import os, requests
API = 'https://api.prometiam.com/functions/v1/risk-api'
HEAD = {'Authorization': f'Bearer {os.environ["PROMETIAM_API_KEY"]}'}
haku = requests.get(f'{API}/companies/search',
params={'country': 'FI', 'company_number': '0112038-9'}, headers=HEAD).json()
yritys = requests.get(f"{API}/companies/{haku['data'][0]['id']}", headers=HEAD).json()['data']
print(yritys['company_name'], yritys['status'], yritys['local_status'])
| Kenttä | Merkitys |
|---|---|
company_name, company_number | Nimi ja Y-tunnus |
status ja local_status | Vakioitu tila ja rekisterin oma tila |
legal_form ja local_legal_form | Yhtiömuoto, esimerkiksi OY tai OYJ |
activity_code | Toimialakoodi |
municipality | Kunnan nimi, kun kunnan koodi on kuntaluettelossa |
vat_number | ALV-numero, kun rekisteri vahvistaa ALV-rekisteröinnin |
Seuranta. POST /monitor ja {"company_id": ..., "country": "FI"} lähettää webhook-ilmoituksen tilamuutoksesta, purkautumisesta, pakoteosumasta ja rekisterimuutoksista (nimi, tila, yhtiömuoto ja rekisteröity osoite). Tapahtumat ajoitetaan sen mukaan, milloin muutos ensimmäisen kerran näkyy rekisteritiedoissa, aikaisintaan 30.9.2026. Starter seuraa 25 yritystä, Professional 250 webhookeilla ja Scale 2 500.
Konkurssi. Suomen konkurssi- ja maksukyvyttömyysilmoitukset (vain yritykset) on liitetty Y-tunnukseen: GET /companies/{id}?include=insolvency tai GET /insolvency/search?country=FI. Seuranta ei hälytä konkurssi-ilmoituksista, mutta konkurssi näkyy yrityksen tilassa. Lue lisää konkurssi-ilmoituksista.
Tilinpäätökset. GET /companies/{id}/financials palauttaa PRH:lle digitaalisesti toimitetut tilinpäätökset (XBRL, heinäkuusta 2023 rekisteröidyt, noin yksi kahdestakymmenestä) sekä pörssikonsernien ESEF-raportit, kirjanpitovaluutassa ja euroina EKP:n vuosikeskiarvolla. Tulos ennen veroja on ennen tilinpäätössiirtoja, eikä henkilöstömäärää ole. Lisäksi tax_records antaa jokaisesta suomalaisesta yrityksestä Verohallinnon julkiset yhteisöverotiedot verovuodesta 2020 (verotettava tulo ja määrätyt verot; 0 tarkoittaa nollaa, ei tuntematonta). Ominaisuus kuuluu Scale-pakettiin; muissa paketeissa ja kokeilussa on 10 kutsua kuukaudessa, ja yksi yritys maksaa 25 krediittiä.
Contains data from the Finnish Patent and Registration Office (PRH), CC BY 4.0.
Yritysprofiilin haku maksaa 1 krediitin. Starter (9,99 € kuukaudessa, 1 000 krediittiä) riittää satoihin tarkistuksiin ja 25 yrityksen seurantaan. Professional (29,99 €, 10 000 krediittiä) sisältää webhookit ja 250 seurattua yritystä. Scale (99,99 €, 50 000 krediittiä) sisältää tilinpäätökset ja 2 500 seurattua yritystä. Hinnat ovat julkisia. Kokeilu kestää 14 päivää ja sisältää 500 krediittiä; kortti vaaditaan, mutta kokeilun aikana ei veloiteta mitään.
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.