Search for companies
This endpoint allows you to search for companies based on a country code and a query string.
The search can be performed using either a company legal name, commercial name, historical name, or registration number. Capabilities vary by country.
Standard Mode (stream=false or omitted): Returns JSON array of results once all search sources have completed.
Streaming Mode (stream=true): Returns Server-Sent Events (SSE) with progressive results as each search source completes. The endpoint emits named events:
progress: Partial results from completed sourcescomplete: Final results when all sources finisherror: If the search fails
Streaming is beneficial for countries with multiple search sources (e.g., Germany queries both Unternehmensregister and Handelsregister), providing faster time-to-first-result.
Response times vary by country: from sub-second to up to 10 seconds.
Authorizations
Query Parameters
The country code in ISO 3166-1 alpha-2 format (e.g., "FR" for France, "DE" for Germany).
AT, BE, CH, CN, CZ, CY, DE, DK, EE, ES, FI, FR, GB, HU, IE, IT, LU, MT, NL, NO, PL, PT, RO, SE, TEST The search query, which can be a company name or registration number. Note that search capabilities may vary by country, with some supporting only name or registration number searches.
"Topograph"
Enable streaming mode. When true, returns Server-Sent Events (SSE) with progressive results as each search source completes. Set Accept header to "text/event-stream" for proper streaming. When false or omitted, returns standard JSON array after all sources complete.
true
Response
List of companies (JSON when stream=false, SSE when stream=true)