Analyzovat finanční ukazatele
Ukazatele, rozvaha a výkaz zisku a ztráty ze zveřejněných účetních závěrek.
Kapitálové společnosti jako GmbH a AG i GmbH & Co. KG zveřejňují každý rok účetní závěrku. Z ní API vrací ukazatele za každé účetní období, rozvahu a výkaz zisku a ztráty se všemi položkami a plný text závěrek.
Načíst ukazatele
Funkce financial_kpi (Finanční KPI) vrací jeden řádek ukazatelů za každé účetní období, například tržby, hospodářský výsledek, zaměstnance a bilanční sumu. Bez dalšího zadání dostaneš všechny dostupné roky, nejnovější první. Náš ukázkový požadavek načítá tři roky Hetzner Online GmbH, Ansbach HRB 6089.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TVUJ_API_KLIC" \ --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": "TVUJ_API_KLIC"}, 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": "TVUJ_API_KLIC" }, }); 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ždý účet dostane základní ukazatele revenue, net_income, employees, active_total (bilanční suma), material_expenses a personnel_expenses. Pro a Max přidávají přes 90 dalších, například podíl vlastního kapitálu, EBITDA a marže.
Poměrové ukazatele jsou zlomky: equity_ratio 0.75 znamená 75 %. _provenance uvádí závěrku, ze které řádek pochází: její typ a začátek a konec účetního období.
financial_kpi stojí 1 kredit za požadavek, bez ohledu na to, kolik let se vrátí. Pokud nevrátí data, nestojí nic.
Firmy zveřejňují účetní závěrky až dvanáct měsíců po konci účetního období. Nejnovější dostupný rok je proto často předloňský.
Tato čísla čteme automaticky ze zveřejněných závěrek. Používáme k tomu nejnovější technologie a hodně investujeme do kvality; jednotlivé chyby přesto nelze vyloučit. V případě pochybností platí samotná závěrka, kterou si můžeš načíst jako plný text.
Zvolit individuální nebo konsolidovanou závěrku
Velké koncerny zveřejňují vedle závěrky každé firmy i konsolidovanou závěrku za celý koncern. Pomocí financial_statement_type volíš, kterou dostaneš:
| financial_statement_type | Význam |
|---|---|
| auto | Výchozí. Každá funkce volí sama. Odpověď proto může míchat individuální a konsolidovaná čísla. |
| annual | Jen individuální závěrky (Jahresabschluss). |
| consolidated | Jen konsolidované závěrky. |
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TVUJ_API_KLIC" \ --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": "TVUJ_API_KLIC"}, 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": "TVUJ_API_KLIC" }, }); 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 řádku je v _provenance.statement_type: „Jahresabschluss“ (individuální účetní závěrka) nebo „Konzernabschluss“ (konsolidovaná účetní závěrka). S annual nebo consolidated API nepřechází na druhý typ. Pokud taková závěrka neexistuje, funkce zůstane prázdná a nestojí nic.
Porovnat roky
financial_years omezí odpověď na poslední účetní období, od 1 do 30. Platí pro všechny finanční funkce požadavku, včetně rozvahy, výkazu zisku a ztráty a účetních závěrek.
year je kalendářní rok, ve kterém účetní období končí. V příkladu Siemens Aktiengesellschaft, München HRB 6684, trvá od 1. října do 30. září. Řádek 2025 tedy pokrývá 1. října 2024 až 30. září 2025.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TVUJ_API_KLIC" \ --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": "TVUJ_API_KLIC"}, 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": "TVUJ_API_KLIC" }, }); 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}
Pro porovnání napříč roky čti začátek a konec z _provenance.period_start a period_end. Uvidíš tak i zkrácené účetní období, například po změně konce roku.
Rozvaha a výkaz zisku a ztráty podrobně
balance_sheet_accounts (Rozvaha) a profit_and_loss_account (Výkaz zisku a ztráty) vracejí všechny položky závěrky s jednotnými názvy napříč účetními standardy. Každá položka má hodnotu; její podpoložky jsou v children. Příklad ukazuje Hetzner Online GmbH.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TVUJ_API_KLIC" \ --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": "TVUJ_API_KLIC"}, 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": "TVUJ_API_KLIC" }, }); 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}
Srovnatelné napříč roky a firmami: Jen
name.in_report je formulováno jako v závěrce. Názvy v name.de a name.en normalizujeme napříč různými účetními standardy, jako jsou HGB a IFRS. Jinak by stejné položky často nešlo porovnat, ani mezi roky jedné firmy, ani mezi firmami. Částky, pořadí a strukturu přebíráme ze závěrky. Jak se standardy zacházíme, popisuje katalog dat v části Účetní standardy.
name.de a name.en jsou jednotné názvy. Pokud položku nerozpoznáme, name.en chybí a name.de opakuje znění ze závěrky. Seznam se v rozvaze jmenuje balance_sheet_accounts a ve výkazu zisku a ztráty profit_and_loss_accounts.
Malé firmy zveřejňují jen zkrácenou rozvahu a žádný výkaz zisku a ztráty. U nich profit_and_loss_account zůstává prázdné a nestojí nic.
Rozvaha stojí 3 kredity, výkaz zisku a ztráty 3 kredity, každý jen s daty. S tarifem Max obsahují oba navíc výkazy činnosti (Tätigkeitsabschlüsse) podle § 6b EnWG pro energetické podniky (activity_statements), bez příplatku.
Účetní závěrky jako plný text
Samotnou závěrku dostaneš jako text: annual_financial_statements ji vrací jako Markdown, annual_financial_statements__html jako HTML. Text obsahuje to, co firma zveřejnila, například rozvahu, výkaz zisku a ztráty, přílohu a výroční zprávu.
Markdown je určen pro AI agenty: je kompaktnější než HTML a šetří tokeny. Původní závěrky často nemají čistou strukturu. Běžné renderery Markdownu proto text většinou bez úprav čistě nezobrazí. Pro zobrazení použij HTML; zachovává nadpisy a tabulky.
Bez financial_years dostaneš pět nejnovějších závěrek. Text může být velmi dlouhý; s financial_years=1 načteš jen tu nejnovější.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TVUJ_API_KLIC" \ --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": "TVUJ_API_KLIC"}, 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": "TVUJ_API_KLIC" }, }); 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ždá závěrka přichází s názvem, datem zveřejnění (document_date) a účetním obdobím. audit obsahuje auditora, výrok auditora a účetní standard. Varianta HTML vrací text v document_html místo document_md.
Každá z obou variant stojí 5 kreditů, jen s daty. Výpisy z rejstříku, seznamy společníků (Gesellschafterlisten) a společenské smlouvy jsou k dispozici jako soubory přes fetch-document, viz Stáhnout dokumenty.
Časté chyby
- Hodnoty parametrů:
financial_statement_typepřijímá jenauto,annualaconsolidated, malými písmeny. Na jiné hodnoty a roky mimo 1 až 30 API odpoví HTTP 422, bez poplatku. - Konsolidované závěrky u samostatných firem: S
consolidatedzůstane funkce u firem bez konsolidované závěrky prázdná. Použij tamautoneboannual. - Firmy bez povinnosti zveřejňovat: Jednotlivci zapsaní jako kupci a osobní společnosti s fyzickou osobou jako plně ručícím společníkem musí závěrky zveřejňovat jen tehdy, když jsou velmi velké (Publizitätsgesetz, německý zákon o zveřejňování). Finanční data pro ně většinou nejsou.