# Handelsregister Scraper & API: German Company Register | $7/1K (`epicscrapers/handelsregister-scraper`) Actor

Search the German Handelsregister by name, HRB number or filters and get the official register data: managing directors with birth date, Prokura, shareholders, share capital, address, business purpose, founding date and name history. No 100-result cap. From $5 per 1,000 companies.

- **URL**: https://apify.com/epicscrapers/handelsregister-scraper.md
- **Developed by:** [Epic Scrapers](https://apify.com/epicscrapers) (community)
- **Categories:** Lead generation, Developer tools, Automation
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 company with register details

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

![Handelsregister Scraper: ein Registerblatt (HRB 215511 B) wird zu JSON mit Geschäftsführern, Prokura und Stammkapital, ab 5 $ pro 1.000 Firmen](https://api.apify.com/v2/key-value-stores/P7NFD43ebd1nhBjmW/records/banner.png)

> 🇬🇧 **English:** [read the English version below](#english-version) (German company register API, managing directors, HRB numbers).

### Handelsregister Scraper und API: Firmendaten, Geschäftsführer und HRB-Nummern aus dem Handelsregister

Der Handelsregister Scraper durchsucht das Gemeinsame Registerportal der Länder (handelsregister.de) und liefert für jede gefundene Firma den **strukturierten Registerinhalt (SI)**, also die amtlichen Daten des Registergerichts, als Tabelle oder JSON. Sie suchen wie im Portal nach Firmenname, HRB-Nummer, Ort, Rechtsform oder Bundesland und erhalten pro Firma eine Zeile mit Geschäftsführern, Prokuristen, Gesellschaftern, Stammkapital, Anschrift, Unternehmensgegenstand und Namenshistorie.

- **Amtliche Daten statt Schätzungen.** Jede Zeile stammt aus dem XJustiz-Dokument "SI – Strukturierter Registerinhalt", das das Registergericht selbst ausgibt. Kein Abschreiben aus Drittquellen, keine geschätzten Werte.
- **Geschäftsführer und Vertretungsbefugnis.** Alle eingetragenen Personen und Firmen mit Rolle (Geschäftsführer, Vorstand, Prokurist, Komplementär, Kommanditist mit Hafteinlage, Inhaber, Liquidator), Geburtsdatum, Wohnort und Vertretungsregel.
- **Mehr als 100 Treffer.** Das Portal zeigt höchstens 100 Treffer pro Suche. Der Scraper teilt größere Suchen automatisch nach Bundesland, Registergericht, Registerart und Straße auf und führt die Ergebnisse ohne Dubletten zusammen.
- **HRB-Nummer, EUID oder Name.** `HRB 215511 B Berlin`, `Amtsgericht München HRB 12345`, `DEF1103R.HRB215511B` oder einfach `Zalando` funktionieren als Suchbegriff.
- **Bezahlung pro Firma, kein Abo.** 7 $ pro 1.000 Firmen mit Registerdaten (ab 5 $ in höheren Apify-Tarifen), 2 $ pro 1.000 Firmen nur mit Trefferlisten-Daten. Export als Excel, CSV, JSON oder per API.

### Wofür wird der Handelsregister Scraper genutzt?

| Ziel                                         | So geht's                                                                                                              |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Firmenliste für den B2B-Vertrieb             | Rechtsform `GmbH`, Bundesland und Ort wählen, Geschäftsführer mit Wohnort exportieren.                                 |
| HRB-Nummern prüfen und Stammdaten anreichern | Eine Liste von HRB-Nummern oder Firmennamen einfügen und Anschrift, Rechtsform, Kapital und Status abgleichen.         |
| Know Your Customer (KYC) und Compliance      | Vertretungsbefugnis, Prokura, Gesellschafter und Registerhinweise (z. B. Verschmelzung, Insolvenz) einer Firma prüfen. |
| Geschäftsführer einer Firma herausfinden     | Firmennamen suchen und `officers` lesen: Name, Rolle, Geburtsdatum, Wohnort.                                           |
| Markt- und Wettbewerbsanalyse                | Alle Firmen mit einem Stichwort (z. B. `Software`) in einer Region mit Gründungsdatum und Stammkapital auswerten.      |
| Änderungen beobachten                        | Regelmäßig dieselbe Suche laufen lassen und `lastEntryDate`, `officers` und `status` vergleichen.                      |
| Eigene Firmendatenbank oder CRM pflegen      | Über die Apify-API aus dem eigenen Code aufrufen, Ergebnis als JSON.                                                   |

### Schnellstart

1. Auf **Try for free** klicken und bei Apify anmelden. Das monatliche Gratisguthaben reicht für rund 700 Firmen mit Registerdaten.
2. Unter **Search terms** einen Firmennamen, ein Stichwort oder eine HRB-Nummer eintragen, z. B. `Zalando`.
3. Optional: Bundesland, Ort, Rechtsform oder Registergericht wählen.
4. Auf **Start** klicken. Nach dem Lauf im Tab **Output** die Daten ansehen und exportieren.

```json
{
    "searchTerms": ["Zalando", "HRB 215511 B Berlin"],
    "states": ["Berlin"],
    "maxResults": 100
}
```

### Eingabe

| Feld                                     | Bedeutung                                                                                                                                        |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `searchTerms`                            | Firmennamen, Stichwörter, HRB/HRA-Nummern (mit oder ohne Gericht) oder EUIDs. Jeder Eintrag ist eine eigene Suche.                               |
| `keywordMode`                            | `all` (alle Wörter), `any` (eines der Wörter) oder `exact` (genauer Firmenname).                                                                 |
| `similarSounding`                        | Auch ähnlich klingende Namen finden (Portal-Option).                                                                                             |
| `states`, `city`, `street`, `postalCode` | Bundesländer, Sitz, Straße. Hinweis: Suchen nach Postleitzahl beantwortet das Portal derzeit mit einem Serverfehler.                             |
| `legalForm`                              | Rechtsform, z. B. `GmbH` (umfasst UG), `AG`, `KG`, `e.K.`, `e.V.`.                                                                               |
| `registerType`, `registerCourt`          | Registerart (HRA, HRB, GnR, PR, VR, GsR) und Registergericht (alle 150 Gerichte).                                                                |
| `includeDeleted`                         | Auch gelöschte Firmen (geschlossene Registerblätter). Für diese gibt das Portal kein SI-Dokument aus, sie kommen mit den Daten der Trefferliste. |
| `maxResults`                             | Höchstzahl Firmen pro Suche. Über 100 wird die Suche automatisch aufgeteilt (bis 10.000).                                                        |
| `maxItems`                               | Höchstzahl Firmen im ganzen Lauf.                                                                                                                |
| `fetchStructuredData`                    | `true` (Standard): Registerdaten laden. `false`: nur die Trefferliste, schnell und für 2 $ pro 1.000.                                            |
| `includeRawXml`                          | Das komplette XJustiz-XML zusätzlich im Feld `siXml` speichern.                                                                                  |

Eine Suche nur nach Rechtsform, Bundesland oder Ort lehnt das Portal ab. Kombinieren Sie diese Filter mit einem Stichwort, einem Gericht oder einer Straße.

### Ausgabe

Jede Zeile ist eine Firma.

| Gruppe            | Felder                                                                                                                                                                 |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Register          | `registerId`, `registerType`, `registerNumber`, `registerCourt`, `euid`, `state`, `status`, `statusRaw`                                                                |
| Firma             | `name`, `legalForm`, `legalFormFull`, `seat`, `address`, `street`, `postalCode`, `city`, `country`, `phone`, `email`, `website` (nur wenn im Register eingetragen)     |
| Kapital und Zweck | `capital`, `capitalCurrency`, `capitalNote`, `purpose`, `foundedDate`, `articlesDate`                                                                                  |
| Personen          | `officers[]` mit `role`, `name`, `firstName`, `lastName`, `birthName`, `birthDate`, `city`, `type` (Person oder Firma), `representation`, `limitedPartnerContribution` |
| Vertretung        | `representation` (allgemeine Vertretungsregel der Firma)                                                                                                               |
| Verlauf           | `history[]` (frühere Namen und Sitze), `registerNotes`, `lastEntryDate`, `lastChangeDate`, `entriesCount`                                                              |
| Sonstiges         | `branches[]` (Zweigniederlassungen), `availableDocuments` (im Portal abrufbare Dokumente), `detailsAvailable`, `searchTerm`                                            |

Beispiel (gekürzt, Personendaten durch Platzhalter ersetzt):

```json
{
    "name": "Connected Retail GmbH",
    "legalForm": "GmbH",
    "registerNumber": "HRB 215511 B",
    "registerCourt": "Amtsgericht Charlottenburg",
    "euid": "DEF1103R.HRB215511B",
    "status": "active",
    "address": "Valeska-Gert-Straße 5, 10243 Berlin",
    "foundedDate": "2016-12-21",
    "capital": 30000,
    "capitalCurrency": "EUR",
    "purpose": "Die Erbringung von Vertriebsdienstleistungen für Einzelhändler, insbesondere für Mode-Einzelhändler, …",
    "representation": "Ist ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. …",
    "officers": [
        {
            "role": "Geschäftsführer(in)",
            "type": "person",
            "name": "Erika Mustermann",
            "birthDate": "1980-01-01",
            "city": "Berlin",
            "representation": "mit der Befugnis Rechtsgeschäfte als Vertreter Dritter abzuschließen"
        }
    ],
    "history": [{ "position": 1, "name": "KICKZ Never Not Ballin' GmbH", "seat": "Berlin" }],
    "branches": [{ "name": "CONNECTED RETAIL GMBH", "seat": "BOLZANO", "country": "Italien" }],
    "lastEntryDate": "2025-12-19"
}
```

### Mehr als 100 Treffer pro Suche

Das Registerportal bricht jede Suche bei 100 Treffern ab ("Die maximale Trefferanzahl von 100 wurde überschritten"). Setzen Sie `maxResults` höher, teilt der Scraper die Suche in engere Suchen auf: erst nach Bundesland, dann nach Registergericht, Registerart und Anfangsbuchstaben der Straße. Jede Firma wird nur einmal gespeichert. Ein Test mit dem Stichwort `Software` in Berlin ergab so 461 Firmen aus 35 Teilsuchen statt 100.

Firmen ohne eingetragene Straße (selten, meist alte Vereine) kann die Straßen-Aufteilung nicht erfassen. Bleibt eine Teilsuche trotzdem über 100, steht das in der Statusmeldung des Laufs.

### Preise

|                                | Free        | Bronze      | Silver         | Gold und höher |
| ------------------------------ | ----------- | ----------- | -------------- | -------------- |
| Firma mit Registerdaten (SI)   | 7 $ / 1.000 | 6 $ / 1.000 | 5,50 $ / 1.000 | 5 $ / 1.000    |
| Firma nur aus der Trefferliste | 2 $ / 1.000 | 2 $ / 1.000 | 1,50 $ / 1.000 | 1,50 $ / 1.000 |

Plattformkosten und Proxy sind enthalten. Nur Trefferlisten-Daten fallen an, wenn Sie `fetchStructuredData` ausschalten, für gelöschte Firmen ohne SI-Dokument und wenn das Portal das Dokument dauerhaft nicht ausgibt. Mit "Maximum cost per run" begrenzen Sie die Kosten eines Laufs; der Scraper hört dann rechtzeitig auf.

### Grenzen und Störungen des Portals

- **Dokumentdienst überlastet (Fehler A 110).** Das Portal ist oft überlastet und gibt dann zeitweise keine Dokumente aus, während die Suche weiter funktioniert. Der Scraper pausiert dann alle Sitzungen und versucht es erneut. Hält die Störung länger als 10 Minuten an, speichert er die restlichen Firmen mit den Daten der Trefferliste (Feld `detailsError`) und zum günstigeren Preis. Starten Sie den Lauf später noch einmal.
- **Geschwindigkeit.** Das Portal braucht etwa 7 Sekunden pro Dokument. Mit 3 parallelen Sitzungen (Standard) sind das rund 1.000 Firmen pro Stunde.
- **E-Mail, Telefon, Website** stehen nur selten im Register. Der Scraper übernimmt sie, wenn sie eingetragen sind, sucht sie aber nicht im Web.

### Nutzungsbedingungen und Datenschutz (DSGVO)

Bitte lesen Sie vor der Nutzung die [Nutzungsordnung des Registerportals](https://www.handelsregister.de/rp_web/information.xhtml). Sie sind selbst dafür verantwortlich, wie Sie den Scraper und die Daten verwenden. Die wichtigsten Punkte:

- **Einzelne Abrufe zu Informationszwecken** sind jedem gestattet (§ 9 Abs. 1 HGB). **Systematische Abrufe, um parallele Voll- oder Teilregister aufzubauen, auszubauen oder zu aktualisieren, sind unzulässig** (Nutzungsordnung Nr. 3).
- **Höchstens 60 Suchen oder Abrufe von Rechtsträgern pro Stunde** (Nr. 5). Wer mehr braucht, kann bei der Servicestelle Registerportal beim AG Hagen eine freigeschaltete IP-Adresse beantragen. Das Portal sperrt IP-Adressen, die es als missbräuchlich einstuft.
- **Personenbezogene Daten.** Geschäftsführer, Prokuristen und Gesellschafter sind natürliche Personen; Name, Geburtsdatum und Wohnort sind personenbezogene Daten im Sinne der DSGVO, auch wenn sie öffentlich im Register stehen. Die Nutzungsordnung (Nr. 4) erlaubt Abruf, Speicherung, Nutzung und Weitergabe nur nach Maßgabe der DSGVO und der Datenschutzgesetze. Sie brauchen eine Rechtsgrundlage (z. B. berechtigtes Interesse nach Art. 6 Abs. 1 lit. f DSGVO), müssen Betroffene informieren (Art. 14), sollten nur die nötigen Felder speichern und Löschfristen festlegen. Für Werbung per E-Mail oder Telefon gelten zusätzlich die Regeln des UWG.

Dieser Text ist keine Rechtsberatung. Wenden Sie sich im Zweifel an eine Anwältin oder einen Anwalt oder Ihre Datenschutzbeauftragten.

### Für KI-Agenten

Rufen Sie `epicscrapers/handelsregister-scraper` mit Suchbegriffen auf. Minimale Eingabe:

```json
{ "searchTerms": ["Zalando"], "maxResults": 20 }
```

Wichtige Ausgabefelder: `name`, `legalForm`, `registerNumber`, `registerCourt`, `euid`, `status`, `address`, `capital`, `purpose`, `foundedDate`, `officers[].role`, `officers[].name`, `officers[].birthDate`, `representation`, `history`. Für eine bekannte Firma `"HRB <Nummer> <Gericht>"` als Suchbegriff verwenden; das ergibt genau einen Treffer.

### Häufige Fragen

#### Ist das eine offizielle Handelsregister-API?

Nein. Das Registerportal bietet keine API an. Der Scraper bedient das Portal wie ein Mensch im Browser und liest das amtliche SI-Dokument aus. Er ist nicht mit den Landesjustizverwaltungen verbunden.

#### Brauche ich einen Handelsregisterauszug?

Der Scraper liefert den strukturierten Registerinhalt (SI), der dieselben Eintragungen wie der aktuelle Auszug (AD) enthält, aber maschinenlesbar. Einen amtlichen Ausdruck als PDF für Behörden oder Banken ersetzt er nicht.

#### Warum bekomme ich weniger Firmen als `maxResults`?

Die Suche hat weniger Treffer, oder dieselbe Firma kam in mehreren Suchen vor und wurde nur einmal gespeichert. Die Zahl der Treffer pro Suche steht im Log.

#### Kann ich neue Handelsregistereintragungen (Neugründungen) abrufen?

Nicht direkt: Das Portal hat keine Suche nach Eintragungsdatum. Sie können eine Suche regelmäßig laufen lassen und neue `registerId`s vergleichen.

***

### English version

### Handelsregister Scraper and API: German company register data, managing directors and HRB numbers

Handelsregister Scraper searches Germany's official company register portal (handelsregister.de, the "Gemeinsames Registerportal der Länder") and returns each company's **structured register content (SI)**, the court's own data, as a spreadsheet or JSON. Search the way the portal does, by company name, HRB number, city, legal form or federal state, and get one row per company with managing directors, authorized signatories (Prokura), partners, share capital, address, business purpose and name history.

If you know the UK's Companies House: Germany has no central, free company API like it. The Handelsregister is run by the courts of the 16 federal states, and its portal is built for one look-up at a time. This scraper makes it usable in bulk.

- **Official data, not estimates.** Every row comes from the XJustiz "SI" document that the register court itself issues.
- **Managing directors and signing authority.** Every registered person or company with role (Geschäftsführer, board member, Prokurist, general or limited partner with liability amount, owner, liquidator), birth date, city of residence and representation rule.
- **No 100-result cap.** The portal stops every search at 100 results. The scraper splits larger searches by state, court, register type and street and merges the results without duplicates.
- **HRB number, EUID or name.** `HRB 215511 B Berlin`, `Amtsgericht München HRB 12345`, `DEF1103R.HRB215511B` or just `Zalando` all work.
- **Pay per company, no subscription.** $7 per 1,000 companies with full register data ($5 on higher Apify plans), $2 per 1,000 for results-list data only. Export to Excel, CSV, JSON or via API.

### What can you do with it?

| Goal                                       | How                                                                                                 |
| ------------------------------------------ | --------------------------------------------------------------------------------------------------- |
| B2B lead lists of German companies         | Pick legal form `GmbH`, a state and a city; export the managing directors.                          |
| Verify HRB numbers, enrich company records | Paste HRB numbers or names; compare address, legal form, capital and status.                        |
| KYC and compliance checks                  | Check signing authority, Prokura, partners and register notes (mergers, insolvency).                |
| Find out who runs a company                | Search the name and read `officers`: name, role, birth date, city.                                  |
| Market research                            | Pull every company matching a keyword (e.g. `Software`) in a region with founding date and capital. |
| Monitor changes                            | Schedule the same search and compare `lastEntryDate`, `officers` and `status`.                      |
| Feed your own database or CRM              | Call it from your code through the Apify API and get JSON.                                          |

### Quick start

1. Click **Try for free** and sign in to Apify. The free monthly credit covers about 700 companies with register data.
2. Add a company name, keyword or HRB number to **Search terms**, for example `Zalando`.
3. Optionally pick a federal state, city, legal form or register court.
4. Click **Start**, then open the **Output** tab and export.

```json
{
    "searchTerms": ["Zalando", "HRB 215511 B Berlin"],
    "states": ["Berlin"],
    "maxResults": 100
}
```

### Input

| Field                                    | Meaning                                                                                                           |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `searchTerms`                            | Company names, keywords, HRB/HRA numbers (with or without court) or EUIDs. Each entry is its own search.          |
| `keywordMode`                            | `all` words, `any` word, or `exact` company name.                                                                 |
| `similarSounding`                        | Also match similar-sounding names (portal option).                                                                |
| `states`, `city`, `street`, `postalCode` | Federal states (German or English names), seat, street. Postal-code searches currently fail on the portal's side. |
| `legalForm`                              | e.g. `GmbH` (includes UG), `AG`, `KG`, `e.K.`, `e.V.`.                                                            |
| `registerType`, `registerCourt`          | Register type (HRA, HRB, GnR, PR, VR, GsR) and register court (all 150).                                          |
| `includeDeleted`                         | Also closed register entries. The portal has no SI document for them, so they come with results-list data.        |
| `maxResults`                             | Max companies per search. Above 100 the search is split automatically (up to 10,000).                             |
| `maxItems`                               | Max companies in the whole run.                                                                                   |
| `fetchStructuredData`                    | `true` (default) loads register data. `false` saves the results list only: fast, $2 per 1,000.                    |
| `includeRawXml`                          | Also save the full XJustiz XML in `siXml`.                                                                        |

The portal refuses a search by legal form, state or city alone. Combine these filters with a keyword, a court or a street.

### Output

One row per company. The fields are listed in the German section above ([Ausgabe](#ausgabe)); names are in English: `registerId`, `registerNumber`, `registerCourt`, `euid`, `status`, `name`, `legalForm`, `address`, `capital`, `purpose`, `foundedDate`, `officers[]` (`role`, `name`, `birthDate`, `city`, `representation`, `limitedPartnerContribution`), `representation`, `history[]`, `registerNotes`, `branches[]`, `lastEntryDate`, `availableDocuments`. Role names and the business purpose stay in German, as the court writes them.

### More than 100 results

The register portal cuts every search at 100 results. Set `maxResults` higher and the scraper splits the search into narrower ones (state, then register court, register type and street initial) and saves each company once. A test with the keyword `Software` in Berlin returned 461 companies from 35 sub-searches instead of 100. Companies without a street on record (rare, mostly old associations) can't be reached by the street split; if a sub-search stays above 100, the run's status message says so.

### Pricing

|                                 | Free       | Bronze     | Silver        | Gold and up   |
| ------------------------------- | ---------- | ---------- | ------------- | ------------- |
| Company with register data (SI) | $7 / 1,000 | $6 / 1,000 | $5.50 / 1,000 | $5 / 1,000    |
| Company from results list only  | $2 / 1,000 | $2 / 1,000 | $1.50 / 1,000 | $1.50 / 1,000 |

Platform usage and proxies are included. You pay the results-list price when `fetchStructuredData` is off, for closed entries without an SI document, and when the portal keeps refusing the document. Set "Maximum cost per run" to cap a run; the scraper stops in time.

### Limits and portal outages

- **Document service overloaded (error A 110).** The portal is often overloaded and then stops issuing documents for a while, although search still works. The scraper pauses all sessions and retries. If the outage lasts more than 10 minutes, it saves the remaining companies with results-list data (`detailsError` field) at the lower price. Run it again later.
- **Speed.** The portal takes about 7 seconds per document. With 3 parallel sessions (default) that's roughly 1,000 companies per hour.
- **Email, phone, website** are rarely in the register. They're included when present; the scraper doesn't look them up on the web.

### Terms of use and data protection (GDPR)

Read the [portal's terms of use (Nutzungsordnung)](https://www.handelsregister.de/rp_web/information.xhtml) before you start. You are responsible for how you use the scraper and the data. The key points:

- **Single retrievals for information purposes** are open to everyone (§ 9(1) HGB). **Systematic retrievals to build, extend or update a full or partial copy of the register are not allowed** (terms, no. 3).
- **At most 60 searches or company retrievals per hour** (no. 5). For more, you can apply for a whitelisted IP address with the Servicestelle Registerportal at the Hagen local court. The portal blocks IP addresses it considers abusive.
- **Personal data.** Managing directors, signatories and partners are people; their name, birth date and city are personal data under the GDPR even though the register publishes them. The terms (no. 4) allow retrieving, storing, using and sharing register data only in line with the GDPR and German data protection law. You need a legal basis (for example legitimate interest, Art. 6(1)(f) GDPR), must inform the people concerned (Art. 14), should keep only the fields you need and set deletion periods. Cold email and phone marketing in Germany is also restricted by the UWG (unfair competition act).

This is not legal advice. If in doubt, ask a lawyer or your data protection officer.

### For AI agents

Call `epicscrapers/handelsregister-scraper` with search terms. Minimal input:

```json
{ "searchTerms": ["Zalando"], "maxResults": 20 }
```

Key output fields: `name`, `legalForm`, `registerNumber`, `registerCourt`, `euid`, `status`, `address`, `capital`, `purpose`, `foundedDate`, `officers[].role`, `officers[].name`, `officers[].birthDate`, `representation`, `history`. For a known company, use `"HRB <number> <court>"` as the search term to get exactly one match.

### FAQ

#### Is this an official Handelsregister API?

No. The register portal has no API. The scraper uses the portal like a person in a browser and reads the official SI document. It is not affiliated with the German state justice administrations.

#### Do I still need a Handelsregisterauszug (register extract)?

The SI contains the same entries as the current extract (AD), machine-readable. It doesn't replace a certified PDF printout for authorities or banks.

#### Why did I get fewer companies than `maxResults`?

The search has fewer matches, or the same company appeared in several searches and was saved once. The log shows the match count per search.

#### Can I get new registrations?

Not directly: the portal can't search by registration date. Schedule a search and compare new `registerId`s between runs.

# Actor input Schema

## `searchTerms` (type: `array`):

Company names or keywords, register numbers ("HRB 215511", optionally with the court: "HRB 215511 Berlin", "Amtsgericht München HRB 12345") or EUIDs ("DEF1103R.HRB215511B"). Each term is one search. Leave empty to search by the filters below only.

## `keywordMode` (type: `string`):

How keywords in a search term are matched against company names. Not used for register numbers.

## `similarSounding` (type: `boolean`):

Also match names that sound like the keywords (e.g. Meier / Mayer).

## `maxResults` (type: `integer`):

The register returns at most 100 companies per search. Above 100, a search that hits that limit is split automatically into narrower searches (by state, court, register type and street) until all companies are found or this number is reached.

## `states` (type: `array`):

Only companies registered in these states. Empty = all of Germany.

## `city` (type: `string`):

City of the business address (Ort), e.g. "Hamburg".

## `postalCode` (type: `string`):

Postal code of the business address, e.g. "10115". Note: as of November 2026 the register itself fails on postal-code searches (internal error 500); use city or register court instead.

## `street` (type: `string`):

Street of the business address.

## `legalForm` (type: `string`):

Only companies of this legal form. The register needs at least one more criterion (a search term, city, court…). Via the API you can also pass an abbreviation such as "GmbH", "AG", "KG" or "e.V.".

## `registerType` (type: `string`):

Only entries of this register.

## `registerCourt` (type: `string`):

Only entries of this local court (Amtsgericht).

## `includeDeleted` (type: `boolean`):

Also return companies whose register sheet is closed (deleted, merged or moved). The register offers no structured details for them, so these rows only have name, register number, court, seat and status.

## `fetchStructuredData` (type: `boolean`):

Download the structured register content (SI) for every company: address, managing directors and other officers with birth dates, share capital, business purpose, founding date, representation rules. Turn off for a fast, cheaper list with name, register number, court, seat, status and name history only.

## `includeRawXml` (type: `boolean`):

Add the original XJustiz XML of the register content to each company (field siXml). Large; only for fields beyond the parsed ones.

## `maxItems` (type: `integer`):

Stop the run after this many companies across all searches. Empty or 0 = no limit.

## `proxyConfiguration` (type: `object`):

German residential proxies are the default: they dropped fewer connections in testing. Traffic is small (about 2 MB per 100 companies).

## `maxConcurrency` (type: `integer`):

Companies fetched at the same time. The register takes about 7 seconds per structured extract and slows down or refuses requests when overloaded, so more sessions mostly add errors.

## Actor input object example

```json
{
  "searchTerms": [
    "Zalando"
  ],
  "keywordMode": "all",
  "similarSounding": false,
  "maxResults": 100,
  "includeDeleted": false,
  "fetchStructuredData": true,
  "includeRawXml": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "DE"
  },
  "maxConcurrency": 3
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `officers` (type: `string`):

No description

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "Zalando"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "DE"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("epicscrapers/handelsregister-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchTerms": ["Zalando"],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "DE",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("epicscrapers/handelsregister-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchTerms": [
    "Zalando"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "DE"
  }
}' |
apify call epicscrapers/handelsregister-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,epicscrapers/handelsregister-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/arVzwclBkUZVt6REn/builds/Fdp7AQmgAn9vOnon0/openapi.json
