How to Get a Handelsregister Extract (AD, CD, SI) Programmatically
germany · handelsregister · kyb · company data · api · 10 min read
Every German company’s register extract is free on handelsregister.de: search the company, then download the AD (current printout) or CD (chronological printout) as a PDF, or the SI (structured register content) as an XML file. There is no official API for the portal. If what you need is the data on the extract (legal form, capital, registered address, managing directors, representation rule) rather than the PDF itself, the practical programmatic route is the SI content parsed into JSON, which is what the Germany Handelsregister Scraper returns. It does not deliver AD, CD or HD PDF files.
This guide explains what each document type contains, how to get them by hand, how to get the SI data as JSON from code, and where a portal download is not enough.
The document types on handelsregister.de
The Handelsregister is kept by the register courts (Amtsgerichte) and published through the joint register portal of the federal states. It covers commercial companies and partnerships (HRA and HRB), and the portal also serves the cooperative (GnR), partnership (PR), association (VR) and civil-law partnership (GsR) registers. Since 1 August 2022, under the DiRUG reform, viewing and downloading register content is free and needs no registration.
Each search hit lists a row of document links. What they mean:
| Code | German name | What you get |
|---|---|---|
| AD | Aktueller Abdruck | Current printout: the entries in force today, as a PDF. This is what most people mean by “Handelsregisterauszug”. |
| CD | Chronologischer Abdruck | Chronological printout: all entries since the register sheet was opened, including ones that are no longer current. PDF. |
| HD | Historischer Abdruck | Historical printout from the older register sheets. Not every company has one. |
| DK | Dokumentenansicht | The documents filed with the court: articles of association, shareholder lists (Gesellschafterliste), notarial deeds, and more. |
| UT | Unternehmensträgerdaten | Basic data on the legal entity. |
| VÖ | Veröffentlichungen | Register announcements. |
| SI | Strukturierter Registerinhalt | The register content as a machine-readable XML file in the XJustiz format. |
So the answer to “which one do I need” depends on who will read it:
- A human reviewer, an auditor’s file, or a counterparty asking “send us your Handelsregisterauszug”: the AD, sometimes the CD.
- Software, a KYB pipeline, a CRM enrichment job, or an AI agent: the SI, because it is structured data and the PDFs are not.
- The shareholder structure of a GmbH: the shareholder list under DK. It is not part of the AD or the SI.
The manual way
- Go to handelsregister.de and open the normal search (Normale Suche).
- Enter the company name as keywords (Schlagwörter). The portal accepts at most five keywords. Legal forms such as GmbH or AG and the words “und” and “mit” do not count toward the limit, while words such as “der”, “für” and “von” do. You can narrow by register type, number, court or federal state.
- In the results list, find the right row. The register number is only unique within its court, so check the court as well:
HRB 215511 Bat Amtsgericht Charlottenburg is one company, and the same number at another court is a different one. - Click AD, CD or SI to download the document.
For one company, this takes a few minutes and costs nothing. Where it stops scaling:
- Each company is a separate search and download. There is no bulk export and no list upload.
- The PDFs are documents, not data. To get the managing directors into a system you read the AD and type them in, or you build a PDF parser and maintain it.
- The SI is data, but you have to parse it. XJustiz is a large XML standard with nested structures and coded values: legal forms, roles and register types appear as code-list entries that you have to map to labels.
- There is no change notification. To learn that a managing director was replaced, you download again and compare.
The automated way: SI as JSON
The Germany Handelsregister Scraper on the Apify Store searches the portal by company name (optionally with a register number), opens each matching company’s structured register content, and returns one JSON record per company. You need an Apify account; there is nothing to configure on the register side. The field list is also on our Handelsregister registry page, and the Germany coverage page lists the German registers we cover.
The actor returns the content of the SI document as fields. It does not download or store the AD, CD, HD PDFs, the filed documents under DK, or the shareholder list. If you need the PDF file itself, take it from the portal.
Input
One specific company:
{
"searchQuery": "Connected Retail",
"registerNumber": "HRB 215511 B",
"maxResults": 1
}
A keyword search returning up to 30 matches:
{
"searchQuery": "BioNTech",
"exactMatch": false,
"maxResults": 30
}
| Field | What it does |
|---|---|
searchQuery | Company name or keywords. Same five-keyword rule as the portal. Send the name only, not a website title or slogan. |
exactMatch | Match the exact company name instead of keyword containment. You can end a long name early with *. |
registerNumber | Narrows the search. "215511" or "HRB 215511 B" both work. It has to be combined with searchQuery, because the portal does not allow number-only searches. |
maxResults | 1-30 companies from the first results page. Default 10. |
onlyNew | Monitor mode: later runs of the same search return only new or changed companies. |
monitorKey | Optional label for a monitor’s memory, e.g. supplier-acme. |
Output
A record, with the officer’s personal data masked:
{
"companyName": "Connected Retail GmbH",
"legalForm": "Gesellschaft mit beschränkter Haftung",
"legalFormCode": "221110",
"registerCourt": "Amtsgericht Charlottenburg",
"registerType": "HRB",
"registerNumber": "HRB 215511 B",
"euid": "DEF1103R.HRB215511B",
"status": "aktuell",
"seat": "Berlin",
"address": {
"street": "Valeska-Gert-Straße",
"houseNumber": "5",
"postalCode": "10243",
"city": "Berlin",
"formatted": "Valeska-Gert-Straße 5, 10243 Berlin"
},
"capital": { "amount": 30000, "currency": "EUR" },
"officers": [
{
"name": "…",
"firstName": "…",
"lastName": "…",
"dateOfBirth": "…",
"city": "…",
"roleCode": "086",
"role": "Geschäftsführer"
}
],
"representationRule": "Ist ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere ...",
"businessPurpose": "Die Erbringung von Vertriebsdienstleistungen für Einzelhändler ...",
"structuredData": true,
"sourceUrl": "https://www.handelsregister.de",
"scrapedAt": "2026-06-09T19:04:27.810Z"
}
How the fields map to what you would read on an AD:
companyName,legalForm,seat,address- the company’s name, legal form, registered seat and business address.legalFormCodeis the raw code from the register’s code list, kept next to the German label.registerCourt,registerType,registerNumber- together, the company’s identifier in Germany. Store all three.euid- the European Unique Identifier, used to identify the company across EU business registers.capital- share capital (Stammkapital for a GmbH, Grundkapital for an AG) as amount and currency.officers- the registered representatives (managing directors, board members, authorised officers depending on the legal form) with name, date of birth, city and role, plus the rawroleCode.representationRule- the general rule of representation: whether one officer can sign alone or two must act jointly. Read it together withofficersbefore accepting a signature.businessPurpose- the object of the company (Gegenstand des Unternehmens).registrationHistory- the registration texts carried in the structured content. Useful context, but not a replacement for the CD if you need the full chronological record.status-aktuellfor a current entry,gelöschtfor a company removed from the register.structuredData-truewhen the SI content was read. When it isfalse, the record carries only core identity (name, court, number, status) andstructuredDataErrorsays why.
Code
JavaScript with apify-client:
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('regdata/germany-handelsregister-scraper').call({
searchQuery: 'Zalando SE',
exactMatch: true,
maxResults: 5,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
for (const c of items) {
console.log(c.companyName, c.registerCourt, c.registerNumber, c.legalForm, c.capital);
for (const o of c.officers) console.log(' ', o.role, o.lastName);
}
Python with apify-client:
import os
from apify_client import ApifyClient
client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("regdata/germany-handelsregister-scraper").call(
run_input={"searchQuery": "BioNTech", "exactMatch": True, "maxResults": 5}
)
for c in client.dataset(run["defaultDatasetId"]).iterate_items():
if not c.get("structuredData"):
print("identity only, re-run later:", c["companyName"], c.get("structuredDataError"))
continue
print(c["companyName"], c["registerNumber"], c["legalForm"], c["capital"])
Datasets export as JSON, CSV, Excel or XML from the Apify console or API.
A worked workflow: verifying a signatory at onboarding
A common reason to pull an extract is to check that the person signing a contract may bind the company. The steps:
- Collect the company name, register court and register number at sign-up. Most German companies print them in their website imprint (Impressum).
- Look up the company with
searchQueryset to the legal name,registerNumberset to the number, andmaxResults: 1. - Match the returned
registerCourtto the court the customer gave you. Same number at a different court means a different company. - Check status.
statusmust beaktuell. Agelöschtentry is a company that no longer exists in the register. - Check the signatory. Find the signer in
officersand readrepresentationRule. If two managing directors must act jointly and only one signed, ask for the second signature. - Record the evidence. Store the JSON with
scrapedAtandsourceUrl. If your policy requires a document, download the AD for the same company from the portal and attach it. - Watch for changes. Save the lookup as an Apify task with
exactMatch: trueandonlyNew: trueand schedule it weekly. The first run records the company. Later runs return the company only when its status, name, seat, share capital or officers changed, withchangeType,changedFieldsandpreviousValueson the row. A run with nothing new ends with an empty dataset. The monitor’s memory sits in a key-value store in your own Apify account.
To add an insolvency check, take the same company name and run it through the Germany Insolvency Register Search, then match its registerCourt and registerNumber back to this record. The scheduled task can feed n8n, Make, Zapier or a webhook through Apify’s integrations.
Limits and gotchas
The actor’s JSON is not a certified extract. Neither is a PDF downloaded from the portal. If a bank, notary or foreign authority asks for a certified extract (beglaubigter Handelsregisterauszug), order it from the register court or through a notary.
No PDFs, no filed documents. AD, CD, HD, DK, UT and VÖ files are not returned. Shareholder lists, articles of association and deeds are only on the portal under DK.
One company or one search per run. The input takes a single searchQuery. Checking 50 named suppliers means 50 runs. A keyword search returns up to 30 companies from the first results page.
Identity-only records. The register does not always serve the structured document. Some entries show as “Abruf nicht möglich” on the portal while documents are temporarily unavailable. In that case the record has structuredData: false with core identity only. Re-run it later. In monitor mode, capital and officers are not compared on such a run, so missing data is never reported as a change.
Keyword rules are the portal’s. More than five counted keywords, or a query made only of legal forms or single letters such as “K&F”, is refused before a run starts. Send the legal name, not a website title.
Register numbers repeat across courts. HRB 12345 exists at many Amtsgerichte. Always key on court plus type plus number, or on euid.
What the Handelsregister does not contain. Beneficial owners are in the Transparenzregister, which is not open to everyone. Annual accounts are filed with the Unternehmensregister. Insolvency proceedings are published on the insolvency portal. Personal data of officers is published by law, but you still process it under the GDPR.
Pricing
The actor is pay per event: from $0.0072 per company record returned, plus $0.025 per run start. A single-company lookup costs about $0.03; a search returning 30 companies costs about $0.24. A search that finds nothing costs only the start fee. Current prices by plan are on the Store page.
FAQ
Is a Handelsregister extract free?
Yes. Since 1 August 2022, viewing and downloading AD, CD, SI and the filed documents on handelsregister.de is free and needs no login. Certified extracts from the court are a separate service.
What is the difference between AD and CD?
The AD shows the entries in force today. The CD shows every entry since the register sheet was opened, including former directors, old addresses and earlier capital amounts.
Does handelsregister.de have an API?
The portal does not offer a general API for automated lookups. The SI download is the official machine-readable format, and the actor returns its content as JSON.
Can I get the AD as a PDF through the actor?
No. The actor returns the SI data as JSON fields. Download the PDF from the portal if you need the document itself.
Where do I find the shareholders of a GmbH?
In the shareholder list (Gesellschafterliste) filed under DK on the portal. It is not part of the AD, the SI or the actor’s output.
Can I search by HRB number alone?
No. The portal requires a name or keyword, and the number only narrows the search. Pass both searchQuery and registerNumber.
Turn this into working data. Browse the registries and use cases, or start free on Apify.