Uusi osoite, uusi nimi, uusi yhtiömuoto tai vastaperustettu yritys on usein hetki, jolloin yritys alkaa ostaa. Rajapinta seuraa CRM-järjestelmäsi yrityksiä, lähettää muutoksen sellaisena kuin PRH:n kaupparekisteri sen näyttää ja listaa juuri rekisteröidyt yritykset. Aina yritystasolla: Suomesta saa vain yritystason tiedot.
Yritys ei osta tasaisesti läpi vuoden. Hankinnat kasautuvat tapahtumien ympärille: yritys perustetaan, muuttaa, vaihtaa nimeä tai yhtiömuotoa, joutuu selvitystilaan tai on taas aktiivinen. Rajapinta antaa nämä muutokset rekisteritapahtumina. Jokaisella tapahtumalla on event_type ja päivämäärä. Nimen, osoitteen ja yhtiömuodon muutoksissa on sekä previous_value että new_value, joten näet, mikä oli ennen ja mikä on nyt.
| Muutos rekisterissä | event_type | Miksi tämä kiinnostaa myyntiä |
|---|---|---|
| Uusi yritys ilmestyy rekisteriin | new_incorporation | Uusi yritys tarvitsee pankin, kirjanpitäjän, vakuutukset, IT:n ja toimitilat |
| Rekisteröity osoite muuttuu | address_change | Uudet tilat: muutto, kalustus, tietoliikenne ja paikalliset toimittajat. Postinumero ja paikkakunta ovat new_value-kentässä |
| Uusi nimi | name_change | Nimenmuutos tarkoittaa, että kyltit, verkkosivut, sopimukset ja järjestelmät on päivitettävä |
| Uusi yhtiömuoto | legal_form_change | Yhtiömuodon vaihto tarkoittaa yleensä uusia sopimuksia sekä uusia pankki- ja vakuutusjärjestelyjä |
| Selvitystila, lakkaaminen, konkurssi tai yrityssaneeraus | liquidation, dissolution, insolvency | Pysäytä kauppa, suojaa saatavasi ja siivoa CRM |
| Taas aktiivinen | reactivation | Yritys oli selvitystilassa, konkurssissa tai yrityssaneerauksessa ja on nyt taas aktiivinen: ota yhteys uudelleen |
| Poistunut rekisteriaineistosta | other | Yritystä ei enää löydy rekisteriaineistosta: poista se myyntiputkesta |
Tapahtuma dissolution tarkoittaa, että yritys on lakannut tai poistettu kaupparekisteristä. Suomesta ei saa toimitusjohtajan, hallituksen tai osakepääoman muutoksia, jotka ovat muissa maissa vahvoja signaaleja. Tapahtuma ajoitetaan sen päivän mukaan, jona muutos ensimmäisen kerran näkyy rekisteritiedoissa, aikaisintaan 30.9.2026. Rekisterin oma päätöspäivä voi olla aikaisempi.
Hae jokainen kohdeyritys Y-tunnuksella kerran, tilaa seuranta ja tallenna CRM-tunnisteesi label-kenttään: se palaa mukana jokaisessa hälytyksessä. Seurannan tilaaminen ei kuluta krediittejä.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
# Kohdeyrityksesi: Y-tunnus ja tunniste CRM:ssä
kohteet = [('0112038-9', 'crm-1001'), ('1463611-4', 'crm-1002')]
for y_tunnus, crm_id in kohteet:
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'FI', 'company_number': y_tunnus})
r.raise_for_status()
osumat = r.json()['data']
if not osumat:
continue
requests.post(f'{BASE}/monitor', headers=H, json={
'company_id': osumat[0]['id'],
'label': crm_id, # palaa mukana jokaisessa hälytyksessä
'events': ['corporate_event', 'status_change', 'dissolution'],
'webhook_url': 'https://example.com/hooks/prometiam',
}).raise_for_status()
Hälytykset on allekirjoitettu. Otsakkeen X-Prometiam-Signature arvo on sha256= ja viestin sisällön HMAC-SHA256-tiiviste, joka lasketaan POST /monitor -kutsun palauttamalla webhook_secret-arvolla. Tarkista allekirjoitus, ennen kuin luot tehtävän asiakasvastaavalle. Webhook kuuluu kaikkiin paketteihin. Hälytykset voi lukea myös kutsulla GET /monitor (50 viimeisintä), joten yöajokin toimii. Seuranta tarkistetaan joka päivä. Kokeilussa seurataan 3 yritystä, Starter-paketissa 25, Professional-paketissa 250 ja Scale-paketissa 2 500.
Ennen ensimmäistä puhelua viimeisimmät muutokset kertovat enemmän kuin yrityskuvaus. GET /company-events/search?country=FI&company_number=0112038-9&date_from=2026-09-30 palauttaa kohdeyrityksen tapahtumat uusimmasta vanhimpaan, 2 krediittiä kutsulta. Tyhjä lista tarkoittaa, ettei muutosta ole vielä nähty.
Ilman Y-tunnusta ja nimeä sama kutsu on maan tapahtumavirta: kaikki Suomen rekisteritapahtumat uusimmasta vanhimpaan, suodatettuna event_type-arvolla. Virta kattaa enintään viimeiset 31 päivää (7 päivää, jos et anna date_from-arvoa, ja vanhempi päivämäärä tuottaa virheen 400). Päivittäinen tai viikoittainen ajo, joka lukee virran ja pitää vain segmenttisi yritykset, löytää ne kohteet, joita et vielä seuraa.
# Kaikki osoitteenmuutokset Suomessa 5.10. alkaen, uusimmat ensin (100 tapahtumaa kutsulta) curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=FI&event_type=address_change&date_from=2026-10-05&limit=100' \ -H 'Authorization: Bearer rk_live_...'
Yksi kutsu maksaa 2 krediittiä ja palauttaa enintään 100 tapahtumaa; sivutus tehdään next_cursor-arvolla. Osoitteenmuutoksessa on sekä vanha että uusi osoite (previous_value ja new_value, postinumeroineen ja postitoimipaikkoineen), joten voit suodattaa postinumeron tai paikkakunnan mukaan jo virrassa ja hakea vain kiinnostavat yritykset kutsulla GET /companies/{id} yhdellä krediitillä. Uudet yritykset (new_incorporation), nimenmuutokset (name_change) ja yhtiömuodon muutokset (legal_form_change) haetaan samalla tavalla.
Perustaminen on ensimmäinen signaali: uusi yritys tarvitsee pankin, kirjanpitäjän, vakuutukset, IT:n ja toimitilat. founded_after listaa tietystä päivästä alkaen perustetut yritykset ilman nimihakua, sivu kerrallaan ja uusimmat ensin. Jokaisesta yrityksestä saat legal_form-kentän (esimerkiksi Oy), toimialan (activity_code, TOL 2025, ja nace_class), kunnan ja maakunnan (municipality, region) sekä osoitteen.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
def uudet_yritykset(alkaen):
"""Kaikki tietystä päivästä alkaen perustetut yritykset, uusimmat ensin (1 krediitti sivulta, enintään 100 yritystä)."""
cursor = None
while True:
p = {'country': 'FI', 'founded_after': alkaen, 'limit': 100, **({'cursor': cursor} if cursor else {})}
r = requests.get(f'{BASE}/companies/search', headers=H, params=p)
r.raise_for_status()
body = r.json()
yield from body['data']
cursor = (body.get('pagination') or {}).get('next_cursor')
if not cursor:
break
# Uudet osakeyhtiöt rakennusalalla (TOL 43) Uudellamaalla
for y in uudet_yritykset('2026-10-05'):
if y['legal_form'] == 'Oy' and (y.get('nace_class') or '')[:2] == '43' and y.get('region') == 'UUSIMAA':
print(y['founding_date'], y['company_number'], y['company_name'], y['municipality'])
Kolme huomiota. Suodatus tapahtuu founding_date-kentän mukaan, ja uusimmat päivät ovat aina vajaita, koska yritys näkyy rekisteriaineistossa vasta perustamisen jälkeen: hae muutaman päivän marginaalilla ja ohita Y-tunnukset, jotka sinulla jo on. vat_number on täytetty vain, kun rekisteri näyttää yrityksen ALV-rekisterissä, joten uudella yrityksellä se on usein tyhjä. Ja kutsussa ei ole toimiala- eikä maakuntasuodatinta: rajaus tehdään vastauksen kenttien perusteella. Jos haluat tietää, milloin yritys ilmestyi rekisteriin ensimmäisen kerran, new_incorporation-tapahtuma antaa sen päivän.
address_change-tapahtuman osoite voi olla myös postilokero, joten osoitteenmuutos ei aina tarkoita muuttoa.municipality) annetaan, kun kunnan koodi on kuntaluettelossa; muuten kenttä voi olla tyhjä.GET /insolvency/search?country=FI, linkitetty Y-tunnukseen), josta seuranta ei hälytä. Konkurssi, selvitystila ja lakkaaminen näkyvät silti tilan muutoksena tapahtumissa.Seuranta ei kuluta krediittejä: paketti määrää, montako yritystä seuraat. Yrityshaku maksaa 1 krediitin ja tapahtumahaku 2; virheet eivät maksa mitään. Starter maksaa 9,99 € kuukaudessa ja sisältää 1 000 krediittiä. Professional maksaa 29,99 € ja sisältää 10 000 krediittiä, 250 seurattavaa yritystä. Scale maksaa 99,99 € ja sisältää 50 000 krediittiä ja 2 500 seurattavaa yritystä. Webhookit kuuluvat kaikkiin paketteihin. Kokeilu kestää 14 päivää ja sisältää 500 krediittiä: kortti vaaditaan, mutta kokeilun aikana ei veloiteta mitään. Sen jälkeen tilaus jatkuu Starter-pakettina (9,99 € kuukaudessa), ellet peruuta sitä.
Lähde: Contains data from the Finnish Patent and Registration Office (PRH), CC BY 4.0.
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.