Financiële kengetallen analyseren
Kengetallen, balans en winst-en-verliesrekening uit de gepubliceerde jaarrekeningen.
Kapitaalvennootschappen zoals GmbH en AG, en ook de GmbH & Co. KG, publiceren elk jaar hun jaarrekening. Daaruit levert de API kengetallen per boekjaar, de balans en W&V met alle posten, en de volledige tekst van de jaarrekeningen.
Kengetallen ophalen
De feature financial_kpi (Financiële KPI’s) levert één rij kengetallen per boekjaar, zoals omzet, jaarresultaat, medewerkers en balanstotaal. Zonder verdere invoer krijg je alle beschikbare jaren, het meest recente eerst. Onze voorbeeldaanvraag haalt drie jaren van Hetzner Online GmbH, Ansbach HRB 6089, op.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: JOUW_API_SLEUTEL" \ --data-urlencode 'q=Ansbach HRB 6089' \ --data-urlencode 'feature=financial_kpi' \ --data-urlencode 'financial_years=3'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "JOUW_API_SLEUTEL"}, params={ "q": "Ansbach HRB 6089", "feature": ["financial_kpi"], "financial_years": "3", }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-organization"); url.searchParams.append("q", "Ansbach HRB 6089"); url.searchParams.append("feature", "financial_kpi"); url.searchParams.append("financial_years", "3"); const response = await fetch(url, { headers: { "x-api-key": "JOUW_API_SLEUTEL" }, }); const data = await response.json();
1{2 "entity_id": "94eb910fef13f94585c48c263fa446d4",3 "name": "Hetzner Online GmbH",4 "financial_kpi": [5 {6 "year": 2023,7 "employees": 340,8 "company_size_by_employees": "large",9 "revenue_per_employee": 1582798.844,10 "net_income_per_employee": 485049.362,11 "assets_total": 397093655.67,12 "active_total": 397093655.67,13 "equity_total": 297695266.84,14 "liabilities_total": 28921831.79,15 "provisions_total": 55716527.94,16 "current_assets_total": 75902450.81,17 "inventory_total": 2605622.88,18 "receivables_total": 34451734.53,19 "securities_current_total": null,20 "cash_and_equivalents": 38845093.4,21 "ppe_total": 269497218.27,22 "intangible_assets": 18788946.41,23 "goodwill": null,24 "equity_ratio": 0.75,25 "debt_to_equity": 0.097,26 "debt_to_assets": 0.073,27 "cash_to_assets": 0.098,28 "cash_to_liabilities": 1.343,29 "receivables_to_assets": 0.087,30 "inventory_to_assets": 0.007,31 "ppe_to_assets": 0.679,32 "intangible_to_assets": 0.047,33 "goodwill_to_assets": null,34 "intangible_to_equity": 0.063,35 "tangible_equity": 278906320.43,36 "tangible_equity_ratio": 0.702,37 "operating_working_capital": 13370466.18,38 "net_working_capital_strict": 61276584.41,39 "net_working_capital_approx": 46980619.02,40 "interest_bearing_debt_strict": null,41 "interest_bearing_debt_broad": 14295965.39,42 "net_debt_narrow": null,43 "net_debt_broad": -24549128.01,44 "bank_debt": null,45 "bonds": null,46 "trade_payables": 14625866.4,47 "intragroup_receivables": 548819.99,48 "intragroup_payables": 2667666.2,49 "company_size_by_assets": "large",50 "revenue": 538151607.13,51 "material_expenses": 116509640.56,52 "material_expenses_goods": 1157010.5,53 "material_expenses_services": 115352630.06,54 "personnel_expenses": 37557386.2,55 "wages_salaries": 33140885.29,56 "social_expenses": 4416500.91,57 "pension_costs": null,58 "depreciation_amortization": 129958760.25,59 "other_operating_income": 1229615.57,60 "other_operating_expenses": 29380170.42,61 "selling_expenses": null,62 "admin_expenses": null,63 "gross_profit": null,64 "ebit": null,65 "ebt": null,66 "income_taxes": 67650181.5,67 "other_taxes": 94694.61,68 "net_income": 164916783.06,69 "ebitda": null,70 "gross_margin": null,71 "ebitda_margin": null,72 "ebit_margin": null,73 "net_margin": 0.306,74 "material_intensity": 0.216,75 "personnel_intensity": 0.07,76 "sga": null,77 "sga_ratio": null,78 "opex_core": 66937556.62,79 "opex_ratio": 0.124,80 "interest_coverage": null,81 "effective_tax_rate": null,82 "capitalized_own_work_ratio": 0.003,83 "inventory_change_ratio": null,84 "finance_income": 5025778.39,85 "finance_income_from_affiliates": null,86 "finance_to_ebt_ratio": null,87 "company_size_by_revenue": "large",88 "source_statement_date": "2023-12-31",89 "source_statement_type": "Jahresabschluss",90 "fixed_assets_total": 316193205.41,91 "land_and_buildings": 46944085.59,92 "long_term_financial_assets": 27907040.73,93 "trade_receivables": 25390709.7,94 "prepaid_expenses": 4997999.45,95 "capital_reserves": 536224.77,96 "revenue_reserves": 20005000,97 "profit_loss_carried_forward": 332187259.01,98 "pension_provisions": null,99 "other_provisions": 22278401.94,100 "liabilities_to_affiliated_companies": 2667666.2,101 "other_liabilities": 11628299.19,102 "deferred_income": 14760029.1,103 "interest_income": 5025778.39,104 "interest_expense": 42.37,105 "depreciation_amortization_operating": 129958760.25,106 "write_downs_financial_assets_and_securities": null,107 "income_after_taxes": 165011477.67,108 "_provenance": {109 "statement_type": "Jahresabschluss",110 "period_start": "2023-01-01",111 "period_end": "2023-12-31",112 "exempt_subsidiary": false,113 "parent_organization": null114 }115 },116 {117 "year": 2022,118 "employees": 320,119 "company_size_by_employees": "large",120 "revenue_per_employee": 1396309.758,121 "net_income_per_employee": 377666.02,122 "assets_total": 444880125.47,123 "active_total": 444880125.47,124 "equity_total": 352242259.01,125 "liabilities_total": 46463198.47,126 "provisions_total": 26782680.75,127 "current_assets_total": 131050312.58,128 "inventory_total": 1887629.1,129 "receivables_total": 27702079.33,130 "securities_current_total": null,131 "cash_and_equivalents": 101460604.15,132 "ppe_total": 269345763.76,133 "intangible_assets": 12231207.94,134 "goodwill": null,135 "equity_ratio": 0.792,136 "debt_to_equity": 0.132,137 "debt_to_assets": 0.104,138 "cash_to_assets": 0.228,139 "cash_to_liabilities": 2.184,140 "receivables_to_assets": 0.062,141 "inventory_to_assets": 0.004,142 "ppe_to_assets": 0.605,143 "intangible_to_assets": 0.027,144 "goodwill_to_assets": null,145 "intangible_to_equity": 0.035,146 "tangible_equity": 340011051.07,147 "tangible_equity_ratio": 0.764,148 "operating_working_capital": 6188582.52,149 "net_working_capital_strict": 115739202.37,150 "net_working_capital_approx": 84587114.11,151 "interest_bearing_debt_strict": null,152 "interest_bearing_debt_broad": 31152088.26,153 "net_debt_narrow": null,154 "net_debt_broad": -70308515.89,155 "bank_debt": null,156 "bonds": null,157 "trade_payables": 15311110.21,158 "intragroup_receivables": 425178.6,159 "intragroup_payables": 4135982.99,160 "company_size_by_assets": "large",161 "revenue": 446819122.41,162 "material_expenses": 86705005.69,163 "material_expenses_goods": 1716860.71,164 "material_expenses_services": 84988144.98,165 "personnel_expenses": 30660187,166 "wages_salaries": 26876081.71,167 "social_expenses": 3784105.29,168 "pension_costs": null,169 "depreciation_amortization": 132774782.91,170 "other_operating_income": 851946.7,171 "other_operating_expenses": 32577388.65,172 "selling_expenses": null,173 "admin_expenses": null,174 "gross_profit": null,175 "ebit": null,176 "ebt": null,177 "income_taxes": 48316338.38,178 "other_taxes": 106304.86,179 "net_income": 120853126.37,180 "ebitda": null,181 "gross_margin": null,182 "ebitda_margin": null,183 "ebit_margin": null,184 "net_margin": 0.27,185 "material_intensity": 0.194,186 "personnel_intensity": 0.069,187 "sga": null,188 "sga_ratio": null,189 "opex_core": 63237575.65,190 "opex_ratio": 0.142,191 "interest_coverage": null,192 "effective_tax_rate": null,193 "capitalized_own_work_ratio": 0.004,194 "inventory_change_ratio": 0.004,195 "finance_income": 2670145.94,196 "finance_income_from_affiliates": 2500000,197 "finance_to_ebt_ratio": null,198 "company_size_by_revenue": "large",199 "source_statement_date": "2022-12-31",200 "source_statement_type": "Jahresabschluss",201 "fixed_assets_total": 309484012.43,202 "land_and_buildings": 47348736.49,203 "long_term_financial_assets": 27907040.73,204 "trade_receivables": 19612063.63,205 "prepaid_expenses": 4345800.46,206 "capital_reserves": null,207 "revenue_reserves": 20005000,208 "profit_loss_carried_forward": 296334132.64,209 "pension_provisions": null,210 "other_provisions": 16843449.75,211 "liabilities_to_affiliated_companies": 4135982.99,212 "other_liabilities": 27016105.27,213 "deferred_income": 19391987.24,214 "interest_income": 170145.94,215 "interest_expense": 145745.2,216 "depreciation_amortization_operating": 132774782.91,217 "write_downs_financial_assets_and_securities": null,218 "income_after_taxes": 120959431.23,219 "_provenance": {220 "statement_type": "Jahresabschluss",221 "period_start": "2022-01-01",222 "period_end": "2022-12-31",223 "exempt_subsidiary": false,224 "parent_organization": null225 }226 },227 {228 "year": 2021,229 "employees": 306,230 "company_size_by_employees": "large",231 "revenue_per_employee": 1199610.825,232 "net_income_per_employee": 338857.681,233 "assets_total": 376822527.31,234 "active_total": 376822527.31,235 "equity_total": 316389132.64,236 "liabilities_total": 15010771.73,237 "provisions_total": 27735264.12,238 "current_assets_total": 55430682.62,239 "inventory_total": 1975280.54,240 "receivables_total": 20732386.22,241 "securities_current_total": null,242 "cash_and_equivalents": 32723015.86,243 "ppe_total": 278908856.1,244 "intangible_assets": 14983369.23,245 "goodwill": null,246 "equity_ratio": 0.84,247 "debt_to_equity": 0.047,248 "debt_to_assets": 0.04,249 "cash_to_assets": 0.087,250 "cash_to_liabilities": 2.18,251 "receivables_to_assets": 0.055,252 "inventory_to_assets": 0.005,253 "ppe_to_assets": 0.74,254 "intangible_to_assets": 0.04,255 "goodwill_to_assets": null,256 "intangible_to_equity": 0.047,257 "tangible_equity": 301405763.41,258 "tangible_equity_ratio": 0.8,259 "operating_working_capital": 10564764.53,260 "net_working_capital_strict": 48670001.51,261 "net_working_capital_approx": 40419910.89,262 "interest_bearing_debt_strict": null,263 "interest_bearing_debt_broad": 8250090.62,264 "net_debt_narrow": null,265 "net_debt_broad": -24472925.24,266 "bank_debt": null,267 "bonds": null,268 "trade_payables": 6760681.11,269 "intragroup_receivables": 312400,270 "intragroup_payables": 3936282.05,271 "company_size_by_assets": "large",272 "revenue": 367080912.48,273 "material_expenses": 62241661.41,274 "material_expenses_goods": 1622512.06,275 "material_expenses_services": 60619149.35,276 "personnel_expenses": 27200586.83,277 "wages_salaries": 24227107.99,278 "social_expenses": 2973478.84,279 "pension_costs": null,280 "depreciation_amortization": 111322161.93,281 "other_operating_income": 1590663.03,282 "other_operating_expenses": 23643459.36,283 "selling_expenses": null,284 "admin_expenses": null,285 "gross_profit": null,286 "ebit": null,287 "ebt": null,288 "income_taxes": 42332995.73,289 "other_taxes": 255354.27,290 "net_income": 103690450.4,291 "ebitda": null,292 "gross_margin": null,293 "ebitda_margin": null,294 "ebit_margin": null,295 "net_margin": 0.282,296 "material_intensity": 0.17,297 "personnel_intensity": 0.074,298 "sga": null,299 "sga_ratio": null,300 "opex_core": 50844046.19,301 "opex_ratio": 0.139,302 "interest_coverage": null,303 "effective_tax_rate": null,304 "capitalized_own_work_ratio": 0.006,305 "inventory_change_ratio": 0.006,306 "finance_income": 58981.94,307 "finance_income_from_affiliates": null,308 "finance_to_ebt_ratio": null,309 "company_size_by_revenue": "large",310 "source_statement_date": "2021-12-31",311 "source_statement_type": "Jahresabschluss",312 "fixed_assets_total": 316732794.11,313 "land_and_buildings": 40516146.96,314 "long_term_financial_assets": 22840568.78,315 "trade_receivables": 15350165.1,316 "prepaid_expenses": 4659050.58,317 "capital_reserves": null,318 "revenue_reserves": 20005000,319 "profit_loss_carried_forward": 222643682.24,320 "pension_provisions": null,321 "other_provisions": 17097544.73,322 "liabilities_to_affiliated_companies": 3936282.05,323 "other_liabilities": 4313808.57,324 "deferred_income": 17687358.82,325 "interest_income": 36416.37,326 "interest_expense": 161642.26,327 "depreciation_amortization_operating": 111322161.93,328 "write_downs_financial_assets_and_securities": null,329 "income_after_taxes": 103945804.67,330 "_provenance": {331 "statement_type": "Jahresabschluss",332 "period_start": "2021-01-01",333 "period_end": "2021-12-31",334 "exempt_subsidiary": false,335 "parent_organization": null336 }337 }338 ],339 "meta": {340 "request_credit_cost": 6,341 "credits_remaining": 145342 }343}
Elk account krijgt de basiskengetallen revenue, net_income, employees, active_total (balanstotaal), material_expenses en personnel_expenses. Pro en Max voegen er meer dan 90 toe, zoals solvabiliteit, EBITDA en marges.
Ratio’s zijn breuken: equity_ratio 0,75 betekent 75%. _provenance noemt de jaarrekening waar de rij vandaan komt: het type en begin en einde van het boekjaar.
financial_kpi kost 1 credit per aanvraag, hoeveel jaren er ook terugkomen. Levert het geen gegevens op, dan kost het niets.
Bedrijven publiceren hun jaarrekening tot twaalf maanden na het einde van het boekjaar. Het meest recente beschikbare jaar is daarom vaak het jaar vóór vorig jaar.
Deze cijfers lezen we automatisch uit de gepubliceerde jaarrekeningen. We gebruiken daarvoor de nieuwste technologie en investeren veel in kwaliteit; afzonderlijke fouten blijven mogelijk. Bij twijfel telt de jaarrekening zelf, die je als volledige tekst kunt ophalen.
Enkelvoudige of geconsolideerde jaarrekening kiezen
Grote concerns publiceren naast de jaarrekening van elk bedrijf een geconsolideerde jaarrekening voor het hele concern. Met financial_statement_type kies je welke je krijgt:
| financial_statement_type | Betekenis |
|---|---|
| auto | Standaard. Elke feature kiest zelf. Een antwoord kan daardoor enkelvoudige en geconsolideerde cijfers mengen. |
| annual | Alleen enkelvoudige jaarrekeningen (Jahresabschluss). |
| consolidated | Alleen geconsolideerde jaarrekeningen. |
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: JOUW_API_SLEUTEL" \ --data-urlencode 'q=Bonn HRB 6794' \ --data-urlencode 'feature=financial_kpi' \ --data-urlencode 'financial_statement_type=consolidated' \ --data-urlencode 'financial_years=2'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "JOUW_API_SLEUTEL"}, params={ "q": "Bonn HRB 6794", "feature": ["financial_kpi"], "financial_statement_type": "consolidated", "financial_years": "2", }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-organization"); url.searchParams.append("q", "Bonn HRB 6794"); url.searchParams.append("feature", "financial_kpi"); url.searchParams.append("financial_statement_type", "consolidated"); url.searchParams.append("financial_years", "2"); const response = await fetch(url, { headers: { "x-api-key": "JOUW_API_SLEUTEL" }, }); const data = await response.json();
1{2 "entity_id": "7e9f0173f498bb9b4eac421bab1573e4",3 "name": "Deutsche Telekom AG",4 "financial_kpi": [5 {6 "year": 2025,7 "employees": null,8 "company_size_by_employees": null,9 "revenue_per_employee": null,10 "net_income_per_employee": null,11 "assets_total": 289769000000,12 "active_total": 289769000000,13 "equity_total": 92231000000,14 "liabilities_total": 197538000000,15 "provisions_total": null,16 "current_assets_total": 10684000000,17 "inventory_total": 2866000000,18 "receivables_total": null,19 "securities_current_total": null,20 "cash_and_equivalents": 7818000000,21 "ppe_total": 64791000000,22 "intangible_assets": 133650000000,23 "goodwill": null,24 "equity_ratio": 0.318,25 "debt_to_equity": 2.142,26 "debt_to_assets": 0.682,27 "cash_to_assets": 0.027,28 "cash_to_liabilities": 0.04,29 "receivables_to_assets": null,30 "inventory_to_assets": 0.01,31 "ppe_to_assets": 0.224,32 "intangible_to_assets": 0.461,33 "goodwill_to_assets": null,34 "intangible_to_equity": 1.449,35 "tangible_equity": -41419000000,36 "tangible_equity_ratio": -0.143,37 "operating_working_capital": 10127000000,38 "net_working_capital_strict": 1103000000,39 "net_working_capital_approx": 1103000000,40 "interest_bearing_debt_strict": null,41 "interest_bearing_debt_broad": null,42 "net_debt_narrow": null,43 "net_debt_broad": null,44 "bank_debt": null,45 "bonds": null,46 "trade_payables": 9581000000,47 "intragroup_receivables": null,48 "intragroup_payables": null,49 "company_size_by_assets": "large",50 "revenue": 119081000000,51 "material_expenses": 48747000000,52 "material_expenses_goods": null,53 "material_expenses_services": null,54 "personnel_expenses": 19781000000,55 "wages_salaries": null,56 "social_expenses": null,57 "pension_costs": null,58 "depreciation_amortization": 24009000000,59 "other_operating_income": 1358000000,60 "other_operating_expenses": 5764000000,61 "selling_expenses": null,62 "admin_expenses": null,63 "gross_profit": null,64 "ebit": 24822000000,65 "ebt": 19499000000,66 "income_taxes": 4573000000,67 "other_taxes": null,68 "net_income": 14926000000,69 "ebitda": 48831000000,70 "gross_margin": null,71 "ebitda_margin": 0.41,72 "ebit_margin": 0.208,73 "net_margin": 0.125,74 "material_intensity": 0.409,75 "personnel_intensity": 0.166,76 "sga": null,77 "sga_ratio": null,78 "opex_core": 25545000000,79 "opex_ratio": 0.215,80 "interest_coverage": 3.806,81 "effective_tax_rate": 0.235,82 "capitalized_own_work_ratio": null,83 "inventory_change_ratio": null,84 "finance_income": 613000000,85 "finance_income_from_affiliates": null,86 "finance_to_ebt_ratio": -0.303,87 "company_size_by_revenue": "large",88 "source_statement_date": "2025-12-31",89 "source_statement_type": "Konzernabschluss",90 "fixed_assets_total": 248592000000,91 "land_and_buildings": null,92 "long_term_financial_assets": null,93 "trade_receivables": 16842000000,94 "prepaid_expenses": null,95 "capital_reserves": 53166000000,96 "revenue_reserves": null,97 "profit_loss_carried_forward": null,98 "pension_provisions": null,99 "other_provisions": 7919000000,100 "liabilities_to_affiliated_companies": null,101 "other_liabilities": null,102 "deferred_income": null,103 "interest_income": 613000000,104 "interest_expense": 6522000000,105 "depreciation_amortization_operating": 24009000000,106 "write_downs_financial_assets_and_securities": null,107 "income_after_taxes": 14926000000,108 "_provenance": {109 "statement_type": "Konzernabschluss",110 "period_start": "2025-01-01",111 "period_end": "2025-12-31",112 "exempt_subsidiary": false,113 "parent_organization": null114 }115 },116 {117 "year": 2024,118 "employees": null,119 "company_size_by_employees": null,120 "revenue_per_employee": null,121 "net_income_per_employee": null,122 "assets_total": 304934000000,123 "active_total": 304934000000,124 "equity_total": 98640000000,125 "liabilities_total": 206294000000,126 "provisions_total": null,127 "current_assets_total": 27334000000,128 "inventory_total": 2451000000,129 "receivables_total": 16411000000,130 "securities_current_total": null,131 "cash_and_equivalents": 8472000000,132 "ppe_total": 66612000000,133 "intangible_assets": 149115000000,134 "goodwill": null,135 "equity_ratio": 0.323,136 "debt_to_equity": 2.091,137 "debt_to_assets": 0.677,138 "cash_to_assets": 0.028,139 "cash_to_liabilities": 0.041,140 "receivables_to_assets": 0.054,141 "inventory_to_assets": 0.008,142 "ppe_to_assets": 0.218,143 "intangible_to_assets": 0.489,144 "goodwill_to_assets": null,145 "intangible_to_equity": 1.512,146 "tangible_equity": -50475000000,147 "tangible_equity_ratio": -0.166,148 "operating_working_capital": null,149 "net_working_capital_strict": 17845000000,150 "net_working_capital_approx": 17845000000,151 "interest_bearing_debt_strict": null,152 "interest_bearing_debt_broad": null,153 "net_debt_narrow": null,154 "net_debt_broad": null,155 "bank_debt": null,156 "bonds": null,157 "trade_payables": 9489000000,158 "intragroup_receivables": null,159 "intragroup_payables": null,160 "company_size_by_assets": "large",161 "revenue": 115769000000,162 "material_expenses": 47374000000,163 "material_expenses_goods": null,164 "material_expenses_services": null,165 "personnel_expenses": 19004000000,166 "wages_salaries": null,167 "social_expenses": null,168 "pension_costs": null,169 "depreciation_amortization": 24027000000,170 "other_operating_income": 3913000000,171 "other_operating_expenses": 5632000000,172 "selling_expenses": null,173 "admin_expenses": null,174 "gross_profit": null,175 "ebit": 26277000000,176 "ebt": 22958000000,177 "income_taxes": 5301000000,178 "other_taxes": null,179 "net_income": 17657000000,180 "ebitda": 50304000000,181 "gross_margin": null,182 "ebitda_margin": 0.435,183 "ebit_margin": 0.227,184 "net_margin": 0.153,185 "material_intensity": 0.409,186 "personnel_intensity": 0.164,187 "sga": null,188 "sga_ratio": null,189 "opex_core": 24636000000,190 "opex_ratio": 0.213,191 "interest_coverage": 3.974,192 "effective_tax_rate": 0.231,193 "capitalized_own_work_ratio": null,194 "inventory_change_ratio": null,195 "finance_income": null,196 "finance_income_from_affiliates": null,197 "finance_to_ebt_ratio": -0.288,198 "company_size_by_revenue": "large",199 "source_statement_date": "2024-12-31",200 "source_statement_type": "Konzernabschluss",201 "fixed_assets_total": 267773000000,202 "land_and_buildings": null,203 "long_term_financial_assets": null,204 "trade_receivables": null,205 "prepaid_expenses": null,206 "capital_reserves": null,207 "revenue_reserves": null,208 "profit_loss_carried_forward": null,209 "pension_provisions": null,210 "other_provisions": 7869000000,211 "liabilities_to_affiliated_companies": null,212 "other_liabilities": null,213 "deferred_income": null,214 "interest_income": null,215 "interest_expense": 6613000000,216 "depreciation_amortization_operating": 24027000000,217 "write_downs_financial_assets_and_securities": null,218 "income_after_taxes": 17657000000,219 "_provenance": {220 "statement_type": "Konzernabschluss",221 "period_start": "2024-01-01",222 "period_end": "2024-12-31",223 "exempt_subsidiary": false,224 "parent_organization": null225 }226 }227 ],228 "meta": {229 "request_credit_cost": 6,230 "credits_remaining": 145231 }232}
Het type van een rij staat in _provenance.statement_type: „Jahresabschluss” (enkelvoudige jaarrekening) of „Konzernabschluss” (geconsolideerde jaarrekening). Met annual of consolidated valt de API niet terug op het andere type. Is er zo’n jaarrekening niet, dan blijft de feature leeg en kost ze niets.
Jaren vergelijken
financial_years beperkt het antwoord tot de meest recente boekjaren, van 1 tot 30. Het geldt voor alle financiële features van de aanvraag, ook balans, W&V en jaarrekeningen.
year is het kalenderjaar waarin het boekjaar eindigt. In het voorbeeld van Siemens Aktiengesellschaft, München HRB 6684, loopt het van 1 oktober tot 30 september. De rij 2025 dekt dus 1 oktober 2024 tot 30 september 2025.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: JOUW_API_SLEUTEL" \ --data-urlencode 'q=Siemens Aktiengesellschaft München' \ --data-urlencode 'feature=financial_kpi' \ --data-urlencode 'financial_years=2'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "JOUW_API_SLEUTEL"}, params={ "q": "Siemens Aktiengesellschaft München", "feature": ["financial_kpi"], "financial_years": "2", }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-organization"); url.searchParams.append("q", "Siemens Aktiengesellschaft München"); url.searchParams.append("feature", "financial_kpi"); url.searchParams.append("financial_years", "2"); const response = await fetch(url, { headers: { "x-api-key": "JOUW_API_SLEUTEL" }, }); const data = await response.json();
1{2 "entity_id": "d5fad47c8d205a3d62ed12a586bd7148",3 "name": "Siemens Aktiengesellschaft",4 "financial_kpi": [5 {6 "year": 2025,7 "employees": null,8 "company_size_by_employees": null,9 "revenue_per_employee": null,10 "net_income_per_employee": null,11 "assets_total": 166202000000,12 "active_total": 166202000000,13 "equity_total": 68371000000,14 "liabilities_total": 97830000000,15 "provisions_total": null,16 "current_assets_total": 41705000000,17 "inventory_total": 10582000000,18 "receivables_total": 16628000000,19 "securities_current_total": null,20 "cash_and_equivalents": 14495000000,21 "ppe_total": 13023000000,22 "intangible_assets": 12199000000,23 "goodwill": 40670000000,24 "equity_ratio": 0.411,25 "debt_to_equity": 1.431,26 "debt_to_assets": 0.589,27 "cash_to_assets": 0.087,28 "cash_to_liabilities": 0.148,29 "receivables_to_assets": 0.1,30 "inventory_to_assets": 0.064,31 "ppe_to_assets": 0.078,32 "intangible_to_assets": 0.073,33 "goodwill_to_assets": 0.245,34 "intangible_to_equity": 0.178,35 "tangible_equity": 56172000000,36 "tangible_equity_ratio": 0.338,37 "operating_working_capital": null,38 "net_working_capital_strict": 32522000000,39 "net_working_capital_approx": 32522000000,40 "interest_bearing_debt_strict": null,41 "interest_bearing_debt_broad": null,42 "net_debt_narrow": null,43 "net_debt_broad": null,44 "bank_debt": null,45 "bonds": null,46 "trade_payables": 9183000000,47 "intragroup_receivables": null,48 "intragroup_payables": null,49 "company_size_by_assets": "large",50 "revenue": 78914000000,51 "material_expenses": null,52 "material_expenses_goods": null,53 "material_expenses_services": null,54 "personnel_expenses": null,55 "wages_salaries": null,56 "social_expenses": null,57 "pension_costs": null,58 "depreciation_amortization": null,59 "other_operating_income": 981000000,60 "other_operating_expenses": null,61 "selling_expenses": null,62 "admin_expenses": null,63 "gross_profit": 30399000000,64 "ebit": null,65 "ebt": 10830000000,66 "income_taxes": 2501000000,67 "other_taxes": null,68 "net_income": 10387000000,69 "ebitda": null,70 "gross_margin": 0.385,71 "ebitda_margin": null,72 "ebit_margin": null,73 "net_margin": 0.132,74 "material_intensity": null,75 "personnel_intensity": null,76 "sga": null,77 "sga_ratio": null,78 "opex_core": null,79 "opex_ratio": null,80 "interest_coverage": null,81 "effective_tax_rate": 0.231,82 "capitalized_own_work_ratio": null,83 "inventory_change_ratio": null,84 "finance_income": null,85 "finance_income_from_affiliates": null,86 "finance_to_ebt_ratio": -0.151,87 "company_size_by_revenue": "large",88 "source_statement_date": "2025-09-30",89 "source_statement_type": "Konzernabschluss",90 "fixed_assets_total": 101490000000,91 "land_and_buildings": null,92 "long_term_financial_assets": null,93 "trade_receivables": null,94 "prepaid_expenses": null,95 "capital_reserves": null,96 "revenue_reserves": 49601000000,97 "profit_loss_carried_forward": null,98 "pension_provisions": 732000000,99 "other_provisions": 3385000000,100 "liabilities_to_affiliated_companies": null,101 "other_liabilities": null,102 "deferred_income": null,103 "interest_income": null,104 "interest_expense": 1640000000,105 "depreciation_amortization_operating": null,106 "write_downs_financial_assets_and_securities": null,107 "income_after_taxes": 8329000000,108 "_provenance": {109 "statement_type": "Konzernabschluss",110 "period_start": "2024-10-01",111 "period_end": "2025-09-30",112 "exempt_subsidiary": false,113 "parent_organization": null114 }115 },116 {117 "year": 2024,118 "employees": null,119 "company_size_by_employees": null,120 "revenue_per_employee": null,121 "net_income_per_employee": null,122 "assets_total": 147812000000,123 "active_total": 147812000000,124 "equity_total": 56231000000,125 "liabilities_total": 91581000000,126 "provisions_total": null,127 "current_assets_total": 37042000000,128 "inventory_total": 10923000000,129 "receivables_total": 16963000000,130 "securities_current_total": null,131 "cash_and_equivalents": 9156000000,132 "ppe_total": 12242000000,133 "intangible_assets": 9593000000,134 "goodwill": 31384000000,135 "equity_ratio": 0.38,136 "debt_to_equity": 1.629,137 "debt_to_assets": 0.62,138 "cash_to_assets": 0.062,139 "cash_to_liabilities": 0.1,140 "receivables_to_assets": 0.115,141 "inventory_to_assets": 0.074,142 "ppe_to_assets": 0.083,143 "intangible_to_assets": 0.065,144 "goodwill_to_assets": 0.212,145 "intangible_to_equity": 0.171,146 "tangible_equity": 46638000000,147 "tangible_equity_ratio": 0.316,148 "operating_working_capital": null,149 "net_working_capital_strict": 28199000000,150 "net_working_capital_approx": 28199000000,151 "interest_bearing_debt_strict": null,152 "interest_bearing_debt_broad": null,153 "net_debt_narrow": null,154 "net_debt_broad": null,155 "bank_debt": null,156 "bonds": null,157 "trade_payables": 8843000000,158 "intragroup_receivables": null,159 "intragroup_payables": null,160 "company_size_by_assets": "large",161 "revenue": 75930000000,162 "material_expenses": null,163 "material_expenses_goods": null,164 "material_expenses_services": null,165 "personnel_expenses": null,166 "wages_salaries": null,167 "social_expenses": null,168 "pension_costs": null,169 "depreciation_amortization": null,170 "other_operating_income": 544000000,171 "other_operating_expenses": null,172 "selling_expenses": null,173 "admin_expenses": null,174 "gross_profit": 29823000000,175 "ebit": null,176 "ebt": 11227000000,177 "income_taxes": 2320000000,178 "other_taxes": null,179 "net_income": 8992000000,180 "ebitda": null,181 "gross_margin": 0.393,182 "ebitda_margin": null,183 "ebit_margin": null,184 "net_margin": 0.118,185 "material_intensity": null,186 "personnel_intensity": null,187 "sga": null,188 "sga_ratio": null,189 "opex_core": null,190 "opex_ratio": null,191 "interest_coverage": null,192 "effective_tax_rate": 0.207,193 "capitalized_own_work_ratio": null,194 "inventory_change_ratio": null,195 "finance_income": null,196 "finance_income_from_affiliates": null,197 "finance_to_ebt_ratio": -0.159,198 "company_size_by_revenue": "large",199 "source_statement_date": "2024-09-30",200 "source_statement_type": "Konzernabschluss",201 "fixed_assets_total": 86459000000,202 "land_and_buildings": null,203 "long_term_financial_assets": null,204 "trade_receivables": null,205 "prepaid_expenses": null,206 "capital_reserves": null,207 "revenue_reserves": 39657000000,208 "profit_loss_carried_forward": null,209 "pension_provisions": 912000000,210 "other_provisions": 3850000000,211 "liabilities_to_affiliated_companies": null,212 "other_liabilities": null,213 "deferred_income": null,214 "interest_income": null,215 "interest_expense": 1785000000,216 "depreciation_amortization_operating": null,217 "write_downs_financial_assets_and_securities": null,218 "income_after_taxes": 8907000000,219 "_provenance": {220 "statement_type": "Konzernabschluss",221 "period_start": "2023-10-01",222 "period_end": "2024-09-30",223 "exempt_subsidiary": false,224 "parent_organization": null225 }226 }227 ],228 "meta": {229 "request_credit_cost": 6,230 "credits_remaining": 145231 }232}
Om over jaren heen te vergelijken, lees je begin en einde uit _provenance.period_start en period_end. Zo zie je ook een verkort boekjaar, bijvoorbeeld na een wijziging van de balansdatum.
Balans en W&V in detail
balance_sheet_accounts (Balans) en profit_and_loss_account (Winst-en-verliesrekening, W&V) leveren alle posten van een jaarrekening, met uniforme namen over verslaggevingsstandaarden heen. Elke post heeft een waarde; de subposten staan in children. Het voorbeeld toont Hetzner Online GmbH.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: JOUW_API_SLEUTEL" \ --data-urlencode 'q=Ansbach HRB 6089' \ --data-urlencode 'feature=balance_sheet_accounts' \ --data-urlencode 'feature=profit_and_loss_account' \ --data-urlencode 'financial_years=1'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "JOUW_API_SLEUTEL"}, params={ "q": "Ansbach HRB 6089", "feature": ["balance_sheet_accounts", "profit_and_loss_account"], "financial_years": "1", }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-organization"); url.searchParams.append("q", "Ansbach HRB 6089"); url.searchParams.append("feature", "balance_sheet_accounts"); url.searchParams.append("feature", "profit_and_loss_account"); url.searchParams.append("financial_years", "1"); const response = await fetch(url, { headers: { "x-api-key": "JOUW_API_SLEUTEL" }, }); const data = await response.json();
1{2 "entity_id": "94eb910fef13f94585c48c263fa446d4",3 "name": "Hetzner Online GmbH",4 "balance_sheet_accounts": [5 {6 "year": 2023,7 "balance_sheet_accounts": [8 {9 "name": {10 "de": "Aktivseite",11 "en": "Assets",12 "in_report": "Aktiva"13 },14 "value": 397093655.67,15 "children": [16 {17 "name": {18 "de": "Anlagevermögen",19 "en": "Fixed Assets",20 "in_report": "A. Anlagevermögen"21 },22 "value": 316193205.41,23 "children": [24 {25 "name": {26 "de": "Immaterielle Vermögensgegenstände",27 "en": "Intangible Assets",28 "in_report": "I. Immaterielle Vermögensgegenstände"29 },30 "value": 18788946.41,31 "children": [32 {33 "name": {34 "de": "Entgeltlich erworbene Konzessionen",35 "en": "Purchased Concessions",36 "in_report": "1. entgeltlich erworbene Konzessionen, gewerbliche Schutzrechte und ähnliche Rechte und Werte sowie Lizenzen an solchen Rechten und Werten"37 },38 "value": 13879378,39 "children": []40 },41 {42 "name": {43 "de": "Geleistete Anzahlungen",44 "en": "Advance Payments",45 "in_report": "2. geleistete Anzahlungen"46 },47 "value": 4909568.41,48 "children": []49 }50 ]51 },52 {53 "name": {54 "de": "Sachanlagen",55 "en": "Tangible Assets",56 "in_report": "II. Sachanlagen"57 },58 "value": 269497218.27,59 "children": [60 {61 "name": {62 "de": "Grundstücke",63 "en": "Land",64 "in_report": "1. Grundstücke, grundstücksgleiche Rechte und Bauten einschließlich der Bauten auf fremden Grundstücken"65 },66 "value": 46944085.59,67 "children": []68 },69 {70 "name": {71 "de": "Technische Anlagen und Maschinen",72 "en": "Technical Equipment and Machinery",73 "in_report": "2. technische Anlagen und Maschinen"74 },75 "value": 161366732.14,76 "children": []77 },78 {79 "name": {80 "de": "Andere Anlagen",81 "en": "Other Equipment",82 "in_report": "3. andere Anlagen, Betriebs- und Geschäftsausstattung"83 },84 "value": 6776880,85 "children": []86 },87 {88 "name": {89 "de": "Geleistete Anzahlungen und Anlagen im Bau",90 "en": "Advance Payments and Construction in Progress",91 "in_report": "4. geleistete Anzahlungen und Anlagen im Bau"92 },93 "value": 54409520.54,94 "children": []95 }96 ]97 },98 {99 "name": {100 "de": "Finanzanlagen",101 "en": "Financial Assets",102 "in_report": "III. Finanzanlagen"103 },104 "value": 27907040.73,105 "children": [106 {107 "name": {108 "de": "Anteile an verbundenen Unternehmen",109 "en": "Shares in Affiliated Companies",110 "in_report": "1. Anteile an verbundenen Unternehmen"111 },112 "value": 27905540.73,113 "children": []114 },115 {116 "name": {117 "de": "2. Genossenschaftsanteile",118 "in_report": "2. Genossenschaftsanteile"119 },120 "value": 1500,121 "children": []122 }123 ]124 }125 ]126 },127 {128 "name": {129 "de": "Umlaufvermögen",130 "en": "Current Assets",131 "in_report": "B. Umlaufvermögen"132 },133 "value": 75902450.81,134 "children": [135 {136 "name": {137 "de": "Vorräte",138 "en": "Inventories",139 "in_report": "I. Vorräte"140 },141 "value": 2605622.88,142 "children": [143 {144 "name": {145 "de": "Rohstoffe, Hilfsstoffe und Betriebsstoffe",146 "en": "Raw Materials, Consumables, and Supplies",147 "in_report": "1. Roh-, Hilfs- und Betriebsstoffe"148 },149 "value": 542757,150 "children": []151 },152 {153 "name": {154 "de": "Fertige Erzeugnisse und Waren",155 "en": "Finished Goods and Merchandise",156 "in_report": "2. fertige Erzeugnisse und Waren"157 },158 "value": 2062865.88,159 "children": []160 }161 ]162 },163 {164 "name": {165 "de": "Forderungen und sonstige Vermögensgegenstände",166 "en": "Receivables and Other Assets",167 "in_report": "II. Forderungen und sonstige Vermögensgegenstände"168 },169 "value": 34451734.53,170 "children": [171 {172 "name": {173 "de": "Forderungen aus Lieferungen und Leistungen",174 "en": "Trade Receivables",175 "in_report": "1. Forderungen aus Lieferungen und Leistungen"176 },177 "value": 25390709.7,178 "children": []179 },180 {181 "name": {182 "de": "Forderungen gegen verbundene Unternehmen",183 "en": "Receivables from Affiliated Companies",184 "in_report": "2. Forderungen gegen verbundene Unternehmen"185 },186 "value": 548819.99,187 "children": []188 },189 {190 "name": {191 "de": "Sonstige Vermögensgegenstände",192 "en": "Other Assets",193 "in_report": "3. sonstige Vermögensgegenstände"194 },195 "value": 8512204.84,196 "children": [197 {198 "name": {199 "de": "davon mit einer Restlaufzeit von mehr als einem Jahr",200 "in_report": "davon mit einer Restlaufzeit von mehr als einem Jahr"201 },202 "value": 640.75,203 "children": []204 }205 ]206 }207 ]208 },209 {210 "name": {211 "de": "Kassenbestand, Bundesbankguthaben, Guthaben bei Kreditinstituten und Schecks",212 "en": "Cash, Central Bank Balances, Bank Deposits, and Checks",213 "in_report": "III. Kassenbestand, Bundesbankguthaben, Guthaben bei Kreditinstituten und Schecks"214 },215 "value": 38845093.4,216 "children": []217 }218 ]219 },220 {221 "name": {222 "de": "Aktive Rechnungsabgrenzungsposten",223 "en": "Prepaid Expenses",224 "in_report": "C. Rechnungsabgrenzungsposten"225 },226 "value": 4997999.45,227 "children": []228 }229 ]230 },231 {232 "name": {233 "de": "Passivseite",234 "en": "Liabilities and Equity",235 "in_report": "Passiva"236 },237 "value": 397093655.67,238 "children": [239 {240 "name": {241 "de": "Eigenkapital",242 "en": "Equity",243 "in_report": "A. Eigenkapital"244 },245 "value": 297695266.84,246 "children": [247 {248 "name": {249 "de": "Gezeichnetes Kapital",250 "en": "Subscribed Capital",251 "in_report": "I. Gezeichnetes Kapital"252 },253 "value": 50000,254 "children": []255 },256 {257 "name": {258 "de": "Kapitalrücklage",259 "en": "Capital Reserve",260 "in_report": "II. Kapitalrücklage"261 },262 "value": 536224.77,263 "children": []264 },265 {266 "name": {267 "de": "Gewinnrücklagen",268 "en": "Revenue Reserves",269 "in_report": "III. Gewinnrücklagen"270 },271 "value": 20005000,272 "children": [273 {274 "name": {275 "de": "Andere Gewinnrücklagen",276 "en": "Other Revenue Reserves",277 "in_report": "1. andere Gewinnrücklagen"278 },279 "value": 20005000,280 "children": []281 }282 ]283 },284 {285 "name": {286 "de": "IV. Bilanzgewinn",287 "in_report": "IV. Bilanzgewinn"288 },289 "value": 277104042.07,290 "children": [291 {292 "name": {293 "de": "Gewinnvortrag/Verlustvortrag",294 "en": "Retained Profit/Loss",295 "in_report": "davon Gewinnvortrag"296 },297 "value": 332187259.01,298 "children": []299 }300 ]301 }302 ]303 },304 {305 "name": {306 "de": "Rückstellungen",307 "en": "Provisions",308 "in_report": "B. Rückstellungen"309 },310 "value": 55716527.94,311 "children": [312 {313 "name": {314 "de": "Steuerrückstellungen",315 "en": "Tax Provisions",316 "in_report": "1. Steuerrückstellungen"317 },318 "value": 33438126,319 "children": []320 },321 {322 "name": {323 "de": "Sonstige Rückstellungen",324 "en": "Other Provisions",325 "in_report": "2. sonstige Rückstellungen"326 },327 "value": 22278401.94,328 "children": []329 }330 ]331 },332 {333 "name": {334 "de": "Verbindlichkeiten",335 "en": "Liabilities",336 "in_report": "C. Verbindlichkeiten"337 },338 "value": 28921831.79,339 "children": [340 {341 "name": {342 "de": "Verbindlichkeiten aus Lieferungen und Leistungen",343 "en": "Trade Payables",344 "in_report": "1. Verbindlichkeiten aus Lieferungen und Leistungen"345 },346 "value": 14625866.4,347 "children": [348 {349 "name": {350 "de": "davon mit einer Restlaufzeit bis zu einem Jahr",351 "in_report": "davon mit einer Restlaufzeit bis zu einem Jahr"352 },353 "value": 14625866.4,354 "children": []355 }356 ]357 },358 {359 "name": {360 "de": "Verbindlichkeiten gegenüber verbundenen Unternehmen",361 "en": "Liabilities to Affiliated Companies",362 "in_report": "2. Verbindlichkeiten gegenüber verbundenen Unternehmen"363 },364 "value": 2667666.2,365 "children": [366 {367 "name": {368 "de": "davon mit einer Restlaufzeit bis zu einem Jahr",369 "in_report": "davon mit einer Restlaufzeit bis zu einem Jahr"370 },371 "value": 2667666.2,372 "children": []373 }374 ]375 },376 {377 "name": {378 "de": "Sonstige Verbindlichkeiten",379 "en": "Other Liabilities",380 "in_report": "3. sonstige Verbindlichkeiten"381 },382 "value": 11628299.19,383 "children": [384 {385 "name": {386 "de": "davon aus Steuern",387 "in_report": "davon aus Steuern"388 },389 "value": 8253740.53,390 "children": []391 },392 {393 "name": {394 "de": "davon im Rahmen der sozialen Sicherheit",395 "in_report": "davon im Rahmen der sozialen Sicherheit"396 },397 "value": 65735.04,398 "children": []399 },400 {401 "name": {402 "de": "davon mit einer Restlaufzeit bis zu einem Jahr",403 "in_report": "davon mit einer Restlaufzeit bis zu einem Jahr"404 },405 "value": 11628299.19,406 "children": []407 }408 ]409 }410 ]411 },412 {413 "name": {414 "de": "Passive Rechnungsabgrenzungsposten",415 "en": "Accrued Expenses",416 "in_report": "D. Rechnungsabgrenzungsposten"417 },418 "value": 14760029.1,419 "children": []420 }421 ]422 }423 ],424 "_provenance": {425 "statement_type": "Jahresabschluss",426 "period_start": "2023-01-01",427 "period_end": "2023-12-31",428 "exempt_subsidiary": false,429 "parent_organization": null430 }431 }432 ],433 "profit_and_loss_account": [434 {435 "year": 2023,436 "profit_and_loss_accounts": [437 {438 "name": {439 "de": "Umsatzerlöse",440 "en": "Revenue",441 "in_report": "1. Umsatzerlöse"442 },443 "value": 538151607.13,444 "children": []445 },446 {447 "name": {448 "de": "Andere aktivierte Eigenleistungen",449 "en": "Other capitalized own work",450 "in_report": "2. andere aktivierte Eigenleistungen"451 },452 "value": 1660657.88,453 "children": []454 },455 {456 "name": {457 "de": "Sonstige betriebliche Erträge",458 "en": "Other operating income",459 "in_report": "3. sonstige betriebliche Erträge"460 },461 "value": 1229615.57,462 "children": [463 {464 "name": {465 "de": "davon Erträge aus der Währungsumrechnung",466 "in_report": "davon Erträge aus der Währungsumrechnung"467 },468 "value": 571328.55,469 "children": []470 }471 ]472 },473 {474 "name": {475 "de": "Materialaufwand",476 "en": "Material expenses",477 "in_report": "4. Materialaufwand"478 },479 "value": 116509640.56,480 "children": [481 {482 "name": {483 "de": "Aufwendungen für Roh-, Hilfs- und Betriebsstoffe und für bezogene Waren",484 "en": "Expenses for raw materials, supplies, and purchased goods",485 "in_report": "a) Aufwendungen für Roh-, Hilfs- und Betriebsstoffe und für bezogene Waren"486 },487 "value": 1157010.5,488 "children": []489 },490 {491 "name": {492 "de": "Aufwendungen für bezogene Leistungen",493 "en": "Expenses for purchased services",494 "in_report": "b) Aufwendungen für bezogene Leistungen"495 },496 "value": 115352630.06,497 "children": []498 }499 ]500 },501 {502 "name": {503 "de": "Personalaufwand",504 "en": "Personnel expenses",505 "in_report": "5. Personalaufwand"506 },507 "value": 37557386.2,508 "children": [509 {510 "name": {511 "de": "Löhne und Gehälter",512 "en": "Wages and salaries",513 "in_report": "a) Löhne und Gehälter"514 },515 "value": 33140885.29,516 "children": []517 },518 {519 "name": {520 "de": "Soziale Abgaben und Aufwendungen für Altersversorgung und für Unterstützung",521 "en": "Social security contributions and expenses for pensions and support",522 "in_report": "b) soziale Abgaben und Aufwendungen für Altersversorgung und für Unterstützung"523 },524 "value": 4416500.91,525 "children": []526 }527 ]528 },529 {530 "name": {531 "de": "Abschreibungen",532 "en": "Depreciation",533 "in_report": "6. Abschreibungen"534 },535 "value": 129958760.25,536 "children": [537 {538 "name": {539 "de": "Auf immaterielle Vermögensgegenstände des Anlagevermögens und Sachanlagen",540 "en": "On intangible assets and property, plant, and equipment",541 "in_report": "a) auf immaterielle Vermögensgegenstände des Anlagevermögens und Sachanlagen"542 },543 "value": 129958760.25,544 "children": []545 }546 ]547 },548 {549 "name": {550 "de": "Sonstige betriebliche Aufwendungen",551 "en": "Other operating expenses",552 "in_report": "7. sonstige betriebliche Aufwendungen"553 },554 "value": 29380170.42,555 "children": [556 {557 "name": {558 "de": "davon Aufwendungen aus der Währungsumrechnung",559 "in_report": "davon Aufwendungen aus der Währungsumrechnung"560 },561 "value": 669524.55,562 "children": []563 }564 ]565 },566 {567 "name": {568 "de": "Sonstige Zinsen und ähnliche Erträge",569 "en": "Other interest and similar income",570 "in_report": "9. sonstige Zinsen und ähnliche Erträge"571 },572 "value": 5025778.39,573 "children": []574 },575 {576 "name": {577 "de": "Zinsen und ähnliche Aufwendungen",578 "en": "Interest and similar expenses",579 "in_report": "10. Zinsen und ähnliche Aufwendungen"580 },581 "value": 42.37,582 "children": []583 },584 {585 "name": {586 "de": "Steuern vom Einkommen und vom Ertrag",587 "en": "Income and profit taxes",588 "in_report": "11. Steuern vom Einkommen und vom Ertrag"589 },590 "value": 67650181.5,591 "children": []592 },593 {594 "name": {595 "de": "Ergebnis nach Steuern",596 "en": "Result after taxes",597 "in_report": "12. Ergebnis nach Steuern"598 },599 "value": 165011477.67,600 "children": []601 },602 {603 "name": {604 "de": "Sonstige Steuern",605 "en": "Other taxes",606 "in_report": "13. sonstige Steuern"607 },608 "value": 94694.61,609 "children": []610 },611 {612 "name": {613 "de": "Jahresüberschuss/Jahresfehlbetrag",614 "en": "Annual net profit/loss",615 "in_report": "14. Jahresüberschuss"616 },617 "value": 164916783.06,618 "children": []619 },620 {621 "name": {622 "de": "15. Gewinnvortrag aus dem Vorjahr",623 "in_report": "15. Gewinnvortrag aus dem Vorjahr"624 },625 "value": 332187259.01,626 "children": []627 },628 {629 "name": {630 "de": "16. Ausschüttung",631 "in_report": "16. Ausschüttung"632 },633 "value": 220000000,634 "children": []635 },636 {637 "name": {638 "de": "Bilanzgewinn/Bilanzverlust",639 "en": "Balance sheet profit/loss",640 "in_report": "17. Bilanzgewinn"641 },642 "value": 277104042.07,643 "children": []644 }645 ],646 "_provenance": {647 "statement_type": "Jahresabschluss",648 "period_start": "2023-01-01",649 "period_end": "2023-12-31",650 "exempt_subsidiary": false,651 "parent_organization": null652 }653 }654 ],655 "meta": {656 "request_credit_cost": 11,657 "credits_remaining": 145658 }659}
Vergelijkbaar over jaren en bedrijven heen: Alleen
name.in_report is geformuleerd zoals in de jaarrekening. De namen in name.de en name.en normaliseren we over de verschillende verslaggevingsstandaarden heen, zoals HGB en IFRS. Anders zouden dezelfde posten vaak niet vergelijkbaar zijn, noch over de jaren van één bedrijf noch tussen bedrijven. Bedragen, volgorde en structuur nemen we over uit de jaarrekening. Hoe we met de standaarden omgaan, staat in de datacatalogus onder Verslaggevingsstandaarden.
name.de en name.en zijn de uniforme namen. Herkennen we een post niet, dan ontbreekt name.en en herhaalt name.de de formulering uit de jaarrekening. De lijst heet balance_sheet_accounts in de balans en profit_and_loss_accounts in de W&V.
Kleine bedrijven publiceren alleen een verkorte balans en geen W&V. Voor hen blijft profit_and_loss_account leeg en kost het niets.
De balans kost 3 credits, de W&V 3 credits, elk alleen met gegevens. Met Max bevatten beide ook de activiteitenverslagen (Tätigkeitsabschlüsse) volgens § 6b EnWG voor energiebedrijven (activity_statements), zonder meerprijs.
Jaarrekeningen als volledige tekst
De jaarrekening zelf krijg je als tekst: annual_financial_statements levert haar als Markdown, annual_financial_statements__html als HTML. De tekst bevat wat het bedrijf heeft gepubliceerd, zoals balans, W&V, toelichting en bestuursverslag.
Markdown is bedoeld voor AI-agents: het is compacter dan HTML en spaart tokens. De oorspronkelijke jaarrekeningen hebben vaak geen nette structuur. Gangbare Markdown-renderers kunnen de tekst daarom meestal niet zonder nabewerking netjes tonen. Gebruik voor weergave HTML; dat behoudt koppen en tabellen.
Zonder financial_years krijg je de vijf meest recente jaarrekeningen. Een tekst kan erg lang zijn; met financial_years=1 haal je alleen de meest recente op.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: JOUW_API_SLEUTEL" \ --data-urlencode 'q=Ansbach HRB 6089' \ --data-urlencode 'feature=annual_financial_statements' \ --data-urlencode 'financial_years=1'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "JOUW_API_SLEUTEL"}, params={ "q": "Ansbach HRB 6089", "feature": ["annual_financial_statements"], "financial_years": "1", }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-organization"); url.searchParams.append("q", "Ansbach HRB 6089"); url.searchParams.append("feature", "annual_financial_statements"); url.searchParams.append("financial_years", "1"); const response = await fetch(url, { headers: { "x-api-key": "JOUW_API_SLEUTEL" }, }); const data = await response.json();
1{2 "entity_id": "94eb910fef13f94585c48c263fa446d4",3 "name": "Hetzner Online GmbH",4 "annual_financial_statements": [5 {6 "document_type": "Jahresabschluss",7 "document_date": "2025-06-25",8 "document_title": "Jahresabschluss zum Geschäftsjahr vom 01.01.2023 bis zum 31.12.2023",9 "language": "Deutsch",10 "year": 2023,11 "audit": {12 "kind": "AUDIT_REPORT",13 "subject": "OWN",14 "audited": true,15 "accounting_framework": "HGB",16 "auditor": {17 "name": "WP Koehler GmbH Wirtschaftsprüfungsgesellschaft",18 "type": "FIRM",19 "entity_id": null,20 "network": null,21 "signatories": [22 {23 "name": "Reiner Musterwald",24 "academic_title": null,25 "qualification": "WP"26 }27 ]28 },29 "signed": {30 "place": "Seeheim-Jugehein",31 "date": "2024-06-10"32 }33 },34 "document_md": "Firma Information Bezeichnung Hetzner Online GmbH, Gunzenhausen Rechnungslegung / Finanzberichte Unternehmensregister Jahresabschluss zum Geschäftsjahr vom 01.01.2023 bis zum 31.12.2023 Datum: 25.06.2025 Sprache: Deutsch | | | --- | | Hetzner Online GmbHGunzenhausenJahresabschluss zum Geschäftsjahr vom 01.01.2023 bis zum 31.12.2023Lagebericht **1. Grundlagen des Unternehmens** **Geschäftsmodell** Die Hetzner Online GmbH (kurz Hetzner Online) ist seit 1997 als Webhoster und Datacenter-Betreiber "im Internet zu Hause" und zählt zu den etablierten Internetdienstleistern in Europa. Das Unternehmen stellt leistungsstarke Hosting-Produkte sowie die für deren Betrieb nötige Infrastruktur sowohl Privat- wie auch Geschäftskunden zur Verfügung. …"35 }36 ],37 "meta": {38 "request_credit_cost": 10,39 "credits_remaining": 14540 }41}
Elke jaarrekening komt met titel, publicatiedatum (document_date) en boekjaar. audit bevat de accountant, de controleverklaring en de verslaggevingsstandaard. De HTML-variant levert de tekst in document_html in plaats van document_md.
Elk van beide varianten kost 5 credits, alleen met gegevens. Registeruittreksels, aandeelhouderslijsten (Gesellschafterlisten) en statuten krijg je als bestand via fetch-document, zie Documenten downloaden.
Veelgemaakte fouten
- Parameterwaarden:
financial_statement_typeaccepteert alleenauto,annualenconsolidated, in kleine letters. Andere waarden en jaren buiten 1 tot 30 beantwoordt de API met HTTP 422, zonder kosten. - Geconsolideerde jaarrekeningen voor losse bedrijven: Met
consolidatedblijft de feature leeg voor bedrijven zonder geconsolideerde jaarrekening. Gebruik daarautoofannual. - Bedrijven zonder publicatieplicht: Eenmanszaken en personenvennootschappen met een natuurlijke persoon als volledig aansprakelijke vennoot hoeven hun jaarrekening alleen te publiceren als ze zeer groot zijn (Publizitätsgesetz, de Duitse publicatiewet). Voor hen zijn er meestal geen financiële gegevens.