curl -H 'X-API-KEY: YOUR_API_KEY' \
"https://handelsregister.ai/api/v1/fetch-organization?q=d3d4ffce1d458d458a525e2e8cd27757&features=history"
# pip install handelsregister
from handelsregister import Handelsregister
client = Handelsregister(api_key="YOUR_API_KEY") # or set HANDELSREGISTER_API_KEY
organization = client.fetch_organization(
q="d3d4ffce1d458d458a525e2e8cd27757",
features=[
"history",
],
)
print(organization["name"])
// npm install handelsregister
import { Handelsregister } from 'handelsregister';
const client = new Handelsregister('YOUR_API_KEY'); // or set HANDELSREGISTER_API_KEY
const organization = await client.fetchOrganization({
q: 'd3d4ffce1d458d458a525e2e8cd27757',
features: [
'history',
],
});
console.log(organization.name);
// npm install handelsregister
const { Handelsregister } = require('handelsregister');
const client = new Handelsregister(process.env.HANDELSREGISTER_API_KEY);
(async () => {
const organization = await client.fetchOrganization({
q: 'd3d4ffce1d458d458a525e2e8cd27757',
features: [
'history',
],
});
console.log(organization.name);
})();
{
"entity_id": "<32-char hex>",
"name": "<string>",
"status": "<enum: ACTIVE | INACTIVE>",
"legal_form": "<string>",
"address": {
"house_number": null,
"street": null,
"postal_code": "<string>",
"city": "<string>",
"county": "<string>",
"state": "<string>",
"country": "<ISO country>",
"coordinates": null
},
"registration": {
"court": "<string>",
"register_type": "<string>",
"register_number": "<string>"
},
"registration_date": "<ISO date>",
"purpose": null,
"keywords": [],
"products_and_services": [],
"contact_data": {
"website": null,
"phone_number": null,
"email": null
},
"industry_classification": {
"redacted": "<bool>"
},
"shareholdings": null,
"financial_kpi": [],
"annual_financial_statements__html": [],
"related_persons": null,
"ubos": null,
"balance_sheet_accounts": [],
"profit_and_loss_account": [],
"shareholders": null,
"history": [
{
"entity_type": "<string>",
"name": {
"en": "<string>",
"de": "<string>"
},
"description": {
"short": {
"en": "<string>",
"de": "<string>"
}
},
"start_date": "<ISO date>",
"details": {
"value": {
"entity_type": "<string>",
"coordinate": null,
"formatted_address": "<string>"
},
"linked_entities": {
"organization": {
"name": "<string>"
}
}
}
}
]
}
Base fields
entity_id
string
Stable handelsregister.ai identifier (32-char hex string).
name
string
Registered legal name of the entity.
status
enum
ACTIVE or INACTIVE.
legal_form
string
Legal form (GmbH, AG, KG, …) when available.
address
object
Postal address with street, house_number, postal_code, city, county, state, country and coordinates.
registration
object
Register record with court, register_type and register_number.
registration_date
date
Initial entry into the commercial register (ISO date).
purpose
string
Stated business purpose (Unternehmensgegenstand).
contact_data
object
website, phone_number and email when available.
industry_classification
object
Industry codes per WZ2008 and WZ2025 with labels.
keywords
array<string>
Keywords derived from the business purpose.
products_and_services
array<string>
Product and service descriptions when available.
history
array<object>
Chronological log of all register changes (name, seat, capital, representation, …).
features=financial_kpi
financial_kpi
array<object>
Per fiscal year: revenue, employees, active_total (balance-sheet total), net_income, material_expenses, personnel_expenses.
features=balance_sheet_accounts
balance_sheet_accounts
array<object>
Per fiscal year: hierarchical balance-sheet line items from the published annual statement.
features=profit_and_loss_account
profit_and_loss_account
array<object>
Per fiscal year: hierarchical profit-and-loss line items.
features=related_persons
related_persons
object
Authorized representatives: { current: [...], past: [...] } — managing directors, board members, signatories.
features=shareholders
shareholders
object
Shareholders: { total_capital, entries: [...] }. Each entry carries shareholder, contribution, contribution_ratio and role. total_capital, contribution and contribution_ratio may be null (e.g. for partnerships).
features=ubos
ubos
object
Ultimate beneficial owners: { beneficial_owners, unresolved_beneficial_owners, coverage } as recorded in the transparency register.
features=shareholdings
shareholdings
object
Stakes this entity holds in others: { holdings: { current: [...] }, summary }. Each holding links another organization by entity_id.
features=publications
publications
array<object>
Official commercial-register publications (date, title, full text).
features=annual_financial_statements__html
annual_financial_statements__html
array<object>
Published annual statements with document_html (rendered HTML), document_type, document_title, document_date, language and year.