Pricing

from $8.00 / 1,000 company records

Try for free

Go to Apify Store

Handelsregister.de [$8💰] German Company Registry

Try for free

Scrape the official German company register (handelsregister.de) — register number, court, status, legal form, registered address, officers with roles & birth dates, representation rules, and name history. Precise lookups or keyword search with filters. JSON or CSV out.

Pricing

from $8.00 / 1,000 company records

Rating

5.0

(1)

Developer

Muhamed Didovic

Actor stats

Bookmarked

Total users

Monthly active users

an hour ago

Last modified

Categories

Lead generation

Agents

You can access the Handelsregister.de [$8💰] German Company Registry programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "MezhXclfDJ1IyVmSS"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~handelsregister-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-handelsregister-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/memo23~handelsregister-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-handelsregister-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/memo23~handelsregister-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-handelsregister-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchQueries": {
            "title": "Company name keywords (one search per line)",
            "type": "array",
            "description": "Company-name keywords, one search per entry, e.g. `Siemens` or `Bäckerei München`. The portal caps each search at 100 results, so split broad terms into narrower queries (by city, register type, or legal form).",
            "items": {
              "type": "string"
            }
          },
          "keywordMatch": {
            "title": "Keyword matching",
            "enum": [
              "all",
              "any",
              "exact"
            ],
            "type": "string",
            "description": "How the words inside one query combine: `all` — every word must appear; `any` — at least one word; `exact` — exact company name.",
            "default": "all"
          },
          "registerType": {
            "title": "Register type",
            "enum": [
              "",
              "HRA",
              "HRB",
              "GnR",
              "PR",
              "VR",
              "GsR"
            ],
            "type": "string",
            "description": "Restrict to one register: HRA (partnerships/sole traders), HRB (GmbH/AG), GnR (cooperatives), PR (professional partnerships), VR (associations), GsR (civil-law partnerships). Empty = all.",
            "default": ""
          },
          "registerNumber": {
            "title": "Register number",
            "type": "string",
            "description": "Exact register number, e.g. `230633`. Combine with register type and court for a precise lookup."
          },
          "registerCourt": {
            "title": "Register court",
            "type": "string",
            "description": "Amtsgericht that keeps the record, by name as on the portal — e.g. `München`, `Berlin (Charlottenburg)`, `Weiden i. d. OPf.`. Spelling is forgiving: case, umlauts (`Wurzburg`), punctuation (`Weiden i.d. OPf.`), word order (`Charlottenburg (Berlin)`), a bare town name (`Weiden`) and a longer one (`Limburg a.d.Lahn`) all resolve. A name that fits several courts (`Frankfurt`) is refused with the options named, and an unrecognised court stops the run instead of returning unfiltered results."
          },
          "legalForm": {
            "title": "Legal form",
            "type": "string",
            "description": "Filter by legal form — full portal label (`Gesellschaft mit beschränkter Haftung`, `eingetragener Verein`) or the everyday abbreviation (`GmbH`, `AG`, `KG`, `OHG`, `eG`, `e.V.`, `GbR`, `SE`)."
          },
          "postalCode": {
            "title": "Postal code",
            "type": "string",
            "description": "Filter by the company seat's postal code, e.g. `80331`."
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "Filter by the company seat's city, e.g. `Hamburg`."
          },
          "states": {
            "title": "Federal states",
            "type": "array",
            "description": "Restrict results to specific Bundesländer. Allowed values: Baden-Württemberg, Bayern, Berlin, Brandenburg, Bremen, Hamburg, Hessen, Mecklenburg-Vorpommern, Niedersachsen, Nordrhein-Westfalen, Rheinland-Pfalz, Saarland, Sachsen, Sachsen-Anhalt, Schleswig-Holstein, Thüringen. Spelling is forgiving (`baden wuerttemberg` resolves to `Baden-Württemberg`); an unrecognised state stops the run.",
            "items": {
              "type": "string"
            }
          },
          "includeDeleted": {
            "title": "Include deleted entries",
            "type": "boolean",
            "description": "Also return companies whose register entry has been deleted (gelöscht). Useful for due-diligence and history research.",
            "default": false
          },
          "fetchStructuredData": {
            "title": "Fetch structured register data (address, officers, representation)",
            "type": "boolean",
            "description": "Download and parse the official SI document (structured XJustiz XML) for every company: registered street address, officers with roles and birth dates, representation rules, legal form. One extra request per company.",
            "default": true
          },
          "includeRawXml": {
            "title": "Include raw XJustiz XML",
            "type": "boolean",
            "description": "Attach the raw SI XML string to each row (large — increases dataset size significantly). For users who need fields beyond the parsed set.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum companies to scrape",
            "minimum": 1,
            "type": "integer",
            "description": "Hard cap on company records pushed to the dataset across all queries.",
            "default": 1000
          },
          "maxConcurrency": {
            "title": "Max concurrent searches",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many portal sessions run in parallel (one per search query). Keep low — the portal is a government service and drops connections when hammered.",
            "default": 3
          },
          "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "handelsregister.de is a public government portal with no anti-bot wall — datacenter proxies are sufficient.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Handelsregister.de Scraper — German Company Registry OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Handelsregister.de [$8💰] German Company Registry from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Handelsregister.de [$8💰] German Company Registry API in Python

Handelsregister.de [$8💰] German Company Registry API in JavaScript

Handelsregister.de [$8💰] German Company Registry API through CLI

Handelsregister.de [$8💰] German Company Registry API

German Handelsregister Company Register Scraper

bovi/handelsregister-de

Search the official German Handelsregister (commercial register) by company name. Returns legal form, register court/number, seat, address, filing dates, representatives, prokuristen/officers, and partners for each matching entry.

Vitalii Bondarev

German Company Register — Handelsregister Scraper

studio-amba/handelsregister-scraper

Search and extract German company data from the official Handelsregister. Look up by company name, register number, city, or legal form. Returns company name, legal form, address, business purpose, share capital, directors, and registration history. No cookies, no login.

Studio Amba

German Company Registry Scraper

dataharvest/handelsregister-scraper

Scrape German company data from Handelsregister.de.

Alex v

German Company Register Search (Handelsregister)

echocall/german-company-register-search

Search the official German company register (Handelsregister) by name. Get HRB/HRA register numbers, court, legal form, seat & status. For KYC, due diligence & lead enrichment.

Kristian Gasic

Germany Handelsregister Scraper

regdata/germany-handelsregister-scraper

Search the German Commercial Register (Handelsregister) by company name or register number. Extract company data, officers / managing directors (Geschäftsführer) with dates of birth, capital, legal form, seat, business purpose. No official API - structured JSON for KYC, KYB & due diligence.

getregdata

German Company KYC 🇩🇪: Handelsregister, HRB, Officers

tagadanar/german-company-kyc

Verify any German company straight from the official Handelsregister: register number, court, status, address, capital and officers (Geschäftsführer, Prokura). Pay per company found, platform usage included.

Tagada Data

German Trade Register Scraper - Company Data & KYC

actorpilot/german-trade-register-scraper

Extract structured German Handelsregister company data by company name or register number: legal form, court, register number, office, address, purpose, capital, representatives, prokura, timestamps, stable IDs, and run summary.

S. Klein

North Data Company & Register Extractor

xtracto/northdata-companies-scraper

Extract German/EU public-register (Handelsregister) data from northdata.com: company name, register number & court, address, officers, founding date, LEI, industry, and the full register/financial event feed with insolvency & liquidation events flagged. URL or company-name search.

Farhan Febrian Nauval

Germany Company Registry & Financials Scraper (Handelsregister)

scrapers_lat/germany-company-financials-scraper

Scrape German companies from the Handelsregister: register court and number (HRB/HRA), legal form, status, registered office, share capital, business purpose, former names, published document availability including annual financial statements, and officers (managing directors /...

Scrapers Lat

Germany Company Scraper — Handelsregister Live Search

dltik/germany-companies-scraper

Search German companies live from the official commercial register (handelsregister.de, free since 2022). Get company name, register number (HRB/HRA), court, federal state and status — fresh, not a stale dump. For KYC, B2B prospecting, CRM enrichment.