Kaksi kutsua: etsi yritys Y-tunnuksella ja hae sen tilinpäätöstiedot JSON-muodossa. Mukana PRH:n avoimen datan vertailu, Verohallinnon julkiset verotiedot ja palvelun rajat.
Suomalaisen yrityksen tilinpäätöstiedot saat kahdella kutsulla: ensin haet yrityksen Y-tunnuksella ja sitten pyydät tilinpäätökset haun palauttamalla id-arvolla. Vastaus on JSON, jossa tuloslaskelman ja taseen luvut ovat samoilla kentillä kuin muissakin maissa, mukana tunnusluvut ja euromääräiset vertailuluvut. Jos haet pelkkiä yritysten verotiedot, ne tulevat samassa vastauksessa tax_records-kentässä jokaisesta suomalaisesta yrityksestä, myös niistä, joilla ei ole digitaalista tilinpäätöstä.
Yrityksen haku onnistuu julkisella demoavaimella rk_live_demo_publichn. Tilinpäätökset eivät: demoavain vastaa 403-virheellä (upgrade_required), koska ominaisuus kuuluu Scale-pakettiin. Siksi toinen kutsu on kirjoitettu muotoon rk_live_.... Kutsut on ajettu 10.11.2026.
# 1. Etsi yritys Y-tunnuksella (demoavain riittää, 1 krediitti) curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=FI&company_number=0112038-9' \ -H 'Authorization: Bearer rk_live_demo_publichn' # 2. Hae tilinpäätökset haun palauttamalla id:llä (Scale-paketti, 25 krediittiä) curl 'https://api.prometiam.com/functions/v1/risk-api/companies/7000001120389/financials?country=FI&years=2' \ -H 'Authorization: Bearer rk_live_...'
Haku palauttaa yrityksen perustiedot ja id-arvon:
{
"data": [
{
"id": 7000001120389,
"country": "FI",
"company_number": "0112038-9",
"company_name": "NOKIA OYJ",
"vat_number": "FI01120389",
"lei": "549300A0JPRWG1KI7U06",
"legal_form": "Oyj",
"status": "active",
...
}
]
}
Tilinpäätöskutsu palauttaa tilikaudet uusimmasta alkaen. Alla on lyhennetty vastaus (... kohdissa, joissa kenttiä on enemmän):
{
"data": {
"company": { "id": 7000001120389, "country": "FI", "company_number": "0112038-9",
"company_name": "NOKIA OYJ", "status": "active" },
"statements": [
{
"fiscal_year": 2025,
"period_start": "2025-01-01",
"period_end": "2025-12-31",
"statement_type": "consolidated",
"framework": "ifrs",
"currency": "EUR",
"filing_date": "2026-03-10",
"figures": {
"revenue": 19889000000,
"gross_profit": 8659000000,
"operating_profit": 885000000,
"profit_before_tax": 915000000,
"net_profit": 660000000,
"total_assets": 37597000000,
"equity": 21058000000,
"cash": 5462000000,
...
},
"ratios": { "gross_margin": 0.4354, "operating_margin": 0.0445, "equity_ratio": 0.5601, ... },
"quality": { "missing": { "employees": "not_stated", "current_assets": "not_stated", ... } },
...
},
...
],
"tax_records": [
{ "tax_year": 2024, "taxable_income": 0, "tax_assessed": 0, "tax_refund": 0, "residual_tax": 0,
"currency": "EUR", "municipality": "091 Helsinki", "reassessed": false, "published": "2025-11-11" },
...
]
},
"meta": { "country": "FI", "availability": "available", "years": 2,
"tax_note": "Finnish Tax Administration public corporate income tax data (Verohallinto, CC BY 4.0), ...",
... }
}
Kaksi asiaa vastauksessa kannattaa huomata. Ensinnäkin Nokia on pörssiyhtiö, joten tilinpäätös on konsernin ESEF-vuosikertomus (statement_type on consolidated, framework on ifrs), ei PRH:n digitaalinen tilinpäätösaineisto: PRH:n oma rajapinta ei palauttanut Nokialle yhtään tilikautta (totalResults on 0, ks. alla). Toiseksi quality.missing kertoo, mitä tilinpäätös ei kerro: kentät, joita ei ole ilmoitettu, ovat null, eikä niitä arvata. Henkilöstömäärää ei ole PRH:n digitaalisissa tilinpäätöksissä, eikä sitä ole tässäkään vastauksessa.
Patentti- ja rekisterihallituksen avoimen datan palvelussa (avoindata.prh.fi) on oma rajapinta digitaaliselle tilinpäätöstiedolle. PRH kuvaa sen niin, että sillä haetaan digitaalisten tilinpäätösten tuloslaskelma- ja tasetietoja ja että tiedot saa vain iXBRL-muodossa ilmoitetuista tilinpäätöksistä; muut tilinpäätökset voi ostaa PRH:n Virre-tietopalvelusta. Rajapinnan kuvauksessa lisenssi on CC BY 4.0, ja PRH pyytää mainitsemaan alkuperäisen lähteen. Rajapinnalla on neljä hakua:
/financials?businessId=...: tilikaudet, joista Y-tunnukselle on digitaalista tilinpäätöstietoa./financial?businessId=...&financialDate=...: yhden tilikauden tilinpäätös./all_financials?financialDate=...: kaikki yritykset, joilla on tilinpäätös tietylle tilikauden päättymispäivälle./all_financial_statements: yritykset, jotka ovat ilmoittaneet tilinpäätöksen annetulla rekisteröintipäivien välillä.Hakutulokset palautetaan enintään sadan rivin sivuina (page-parametri). Näin kutsut toimivat 10.11.2026, esimerkkinä yritys, jolla tilinpäätöksiä on (Y-tunnus 0100379-9):
# Mille tilikausille yrityksellä on digitaalista tilinpäätöstietoa? curl 'https://avoindata.prh.fi/opendata-xbrl-api/v3/financials?businessId=0100379-9' # Yhden tilikauden tilinpäätös (palauttaa XBRL-instanssin, XML) curl 'https://avoindata.prh.fi/opendata-xbrl-api/v3/financial?businessId=0100379-9&financialDate=2024-12-31'
{"totalResults":6,"financials":[
{"businessId":"0100379-9","financialDate":"2020-12-31"},
{"businessId":"0100379-9","financialDate":"2021-12-31"},
...
{"businessId":"0100379-9","financialDate":"2025-12-31"}]}
Toinen kutsu palauttaa XBRL-instanssin eli XML-tiedoston, jossa luvut on merkitty suomalaisen tilinpäätöstaksonomian käsitteillä. Siitä saat tarkat tagatut luvut, mutta tulkitseminen, konsernien ja yksittäisten yhtiöiden erottelu ja eri tilikausien vertailu jäävät sinun tehtäväksesi. Nokialle sama haku antaa tyhjän vastauksen, koska sen tilinpäätökset eivät ole PRH:n digitaalisessa aineistossa:
curl 'https://avoindata.prh.fi/opendata-xbrl-api/v3/financials?businessId=0112038-9'
{"totalResults":0,"financials":[]}
| PRH:n avoin data | Prometiam | |
|---|---|---|
| Kattavuus | Vain PRH:lle digitaalisesti (iXBRL) toimitetut tilinpäätökset, noin yksi kahdestakymmenestä yrityksestä | Samat PRH:n digitaaliset tilinpäätökset sekä pörssikonsernien ESEF-vuosikertomukset; lisäksi tax_records jokaisesta suomalaisesta yrityksestä |
| Muoto | XBRL-instanssi (XML), Suomen taksonomia | JSON: figures, figures_eur, ratios, growth, flags, quality |
| Tilikaudet | Lista tilikausista yritystä kohden, yksi tilikausi per kutsu | Useita tilikausia yhdessä kutsussa (years-parametri) |
| Muut maat | Vain Suomi | Sama vastausmuoto GB, FR, DK, SE, NO ja muissa maissa, joissa tilinpäätökset ovat tarjolla |
| Seuranta | Ei | POST /monitor seuraa rekisterimuutoksia ja yrityksen tilaa; ilmoitusta uudesta tilinpäätöksestä ei ole |
| Hinta | Ilmainen | Scale-paketti 99,99 € kuukaudessa; 25 krediittiä yhden yrityksen tilinpäätöksistä |
Verohallinto julkaisee yhteisöjen tuloveroa koskevat julkiset tiedot verovuosittain, ja Prometiam liittää ne jokaiseen suomalaiseen yritykseen tax_records-kenttään. Tiedot alkavat verovuodesta 2020 ja julkaistaan joka marraskuussa edelliseltä vuodelta. Lähde on Verohallinnon avoin aineisto (CC BY 4.0), ja luvut ovat euroina.
| Kenttä | Merkitys |
|---|---|
tax_year | Verovuosi |
taxable_income | Verotettava tulo |
tax_assessed, tax_refund, residual_tax | Määrätty vero, palautettu vero ja jäännösvero |
municipality | Verohallinnon ilmoittama kotikunta, esimerkiksi 091 Helsinki |
reassessed | true, kun luvut ovat myöhemmästä jälkiverotuksesta |
published | Päivä, jona tieto julkaistiin |
Nolla (0) tarkoittaa, ettei verotettavaa tuloa tai veroa ole, esimerkiksi tappion vuoksi. Se ei tarkoita tuntematonta. Nokian rivit yllä ovat nollia kahdelta viimeiseltä verovuodelta. Verotiedot eivät ole tilinpäätöstä: ne kertovat verotuksesta, eivät liikevaihdosta tai taseesta, eikä niistä voi päätellä yrityksen tulosta.
PRH:n rajapinta riittää, kun tarvitset vain suomalaisia yrityksiä, kohdeyrityksesi ovat digitaalisesti tilinpäätöksensä ilmoittaneiden joukossa ja tiimilläsi on valmius jäsentää XBRL ja Suomen taksonomia itse. Se on ilmainen, eikä sinun tarvitse maksaa välikädelle, jos haluat vain raakatiedot tai yksittäisen tagatun luvun. Prometiam on järkevämpi, kun vertailet yrityksiä useassa maassa samalla rakenteella, tarvitset tunnusluvut ja quality-merkinnät valmiina, haluat yhdistää tilinpäätökset yritysprofiiliin, seurantaan ja konkurssi-ilmoituksiin samalla avaimella tai tarvitset tax_records-tiedot ilman erillistä integraatiota.
statements-lista, ja meta.availability kertoo syyn.ratios), toimialavertailut (ratio_benchmarks) ja merkinnät (flags) ovat suuntaa antavia laskelmia ilmoitetuista luvuista. Ne eivät ole luottoluokitus, luottopisteet tai luottoraja. Toimialavertailu puuttuu (null), jos vertailuryhmässä ei ole vähintään 30 yritystä.tax_records kattaa kaikki suomalaiset yritykset, mutta ei yksityisiä elinkeinonharjoittajia. Yritys- ja rekisteritiedoissa ei ole avainhenkilöitä eikä rekisterin vaatimustenmukaisuussignaalia.Contains data from the Finnish Patent and Registration Office (PRH), CC BY 4.0. Listed groups: Contains annual financial reports published by the issuers (ESEF, IFRS), collected by XBRL International (filings.xbrl.org). Adapted by Prometiam. Tax records: Verohallinto, CC BY 4.0.
Yrityksen haku maksaa 1 krediitin, yhden yrityksen tilinpäätökset 25 krediittiä. Jos yritykselle ei ole tilinpäätöstä, vastaus on tyhjä eikä maksa mitään, ja virheet ovat ilmaisia. Scale (99,99 € kuukaudessa, 50 000 krediittiä) sisältää tilinpäätökset. Starter (9,99 €, 1 000 krediittiä), Professional (29,99 €, 10 000 krediittiä) ja kokeiluavaimet saavat 10 tilinpäätöskutsua kuukaudessa. Kokeilu kestää 14 päivää ja sisältää 500 krediittiä; kortti vaaditaan, mutta kokeilun aikana ei veloiteta mitään. Hinnat ovat julkisia.
Rekisteröidy · 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.