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 using simple query parameters. This endpoint provides a straightforward way to find companies by name, register number, or basic attributes. For more advanced filtering capabilities, see the advanced search endpoint. Cost: 1 credit per search

​
Search Parameters

You can search by free-text query (company name), or use specific filters like register_number, register_type (HRA, HRB, etc.), register_court, active status, and legal_form. Results are paginated - use the page and per_page parameters to navigate through results. The response provides a list of matching companies with basic information: company ID, name, registration details (register type, number, court), legal form, and current status. Use the company ID to retrieve detailed information from other endpoints.

​
Pagination

Results are returned in pages of up to 100 companies. Use page=1 for the first page, page=2 for the second, and so on. The response includes total count information to help you navigate through large result sets. For searches returning many results, consider using more specific filters to narrow your results.

​
Use Cases

Quick Lookup: Find a specific company when you know its name or register number. Simple searches are fast and cost-efficient at just 1 credit. Register Number Validation: Verify that a register number exists and retrieve basic company information for validation purposes. Name Variations: Search for companies by name to find the correct entry when you’re unsure of the exact legal name or spelling. 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 30).

Response

Successful search operation

​
results
object[]
required

List of companies matching the search criteria.

​
pagination
object
required