Skip to main content
POST
/
v1
/
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 companySearch = await client.search.findCompaniesV1();

console.log(companySearch.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

Perform advanced searches with complex filters to find companies matching specific criteria. Combine multiple filters on company attributes, financial metrics, ownership characteristics, and geographic location to identify your exact target audience. Cost: 10 credits per search

Powerful Filtering Options

Use filters to search by company status, legal form, location (city, postal code, or radius), industry codes, financial metrics (revenue, employees, balance sheet), incorporation date, ownership structure (family-owned, sole owner, owner-managed), and more. Combine multiple filters with AND logic to narrow your results precisely. You can filter by over 20 different fields including balance sheet totals, employee counts, youngest owner age, capital amounts, and specific ownership characteristics. See our filtering guide for detailed examples and all available filter fields.

Use Cases

Lead Generation: Find companies matching your ideal customer profile. For example, search for GmbH companies in a specific industry with 50-200 employees and revenue over €5M in your target region. Market Analysis: Identify all companies in a specific industry sector, analyze their distribution across regions, or find newly incorporated businesses in your market. Succession Planning: Search for owner-managed companies where the owner is approaching retirement age (youngest_owner_age > 60, has_representative_owner = true) - perfect for identifying acquisition opportunities or succession planning services. 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.

Body

application/json
query
object

Search query to filter companies.

filters
object[]

Filters to filter companies.

location
object

Location to filter companies.

pagination
object

Pagination parameters.

Response

Successful search operation

results
object[]
required

List of companies matching the search criteria.

pagination
object
required