Search Company

Search mirrored German registry companies by name and strict supported filters.

[!NOTE] See the API Guide for the shared request lifecycle (sync, async polling, async webhook), error envelope, rate limits, custom_vars, and deduplication. This endpoint uses the German registry pilot feature gate.

Try it

Pricing

Endpoint

Input Parameters

Provide either a meaningful query (at least three searchable characters after trimming whitespace and wildcard characters) or at least one selective filter: register_type, legal_form, state, or city. has_financials may be added only when paired with a meaningful query or one of those selective filters. Supported filters keys are exactly: register_type, legal_form, state, city, and has_financials. Unknown top-level search parameters or filters return 422 before enrichment creation or credit reservation. Founded/incorporation-date filters are not available in v1.

Pagination is bounded: page accepts 1 through 1000; per_page accepts 1 through 100 and defaults to 25. The response retains total_results and total_pages for OpenRegister compatibility; those count queries use the same indexed mirror search path as the result page.

Search Scope

V1 is mirror-only. It searches the local registry mirror and does not perform a live Handelsregister or Bundesanzeiger lookup. Responses include _registry_meta.search_scope = "mirror".

has_financials is based on whether the mirrored company has a financial-category publication.

Examples

Output Fields

Typical Response Times

Mirror search: optimized for local indexed mirror queries; latency depends on mirror size and filter selectivity.