---
title: "Get detailed company information"
method: GET
path: "/v1/company/{company_id}"
tags: ["v1"]
---

# Get detailed company information

`GET /v1/company/{company_id}`

## Path parameters

- `company_id` string, required

## Query parameters

- `realtime` boolean
- `export` boolean

## Response `200`

Successfully retrieved company data

- CompanyV1
  - `id` string, required — Unique company identifier. Example: DE-HRB-F1103-267645
  - `register` CompanyRegister, required
    - `company_id` string — Unique company identifier. Example: DE-HRB-F1103-267645
    - `register_number` string, required — Registration number in the company register. Example: "230633"
    - `register_type` 'HRB' | 'HRA' | 'PR' | 'GnR' | 'VR', required — Type of company register where the entity is recorded. Common types: - HRB: Commercial Register B (limited liability companies, stock corporations) - HRA: Commercial Register A (partnerships, sole proprietorships) - PR: Partnership Register - GnR: Cooperative Register - VR: Association Register
    - `register_court` string, required — Court where the company is registered. Example: "Berlin (Charlottenburg)"
    - `start_date` string, date — Date when this registration information became effective. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
  - `registers` CompanyRegister[], required — Historical registration changes. Shows how registration details changed over time.
    - `company_id` string — Unique company identifier. Example: DE-HRB-F1103-267645
    - `register_number` string, required — Registration number in the company register. Example: "230633"
    - `register_type` 'HRB' | 'HRA' | 'PR' | 'GnR' | 'VR', required — Type of company register where the entity is recorded. Common types: - HRB: Commercial Register B (limited liability companies, stock corporations) - HRA: Commercial Register A (partnerships, sole proprietorships) - PR: Partnership Register - GnR: Cooperative Register - VR: Association Register
    - `register_court` string, required — Court where the company is registered. Example: "Berlin (Charlottenburg)"
    - `start_date` string, date — Date when this registration information became effective. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
  - `status` 'active' | 'inactive' | 'liquidation', required — Current status of the company: - active: Operating normally - inactive: No longer operating - liquidation: In the process of being dissolved
  - `name` CompanyName, required
    - `name` string, required — Official company name including any legal form designations. Example: "Descartes Technologies UG (haftungsbeschränkt)"
    - `legal_form` 'ag' | 'eg' | 'ek' | 'ev' | 'ewiv' | 'foreign' | 'gbr' | 'ggmbh' | 'gmbh' | 'kg' | 'kgaa' | 'unknown' | 'llp' | 'municipal' | 'ohg' | 'se' | 'ug', required — Legal form of the company. Common German legal forms: - gmbh: Gesellschaft mit beschränkter Haftung (Limited Liability Company) - ag: Aktiengesellschaft (Stock Corporation) - ug: Unternehmergesellschaft (Entrepreneurial Company with limited liability) - ohg: Offene Handelsgesellschaft (General Partnership) - kg: Kommanditgesellschaft (Limited Partnership) - ev: Eingetragener Verein (Registered Association)
    - `start_date` string, date, required — Date when this name became effective. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
  - `names` CompanyName[], required — Historical company names. Shows how the company name changed over time.
    - `name` string, required — Official company name including any legal form designations. Example: "Descartes Technologies UG (haftungsbeschränkt)"
    - `legal_form` 'ag' | 'eg' | 'ek' | 'ev' | 'ewiv' | 'foreign' | 'gbr' | 'ggmbh' | 'gmbh' | 'kg' | 'kgaa' | 'unknown' | 'llp' | 'municipal' | 'ohg' | 'se' | 'ug', required — Legal form of the company. Common German legal forms: - gmbh: Gesellschaft mit beschränkter Haftung (Limited Liability Company) - ag: Aktiengesellschaft (Stock Corporation) - ug: Unternehmergesellschaft (Entrepreneurial Company with limited liability) - ohg: Offene Handelsgesellschaft (General Partnership) - kg: Kommanditgesellschaft (Limited Partnership) - ev: Eingetragener Verein (Registered Association)
    - `start_date` string, date, required — Date when this name became effective. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
  - `address` CompanyAddress, required
    - `street` string — Street name and number. Example: "Musterstraße 1"
    - `city` string, required — City or locality name. Example: "Berlin"
    - `postal_code` string — Postal or ZIP code. Example: "10117"
    - `country` string, required — Country name. Example: "Germany"
    - `extra` string — Additional address information such as c/o or attention line. Example: "c/o Max Mustermann"
    - `start_date` string, date, required — Date when this address became effective. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
    - `formatted_value` string, required — Complete address formatted as a single string. Example: "Musterstraße 1, 10117 Berlin, Germany"
  - `addresses` CompanyAddress[], required — Historical addresses. Shows how the company address changed over time.
    - `street` string — Street name and number. Example: "Musterstraße 1"
    - `city` string, required — City or locality name. Example: "Berlin"
    - `postal_code` string — Postal or ZIP code. Example: "10117"
    - `country` string, required — Country name. Example: "Germany"
    - `extra` string — Additional address information such as c/o or attention line. Example: "c/o Max Mustermann"
    - `start_date` string, date, required — Date when this address became effective. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
    - `formatted_value` string, required — Complete address formatted as a single string. Example: "Musterstraße 1, 10117 Berlin, Germany"
  - `purpose` CompanyPurpose, required
    - `purpose` string, required — Official description of the company's business activities and objectives. This is the registered purpose as stated in official documents.
    - `start_date` string, date, required — Date when this purpose became effective. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
  - `purposes` CompanyPurpose[], required — Historical business purposes. Shows how the company purpose changed over time.
    - `purpose` string, required — Official description of the company's business activities and objectives. This is the registered purpose as stated in official documents.
    - `start_date` string, date, required — Date when this purpose became effective. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
  - `capital` CompanyCapital, required
    - `amount` number, double, required — Capital amount as a decimal number. Example: 100000.00 represents 100,000.00 monetary units
    - `currency` 'EUR' | 'DEM' | 'USD', required — Currency code for the capital amount. Example: "EUR" for Euro
    - `start_date` string, date, required — Date when this capital amount became effective. Format: ISO 8601 (YYYY-MM-DD) Example: "2023-01-01"
  - `capitals` CompanyCapital[], required — Historical capital changes. Shows how the company capital changed over time.
    - `amount` number, double, required — Capital amount as a decimal number. Example: 100000.00 represents 100,000.00 monetary units
    - `currency` 'EUR' | 'DEM' | 'USD', required — Currency code for the capital amount. Example: "EUR" for Euro
    - `start_date` string, date, required — Date when this capital amount became effective. Format: ISO 8601 (YYYY-MM-DD) Example: "2023-01-01"
  - `representation` CompanyRepresentativeV1[], required — List of individuals or entities authorized to represent the company. Includes directors, officers, and authorized signatories.
    - `id` string, nullable, required — Unique identifier for the representative. For companies: Format matches company_id pattern For individuals: UUID Example: "DE-HRB-F1103-267645" or UUID May be null for certain representatives.
    - `name` string, required — The name of the representative. E.g. "Max Mustermann" or "Max Mustermann GmbH"
    - `type` 'natural_person' | 'legal_person', required
    - `role` 'DIRECTOR' | 'PROKURA' | 'SHAREHOLDER' | 'OWNER' | 'PARTNER' | 'PERSONAL_LIABLE_DIRECTOR' | 'LIQUIDATOR' | 'OTHER', required
    - `start_date` string, date, required — Date when this representative role became effective. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
    - `end_date` string, date, nullable, required — Date when this representative role ended (if applicable). Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
    - `authority` string, nullable, required — The representative's current individual representation authority (individuelle Vertretungsbefugnis), as published in the register. Null if no special authority is recorded. Example: "einzelvertretungsberechtigt mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen Rechtsgeschäfte abzuschließen"
    - `legal_person` CompanyRepresentativeV1LegalPerson, nullable
      - `name` string, required
      - `city` string, nullable, required
      - `country` string, required — Country where the representative is located, in ISO 3166-1 alpha-2 format. Example: "DE" for Germany
    - `natural_person` CompanyRepresentativeV1NaturalPerson, nullable
      - `city` string, nullable, required — City where the representative is located. Example: "Berlin"
      - `first_name` string, nullable, required — First name of the representative. Example: "Max"
      - `last_name` string, nullable, required — Last name of the representative. Example: "Mustermann"
      - `date_of_birth` string, date, nullable, required — Date of birth of the representative. May still be null for natural persons if it is not available. Format: ISO 8601 (YYYY-MM-DD) Example: "1990-01-01"
  - `representation_rule` string, nullable, 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` CompanyIndicatorSummary[], required — Key company indicators like net income, employee count, revenue, etc..
    - `date` string, date, required — Date to which this financial indicators apply. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
    - `report_id` string, uuid, required — The report id (source) of the indicators.
    - `balance_sheet_total` integer, nullable, required — The balance sheet total of that year (in cents).
    - `net_income` integer, nullable, required — The net income of that year (in cents).
    - `revenue` integer, nullable, required — The revenue of that year (in cents).
    - `cash` integer, nullable, required — The cash of that year (in cents).
    - `employees` integer, nullable, required — The number of employees of that year.
    - `equity` integer, nullable, required — The equity of that year (in cents).
    - `real_estate` integer, nullable, required — The real estate of that year (in cents).
    - `materials` integer, nullable, required — The materials of that year (in cents).
    - `pension_provisions` integer, nullable, required — The pension provisions of that year (in cents).
    - `salaries` integer, nullable, required — The salaries of that year (in cents).
    - `taxes` integer, nullable, required — The taxes of that year (in cents).
    - `liabilities` integer, nullable, required — The liabilities of that year (in cents).
    - `capital_reserves` integer, nullable, required — The capital reserves of that year (in cents).
  - `legal_form` 'ag' | 'eg' | 'ek' | 'ev' | 'ewiv' | 'foreign' | 'gbr' | 'ggmbh' | 'gmbh' | 'kg' | 'kgaa' | 'unknown' | 'llp' | 'municipal' | 'ohg' | 'se' | 'ug', required — Legal form of the company. Common German legal forms: - gmbh: Gesellschaft mit beschränkter Haftung (Limited Liability Company) - ag: Aktiengesellschaft (Stock Corporation) - ug: Unternehmergesellschaft (Entrepreneurial Company with limited liability) - ohg: Offene Handelsgesellschaft (General Partnership) - kg: Kommanditgesellschaft (Limited Partnership) - ev: Eingetragener Verein (Registered Association)
  - `lei` string — Legal Entity Identifier (LEI), if available.
  - `documents` CompanyDocument[], required — Available official documents related to the company.
    - `id` string, required — Unique identifier for the document. Example: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    - `type` 'articles_of_association' | 'sample_protocol' | 'shareholder_list', required — Categorization of the document: - articles_of_association: Company statutes/bylaws - sample_protocol: Standard founding protocol - shareholder_list: List of company shareholders
    - `date` string, date, required — Document publication or filing date. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
    - `latest` boolean, required — Whether this is the latest version of the document_type.
  - `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, nullable, required — Date of the notarized company agreement (Gesellschaftsvertrag or Satzung). Format: ISO 8601 (YYYY-MM-DD) Example: "2021-12-21"
  - `terminated_at` string, date, nullable, required — Date when the company was officially terminated (if applicable). Format: ISO 8601 (YYYY-MM-DD) Example: "2024-01-01"
  - `merged_into` CompanyMergedInto, required
    - `company_id` string, required — Unique company identifier of the company this company was merged into. Example: DE-HRB-F1103-267645
    - `name` string, required — Current name of the company this company was merged into.
    - `registration_date` string, date, required — Date the merger was registered. Format: ISO 8601 (YYYY-MM-DD)
    - `agreement_date` string, date, nullable, required — Date the underlying contract (Verschmelzungsvertrag) was concluded, as cited in the register entry. Null when the register text does not cite a contract date. Entries sharing an agreement_date belong to the same transaction. Format: ISO 8601 (YYYY-MM-DD)
  - `acquisitions` CompanyAcquisition[], required — Companies that were merged into this company (Verschmelzung durch Aufnahme, as the acquiring entity).
    - `company_id` string, required — Unique company identifier of the company that was merged into this company. Example: DE-HRB-F1103-267645
    - `name` string, required — Current name of the company that was merged into this company.
    - `registration_date` string, date, required — Date the merger was registered. Format: ISO 8601 (YYYY-MM-DD)
    - `agreement_date` string, date, nullable, required — Date the underlying contract (Verschmelzungsvertrag) was concluded, as cited in the register entry. Null when the register text does not cite a contract date. Entries sharing an agreement_date belong to the same transaction. Format: ISO 8601 (YYYY-MM-DD)
  - `asset_spin_offs` CompanyAssetSpinOff[], required — Spin-offs (Ausgliederung, § 123 Abs. 3 UmwG) in which this company transferred assets to another company as the transferring entity.
    - `company_id` string, required — Unique company identifier of the company that received the assets. Example: DE-HRB-F1103-267645
    - `name` string, required — Current name of the company that received the assets.
    - `registration_date` string, date, required — Date the spin-off was registered. Format: ISO 8601 (YYYY-MM-DD)
    - `agreement_date` string, date, nullable, required — Date the underlying contract (Ausgliederungsvertrag) was concluded, as cited in the register entry. Null when the register text does not cite a contract date. Entries sharing an agreement_date belong to the same transaction. Format: ISO 8601 (YYYY-MM-DD)
  - `profit_transfer_agreement` CompanyProfitTransferAgreement, required
    - `company_id` string, required — Unique company identifier of the parent company receiving this company's profit (Organträger). Example: DE-HRB-F1103-267645
    - `name` string, required — Current name of the parent company.
    - `registration_date` string, date, required — Date the agreement was registered. Format: ISO 8601 (YYYY-MM-DD)
    - `agreement_date` string, date, nullable, required — Date the underlying contract (Gewinnabführungsvertrag) was concluded, as cited in the register entry. Null when the register text does not cite a contract date. Entries sharing an agreement_date belong to the same transaction. Format: ISO 8601 (YYYY-MM-DD)
  - `industry_codes` object, required — Industry codes of the company.
    - `WZ2025` IndustryCode[], required
      - `code` string, required
  - `contact` Website, required
    - `email` string
    - `phone` string
    - `vat_id` string
    - `website_url` string, required
    - `social_media` SocialMediaLinks, required
      - `linkedin` string
      - `instagram` string
      - `github` string
      - `twitter` string
      - `facebook` string
      - `youtube` string
      - `xing` string
      - `tiktok` string
  - `insolvencies` CompanyInsolvencySummary[] — Insolvency proceedings of the company, if any. Contains basic information per proceeding; use the insolvency endpoint to retrieve all events of a proceeding.
    - `id` string, uuid, required — Unique identifier of the insolvency proceeding.
    - `current_status` 'preliminary' | 'opened' | 'rejected_no_assets' | 'mass_insufficient' | 'plan_supervised' | 'lifted' | 'discontinued' | 'discharge_pending' | 'discharge_granted' | 'discharge_denied' | 'discharge_revoked' | 'unknown', required — Current status of the insolvency proceeding.
    - `court` string, required — Insolvency court handling the proceeding.
    - `case_number` string, required — Case number of the proceeding at the court. Example: "36d IN 3382/25"
    - `proceeding_kind` 'regular_insolvency' | 'consumer_insolvency' — Kind of insolvency proceeding.
    - `administration_kind` 'external_administration' | 'self_administration' | 'protective_shield' — Kind of administration ordered for the proceeding.
    - `opened_at` string, date, nullable — Date the proceeding was opened. Format: ISO 8601 (YYYY-MM-DD)
    - `closed_at` string, date, nullable — Date the proceeding was closed. Format: ISO 8601 (YYYY-MM-DD)
  - `sources` Source[], required — Sources of the company data.
    - `document_url` string, required — Url of the source document. In the form of a presigned url accessible for 30 minutes.

## Other responses

- `400` — Bad Request - Invalid parameters provided
- `401` — Unauthorized - Authentication required
- `402` — Payment Required - Insufficient credits for this request
- `404` — Not Found - Company ID doesn't exist
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error - An error occurred while processing the request

---

[API](https://skmtc.net/oregister/apis/openregister-api.md) · [All operations](https://skmtc.net/oregister/apis/openregister-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oregister/openregister-api/revisions/d1fcaf6d6ca0/schema)