Eesti ettevõtete andmed API kaudu

Prometiam on üks REST API ametlike äriregistrite andmetega 27 riigi kohta. Eesti jaoks saad e-äriregistri (RIK) kirjed registrikoodi, nime või KMKR-numbri järgi, ühtses JSON-kujul ja sama võtmega nagu Soome, Läti või Poola puhul.

Mis on Prometiam

Prometiam on tasuline REST API, mis annab ametlike äriregistrite andmed ühes ühtses kujus. Kaetud on 27 riiki: Hispaania, Prantsusmaa, Ühendkuningriik, Iirimaa, Poola, Norra, Soome, Rootsi, Horvaatia, Belgia, Taani, Eesti, Slovakkia, Šveits, Läti, Küpros, Rumeenia, Leedu, Kanada, Austraalia, Jaapan, Iisrael, Singapur, Kolumbia, Taiwan, Brasiilia ja Ameerika Ühendriigid. Ettevõtte objekt on igal pool sama, nii et ühe riigi jaoks kirjutatud kood töötab ka teiste riikidega.

Mida saad Eesti kohta

Andmed pärinevad Eesti e-äriregistrist, mida peab Registrite ja Infosüsteemide Keskus (RIK). Registreeritud üksuse tunneb ära kaheksakohalise registrikoodi järgi, näiteks 10060701 (Swedbank AS). Kui sa pole kindel, mida kood tähendab, loe juhendit „Mis on äriregister?“ või kontrolli koodi tasuta registrikoodi otsingus.

  • ärinimi, registrikood, õiguslik vorm (legal_form) ja registri enda sõnastus (local_legal_form)
  • staatus ühtses väärtuses (status) ning registri enda sõnadega (local_status), sealhulgas likvideerimine ja pankrot
  • registreeritud aadress ja asutamise kuupäev
  • tegevusalakood EMTAK 2008 või EMTAK 2025, olenevalt sellest, kumb on ettevõttel registris
  • käibemaksukohustuslase number (KMKR) väljadel vat_number ja vat_number_source; KMKR-numbri järgi saab otsida parameetriga vat=
  • registrimuudatuste sündmused (nimi, staatus, õiguslik vorm, aadress) ja seire veebihaagiga

Eesti andmed uuenevad igal tööpäeval. Registrimuudatuste sündmused saavad kuupäeva siis, kui muudatus registriandmetes esimest korda nähtavaks saab; sündmusi ei ole enne 30. septembrit 2026.

Näidispäring

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

Vastuses on id, mida kasutad edasi päringus GET /companies/{id}. Registrimuudatusi küsid päringuga GET /company-events/search?country=EE&company_number=10060701 ja seire käivitad päringuga POST /monitor kehaga {"company_id": ..., "country": "EE"}. KMKR-numbri järgi otsimisel võib üks grupinumber kuuluda mitmele grupi liikmele, seega vat= päring võib anda rohkem kui ühe ettevõtte.

Mida Eesti kohta ei saa

  • juhatuse liikmeid ega muid ametisoleku andmeid ei väljastata: Eesti puhul on tegu ainult ettevõtte kirjetega (juhatuse liikmed on API-s Hispaania, Prantsusmaa, Ühendkuningriigi ja Norra kohta)
  • registri vastavussignaali ei ole
  • maksejõuetuse teateid Eesti kohta ei ole, kuid likvideerimine ja pankrot kajastuvad ettevõtte staatuses
  • füüsilisest isikust ettevõtjaid (FIE) ei väljastata kunagi
  • finantsaruandeid Eesti ettevõtete kohta ei ole

Hind

Hinnad on avalikud ja müügikõnet ei ole. Starter maksab 9,99 € kuus (1 000 krediiti kuus), Professional 29,99 € kuus (10 000 krediiti, sanktsioonide kontroll beetaversioonina ja veebihaagid), Scale 99,99 € kuus (50 000 krediiti ja finantsaruanded) ning Enterprise kokkuleppel. Aastane arveldus annab kaks kuud tasuta. Prooviperiood kestab 14 päeva ja sisaldab 500 krediiti; kaart on nõutav, prooviperioodi jooksul tasu ei võeta, seejärel jätkub Starter, kui sa ei tühista. Täpsemad tingimused: hinnad.

Kasutusjuhud

Contains data from the Estonian e-Business Register (RIK), CC BY 4.0

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

Kust Eesti andmed pärinevad?
Eesti e-äriregistrist, mida peab Registrite ja Infosüsteemide Keskus (RIK). Prometiam toob andmed ühtsesse kujusse, kuid ei ole ametlik registriväljavõte.
Kuidas ettevõtet otsida?
Registrikoodi (company_number), nime (name) või KMKR-numbri (vat) järgi päringuga GET /companies/search?country=EE.
Kas API annab ka juhatuse liikmed?
Ei. Eesti puhul on ainult ettevõtte kirjed. Juhatuse liikmeid annab API Hispaania, Prantsusmaa, Ühendkuningriigi ja Norra kohta.
Kas prooviperioodiks on kaart vaja?
Jah. Prooviperiood kestab 14 päeva ja sisaldab 500 krediiti. Kaart on nõutav, prooviperioodi jooksul tasu ei võeta ning seejärel jätkub Starter-pakett (9,99 € kuus), kui sa ei tühista.
Kas seda saab proovida ilma kaardita?
Jah: dokumentatsiooni demovõtmega, MCP demorežiimis ja registrikoodi otsingus.