import Openregister from 'openregister';
const client = new Openregister({
apiKey: process.env['OPENREGISTER_API_KEY'], // This is the default and can be omitted
});
const response = await client.company.getDetailsV1('company_id');
console.log(response.id);import os
from openregister import Openregister
client = Openregister(
api_key=os.environ.get("OPENREGISTER_API_KEY"), # This is the default and can be omitted
)
response = client.company.get_details_v1(
company_id="company_id",
)
print(response.id)package main
import (
"context"
"fmt"
"github.com/oregister/openregister-go"
"github.com/oregister/openregister-go/option"
)
func main() {
client := openregister.NewClient(
option.WithAPIKey("My API Key"),
)
response, err := client.Company.GetDetailsV1(
context.TODO(),
"company_id",
openregister.CompanyGetDetailsV1Params{},
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", response.ID)
}
openregister company get-details-v1 \
--api-key 'My API Key' \
--company-id company_idcurl --request GET \
--url https://api.openregister.de/v1/company/{company_id} \
--header 'Authorization: Bearer <token>'<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.openregister.de/v1/company/{company_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.get("https://api.openregister.de/v1/company/{company_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.openregister.de/v1/company/{company_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "<string>",
"register": {
"register_number": "<string>",
"register_type": "HRB",
"register_court": "<string>",
"company_id": "<string>",
"start_date": "2023-12-25"
},
"registers": [
{
"register_number": "<string>",
"register_type": "HRB",
"register_court": "<string>",
"company_id": "<string>",
"start_date": "2023-12-25"
}
],
"status": "active",
"name": {
"name": "<string>",
"legal_form": "ag",
"start_date": "2023-12-25"
},
"names": [
{
"name": "<string>",
"legal_form": "ag",
"start_date": "2023-12-25"
}
],
"address": {
"city": "<string>",
"country": "<string>",
"start_date": "2023-12-25",
"formatted_value": "<string>",
"street": "<string>",
"postal_code": "<string>",
"extra": "<string>"
},
"addresses": [
{
"city": "<string>",
"country": "<string>",
"start_date": "2023-12-25",
"formatted_value": "<string>",
"street": "<string>",
"postal_code": "<string>",
"extra": "<string>"
}
],
"purpose": {
"purpose": "<string>",
"start_date": "2023-12-25"
},
"purposes": [
{
"purpose": "<string>",
"start_date": "2023-12-25"
}
],
"capital": {
"amount": 123,
"currency": "EUR",
"start_date": "2023-12-25"
},
"capitals": [
{
"amount": 123,
"currency": "EUR",
"start_date": "2023-12-25"
}
],
"representation": [
{
"id": "<string>",
"name": "<string>",
"type": "natural_person",
"role": "DIRECTOR",
"role_detail": {
"code": "DIRECTOR",
"label_de": "<string>",
"label_de_short": "<string>",
"label_en": "<string>",
"label_en_short": "<string>"
},
"start_date": "2023-12-25",
"end_date": "2023-12-25",
"authority": "<string>",
"legal_person": {
"name": "<string>",
"city": "<string>",
"country": "<string>"
},
"natural_person": {
"city": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"date_of_birth": "2023-12-25"
}
}
],
"representation_rule": "<string>",
"indicators": [
{
"date": "2023-12-25",
"report_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"balance_sheet_total": 123,
"net_income": 123,
"revenue": 123,
"cash": 123,
"employees": 123,
"equity": 123,
"real_estate": 123,
"materials": 123,
"pension_provisions": 123,
"salaries": 123,
"taxes": 123,
"liabilities": 123,
"capital_reserves": 123
}
],
"legal_form": "ag",
"documents": [
{
"id": "<string>",
"type": "articles_of_association",
"date": "2023-12-25",
"latest": true
}
],
"incorporated_at": "2023-12-25",
"notarized_at": "2023-12-25",
"terminated_at": "2023-12-25",
"merged_into": {
"company_id": "<string>",
"name": "<string>",
"registration_date": "2023-12-25",
"agreement_date": "2023-12-25"
},
"acquisitions": [
{
"company_id": "<string>",
"name": "<string>",
"registration_date": "2023-12-25",
"agreement_date": "2023-12-25"
}
],
"asset_spin_offs": [
{
"company_id": "<string>",
"name": "<string>",
"registration_date": "2023-12-25",
"agreement_date": "2023-12-25"
}
],
"profit_transfer_agreement": {
"company_id": "<string>",
"name": "<string>",
"registration_date": "2023-12-25",
"agreement_date": "2023-12-25"
},
"industry_codes": {
"WZ2025": [
{
"code": "<string>"
}
]
},
"contact": {
"website_url": "<string>",
"social_media": {
"linkedin": "<string>",
"instagram": "<string>",
"github": "<string>",
"twitter": "<string>",
"facebook": "<string>",
"youtube": "<string>",
"xing": "<string>",
"tiktok": "<string>"
},
"email": "<string>",
"phone": "<string>",
"vat_id": "<string>"
},
"sources": [
{
"document_url": "<string>"
}
],
"lei": "<string>",
"insolvencies": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"current_status": "preliminary",
"court": "<string>",
"case_number": "<string>",
"proceeding_kind": "regular_insolvency",
"administration_kind": "external_administration",
"opened_at": "2023-12-25",
"closed_at": "2023-12-25"
}
]
}Company information
import Openregister from 'openregister';
const client = new Openregister({
apiKey: process.env['OPENREGISTER_API_KEY'], // This is the default and can be omitted
});
const response = await client.company.getDetailsV1('company_id');
console.log(response.id);import os
from openregister import Openregister
client = Openregister(
api_key=os.environ.get("OPENREGISTER_API_KEY"), # This is the default and can be omitted
)
response = client.company.get_details_v1(
company_id="company_id",
)
print(response.id)package main
import (
"context"
"fmt"
"github.com/oregister/openregister-go"
"github.com/oregister/openregister-go/option"
)
func main() {
client := openregister.NewClient(
option.WithAPIKey("My API Key"),
)
response, err := client.Company.GetDetailsV1(
context.TODO(),
"company_id",
openregister.CompanyGetDetailsV1Params{},
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", response.ID)
}
openregister company get-details-v1 \
--api-key 'My API Key' \
--company-id company_idcurl --request GET \
--url https://api.openregister.de/v1/company/{company_id} \
--header 'Authorization: Bearer <token>'<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.openregister.de/v1/company/{company_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.get("https://api.openregister.de/v1/company/{company_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.openregister.de/v1/company/{company_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "<string>",
"register": {
"register_number": "<string>",
"register_type": "HRB",
"register_court": "<string>",
"company_id": "<string>",
"start_date": "2023-12-25"
},
"registers": [
{
"register_number": "<string>",
"register_type": "HRB",
"register_court": "<string>",
"company_id": "<string>",
"start_date": "2023-12-25"
}
],
"status": "active",
"name": {
"name": "<string>",
"legal_form": "ag",
"start_date": "2023-12-25"
},
"names": [
{
"name": "<string>",
"legal_form": "ag",
"start_date": "2023-12-25"
}
],
"address": {
"city": "<string>",
"country": "<string>",
"start_date": "2023-12-25",
"formatted_value": "<string>",
"street": "<string>",
"postal_code": "<string>",
"extra": "<string>"
},
"addresses": [
{
"city": "<string>",
"country": "<string>",
"start_date": "2023-12-25",
"formatted_value": "<string>",
"street": "<string>",
"postal_code": "<string>",
"extra": "<string>"
}
],
"purpose": {
"purpose": "<string>",
"start_date": "2023-12-25"
},
"purposes": [
{
"purpose": "<string>",
"start_date": "2023-12-25"
}
],
"capital": {
"amount": 123,
"currency": "EUR",
"start_date": "2023-12-25"
},
"capitals": [
{
"amount": 123,
"currency": "EUR",
"start_date": "2023-12-25"
}
],
"representation": [
{
"id": "<string>",
"name": "<string>",
"type": "natural_person",
"role": "DIRECTOR",
"role_detail": {
"code": "DIRECTOR",
"label_de": "<string>",
"label_de_short": "<string>",
"label_en": "<string>",
"label_en_short": "<string>"
},
"start_date": "2023-12-25",
"end_date": "2023-12-25",
"authority": "<string>",
"legal_person": {
"name": "<string>",
"city": "<string>",
"country": "<string>"
},
"natural_person": {
"city": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"date_of_birth": "2023-12-25"
}
}
],
"representation_rule": "<string>",
"indicators": [
{
"date": "2023-12-25",
"report_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"balance_sheet_total": 123,
"net_income": 123,
"revenue": 123,
"cash": 123,
"employees": 123,
"equity": 123,
"real_estate": 123,
"materials": 123,
"pension_provisions": 123,
"salaries": 123,
"taxes": 123,
"liabilities": 123,
"capital_reserves": 123
}
],
"legal_form": "ag",
"documents": [
{
"id": "<string>",
"type": "articles_of_association",
"date": "2023-12-25",
"latest": true
}
],
"incorporated_at": "2023-12-25",
"notarized_at": "2023-12-25",
"terminated_at": "2023-12-25",
"merged_into": {
"company_id": "<string>",
"name": "<string>",
"registration_date": "2023-12-25",
"agreement_date": "2023-12-25"
},
"acquisitions": [
{
"company_id": "<string>",
"name": "<string>",
"registration_date": "2023-12-25",
"agreement_date": "2023-12-25"
}
],
"asset_spin_offs": [
{
"company_id": "<string>",
"name": "<string>",
"registration_date": "2023-12-25",
"agreement_date": "2023-12-25"
}
],
"profit_transfer_agreement": {
"company_id": "<string>",
"name": "<string>",
"registration_date": "2023-12-25",
"agreement_date": "2023-12-25"
},
"industry_codes": {
"WZ2025": [
{
"code": "<string>"
}
]
},
"contact": {
"website_url": "<string>",
"social_media": {
"linkedin": "<string>",
"instagram": "<string>",
"github": "<string>",
"twitter": "<string>",
"facebook": "<string>",
"youtube": "<string>",
"xing": "<string>",
"tiktok": "<string>"
},
"email": "<string>",
"phone": "<string>",
"vat_id": "<string>"
},
"sources": [
{
"document_url": "<string>"
}
],
"lei": "<string>",
"insolvencies": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"current_status": "preliminary",
"court": "<string>",
"case_number": "<string>",
"proceeding_kind": "regular_insolvency",
"administration_kind": "external_administration",
"opened_at": "2023-12-25",
"closed_at": "2023-12-25"
}
]
}Get company information
Returns comprehensive company data including registration details, management, financial indicators, contact information, and complete historical changes. Cost: 10 credits (20 credits withrealtime=true)
Realtime Parameter
Addrealtime=true to fetch the latest data directly from the Handelsregister. Costs an additional 10 credits. Use for compliance checks or when you need guaranteed current data.
Roles
Each entry inrepresentation carries a role and a role_detail — see Roles.
Insolvency Data
When the company has insolvency proceedings, the response includes aninsolvencies array with a summary of each proceeding. Use the insolvency endpoint to retrieve the full event history of a proceeding.Authorizations
API Key Authentication Provide your API key as a Bearer token in the Authorization header.
Path Parameters
Unique company identifier. Example: DE-HRB-F1103-267645
Query Parameters
Get the most up-to-date company information directly from the Handelsregister. When set to true, we fetch the latest data in real-time from the official German commercial register, ensuring you receive the most current company details. Note: Real-time requests take longer but guarantee the freshest data available.
Setting this to true will return the company without sources.
Response
Successfully retrieved company data
Unique company identifier. Example: DE-HRB-F1103-267645
Current registration information of the company.
Show child attributes
Show child attributes
Historical registration changes. Shows how registration details changed over time.
Show child attributes
Show child attributes
Current status of the company:
- active: Operating normally
- inactive: No longer operating
- liquidation: In the process of being dissolved
active, inactive, liquidation Current official name of the company.
Show child attributes
Show child attributes
Historical company names. Shows how the company name changed over time.
Show child attributes
Show child attributes
Current registered address of the company.
Show child attributes
Show child attributes
Historical addresses. Shows how the company address changed over time.
Show child attributes
Show child attributes
Current official business purpose of the company.
Show child attributes
Show child attributes
Historical business purposes. Shows how the company purpose changed over time.
Show child attributes
Show child attributes
Current registered capital of the company.
Show child attributes
Show child attributes
Historical capital changes. Shows how the company capital changed over time.
Show child attributes
Show child attributes
List of individuals or entities authorized to represent the company. Includes directors, officers, and authorized signatories.
Show child attributes
Show child attributes
The company's current general representation rule (allgemeine Vertretungsregelung), as published in the register. Example: "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."
Key company indicators like net income, employee count, revenue, etc..
Show child attributes
Show child attributes
Legal form of the company. Example: "gmbh" for Gesellschaft mit beschränkter Haftung
ag, eg, ek, ev, ewiv, foreign, gbr, ggmbh, gmbh, kg, kgaa, unknown, llp, municipal, ohg, se, ug Available official documents related to the company.
Show child attributes
Show child attributes
Date when the company was officially registered. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
Date of the notarized company agreement (Gesellschaftsvertrag or Satzung). Format: ISO 8601 (YYYY-MM-DD) Example: "2021-12-21"
Date when the company was officially terminated (if applicable). Format: ISO 8601 (YYYY-MM-DD) Example: "2024-01-01"
If the company ceased to exist through a merger (Verschmelzung), the company it was merged into.
Show child attributes
Show child attributes
Companies that were merged into this company (Verschmelzung durch Aufnahme, as the acquiring entity).
Show child attributes
Show child attributes
Spin-offs (Ausgliederung, § 123 Abs. 3 UmwG) in which this company transferred assets to another company as the transferring entity.
Show child attributes
Show child attributes
The company's current profit and loss transfer agreement (Gewinnabführungsvertrag), if one exists. The referenced company is the parent receiving this company's profit (Organträger). Null if the company has no active agreement.
Show child attributes
Show child attributes
Industry codes of the company.
Show child attributes
Show child attributes
Contact information of the company.
Show child attributes
Show child attributes
Sources of the company data.
Show child attributes
Show child attributes
Legal Entity Identifier (LEI), if available.
Insolvency proceedings of the company, if any. Contains basic information per proceeding; use the insolvency endpoint to retrieve all events of a proceeding.
Show child attributes
Show child attributes
Was this page helpful?

