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

# Get detailed company information

`GET /v0/company/{company_id}`

## Request

- Base URL: `https://api.openregister.de`
- URL: `https://api.openregister.de/v0/company/{company_id}`
- Auth: HTTP bearer

## 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

## Changes

- **2026-06-24** `1aebcb0cae4a`: 7 breaking, 35 warning, 2 info
  - the `capital` response's property type changed from `object` to no type for status `200`
  - the `purpose` response's property type changed from `object` to no type for status `200`
  - removed the required property `capital/amount` from the response with the `200` status
  - removed the required property `capital/currency` from the response with the `200` status
  - …40 more
- **2025-08-27** `b37d87e51e02`: 4 breaking, 1 info
  - the response property `capital` became nullable for the status `200`
  - the response property `capitals/items/` became nullable for the status `200`
  - the response property `purpose` became nullable for the status `200`
  - the response property `purposes/items/` became nullable for the status `200`
  - …1 more
- **2025-08-07** `479e9feda92d`: 1 info
  - the response property `representation/items/country` became required for the status `200`
- **2025-08-07** `174349fff670`: 1 breaking
  - the response property `representation/items/country` became optional for the status `200`

[Operation history](https://skmtc.dev/oregister/apis/openregister-api/changes/v0/company/:company_id/get.md)

---

[API](https://skmtc.dev/oregister/apis/openregister-api.md) - [All operations](https://skmtc.dev/oregister/apis/openregister-api/llms.txt) - [OpenAPI document](https://skmtc.dev/oregister/apis/openregister-api/revisions/d1fcaf6d6ca0?raw)