Skip to main content
GET
/
v0
/
search
/
company
Search for companies
curl --request GET \
  --url https://api.openregister.de/v0/search/company \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "company_id": "<string>",
      "name": "<string>",
      "country": "<string>",
      "register_number": "<string>",
      "register_type": "HRB",
      "register_court": "<string>",
      "active": true,
      "legal_form": "ag"
    }
  ],
  "pagination": {
    "page": 123,
    "per_page": 123,
    "total_pages": 123,
    "total_results": 123
  }
}

​
Search companies

Search for companies based on various criteria. You can filter by company name, register number, register type, register court, active status, and legal form. The response provides a list of matching companies with their basic information including ID, name, registration details, status, and legal form. A full list of all german register courts is available here.

Authorizations

​
Authorization
string
header
required

API Key Authentication Provide your API key as a Bearer token in the Authorization header.

Query Parameters

​
query
string

Text search query to find companies by name. Example: "Descartes Technologies UG"

​
register_number
string

Company register number for exact matching. Example: "230633"

​
register_type
enum<string>

Type of register to filter results. Example: "HRB" (Commercial Register B)

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
Available options:
HRB,
HRA,
PR,
GnR,
VR
​
register_court
string

Court where the company is registered. Example: "Berlin (Charlottenburg)"

​
active
boolean
default:true

Filter for active or inactive companies. Set to true for active companies only, false for inactive only.

​
legal_form
enum<string>

Legal form of the company. Example: "gmbh" for "Gesellschaft mit beschränkter Haftung"

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)
Available options:
ag,
eg,
ek,
ev,
ewiv,
foreign,
gbr,
ggmbh,
gmbh,
kg,
kgaa,
unknown,
llp,
municipal,
ohg,
se,
ug
​
incorporation_date
string

Date of incorporation of the company. Format: ISO 8601 (YYYY-MM-DD) Example: "2022-01-01"

date format YYYY-MM-DD

​
page
integer
default:1

Page number for pagination.

​
per_page
integer
default:10

Number of results per page (max 50).

Response

Successful search operation

​
results
object[]
required

List of companies matching the search criteria.

​
pagination
object
required