---
title: "Search for companies"
method: GET
path: "/v0/search/company"
tags: ["v0"]
---

# Search for companies

`GET /v0/search/company`

## Query parameters

- `query` string
- `register_number` string
- `register_type` 'HRB' | 'HRA' | 'PR' | 'GnR' | 'VR' — 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
- `active` boolean
- `legal_form` 'ag' | 'eg' | 'ek' | 'ev' | 'ewiv' | 'foreign' | 'gbr' | 'ggmbh' | 'gmbh' | 'kg' | 'kgaa' | 'unknown' | 'llp' | 'municipal' | 'ohg' | 'se' | 'ug' — 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)
- `incorporation_date` string — date format YYYY-MM-DD
- `page` integer
- `per_page` integer

## Response `200`

Successful search operation

- CompanySearchResponse
  - `results` CompanySearchResponseItem[], required — List of companies matching the search criteria.
    - `company_id` string, required — Unique company identifier. Example: DE-HRB-F1103-267645
    - `name` string, required — Official registered company name. Example: "Max Mustermann GmbH"
    - `country` string, nullable, required — Country where the company is registered using ISO 3166-1 alpha-2 code. Example: "DE" for Germany
    - `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)"
    - `active` boolean, required — Company status - true if active, false if inactive.
    - `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)
    - `address` CompanySearchAddress, 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 of the address using ISO 3166-1 alpha-2 code. Example: "DE" for Germany
      - `extra` string — Additional address information such as c/o or attention line. Example: "c/o Max Mustermann"
      - `formatted_value` string, required — Complete address formatted as a single string. Example: "Musterstraße 1, 10117 Berlin"
    - `purpose` string, nullable, required — Current official business purpose of the company, taken from the search index.
  - `pagination` Pagination, required
    - `page` integer, required — Current page number.
    - `per_page` integer, required — Number of results per page.
    - `total_pages` integer, required — Total number of pages.
    - `total_results` integer, required — Total number of results.

## Other responses

- `400` — Bad Request - Invalid parameters provided
- `401` — Unauthorized - Authentication required
- `402` — Payment Required - Insufficient credits for this request
- `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)