Company information

GET /v1/company/{company_id}

JavaScript

JavaScript

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);

200

{
  "id": "<string>",
  "register": {
    "register_number": "<string>",
    "register_court": "<string>",
    "company_id": "<string>",
    "start_date": "<string>"
  },
  "registers": [
    {
      "register_number": "<string>",
      "register_court": "<string>",
      "company_id": "<string>",
      "start_date": "<string>"
    }
  ],
  "name": {
    "name": "<string>",
    "start_date": "<string>"
  },
  "names": [
    {
      "name": "<string>",
      "start_date": "<string>"
    }
  ],
  "address": {
    "city": "<string>",
    "country": "<string>",
    "start_date": "<string>",
    "formatted_value": "<string>",
    "street": "<string>",
    "postal_code": "<string>",
    "extra": "<string>"
  },
  "addresses": [
    {
      "city": "<string>",
      "country": "<string>",
      "start_date": "<string>",
      "formatted_value": "<string>",
      "street": "<string>",
      "postal_code": "<string>",
      "extra": "<string>"
    }
  ],
  "purpose": {
    "purpose": "<string>",
    "start_date": "<string>"
  },
  "purposes": [
    {
      "purpose": "<string>",
      "start_date": "<string>"
    }
  ],
  "capital": {
    "amount": 123,
    "start_date": "<string>"
  },
  "capitals": [
    {
      "amount": 123,
      "start_date": "<string>"
    }
  ],
  "representation": [
    {
      "id": "<string>",
      "name": "<string>",
      "start_date": "<string>",
      "end_date": "<string>",
      "legal_person": {
        "name": "<string>",
        "city": "<string>",
        "country": "<string>"
      },
      "natural_person": {
        "city": "<string>",
        "first_name": "<string>",
        "last_name": "<string>",
        "date_of_birth": "<string>"
      }
    }
  ],
  "indicators": [
    {
      "date": "<string>",
      "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,
      "active_accruals": 123,
      "passive_accruals": 123
    }
  ],
  "documents": [
    {
      "id": "<string>",
      "date": "<string>",
      "latest": true
    }
  ],
  "incorporated_at": "<string>",
  "notarized_at": "<string>",
  "terminated_at": "<string>",
  "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>"
}

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.

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

200

application/json

Successfully retrieved company data

id · string · required

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

register · object · required

Current registration information of the company.

Show child attributes

registers · object[] · required

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

Show child attributes

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.

Show child attributes

names · object[] · required

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

Show child attributes

address · object · required

Current registered address of the company.

Show child attributes

addresses · object[] · required

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

Show child attributes

purpose · object · required

Current official business purpose of the company.

Show child attributes

purposes · object[] · required

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

Show child attributes

capital · object · required

Current registered capital of the company.

Show child attributes

capitals · object[] · required

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

Show child attributes

representation · object[] · required

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

Show child attributes

indicators · object[] · required

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

Show child attributes

legal_form · enum<string> · required

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.

Show child attributes

incorporated_at · string · required

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

notarized_at · string | null · required

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

terminated_at · string | null · required

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

industry_codes · object · required

Industry codes of the company.

Show child attributes

contact · object · required

Contact information of the company.

Show child attributes

sources · object[] · required

Sources of the company data.

Show child attributes

lei · string

Legal Entity Identifier (LEI), if available.