Sign in

v1

latestOpenAPI 3.1.02026-07-2623108126.0 KB
v1

Get detailed company information

get/v1/company/{company_id}

Path parameters

company_idstring required

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

Query parameters

realtimeboolean

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.

exportboolean

Setting this to true will return the company without sources.

Response

Successfully retrieved company data

idstring required

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

status'active' | 'inactive' | 'liquidation' required

Current status of the company:

  • active: Operating normally
  • inactive: No longer operating
  • liquidation: In the process of being dissolved
representation_rulestring 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."

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

Legal Entity Identifier (LEI), if available.

incorporated_atstring date required

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

notarized_atstring date nullable required

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

terminated_atstring date nullable required

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