Analizuj KPI finansowe
KPI, bilans i rachunek zysków i strat z opublikowanych sprawozdań finansowych.
Spółki kapitałowe, takie jak GmbH i AG, a także GmbH & Co. KG, co roku publikują sprawozdania finansowe. Z nich API zwraca KPI za każdy rok obrotowy, bilans oraz rachunek zysków i strat ze wszystkimi pozycjami i pełny tekst sprawozdań.
Pobierz KPI
Feature financial_kpi (Wskaźniki finansowe) zwraca jeden wiersz KPI na rok obrotowy, np. przychody, wynik netto, pracowników i sumę bilansową. Bez dalszych danych dostajesz wszystkie dostępne lata, najnowsze najpierw. Nasze przykładowe zapytanie pobiera trzy lata Hetzner Online GmbH, Ansbach HRB 6089.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TWOJ_KLUCZ_API" \ --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": "TWOJ_KLUCZ_API"}, 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": "TWOJ_KLUCZ_API" }, }); 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}
Każde konto dostaje podstawowe KPI revenue, net_income, employees, active_total (suma bilansowa), material_expenses i personnel_expenses. Pro i Max dodają ponad 90 kolejnych, np. wskaźnik kapitału własnego, EBITDA i marże.
Wskaźniki to ułamki: equity_ratio 0.75 oznacza 75%. _provenance wskazuje sprawozdanie, z którego pochodzi wiersz: jego typ oraz początek i koniec roku obrotowego.
financial_kpi kosztuje 1 kredyt za zapytanie, niezależnie od liczby zwróconych lat. Jeśli nie zwraca danych, nic nie kosztuje.
Firmy publikują sprawozdania finansowe do dwunastu miesięcy po końcu roku obrotowego. Najnowszy dostępny rok to więc często rok przedostatni.
Te liczby odczytujemy automatycznie z opublikowanych sprawozdań. Używamy do tego najnowszej technologii i dużo inwestujemy w jakość; pojedyncze błędy są jednak możliwe. W razie wątpliwości liczy się samo sprawozdanie, które możesz pobrać jako pełny tekst.
Wybierz sprawozdanie jednostkowe lub skonsolidowane
Duże grupy oprócz sprawozdania każdej spółki publikują sprawozdanie skonsolidowane dla całej grupy. Przez financial_statement_type wybierasz, które dostajesz:
| financial_statement_type | Znaczenie |
|---|---|
| auto | Domyślnie. Każdy feature wybiera sam. Odpowiedź może więc mieszać liczby jednostkowe i skonsolidowane. |
| annual | Tylko sprawozdania jednostkowe (Jahresabschluss). |
| consolidated | Tylko sprawozdania skonsolidowane. |
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TWOJ_KLUCZ_API" \ --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": "TWOJ_KLUCZ_API"}, 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": "TWOJ_KLUCZ_API" }, }); 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}
Typ wiersza jest w _provenance.statement_type: „Jahresabschluss” (sprawozdanie jednostkowe) lub „Konzernabschluss” (sprawozdanie skonsolidowane). Przy annual lub consolidated API nie przechodzi na drugi typ. Jeśli takiego sprawozdania nie ma, feature pozostaje pusty i nic nie kosztuje.
Porównaj lata
financial_years ogranicza odpowiedź do ostatnich lat obrotowych, od 1 do 30. Dotyczy wszystkich features finansowych zapytania, także bilansu, rachunku zysków i strat oraz sprawozdań.
year to rok kalendarzowy, w którym kończy się rok obrotowy. W przykładzie Siemens Aktiengesellschaft, München HRB 6684, trwa on od 1 października do 30 września. Wiersz 2025 obejmuje więc okres od 1 października 2024 do 30 września 2025.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TWOJ_KLUCZ_API" \ --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": "TWOJ_KLUCZ_API"}, 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": "TWOJ_KLUCZ_API" }, }); 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}
Aby porównywać lata, odczytuj początek i koniec z _provenance.period_start i period_end. Tak zobaczysz też skrócony rok obrotowy, np. po zmianie dnia bilansowego.
Bilans i rachunek zysków i strat w szczegółach
balance_sheet_accounts (Bilans) i profit_and_loss_account (Rachunek zysków i strat) zwracają wszystkie pozycje sprawozdania, z jednolitymi nazwami niezależnie od standardu rachunkowości. Każda pozycja ma wartość; jej podpozycje są w children. Przykład pokazuje Hetzner Online GmbH.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TWOJ_KLUCZ_API" \ --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": "TWOJ_KLUCZ_API"}, 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": "TWOJ_KLUCZ_API" }, }); 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}
Porównywalne między latami i firmami: tylko
name.in_report brzmi jak w sprawozdaniu. Nazwy w name.de i name.en normalizujemy w różnych standardach rachunkowości, takich jak HGB i IFRS. Inaczej tych samych pozycji często nie dałoby się porównać, ani między latami jednej firmy, ani między firmami. Kwoty, kolejność i strukturę przejmujemy ze sprawozdania. Jak traktujemy standardy, opisuje katalog danych w Standardach rachunkowości.
name.de i name.en to jednolite nazwy. Jeśli nie rozpoznamy pozycji, brakuje name.en, a name.de powtarza brzmienie ze sprawozdania. Lista nazywa się balance_sheet_accounts w bilansie i profit_and_loss_accounts w rachunku zysków i strat.
Małe firmy publikują tylko skrócony bilans i brak rachunku zysków i strat. U nich profit_and_loss_account pozostaje pusty i nic nie kosztuje.
Bilans kosztuje 3 kredyty, rachunek zysków i strat 3 kredyty, każdy tylko z danymi. W Max oba zawierają też sprawozdania z działalności (Tätigkeitsabschlüsse) według § 6b EnWG dla przedsiębiorstw energetycznych (activity_statements), bez dopłaty.
Sprawozdania finansowe jako pełny tekst
Samo sprawozdanie dostajesz jako tekst: annual_financial_statements zwraca je jako Markdown, annual_financial_statements__html jako HTML. Tekst zawiera to, co firma opublikowała, np. bilans, rachunek zysków i strat, informację dodatkową i sprawozdanie z działalności.
Markdown jest przeznaczony dla agentów AI: jest bardziej zwarty niż HTML i oszczędza tokeny. Oryginalne sprawozdania często nie mają czystej struktury. Popularne renderery Markdown zwykle nie wyświetlą więc tekstu czysto bez obróbki. Do wyświetlania używaj HTML; zachowuje nagłówki i tabele.
Bez financial_years dostajesz pięć najnowszych sprawozdań. Tekst może być bardzo długi; z financial_years=1 pobierasz tylko najnowszy.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TWOJ_KLUCZ_API" \ --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": "TWOJ_KLUCZ_API"}, 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": "TWOJ_KLUCZ_API" }, }); 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}
Każde sprawozdanie przychodzi z tytułem, datą publikacji (document_date) i rokiem obrotowym. audit zawiera biegłego rewidenta, opinię z badania i standard rachunkowości. Wariant HTML zwraca tekst w document_html zamiast document_md.
Każdy z dwóch wariantów kosztuje 5 kredytów, tylko z danymi. Odpisy z rejestru, listy wspólników (Gesellschafterlisten) i umowy spółki są dostępne jako pliki przez fetch-document, zobacz Pobieraj dokumenty.
Częste pułapki
- Wartości parametrów:
financial_statement_typeprzyjmuje tylkoauto,annualiconsolidated, małymi literami. Na inne wartości i lata spoza zakresu od 1 do 30 API odpowiada HTTP 422, bezpłatnie. - Sprawozdania skonsolidowane dla pojedynczych firm: przy
consolidatedfeature pozostaje pusty dla firm bez sprawozdania skonsolidowanego. Użyj tamautolubannual. - Firmy bez obowiązku publikacji: jednoosobowi przedsiębiorcy i spółki osobowe z osobą fizyczną jako wspólnikiem odpowiadającym osobiście muszą publikować sprawozdania tylko wtedy, gdy są bardzo duże (Publizitätsgesetz, niemiecka ustawa o obowiązkach informacyjnych). Danych finansowych zwykle dla nich nie ma.