GET
/
v0
/
search
/
company
JavaScript
import Openregister from 'openregister';

const client = new Openregister({
  apiKey: process.env['OPENREGISTER_API_KEY'], // This is the default and can be omitted
});

const response = await client.search.findCompanies();

console.log(response.pagination);
{
  "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)

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"

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"

​
page
integer
default:1

Page number for pagination.

​
per_page
integer
default:10

Number of results per page (max 50).

Response

200
application/json

Successful search operation

The response is of type object.