Analyser les indicateurs financiers

Indicateurs, bilan et compte de résultat issus des comptes annuels publiés.

Les sociétés de capitaux comme la GmbH et l’AG, ainsi que la GmbH & Co. KG, publient leurs comptes annuels chaque année. L’API en tire des indicateurs par exercice, le bilan et le compte de résultat avec tous les postes, ainsi que le texte intégral des comptes.

Récupérer les indicateurs

La fonctionnalité financial_kpi (Indicateurs financiers) renvoie une ligne d’indicateurs par exercice, comme le chiffre d’affaires, le résultat net, les salariés et le total du bilan. Sans autre précision, tu obtiens toutes les années disponibles, la plus récente en premier. Notre requête d’exemple récupère trois années de Hetzner Online GmbH, Ansbach HRB 6089.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: TA_CLE_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": "TA_CLE_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": "TA_CLE_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}

200 · Exemple de réponse : indicateurs financiers de Hetzner Online GmbH sur trois ans, avec Max

Chaque compte obtient les indicateurs de base revenue, net_income, employees, active_total (total du bilan), material_expenses et personnel_expenses. Pro et Max en ajoutent plus de 90, comme le ratio de fonds propres, l’EBITDA et les marges.

Les ratios sont des fractions : equity_ratio 0,75 signifie 75 %. _provenance indique les comptes dont provient la ligne : leur type ainsi que le début et la fin de l’exercice.

financial_kpi coûte 1 crédit par requête, quel que soit le nombre d’années renvoyées. S’il ne renvoie aucune donnée, il ne coûte rien.

Les entreprises publient leurs comptes annuels jusqu’à douze mois après la clôture de l’exercice. La dernière année disponible est donc souvent l’avant-dernière.

Nous lisons ces chiffres automatiquement dans les comptes publiés. Nous utilisons pour cela les technologies les plus récentes et investissons beaucoup dans la qualité ; des erreurs isolées restent possibles. En cas de doute, ce sont les comptes eux-mêmes qui font foi ; tu peux les récupérer en texte intégral.

Choisir comptes individuels ou consolidés

Les grands groupes publient, en plus des comptes de chaque société, des comptes consolidés pour l’ensemble du groupe. Avec financial_statement_type, tu choisis lesquels tu obtiens :

financial_statement_type
financial_statement_type	Signification
auto	Par défaut. Chaque fonctionnalité choisit elle-même. Une réponse peut donc mêler chiffres individuels et consolidés.
annual	Uniquement les comptes individuels (Jahresabschluss).
consolidated	Uniquement les comptes consolidés.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: TA_CLE_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": "TA_CLE_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": "TA_CLE_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}

200 · Exemple de réponse : chiffres consolidés de Deutsche Telekom AG, Bonn HRB 6794 (extrait)

Le type d’une ligne figure dans _provenance.statement_type : « Jahresabschluss » (comptes annuels) ou « Konzernabschluss » (comptes consolidés). Avec annual ou consolidated, l’API ne se rabat pas sur l’autre type. S’il n’existe pas de tels comptes, la fonctionnalité reste vide et ne coûte rien.

Comparer les années

financial_years limite la réponse aux derniers exercices, de 1 à 30. Le paramètre s’applique à toutes les fonctionnalités financières de la requête, y compris bilan, compte de résultat et comptes annuels.

year est l’année civile au cours de laquelle l’exercice se termine. Dans l’exemple de Siemens Aktiengesellschaft, München HRB 6684, il court du 1er octobre au 30 septembre. La ligne 2025 couvre donc la période du 1er octobre 2024 au 30 septembre 2025.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: TA_CLE_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": "TA_CLE_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": "TA_CLE_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}

200 · Exemple de réponse : Siemens Aktiengesellschaft, exercice clos le 30 septembre (extrait)

Pour comparer les années, lis le début et la fin dans _provenance.period_start et period_end. Tu repères ainsi aussi un exercice raccourci, par exemple après un changement de date de clôture.

Bilan et compte de résultat en détail

balance_sheet_accounts (Bilan) et profit_and_loss_account (Compte de résultat) renvoient tous les postes des comptes, avec des noms uniformes quelles que soient les normes comptables. Chaque poste a une valeur ; ses sous-postes figurent dans children. L’exemple montre Hetzner Online GmbH.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: TA_CLE_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": "TA_CLE_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": "TA_CLE_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}

200 · Exemple de réponse : bilan et compte de résultat de Hetzner Online GmbH pour une année (extrait)

Comparable entre années et entreprises : seul name.in_report est formulé comme dans les comptes. Nous normalisons les noms dans name.de et name.en entre les différentes normes comptables, comme HGB et IFRS. Sinon, les mêmes postes ne pourraient souvent pas être comparés, ni entre les années d’une entreprise ni entre entreprises. Les montants, l’ordre et la structure sont repris des comptes. Notre traitement des normes est décrit dans le catalogue de données sous Normes comptables.

name.de et name.en sont les noms uniformes. Si nous ne reconnaissons pas un poste, name.en manque et name.de reprend la formulation des comptes. La liste s’appelle balance_sheet_accounts dans le bilan et profit_and_loss_accounts dans le compte de résultat.

Les petites entreprises ne publient qu’un bilan abrégé et pas de compte de résultat. Pour elles, profit_and_loss_account reste vide et ne coûte rien.

Le bilan coûte 3 crédits, le compte de résultat 3 crédits, chacun uniquement avec des données. Avec Max, les deux contiennent aussi les comptes d’activité (Tätigkeitsabschlüsse) selon le § 6b EnWG des fournisseurs d’énergie (activity_statements), sans supplément.

Comptes annuels en texte intégral

Tu obtiens les comptes eux-mêmes sous forme de texte : annual_financial_statements les renvoie en Markdown, annual_financial_statements__html en HTML. Le texte contient ce que l’entreprise a publié, comme bilan, compte de résultat, annexe et rapport de gestion.

Markdown est destiné aux agents IA : il est plus compact que HTML et économise des tokens. Les comptes d’origine n’ont souvent pas de structure propre. Les moteurs de rendu Markdown courants ne peuvent donc généralement pas afficher le texte proprement sans retouche. Pour l’affichage, utilise HTML ; il conserve titres et tableaux.

Sans financial_years, tu obtiens les cinq derniers comptes. Un texte peut être très long ; avec financial_years=1, tu ne récupères que le plus récent.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: TA_CLE_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": "TA_CLE_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": "TA_CLE_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}

200 · Exemple de réponse : comptes annuels 2023 de Hetzner Online GmbH, texte raccourci

Chaque document de comptes arrive avec son titre, sa date de publication (document_date) et son exercice. audit contient le commissaire aux comptes, l’opinion d’audit et la norme comptable. La variante HTML renvoie le texte dans document_html au lieu de document_md.

Chacune des deux variantes coûte 5 crédits, uniquement avec des données. Les extraits du registre, listes des associés (Gesellschafterlisten) et statuts sont disponibles sous forme de fichiers via fetch-document, voir Télécharger des documents.

Pièges fréquents

Valeurs des paramètres : financial_statement_type n’accepte que auto, annual et consolidated, en minuscules. L’API répond aux autres valeurs et aux années hors de 1 à 30 avec HTTP 422, sans frais.
Comptes consolidés pour des sociétés isolées : avec consolidated, la fonctionnalité reste vide pour les entreprises sans comptes consolidés. Utilise-y auto ou annual.
Entreprises sans obligation de publication : les commerçants individuels et les sociétés de personnes avec une personne physique comme associé indéfiniment responsable ne doivent publier leurs comptes que s’ils sont très grands (Publizitätsgesetz, loi allemande sur la publicité). Il n’y a généralement pas de données financières pour eux.

Ensuite

Données financières Tous les indicateurs et postes avec leur signification. fetch-organization Tous les paramètres et fonctionnalités du profil d’entreprise. Disponibilité des données Quelles entreprises publient quels comptes. Télécharger des documents Extraits du registre, listes des associés et statuts sous forme de fichiers.