---
updatedAt: 2026-04-24T15:12:04.000Z
agentTools:
projectIndex: https://docs.beauhurst.com/llms.txt
---
# Get German Legal Entity data
Get registered details of German Legal Entities
# 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/{company_registration_number}/summary": {
"get": {
"operationId": "legalentity_de_summary_retrieve",
"description": "Get registered details of German Legal Entities",
"summary": "Get German Legal Entity data",
"parameters": [
{
"in": "path",
"name": "company_registration_number",
"schema": {
"type": "string"
},
"description": "Court code and CRN (Handelsregister number), separated by an underscore.\n\nAvailable court codes:\n- `AAC`: Aachen\n- `ALT`: Altenburg\n- `AMB`: Amberg\n- `ANS`: Ansbach\n- `APO`: Apolda\n- `ARI`: Arnstadt Zweigstelle Ilmenau\n- `ARN`: Arnsberg\n- `ARS`: Arnstadt\n- `ASC`: Aschaffenburg\n- `AUG`: Augsburg\n- `AUR`: Aurich\n- `BAM`: Bamberg\n- `BAY`: Bayreuth\n- `BER`: Berlin (Charlottenburg)\n- `BHE`: Bad Hersfeld\n- `BHO`: Bad Homburg v.d.H.\n- `BIE`: Bielefeld\n- `BKR`: Bad Kreuznach\n- `BOC`: Bochum\n- `BOE`: Bad Oeynhausen\n- `BON`: Bonn\n- `BRA`: Braunschweig\n- `BRE`: Bremen\n- `BSA`: Bad Salzungen\n- `CHE`: Chemnitz\n- `COB`: Coburg\n- `COE`: Coesfeld\n- `COT`: Cottbus\n- `DAR`: Darmstadt\n- `DEG`: Deggendorf\n- `DOR`: Dortmund\n- `DRE`: Dresden\n- `DSS`: Düsseldorf\n- `DUE`: Düren\n- `DUI`: Duisburg\n- `EIS`: Eisenach\n- `ERF`: Erfurt\n- `ESC`: Eschwege\n- `ESS`: Essen\n- `FLE`: Flensburg\n- `FRA`: Frankfurt am Main\n- `FRE`: Freiburg\n- `FRI`: Friedberg\n- `FRO`: Frankfurt/Oder\n- `FRT`: Fritzlar\n- `FUE`: Fürth\n- `FUL`: Fulda\n- `GEL`: Gelsenkirchen\n- `GER`: Gera\n- `GIE`: Gießen\n- `GOE`: Göttingen\n- `GOT`: Gotha\n- `GRE`: Greiz\n- `GUE`: Gütersloh\n- `HAG`: Hagen\n- `HAM`: Hamburg\n- `HAN`: Hanau\n- `HEI`: Heilbad Heiligenstadt\n- `HIL`: Hildburghausen\n- `HLD`: Hildesheim\n- `HMM`: Hamm\n- `HNN`: Hannover\n- `HOF`: Hof\n- `HOM`: Homburg\n- `ING`: Ingolstadt\n- `ISE`: Iserlohn\n- `JEN`: Jena\n- `KAI`: Kaiserslautern\n- `KAS`: Kassel\n- `KEM`: Kempten (Allgäu)\n- `KIE`: Kiel\n- `KLE`: Kleve\n- `KNG`: Königstein\n- `KOB`: Koblenz\n- `KOE`: Köln\n- `KOR`: Korbach\n- `KRE`: Krefeld\n- `LAN`: Landau\n- `LEB`: Lebach\n- `LEI`: Leipzig\n- `LEM`: Lemgo\n- `LIM`: Limburg\n- `LNB`: Lüneburg\n- `LND`: Landshut\n- `LNG`: Langenfeld\n- `LUD`: Ludwigshafen a.Rhein (Ludwigshafen)\n- `LUE`: Lübeck\n- `MAI`: Mainz\n- `MAN`: Mannheim\n- `MAR`: Marburg\n- `MEI`: Meiningen\n- `MEM`: Memmingen\n- `MER`: Merzig\n- `MNC`: München\n- `MNS`: Münster\n- `MOE`: Mönchengladbach\n- `MON`: Montabaur\n- `MUE`: Mühlhausen\n- `NEU`: Neubrandenburg\n- `NNK`: Neunkirchen\n- `NOR`: Nordhausen\n- `NRP`: Neuruppin\n- `NSS`: Neuss\n- `NUE`: Nürnberg\n- `OFF`: Offenbach am Main\n- `OLD`: Oldenburg (Oldenburg)\n- `OSN`: Osnabrück\n- `OTT`: Ottweiler\n- `PAD`: Paderborn\n- `PAS`: Passau\n- `PIN`: Pinneberg\n- `POE`: Pößneck\n- `POL`: Pößneck Zweigstelle Bad Lobenstein\n- `POT`: Potsdam\n- `REC`: Recklinghausen\n- `REG`: Regensburg\n- `ROS`: Rostock\n- `RUD`: Rudolstadt\n- `SAA`: Saarbrücken\n- `SCH`: Schweinfurt\n- `SGN`: Siegen\n- `SHW`: Schwerin\n- `SIE`: Siegburg\n- `SNN`: Sonneberg\n- `SOE`: Sömmerda\n- `SON`: Sondershausen\n- `SRA`: Straubing\n- `SRL`: Saarlouis\n- `STA`: Stadthagen\n- `STD`: Stadtroda\n- `STE`: Steinfurt\n- `STI`: St. Ingbert (St Ingbert)\n- `STN`: Stendal\n- `STR`: Stralsund\n- `STU`: Stuttgart\n- `STW`: St. Wendel (St Wendel)\n- `SUH`: Suhl\n- `TOS`: Tostedt\n- `TRA`: Traunstein\n- `ULM`: Ulm\n- `VOE`: Völklingen\n- `WAL`: Walsrode\n- `WEI`: Weiden i. d. OPf.\n- `WET`: Wetzlar\n- `WIE`: Wiesbaden\n- `WIT`: Wittlich\n- `WMR`: Weimar\n- `WUE`: Würzburg\n- `WUP`: Wuppertal\n- `ZWE`: Zweibrücken",
"required": true,
"examples": {
"Example1": {
"value": "BOE_HRB9455",
"summary": "Example with court code and CRN"
}
}
}
],
"tags": [
"legalentity"
],
"security": [
{
"tokenAuth": []
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/GermanLegalEntitySummary"
}
}
},
"description": ""
}
}
}
}
},
"components": {
"schemas": {
"GermanLegalEntitySummary": {
"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"
},
"handelsregister_number": {
"type": "string"
},
"registered_court": {
"type": "string",
"nullable": true
},
"beauhurst_url": {
"type": "string",
"readOnly": true
},
"incorporation_date": {
"type": "string",
"format": "date",
"nullable": true
},
"cessation_date": {
"type": "string",
"format": "date",
"nullable": true
},
"handelsregister_status": {
"type": "string"
},
"legal_form": {
"type": "string"
},
"registered_address": {
"type": "string"
},
"registered_postcode": {
"type": "string",
"nullable": true
},
"registered_city": {
"type": "string",
"nullable": true
},
"wz_code": {
"allOf": [
{
"$ref": "#/components/schemas/WZCode"
}
],
"nullable": true
}
},
"required": [
"beauhurst_url",
"cessation_date",
"company_registration_number",
"handelsregister_number",
"handelsregister_status",
"incorporation_date",
"legal_form",
"registered_address",
"registered_city",
"registered_court",
"registered_name",
"registered_postcode",
"true_company_id",
"wz_code"
]
},
"WZCode": {
"type": "object",
"properties": {
"code": {
"type": "string",
"readOnly": true
},
"description": {
"type": "string",
"readOnly": true
},
"group": {
"type": "string",
"readOnly": true
}
},
"required": [
"code",
"description",
"group"
]
}
},
"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": {}
}
```