Skip to main content
GET
JavaScript

Get company information

Returns comprehensive company data including registration details, management, financial indicators, contact information, and complete historical changes. Cost: 10 credits (20 credits with realtime=true)

Realtime Parameter

Add realtime=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.

Insolvency Data

When the company has insolvency proceedings, the response includes an insolvencies array with a summary of each proceeding. Use the insolvency endpoint to retrieve the full event history of a proceeding.

Authorizations

Authorization
string
header
required

API Key Authentication Provide your API key as a Bearer token in the Authorization header.

Path Parameters

company_id
string
required

Unique company identifier. Example: DE-HRB-F1103-267645

Query Parameters

realtime
boolean

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.

export
boolean

Setting this to true will return the company without sources.

Response

Successfully retrieved company data

id
string
required

Unique company identifier. Example: DE-HRB-F1103-267645

register
object
required

Current registration information of the company.

registers
object[]
required

Historical registration changes. Shows how registration details changed over time.

status
enum<string>
required

Current status of the company:

  • active: Operating normally
  • inactive: No longer operating
  • liquidation: In the process of being dissolved
Available options:
active,
inactive,
liquidation
name
object
required

Current official name of the company.

names
object[]
required

Historical company names. Shows how the company name changed over time.

address
object
required

Current registered address of the company.

addresses
object[]
required

Historical addresses. Shows how the company address changed over time.

purpose
object | null
required

Current official business purpose of the company.

purposes
object[]
required

Historical business purposes. Shows how the company purpose changed over time.

capital
object | null
required

Current registered capital of the company.

capitals
object[]
required

Historical capital changes. Shows how the company capital changed over time.

representation
object[]
required

List of individuals or entities authorized to represent the company. Includes directors, officers, and authorized signatories.

representation_rule
string | null
required

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."

indicators
object[]
required

Key company indicators like net income, employee count, revenue, etc..

Legal form of the company. Example: "gmbh" for Gesellschaft mit beschränkter Haftung

Available options:
ag,
eg,
ek,
ev,
ewiv,
foreign,
gbr,
ggmbh,
gmbh,
kg,
kgaa,
unknown,
llp,
municipal,
ohg,
se,
ug
documents
object[]
required

Available official documents related to the company.

incorporated_at
string<date>
required

Date when the company was officially registered. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"

notarized_at
string<date> | null
required

Date of the notarized company agreement (Gesellschaftsvertrag or Satzung). Format: ISO 8601 (YYYY-MM-DD) Example: "2021-12-21"

terminated_at
string<date> | null
required

Date when the company was officially terminated (if applicable). Format: ISO 8601 (YYYY-MM-DD) Example: "2024-01-01"

merged_into
object | null
required

If the company ceased to exist through a merger (Verschmelzung), the company it was merged into.

acquisitions
object[]
required

Companies that were merged into this company (Verschmelzung durch Aufnahme, as the acquiring entity).

asset_spin_offs
object[]
required

Spin-offs (Ausgliederung, § 123 Abs. 3 UmwG) in which this company transferred assets to another company as the transferring entity.

profit_transfer_agreement
object | null
required

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.

industry_codes
object
required

Industry codes of the company.

contact
object | null
required

Contact information of the company.

sources
object[]
required

Sources of the company data.

lei
string

Legal Entity Identifier (LEI), if available.

insolvencies
object[]

Insolvency proceedings of the company, if any. Contains basic information per proceeding; use the insolvency endpoint to retrieve all events of a proceeding.