Analizar KPI financieros
KPI, balance y cuenta de pérdidas y ganancias de las cuentas anuales publicadas.
Las sociedades de capital como GmbH y AG, así como la GmbH & Co. KG, publican sus cuentas anuales cada año. A partir de ellas, la API devuelve KPI por ejercicio, el balance y la cuenta de pérdidas y ganancias con todas sus partidas, y el texto completo de las cuentas.
Obtener KPI
La función financial_kpi (KPI financieros) devuelve una fila de KPI por ejercicio, como facturación, resultado del ejercicio, empleados y total del balance. Sin más indicaciones obtienes todos los años disponibles, el más reciente primero. Nuestra solicitud de ejemplo obtiene tres años de Hetzner Online GmbH, Ansbach HRB 6089.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TU_CLAVE_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": "TU_CLAVE_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": "TU_CLAVE_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}
Toda cuenta obtiene los KPI básicos revenue, net_income, employees, active_total (total del balance), material_expenses y personnel_expenses. Pro y Max añaden más de 90, como ratio de patrimonio neto, EBITDA y márgenes.
Los ratios son fracciones: equity_ratio 0.75 significa 75 %. _provenance nombra las cuentas de las que procede la fila: su tipo y el inicio y fin del ejercicio.
financial_kpi cuesta 1 crédito por solicitud, independientemente de cuántos años se devuelvan. Si no devuelve datos, no cuesta nada.
Las empresas publican sus cuentas anuales hasta doce meses después del cierre del ejercicio. Por eso el año más reciente disponible suele ser el penúltimo.
Leemos estas cifras automáticamente de las cuentas publicadas. Para ello usamos la tecnología más actual e invertimos mucho en calidad; aun así, pueden darse errores puntuales. En caso de duda, vale lo que dicen las propias cuentas, que puedes obtener como texto completo.
Elegir cuentas individuales o consolidadas
Los grandes grupos publican, además de las cuentas de cada empresa, unas cuentas consolidadas para todo el grupo. Con financial_statement_type eliges cuáles obtienes:
| financial_statement_type | Significado |
|---|---|
| auto | Por defecto. Cada función elige por sí misma. Por eso una respuesta puede mezclar cifras individuales y consolidadas. |
| annual | Solo cuentas individuales (Jahresabschluss). |
| consolidated | Solo cuentas consolidadas. |
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TU_CLAVE_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": "TU_CLAVE_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": "TU_CLAVE_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}
El tipo de una fila está en _provenance.statement_type: “Jahresabschluss” (cuentas anuales) o “Konzernabschluss” (cuentas consolidadas). Con annual o consolidated, la API no recurre al otro tipo. Si no existen esas cuentas, la función queda vacía y no cuesta nada.
Comparar años
financial_years limita la respuesta a los ejercicios más recientes, de 1 a 30. Se aplica a todas las funciones financieras de la solicitud, incluidos balance, cuenta de resultados y cuentas anuales.
year es el año natural en el que termina el ejercicio. En el ejemplo de Siemens Aktiengesellschaft, München HRB 6684, va del 1 de octubre al 30 de septiembre. Así, la fila 2025 abarca del 1 de octubre de 2024 al 30 de septiembre de 2025.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TU_CLAVE_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": "TU_CLAVE_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": "TU_CLAVE_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}
Para comparar entre años, lee el inicio y el fin de _provenance.period_start y period_end. Así ves también un ejercicio abreviado, por ejemplo tras un cambio de la fecha de cierre.
Balance y cuenta de resultados en detalle
balance_sheet_accounts (Balance) y profit_and_loss_account (Cuenta de pérdidas y ganancias) devuelven todas las partidas de unas cuentas, con nombres uniformes entre normas contables. Cada partida tiene un valor; sus subpartidas están en children. El ejemplo muestra Hetzner Online GmbH.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TU_CLAVE_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": "TU_CLAVE_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": "TU_CLAVE_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}
Comparables entre años y empresas: Solo
name.in_report está redactado como en las cuentas. Normalizamos los nombres de name.de y name.en entre las distintas normas contables, como HGB e IFRS. De lo contrario, a menudo no se podrían comparar las mismas partidas, ni entre los años de una empresa ni entre empresas. Importes, orden y estructura los tomamos de las cuentas. Cómo tratamos las normas se describe en el catálogo de datos en Normas contables.
name.de y name.en son los nombres uniformes. Si no reconocemos una partida, falta name.en y name.de repite la redacción de las cuentas. La lista se llama balance_sheet_accounts en el balance y profit_and_loss_accounts en la cuenta de resultados.
Las empresas pequeñas solo publican un balance abreviado y ninguna cuenta de resultados. Para ellas, profit_and_loss_account queda vacío y no cuesta nada.
El balance cuesta 3 créditos, la cuenta de resultados 3 créditos, cada uno solo con datos. Con Max, ambos contienen también las cuentas por actividad (Tätigkeitsabschlüsse) según § 6b EnWG de las empresas energéticas (activity_statements), sin coste adicional.
Cuentas anuales como texto completo
Obtienes las propias cuentas como texto: annual_financial_statements las devuelve como Markdown, annual_financial_statements__html como HTML. El texto contiene lo que publicó la empresa, como balance, cuenta de resultados, memoria e informe de gestión.
Markdown está pensado para agentes de IA: es más compacto que HTML y ahorra tokens. Las cuentas originales a menudo no tienen una estructura limpia. Por eso los renderizadores de Markdown habituales no suelen mostrar bien el texto sin retoques. Para mostrarlo, usa HTML; conserva títulos y tablas.
Sin financial_years obtienes las cinco cuentas más recientes. Un texto puede ser muy largo; con financial_years=1 obtienes solo las más recientes.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TU_CLAVE_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": "TU_CLAVE_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": "TU_CLAVE_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}
Cada cuenta anual llega con su título, fecha de publicación (document_date) y ejercicio. audit contiene el auditor, el informe de auditoría y la norma contable. La variante HTML devuelve el texto en document_html en lugar de document_md.
Cada una de las dos variantes cuesta 5 créditos, solo con datos. Los extractos del registro, las listas de socios (Gesellschafterlisten) y los estatutos están disponibles como archivos mediante fetch-document, consulta Descargar documentos.
Errores frecuentes
- Valores de parámetros:
financial_statement_typesolo aceptaauto,annualyconsolidated, en minúsculas. La API responde a otros valores y a años fuera de 1 a 30 con HTTP 422, sin coste. - Cuentas consolidadas para empresas individuales: Con
consolidated, la función queda vacía para empresas sin cuentas consolidadas. Usa ahíautooannual. - Empresas sin obligación de publicar: Los comerciantes individuales y las sociedades de personas con una persona física como socio colectivo solo tienen que publicar sus cuentas cuando son muy grandes (Publizitätsgesetz, la ley alemana de publicidad). Para ellas no suele haber datos financieros.