Majandusaasta aruanded API-ga: ettevõtte majandusnäitajad

Leia ettevõte registrikoodi järgi ja loe tema majandusaasta aruannete põhinäitajad (käive, varad, töötajate arv) ühe JSON-vastusena. Eesti kohta ainult põhinäitajad, mitte täielik bilanss.

Kaks päringut: ettevõte ja tema majandusaasta aruanne

Äriregistrisse esitatud majandusaasta aruanded on avalikud, kuid avaandmetes tulevad need CSV-failidena ja ühe ettevõtte näitajate leidmiseks tuleb faile ise ühendada. API-ga on selleks kaks päringut. Esimene leiab ettevõtte registrikoodi järgi ja töötab avaliku demovõtmega rk_live_demo_publichn. Teine küsib aruande: finantsaruannete lõpp-punkt vastab demovõtmega veaga 403 upgrade_required, seega kasuta oma võtit (rk_live_...).

# 1. ettevõte registrikoodi järgi (Eesti Energia AS)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=EE&company_number=10421629&limit=1' \
  -H 'Authorization: Bearer rk_live_demo_publichn'

# 2. tema majandusaasta aruanded (kasuta eelmise vastuse data[0].id)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/12000010421629/financials?country=EE&years=2' \
  -H 'Authorization: Bearer rk_live_...'

Vastus 10. novembril 2026, lühendatud märgiga .... Näitajad on sellised, nagu need registrisse esitati; tühi väli on null koos põhjusega quality.missing, mitte null euro.

{
  "data": {
    "company": {
      "id": 12000010421629,
      "country": "EE",
      "company_number": "10421629",
      "company_name": "EESTI ENERGIA AS",
      "status": "active"
    },
    "statements": [
      {
        "fiscal_year": 2025,
        "period_start": "2025-01-01",
        "period_end": "2025-12-31",
        "statement_type": "individual",
        "framework": "ee_rik_ind",
        "currency": "EUR",
        "filing_date": "2026-04-29",
        "figures": {
          "revenue": 342713275,
          "total_assets": 2541460168,
          "employees": 793,
          "net_profit": null,
          "equity": null,
          ...
        },
        "ratios": {
          "asset_turnover": 0.1348,
          "revenue_per_employee": 432173.11,
          ...
        },
        "quality": {
          "notes": ["figures_from_pdf_report", "indicator_only"],
          "missing": { "net_profit": "not_stated", "equity": "not_stated", ... }
        }
      }
    ]
  },
  "meta": { "country": "EE", "availability": "available", ... }
}

Selle ettevõtte aruandest on loetud kolm põhinäitajat: käive, varad ja töötajate arv. Märge figures_from_pdf_report ütleb, et näitajad on loetud PDF-aruandest, ja indicator_only, et tegu on põhinäitajatega, mitte täieliku aruandega. Suhtarvud (ratios) arvutatakse ainult nendest näitajatest, mis aruandes on, ja need on informatiivsed.

Mida annab ametlik allikas

RIK avaldab oma avaandmete lehel (avaandmed.ariregister.rik.ee) majandusaasta aruannete andmestikud: aruannete üldinfo, müügitulu jaotus EMTAK-i järgi, müügitulu regioonide kaupa ja põhinäitajad iga aruandeaasta kohta (2019 kuni 2025). Need on neli omavahel report_id kaudu seotud CSV-tüüpi, mida uuendatakse kord kuus. Põhinäitajad on võetud konsolideerimata aruandest ka siis, kui esitati konsolideeritud aruanne, ja neid on umbes kuusteist: raha, käibe- ja põhivara, varad, lühi- ja pikaajalised kohustused, omakapital, käive, tööjõukulu, kulum, ärikasum, perioodi kasum, kasum enne tulumaksu, jaotamata kasum ja keskmine töötajate arv. Terve aruande saamiseks tuleb kasutada äriregistri teenuseid; RIK-i päringuteenus aruande kohta nõuab äriregistri kasutajanime ja parooli.

KüsimusRIK avaandmedPrometiam API
FormaatCSV-failid, mis tuleb report_id kaudu ühendadaühe ettevõtte JSON, samad väljanimed igas riigis
Ettevõtte leidmineregistrikood failistcompany_number, nimi või KMKR ühe otsinguga
Näitajadumbes kuusteist põhinäitajatpõhinäitajad standardväljadel (figures, ratios, quality)
Aastadaruandeaastad 2019–2025 failidenamajandusaastad alates 2019
Teised riigidiga riigi register eraldisama lõpp-punkt ja väljad kõigis riikides, kus finantsaruanded on olemas
Hindavaandmed on tasutaScale-pakett 99,99 € kuus, 25 krediiti ühe ettevõtte kohta

Mida Eesti kohta ei saa

  • ainult põhinäitajad (umbes kuusteist kokkuvõtte näitajat: varad, omakapital, käive, kasumid, tööjõukulu ja töötajate arv), mitte kunagi täielik bilanss ega kasumiaruanne; kohustused kokku on varad miinus omakapital
  • majandusaastad alates 2019; aasta, mille aruandel avaandmetes näitajaid ei ole, puudub vastusest
  • mõned näitajad on loetud PDF-aruandest (figures_from_pdf_report), seega võib osa välju olla null
  • ainult ettevõtte kirjed: juhatuse liikmeid ega kasusaajaid API Eesti kohta ei anna; füüsilisest isikust ettevõtjaid (FIE) ei väljastata kunagi
  • näitajad on esitatud nii, nagu need aruandes on; suhtarvud ja võrdlused on informatiivsed, mitte krediidiskoor ega hinnang

Hind krediitides

Ühe ettevõtte majandusaasta aruanded maksavad 25 krediiti. Vastus, milles aruannet ei ole, on tasuta, nagu kõik vead. Ettevõtte otsing maksab 1 krediidi. Finantsaruanded kuuluvad Scale-paketti (99,99 € kuus, 50 000 krediiti); Starteri, Professionali ja prooviperioodi võtmetega saab sellele lõpp-punktile teha 10 päringut kuus. Prooviperiood kestab 14 päeva ja sisaldab 500 krediiti; kaart on nõutav, prooviperioodi jooksul tasu ei võeta. Vaata hindu.

Millal piisab ametlikest failidest

Kui vajad ühekordset statistikat kogu registri kohta või vaatad aeg-ajalt üht ettevõtet, piisab RIK avaandmetest ja äriregistri veebist, mis on tasuta. API tasub ennast ära siis, kui kontrollid tarnijaid või kliente automaatselt (tarnija taustakontroll, KYB kontroll), kui sul on vaja sama väljakomplekti mitme riigi ettevõtete kohta või kui ei taha CSV-faile ise ühendada.

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

Seotud lehed

Registreeru · 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.

Korduma kippuvad küsimused

Kuidas saada ettevõtte majandusaasta aruanne API kaudu?
Leia ettevõte päringuga GET /companies/search?country=EE&company_number=... ja küsi seejärel GET /companies/{id}/financials?country=EE. Vastus on JSON, kus iga majandusaasta kohta on põhinäitajad ja märge selle kohta, mis puudub.
Kas API annab täieliku bilansi ja kasumiaruande?
Ei. Eesti kohta annab API ainult põhinäitajad (umbes kuusteist kokkuvõtte näitajat), mitte kunagi täielikku aruannet. Täieliku aruande leiad äriregistrist.
Mis aastatest aruanded on?
Majandusaastad alates 2019. Aasta, mille aruandel avaandmetes näitajaid ei ole, puudub.
Mis maksab ühe ettevõtte aruanne?
25 krediiti ja kuulub Scale-paketti (99,99 € kuus). Muude pakettide võtmetega saab teha 10 päringut kuus. Vastus ilma aruandeta on tasuta.
Kas suhtarvud on krediidiskoor?
Ei. Suhtarvud arvutatakse aruandes olevatest näitajatest ja need on informatiivsed, mitte hinnang ega krediidiskoor.