---
updatedAt: 2026-04-24T15:12:04.000Z
agentTools:
projectIndex: https://docs.beauhurst.com/llms.txt
---
# Search for German Legal Entities
Combine registered_name or handelsregister_number with registered_court to disambiguate companies
that share a name or register number across different courts. company_registration_number already
encodes the court, so registered_court isn't accepted alongside it.
# OpenAPI definition
```json
{
"openapi": "3.0.3",
"info": {
"title": "Beauhurst API v2",
"version": "1.0.0 (externalapi)",
"description": "Usage
The API only accepts GET requests over HTTPS.
Authorization
The Beauhurst API requires authentication in the form of an API key,provided in the format 'apikey '.
To obtain an API key, please contact your subscription's account manager at Beauhurst. Be sure to keep this key private and secure.
"
},
"paths": {
"/legalentity/de/search": {
"get": {
"operationId": "legalentity_de_search_list",
"description": "\n Combine registered_name or handelsregister_number with registered_court to disambiguate companies\n that share a name or register number across different courts. company_registration_number already\n encodes the court, so registered_court isn't accepted alongside it.\n ",
"summary": "Search for German Legal Entities",
"parameters": [
{
"in": "query",
"name": "company_registration_number",
"schema": {
"type": "string",
"pattern": "^(?:AAC|ALT|AMB|ANS|APO|ARN|ARS|ARI|ASC|AUG|AUR|BHE|BHO|BKR|BOE|BSA|BAM|BAY|BER|BIE|BOC|BON|BRA|BRE|CHE|COB|COE|COT|DAR|DEG|DOR|DRE|DUI|DUE|DSS|EIS|ERF|ESC|ESS|FLE|FRA|FRO|FRE|FRI|FRT|FUL|FUE|GEL|GER|GIE|GOT|GOE|GRE|GUE|HAG|HAM|HMM|HAN|HNN|HEI|HIL|HLD|HOF|HOM|ING|ISE|JEN|KAI|KAS|KEM|KIE|KLE|KOB|KOE|KNG|KOR|KRE|LAN|LND|LNG|LEB|LEI|LEM|LIM|LUE|LUD|LNB|MAI|MAN|MAR|MEI|MEM|MER|MOE|MON|MUE|MNC|MNS|NEU|NNK|NRP|NSS|NOR|NUE|OFF|OLD|OSN|OTT|PAD|PAS|PIN|POE|POL|POT|REC|REG|ROS|RUD|SAA|SRL|SCH|SHW|SIE|SGN|SOE|SON|SNN|STA|STD|STE|STN|STI|STR|SRA|STU|STW|SUH|TOS|TRA|ULM|VOE|WAL|WEI|WMR|WET|WIE|WIT|WUP|WUE|ZWE)_[A-Za-z0-9][A-Za-z0-9.\\-%]*$",
"minLength": 1
},
"description": "Court code and CRN (Handelsregister number), separated by underscore."
},
{
"in": "query",
"name": "handelsregister_number",
"schema": {
"type": "string",
"minLength": 1
},
"description": "Register type and number assigned by the local court, e.g. `HRB 9455` or `HRA153940`. Matching ignores case and whitespace."
},
{
"name": "limit",
"required": false,
"in": "query",
"description": "Number of results to return per page.",
"schema": {
"type": "integer"
}
},
{
"name": "offset",
"required": false,
"in": "query",
"description": "The initial index from which to return the results.",
"schema": {
"type": "integer"
}
},
{
"in": "query",
"name": "registered_court",
"schema": {
"enum": [
"Aachen",
"Altenburg",
"Amberg",
"Ansbach",
"Apolda",
"Arnsberg",
"Arnstadt",
"Arnstadt Zweigstelle Ilmenau",
"Aschaffenburg",
"Augsburg",
"Aurich",
"Bad Hersfeld",
"Bad Homburg v.d.H.",
"Bad Kreuznach",
"Bad Oeynhausen",
"Bad Salzungen",
"Bamberg",
"Bayreuth",
"Berlin (Charlottenburg)",
"Bielefeld",
"Bochum",
"Bonn",
"Braunschweig",
"Bremen",
"Chemnitz",
"Coburg",
"Coesfeld",
"Cottbus",
"Darmstadt",
"Deggendorf",
"Dortmund",
"Dresden",
"Duisburg",
"Düren",
"Düsseldorf",
"Eisenach",
"Erfurt",
"Eschwege",
"Essen",
"Flensburg",
"Frankfurt am Main",
"Frankfurt/Oder",
"Freiburg",
"Friedberg",
"Fritzlar",
"Fulda",
"Fürth",
"Gelsenkirchen",
"Gera",
"Gießen",
"Gotha",
"Greiz",
"Göttingen",
"Gütersloh",
"Hagen",
"Hamburg",
"Hamm",
"Hanau",
"Hannover",
"Heilbad Heiligenstadt",
"Hildburghausen",
"Hildesheim",
"Hof",
"Homburg",
"Ingolstadt",
"Iserlohn",
"Jena",
"Kaiserslautern",
"Kassel",
"Kempten (Allgäu)",
"Kiel",
"Kleve",
"Koblenz",
"Korbach",
"Krefeld",
"Köln",
"Königstein",
"Landau",
"Landshut",
"Langenfeld",
"Lebach",
"Leipzig",
"Lemgo",
"Limburg",
"Ludwigshafen a.Rhein (Ludwigshafen)",
"Lübeck",
"Lüneburg",
"Mainz",
"Mannheim",
"Marburg",
"Meiningen",
"Memmingen",
"Merzig",
"Montabaur",
"Mönchengladbach",
"Mühlhausen",
"München",
"Münster",
"Neubrandenburg",
"Neunkirchen",
"Neuruppin",
"Neuss",
"Nordhausen",
"Nürnberg",
"Offenbach am Main",
"Oldenburg (Oldenburg)",
"Osnabrück",
"Ottweiler",
"Paderborn",
"Passau",
"Pinneberg",
"Potsdam",
"Pößneck",
"Pößneck Zweigstelle Bad Lobenstein",
"Recklinghausen",
"Regensburg",
"Rostock",
"Rudolstadt",
"Saarbrücken",
"Saarlouis",
"Schweinfurt",
"Schwerin",
"Siegburg",
"Siegen",
"Sondershausen",
"Sonneberg",
"St. Ingbert (St Ingbert)",
"St. Wendel (St Wendel)",
"Stadthagen",
"Stadtroda",
"Steinfurt",
"Stendal",
"Stralsund",
"Straubing",
"Stuttgart",
"Suhl",
"Sömmerda",
"Tostedt",
"Traunstein",
"Ulm",
"Völklingen",
"Walsrode",
"Weiden i. d. OPf.",
"Weimar",
"Wetzlar",
"Wiesbaden",
"Wittlich",
"Wuppertal",
"Würzburg",
"Zweibrücken"
],
"type": "string",
"minLength": 1
},
"description": "Registered court of the German company. Only valid with registered_name or handelsregister_number.\n\n* `Aachen` - Aachen\n* `Altenburg` - Altenburg\n* `Amberg` - Amberg\n* `Ansbach` - Ansbach\n* `Apolda` - Apolda\n* `Arnsberg` - Arnsberg\n* `Arnstadt` - Arnstadt\n* `Arnstadt Zweigstelle Ilmenau` - Arnstadt Zweigstelle Ilmenau\n* `Aschaffenburg` - Aschaffenburg\n* `Augsburg` - Augsburg\n* `Aurich` - Aurich\n* `Bad Hersfeld` - Bad Hersfeld\n* `Bad Homburg v.d.H.` - Bad Homburg v.d.H.\n* `Bad Kreuznach` - Bad Kreuznach\n* `Bad Oeynhausen` - Bad Oeynhausen\n* `Bad Salzungen` - Bad Salzungen\n* `Bamberg` - Bamberg\n* `Bayreuth` - Bayreuth\n* `Berlin (Charlottenburg)` - Berlin (Charlottenburg)\n* `Bielefeld` - Bielefeld\n* `Bochum` - Bochum\n* `Bonn` - Bonn\n* `Braunschweig` - Braunschweig\n* `Bremen` - Bremen\n* `Chemnitz` - Chemnitz\n* `Coburg` - Coburg\n* `Coesfeld` - Coesfeld\n* `Cottbus` - Cottbus\n* `Darmstadt` - Darmstadt\n* `Deggendorf` - Deggendorf\n* `Dortmund` - Dortmund\n* `Dresden` - Dresden\n* `Duisburg` - Duisburg\n* `Düren` - Düren\n* `Düsseldorf` - Düsseldorf\n* `Eisenach` - Eisenach\n* `Erfurt` - Erfurt\n* `Eschwege` - Eschwege\n* `Essen` - Essen\n* `Flensburg` - Flensburg\n* `Frankfurt am Main` - Frankfurt am Main\n* `Frankfurt/Oder` - Frankfurt/Oder\n* `Freiburg` - Freiburg\n* `Friedberg` - Friedberg\n* `Fritzlar` - Fritzlar\n* `Fulda` - Fulda\n* `Fürth` - Fürth\n* `Gelsenkirchen` - Gelsenkirchen\n* `Gera` - Gera\n* `Gießen` - Gießen\n* `Gotha` - Gotha\n* `Greiz` - Greiz\n* `Göttingen` - Göttingen\n* `Gütersloh` - Gütersloh\n* `Hagen` - Hagen\n* `Hamburg` - Hamburg\n* `Hamm` - Hamm\n* `Hanau` - Hanau\n* `Hannover` - Hannover\n* `Heilbad Heiligenstadt` - Heilbad Heiligenstadt\n* `Hildburghausen` - Hildburghausen\n* `Hildesheim` - Hildesheim\n* `Hof` - Hof\n* `Homburg` - Homburg\n* `Ingolstadt` - Ingolstadt\n* `Iserlohn` - Iserlohn\n* `Jena` - Jena\n* `Kaiserslautern` - Kaiserslautern\n* `Kassel` - Kassel\n* `Kempten (Allgäu)` - Kempten (Allgäu)\n* `Kiel` - Kiel\n* `Kleve` - Kleve\n* `Koblenz` - Koblenz\n* `Korbach` - Korbach\n* `Krefeld` - Krefeld\n* `Köln` - Köln\n* `Königstein` - Königstein\n* `Landau` - Landau\n* `Landshut` - Landshut\n* `Langenfeld` - Langenfeld\n* `Lebach` - Lebach\n* `Leipzig` - Leipzig\n* `Lemgo` - Lemgo\n* `Limburg` - Limburg\n* `Ludwigshafen a.Rhein (Ludwigshafen)` - Ludwigshafen a.Rhein (Ludwigshafen)\n* `Lübeck` - Lübeck\n* `Lüneburg` - Lüneburg\n* `Mainz` - Mainz\n* `Mannheim` - Mannheim\n* `Marburg` - Marburg\n* `Meiningen` - Meiningen\n* `Memmingen` - Memmingen\n* `Merzig` - Merzig\n* `Montabaur` - Montabaur\n* `Mönchengladbach` - Mönchengladbach\n* `Mühlhausen` - Mühlhausen\n* `München` - München\n* `Münster` - Münster\n* `Neubrandenburg` - Neubrandenburg\n* `Neunkirchen` - Neunkirchen\n* `Neuruppin` - Neuruppin\n* `Neuss` - Neuss\n* `Nordhausen` - Nordhausen\n* `Nürnberg` - Nürnberg\n* `Offenbach am Main` - Offenbach am Main\n* `Oldenburg (Oldenburg)` - Oldenburg (Oldenburg)\n* `Osnabrück` - Osnabrück\n* `Ottweiler` - Ottweiler\n* `Paderborn` - Paderborn\n* `Passau` - Passau\n* `Pinneberg` - Pinneberg\n* `Potsdam` - Potsdam\n* `Pößneck` - Pößneck\n* `Pößneck Zweigstelle Bad Lobenstein` - Pößneck Zweigstelle Bad Lobenstein\n* `Recklinghausen` - Recklinghausen\n* `Regensburg` - Regensburg\n* `Rostock` - Rostock\n* `Rudolstadt` - Rudolstadt\n* `Saarbrücken` - Saarbrücken\n* `Saarlouis` - Saarlouis\n* `Schweinfurt` - Schweinfurt\n* `Schwerin` - Schwerin\n* `Siegburg` - Siegburg\n* `Siegen` - Siegen\n* `Sondershausen` - Sondershausen\n* `Sonneberg` - Sonneberg\n* `St. Ingbert (St Ingbert)` - St. Ingbert (St Ingbert)\n* `St. Wendel (St Wendel)` - St. Wendel (St Wendel)\n* `Stadthagen` - Stadthagen\n* `Stadtroda` - Stadtroda\n* `Steinfurt` - Steinfurt\n* `Stendal` - Stendal\n* `Stralsund` - Stralsund\n* `Straubing` - Straubing\n* `Stuttgart` - Stuttgart\n* `Suhl` - Suhl\n* `Sömmerda` - Sömmerda\n* `Tostedt` - Tostedt\n* `Traunstein` - Traunstein\n* `Ulm` - Ulm\n* `Völklingen` - Völklingen\n* `Walsrode` - Walsrode\n* `Weiden i. d. OPf.` - Weiden i. d. OPf.\n* `Weimar` - Weimar\n* `Wetzlar` - Wetzlar\n* `Wiesbaden` - Wiesbaden\n* `Wittlich` - Wittlich\n* `Wuppertal` - Wuppertal\n* `Würzburg` - Würzburg\n* `Zweibrücken` - Zweibrücken"
},
{
"name": "registered_name",
"required": false,
"in": "query",
"description": "Registered name of the legal entity",
"schema": {
"type": "string"
}
},
{
"name": "registered_name_filter_type",
"required": false,
"in": "query",
"description": "Match type for registered_name: exact or partial\n\n* `exact` - exact\n* `partial` - partial",
"schema": {
"type": "string",
"enum": [
"exact",
"partial"
],
"minLength": 1
}
},
{
"name": "sort",
"required": false,
"in": "query",
"description": "Sort by registered_name. Prefix with '-' for descending order.\n\n* `registered_name` - registered_name\n* `-registered_name` - -registered_name",
"schema": {
"type": "string",
"enum": [
"registered_name",
"-registered_name"
],
"minLength": 1
}
}
],
"tags": [
"legalentity"
],
"security": [
{
"tokenAuth": []
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PaginatedGermanLegalEntitySearchList"
}
}
},
"description": ""
}
}
}
}
},
"components": {
"schemas": {
"GermanLegalEntitySearch": {
"type": "object",
"properties": {
"company_registration_number": {
"type": "string",
"nullable": true,
"description": "Court code and CRN (Handelsregister number), separated by an underscore (e.g. BOE_HRB9455)"
},
"true_company_id": {
"type": "string",
"nullable": true,
"description": "Beauhurst True Company ID"
},
"registered_name": {
"type": "string",
"description": "Registered name of the LE"
}
},
"required": [
"company_registration_number",
"registered_name",
"true_company_id"
]
},
"PaginatedGermanLegalEntitySearchList": {
"type": "object",
"properties": {
"meta": {
"type": "object",
"properties": {
"total": {
"type": "integer",
"example": 10
},
"limit": {
"type": "integer",
"example": 10
},
"offset": {
"type": "integer",
"example": 10
},
"count": {
"type": "integer",
"example": 10
}
}
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/GermanLegalEntitySearch"
}
}
}
}
},
"securitySchemes": {
"tokenAuth": {
"type": "apiKey",
"in": "header",
"name": "Authorization",
"description": "Token-based authentication with required prefix \"APIkey\""
}
}
},
"servers": [
{
"url": "https://platform.beauhurst.com/_api/v2.0"
}
],
"x-readme": {}
}
```