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

# Get detailed company information

`GET /v0/company/{company_id}`

## Path parameters

- `company_id` string, required

## Query parameters

- `history` boolean
- `financials` boolean
- `documents` boolean

## Response `200`

Successfully retrieved company data

- Company
  - `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[] — Historical registration changes, only included when history=true. 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[] — Historical company names, only included when history=true. 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[] — Historical addresses, only included when history=true. 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
    - `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[] — Historical business purposes, only included when history=true. 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
    - `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[] — Historical capital changes, only included when history=true. 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` CompanyRepresentative[], required — List of individuals or entities authorized to represent the company. Includes directors, officers, and authorized signatories.
    - `id` string — 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 — Date when this representative role ended (if applicable). Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
    - `city` string, required — City where the representative is located. Example: "Berlin"
    - `country` string, required — Country where the representative is located, in ISO 3166-1 alpha-2 format. Example: "DE" for Germany
    - `first_name` string — First name of the representative. Only provided for type=natural_person. Example: "Max"
    - `last_name` string — Last name of the representative. Only provided for type=natural_person. Example: "Mustermann"
    - `date_of_birth` string, date — Date of birth of the representative. Only provided for type=natural_person. May still be null for natural persons if it is not available. Format: ISO 8601 (YYYY-MM-DD) Example: "1990-01-01"
  - `financials` CompanyFinancials
    - `reports` FinancialReport[], required — The financial reports of the company.
      - `id` string, required — The unique identifier for the financial report. E.g. "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      - `name` string, required — The name of the financial report. E.g. "Jahresabschluss 2022"
      - `published_at` string, date, required — The date when the financial report was published. Format: ISO 8601 (YYYY-MM-DD)
    - `indicators` FinancialIndicator[], required — Key financial metrics extracted from the reports. Includes balance sheet totals, revenue, and other important figures.
      - `report_id` string, required — The identifier for the financial report this indicator originates from. E.g. "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      - `type` 'balance_sheet_total' | 'net_income' | 'parent_net_income' | 'income_before_tax' | 'income_after_tax' | 'ebit' | 'ebitda' | 'revenue' | 'gross_profit' | 'cash' | 'employees' | 'equity' | 'real_estate' | 'materials' | 'pension_provisions' | 'salaries' | 'taxes' | 'other_taxes' | 'commission_income' | 'commission_expense' | 'liabilities' | 'capital_reserves' | 'active_accruals' | 'passive_accruals' | 'fixed_assets' | 'current_assets' | 'receivables' | 'trade_receivables' | 'inventory' | 'provisions' | 'bank_debt' | 'trade_payables' | 'tangible_assets' | 'financial_assets' | 'retained_earnings' | 'profit_carryforward' | 'other_provisions' | 'shareholder_liabilities' | 'operating_depreciation' | 'financial_depreciation' | 'other_operating_income' | 'interest_income' | 'interest_expense' | 'other_liabilities' | 'financial_debt' | 'intangible_assets' | 'other_operating_expenses' | 'affiliated_liabilities', required — The type of indicator.
      - `value` integer, required — Value of the indicator in the smallest currency unit (cents). Example: 2099 represents €20.99 for monetary values For non-monetary values (e.g., employees), the actual number.
      - `date` string, date, required — Date to which this financial indicator applies. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"
  - `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)
  - `documents` CompanyDocument[] — Available official documents related to the company, only included when documents=true.
    - `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"
  - `terminated_at` string, date — Date when the company was officially terminated (if applicable). Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"

## 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/versions/d1fcaf6d6ca0/schema)