Analizează KPI‑urile financiare
KPI‑uri, bilanț și cont de profit și pierdere din situațiile financiare anuale publicate.
Societățile de capital precum GmbH și AG, precum și GmbH & Co. KG, își publică anual situațiile financiare. Din acestea, API-ul returnează KPI‑uri pe exercițiu financiar, bilanțul și contul de profit și pierdere cu toate pozițiile, precum și textul integral al situațiilor.
Preia KPI‑urile
Funcția financial_kpi (Indicatori financiari) returnează un rând de KPI‑uri pe exercițiu financiar, de ex. cifra de afaceri, profitul net, angajații și totalul activelor. Fără alte date de intrare primești toți anii disponibili, cel mai recent primul. Cererea noastră exemplu preia trei ani ai Hetzner Online GmbH, Ansbach HRB 6089.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: CHEIA_TA_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": "CHEIA_TA_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": "CHEIA_TA_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}
Fiecare cont primește KPI‑urile de bază revenue, net_income, employees, active_total (totalul activelor), material_expenses și personnel_expenses. Pro și Max adaugă peste 90 în plus, de ex. rata capitalurilor proprii, EBITDA și marje.
Rapoartele sunt fracții: equity_ratio 0.75 înseamnă 75%. _provenance numește situația din care provine rândul: tipul ei, începutul și sfârșitul exercițiului financiar.
financial_kpi costă 1 credit per cerere, indiferent câți ani vin înapoi. Dacă nu returnează date, nu costă nimic.
Companiile își publică situațiile financiare anuale până la douăsprezece luni după încheierea exercițiului financiar. Cel mai recent an disponibil este de aceea adesea cel de dinainte de anul trecut.
Citim aceste cifre automat din situațiile publicate. Folosim pentru asta cea mai nouă tehnologie și investim mult în calitate; erori izolate sunt totuși posibile. În caz de îndoială contează situația însăși, pe care o poți prelua ca text integral.
Alege situații individuale sau consolidate
Grupurile mari publică, pe lângă situația fiecărei companii, o situație consolidată pentru întregul grup. Cu financial_statement_type alegi pe care o primești:
| financial_statement_type | Semnificație |
|---|---|
| auto | Implicit. Fiecare funcție alege singură. Un răspuns poate deci amesteca cifre individuale și consolidate. |
| annual | Doar situații individuale (Jahresabschluss). |
| consolidated | Doar situații consolidate. |
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: CHEIA_TA_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": "CHEIA_TA_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": "CHEIA_TA_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}
Tipul unui rând se află în _provenance.statement_type: „Jahresabschluss” (situație financiară anuală) sau „Konzernabschluss” (situație financiară consolidată). Cu annual sau consolidated, API-ul nu trece la celălalt tip. Dacă nu există o astfel de situație, funcția rămâne goală și nu costă nimic.
Compară anii
financial_years limitează răspunsul la cele mai recente exerciții financiare, de la 1 la 30. Se aplică tuturor funcțiilor financiare ale cererii, inclusiv bilanț, cont de profit și pierdere și situații anuale.
year este anul calendaristic în care se încheie exercițiul financiar. În exemplul Siemens Aktiengesellschaft, München HRB 6684, acesta durează de la 1 octombrie la 30 septembrie. Rândul 2025 acoperă deci 1 octombrie 2024 – 30 septembrie 2025.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: CHEIA_TA_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": "CHEIA_TA_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": "CHEIA_TA_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}
Ca să compari între ani, citește începutul și sfârșitul din _provenance.period_start și period_end. Așa vezi și un exercițiu financiar scurtat, de exemplu după schimbarea datei de închidere.
Bilanțul și contul de profit și pierdere în detaliu
balance_sheet_accounts (Bilanț) și profit_and_loss_account (Cont de profit și pierdere) returnează toate pozițiile unei situații, cu denumiri unitare între standardele contabile. Fiecare poziție are o valoare; subpozițiile sale se află în children. Exemplul arată Hetzner Online GmbH.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: CHEIA_TA_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": "CHEIA_TA_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": "CHEIA_TA_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}
Comparabil între ani și companii: Doar
name.in_report e formulat ca în situație. Denumirile din name.de și name.en le normalizăm între diferitele standarde contabile, de ex. HGB și IFRS. Altfel aceleași poziții adesea nu ar putea fi comparate, nici între anii unei companii, nici între companii. Sumele, ordinea și structura le preluăm din situație. Cum tratăm standardele afli în catalogul de date la Standarde contabile.
name.de și name.en sunt denumirile unitare. Dacă nu recunoaștem o poziție, name.en lipsește, iar name.de repetă formularea din situație. Lista se numește balance_sheet_accounts în bilanț și profit_and_loss_accounts în contul de profit și pierdere.
Companiile mici publică doar un bilanț prescurtat și niciun cont de profit și pierdere. Pentru ele, profit_and_loss_account rămâne gol și nu costă nimic.
Bilanțul costă 3 credite, contul de profit și pierdere 3 credite, fiecare doar cu date. Cu Max, ambele conțin și situațiile de activitate (Tätigkeitsabschlüsse) conform § 6b EnWG pentru furnizorii de energie (activity_statements), fără cost suplimentar.
Situațiile anuale ca text integral
Situația însăși o primești ca text: annual_financial_statements o returnează ca Markdown, annual_financial_statements__html ca HTML. Textul conține ce a publicat compania, de ex. bilanț, cont de profit și pierdere, anexă și raport de gestiune.
Markdown este gândit pentru agenți AI: e mai compact decât HTML și economisește tokeni. Situațiile originale adesea nu au o structură curată. Rendererele Markdown obișnuite nu pot de aceea afișa de regulă textul curat fără prelucrare. Pentru afișare folosește HTML; păstrează titlurile și tabelele.
Fără financial_years primești cele mai recente cinci situații. Un text poate fi foarte lung; cu financial_years=1 preiei doar pe cea mai recentă.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: CHEIA_TA_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": "CHEIA_TA_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": "CHEIA_TA_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}
Fiecare situație vine cu titlul, data publicării (document_date) și exercițiul financiar. audit conține auditorul, opinia de audit și standardul contabil. Varianta HTML returnează textul în document_html în loc de document_md.
Fiecare dintre cele două variante costă 5 credite, doar cu date. Extrasele din registru, listele asociaților (Gesellschafterlisten) și actele constitutive sunt disponibile ca fișiere prin fetch-document, vezi Descarcă documente.
Capcane frecvente
- Valorile parametrilor:
financial_statement_typeacceptă doarauto,annualșiconsolidated, cu litere mici. La alte valori și la ani în afara intervalului 1 – 30, API-ul răspunde cu HTTP 422, fără cost. - Situații consolidate pentru companii individuale: Cu
consolidated, funcția rămâne goală pentru companiile fără situație consolidată. Folosește acoloautosauannual. - Companii fără obligație de publicare: Comercianții individuali și societățile de persoane cu o persoană fizică drept asociat cu răspundere nelimitată trebuie să își publice situațiile doar când sunt foarte mari (Publizitätsgesetz, legea germană privind publicitatea). Pentru ele de obicei nu există date financiare.