Skip to main content
GET
/
v1
/
company
/
{company_id}
JavaScript
import Openregister from 'openregister';

const client = new Openregister({
  apiKey: 'My API Key',
});

const response = await client.company.getDetailsV1('company_id');

console.log(response.id);
{
  "id": "<string>",
  "register": {
    "company_id": "<string>",
    "register_number": "<string>",
    "register_type": "HRB",
    "register_court": "<string>",
    "start_date": "<string>"
  },
  "registers": [
    {
      "company_id": "<string>",
      "register_number": "<string>",
      "register_type": "HRB",
      "register_court": "<string>",
      "start_date": "<string>"
    }
  ],
  "status": "active",
  "name": {
    "name": "<string>",
    "legal_form": "ag",
    "start_date": "<string>"
  },
  "names": [
    {
      "name": "<string>",
      "legal_form": "ag",
      "start_date": "<string>"
    }
  ],
  "address": {
    "street": "<string>",
    "city": "<string>",
    "postal_code": "<string>",
    "country": "<string>",
    "extra": "<string>",
    "start_date": "<string>",
    "formatted_value": "<string>"
  },
  "addresses": [
    {
      "street": "<string>",
      "city": "<string>",
      "postal_code": "<string>",
      "country": "<string>",
      "extra": "<string>",
      "start_date": "<string>",
      "formatted_value": "<string>"
    }
  ],
  "purpose": {
    "purpose": "<string>",
    "start_date": "<string>"
  },
  "purposes": [
    {
      "purpose": "<string>",
      "start_date": "<string>"
    }
  ],
  "capital": {
    "amount": 123,
    "currency": "EUR",
    "start_date": "<string>"
  },
  "capitals": [
    {
      "amount": 123,
      "currency": "EUR",
      "start_date": "<string>"
    }
  ],
  "representation": [
    {
      "id": "<string>",
      "name": "<string>",
      "type": "natural_person",
      "role": "DIRECTOR",
      "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
    }
  ],
  "legal_form": "ag",
  "documents": [
    {
      "id": "<string>",
      "type": "articles_of_association",
      "date": "<string>",
      "latest": true
    }
  ],
  "incorporated_at": "<string>",
  "terminated_at": "<string>",
  "industry_codes": {
    "WZ2025": [
      {
        "code": "<string>"
      }
    ]
  },
  "contact": {
    "email": "<string>",
    "phone": "<string>",
    "vat_id": "<string>",
    "website_url": "<string>",
    "social_media": {
      "linkedin": "<string>",
      "instagram": "<string>",
      "github": "<string>",
      "twitter": "<string>",
      "facebook": "<string>",
      "youtube": "<string>",
      "xing": "<string>",
      "tiktok": "<string>"
    }
  },
  "sources": [
    {
      "document_url": "<string>"
    }
  ]
}

Get company information

Retrieve detailed information about a company using its unique ID.

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
array
required

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

capital
object | null
required

Current registered capital of the company.

capitals
array
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.

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
required

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

terminated_at
string | null
required

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

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.

I