Handelsregister API
Documentation for the Handelsregister API, including real-time document retrieval and organization data access
Key Features
Company Search
Search for companies by name or local identifiers
Document Retrieval
Order official documents for a company
Company Report
Get comprehensive company reports with structured data
Real-time Search
Our real-time search API allows you to search for companies directly from the German Handelsregister portal. This is useful when you need the most up-to-date search results or when searching for companies not yet in our index.
Advanced Query
For more precise searches, use the advancedQuery parameter instead of a simple name search. This allows you to combine multiple search criteria for better results.
{
"advancedQuery": {
"name": "Chocoladefabriken Lindt & Sprüngli GmbH",
"registerNumber": "HRB 3452",
"jurisdiction": "de"
}
}Available Fields (Germany)
| Field | Description | Example |
|---|---|---|
name | Company name | "BMW AG" |
courtId | Court ID | "D2803" |
courtCity | Court city (fuzzy-matched) | "München" |
registerType | Register type | "HRB", "HRA", "GNR" |
registerNumber | Register number (can include prefix) | "10364", "HRB 275800" |
registerSuffix | Register suffix | "B" |
jurisdiction | Always "de" for Germany | "de" |
You cannot use both courtId and courtCity in the same query - use one or
the other. The courtCity field supports fuzzy matching, so minor spelling
variations are handled automatically.
Example Queries
Search by name and register number:
{
"advancedQuery": {
"name": "Lindt",
"registerNumber": "HRB 3452",
"jurisdiction": "de"
}
}Search by court city and register details:
{
"advancedQuery": {
"courtCity": "München",
"registerType": "HRB",
"registerNumber": "10364B",
"jurisdiction": "de"
}
}Search by register number with embedded type:
{
"advancedQuery": {
"courtCity": "Berlin",
"registerNumber": "HR B 275800",
"jurisdiction": "de"
}
}The registerNumber field automatically parses embedded register types (like HRB, HR B, HRA, etc.) and suffixes, so you can pass the full register number as it appears in official documents.
Real-time Document Retrieval
Our real-time document retrieval service allows you to fetch official documents directly from the German Handelsregister on demand. This ensures you always have access to the most current versions of company documents.
Supported Document Types
- Shareholder Lists (Gesellschafterliste)
- Articles of Association (Satzung / Gesellschaftsvertrag)
- Current Extract (Aktuelle Auszug)
- Historical Extracts (Historischer Auszug)
- Structured Information (Strukturierte Information)
How It Works
- The API establishes a connection to the official Handelsregister
- Documents are retrieved in real-time
- Retrieved documents are automatically processed and made available via a secure URL
- Documents are cached to improve performance for subsequent requests
For detailed implementation instructions, refer to our API Reference.
Company Data Access
The Companies API provides comprehensive access to company data stored in our databases. This includes basic company information, registered addresses, legal form, status, and more.
Available Endpoints
Our API provides several endpoints for accessing company data:
For complete API details including parameters, request and response schemas, and authentication requirements, see our interactive API Reference.
Data Coverage FAQ
Last updated on