Äriregistri API: Eesti ettevõtete andmed REST-ina

Eesti e-äriregistri andmed saab kätte RIK avaandmetest tasuta. Siit näed, millal piisab neist ja millal tasub kasutada Prometiami REST API-t registrikoodi, nime või KMKR-i järgi.

Mida annab ametlik allikas

Eesti äriregistrit peab Registrite ja Infosüsteemide Keskus (RIK). RIK avaldab registri andmeid avaandmetena ja äriregistri veebis saab ettevõtet tasuta päringuga vaadata; päringuteenuste ja avaandmete tingimused leiad RIK avaandmete lehelt. Ühe ettevõtte käsitsi kontrolliks või ühekordseks andmeimpordiks on see õige tee ning meie tasuta registrikoodi otsing aitab koodi kiiresti üle vaadata.

Prometiam ei ole ametlik allikas ega asenda äriregistrit. See lisab kihi neile, kes kasutavad registriandmeid oma tarkvaras.

Mida Prometiam lisab

  • üks JSON-kuju: sama ettevõtte objekt Eesti, Soome, Läti ja 26 teise riigi jaoks, nii et integratsiooni ei pea riigiti uuesti kirjutama
  • otsing registrikoodi (company_number), nime (name) või KMKR-i (vat=) järgi ühes päringus
  • KMKR väljadel vat_number ja vat_number_source (register: register avaldab numbri ise)
  • registrimuudatuste sündmused (nimi, staatus, õiguslik vorm, aadress) alates 30. septembrist 2026
  • seire veebihaagiga (POST /monitor) ja partiipäring (POST /companies/lookup)
  • finantsnäitajad (käive, kasum, varad, omakapital, töötajate arv) Scale-paketis

Näidispäring

Otsi ettevõte registrikoodi järgi ja küsi seejärel täisprofiil otsingu tagastatud id abil. Vastused on välja data all.

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=EE&company_number=10060701' \
  -H 'Authorization: Bearer rk_live_...'

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/{id}' \
  -H 'Authorization: Bearer rk_live_...'

# registrimuudatused
curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=EE&company_number=10060701' \
  -H 'Authorization: Bearer rk_live_...'

Registrikood on kaheksakohaline ja selle kontrollnumbrit kontrollitakse: kirjaviga annab vea 400 validation_error, mitte vaikselt tühja vastuse.

KMKR ja grupinumbrid

Eesti puhul avaldab register KMKR-numbri ise. Käibemaksugrupi number võib kuuluda mitmele grupi liikmele, seega vat= päring võib anda rohkem kui ühe ettevõtte. Teise EL-i riigi numbrit kontrollid päringuga GET /vat/{number} (VIES).

Mida Eesti kohta ei saa

  • juhatuse liikmeid, osanikke ega tegelikke kasusaajaid: ainult ettevõtte kirjed
  • registri vastavussignaali ega maksejõuetuse teateid; likvideerimine ja pankrot on ettevõtte staatuses ja registrimuudatuste sündmustes
  • füüsilisest isikust ettevõtjaid (FIE) ei väljastata kunagi
  • täielikku bilanssi ja kasumiaruannet: Eesti kohta on ainult põhinäitajad, Scale-pakett

Seire ja registrimuudatused

Avaandmete puhul tuleb muudatuste leidmiseks andmeid ise võrrelda. Prometiamiga paned ettevõtte seire alla päringuga POST /monitor kehaga {"company_id": ..., "country": "EE"} ja saad veebihaagi, kui staatus muutub, ettevõte kustutatakse või registris muutub nimi, õiguslik vorm või aadress. Muudatus saab kuupäeva siis, kui see registriandmetes esimest korda nähtavaks saab; sündmusi ei ole enne 30. septembrit 2026. Starter jälgib 25 ettevõtet, Professional 250 (koos veebihaagidega) ja Scale 2 500.

Millal piisab avaandmetest

Kui vaatad aeg-ajalt üht ettevõtet või laed registri ühekordselt oma andmebaasi, ei vaja sa API-t. API tasub ennast ära siis, kui kontrollid kliente või tarnijaid automaatselt (näiteks KYB kontroll või tarnija taustakontroll), kui töötad mitme riigi ettevõtetega samas töövoos või kui tahad muudatustest teada saada ilma andmeid ise võrdlemata.

Hind krediitides

Ettevõtte otsing ja profiil maksavad 1 krediidi, registrimuudatuste päring 2 krediiti; vead on tasuta. Starter maksab 9,99 € kuus (1 000 krediiti), Professional 29,99 € (10 000 krediiti) ja Scale 99,99 € (50 000 krediiti). Prooviperiood kestab 14 päeva ja sisaldab 500 krediiti; kaart on nõutav, prooviperioodi jooksul tasu ei võeta. Vaata hindu.

Contains data from the Estonian e-Business Register (RIK), CC BY 4.0. Prometiam ei ole ametlik registriväljavõte.

Seotud lehed

Alusta 14-päevast prooviperioodi · API dokumentatsioon

Prooviperiood kestab 14 päeva ja sisaldab 500 krediiti. Kaart on nõutav, prooviperioodi jooksul tasu ei võeta; seejärel jätkub Starter-pakett (9,99 € kuus), kui sa ei tühista.

Frequently asked questions

Kas äriregistril on API?
RIK avaldab äriregistri andmeid avaandmetena; tingimused leiad RIK avaandmete lehelt. Prometiam pakub lisaks REST API, mille vastus on Eesti ja 28 teise riigi puhul sama kujuga.
Kas Eesti ettevõtete andmed on tasuta?
Ametlikud allikad on tasuta kasutatavad. Prometiami API on tasuline (alates 9,99 € kuus) ja lisab ühtse JSON-kuju, otsingu nime ja KMKR-i järgi, registrimuudatuste sündmused ja seire.
Kuidas otsida ettevõtet KMKR-i järgi?
Päringuga GET /companies/search?country=EE&vat=.... Grupinumber võib kuuluda mitmele ettevõttele, seega tulemusi võib olla rohkem kui üks.
Kas API annab juhatuse liikmed või kasusaajad?
Ei. Eesti kohta annab API ainult ettevõtte kirjed.