Search a national company register by name, when you have a name rather than an
identifier.
`country="NO"` searches Brønnøysundregistrene / Enhetsregisteret (brreg) for Norwegian
companies — the norway company lookup tool for the norwegian business registry when the
organisasjonsnummer (orgnr, org.nr) is not yet known. `country="GB"` is the uk company
search: Companies House by company name, returning each hit's company number
(company registration number, CRN).
**Sweden cannot be searched by name.** Bolagsverket's free API has four operations and
none of them takes a company name, so `country="SE"` raises `not_implemented` — that is
a fact about the register, not a temporary gap, and it will not start working. Sweden
supports lookup by identifier only: call `lookup_company` with the ten-digit
organisationsnummer (or a sole trader's twelve-digit personnummer), or
`validate_company_id` first to check the shape for free. Bolagsverket publishes the
whole register as bulk downloadable files for callers who must search by name.
Use it when a user gives you a company name, then call `lookup_company` with the `id`
of the right hit for the full report — a search hit is deliberately thin (name, legal
form, status, city) and must not be acted on directly. `limit` is 1-100 (default 10).
Hits arrive in the register's own relevance order, so read each hit's `confidence`
rather than assuming the first row is the best one. Zero hits is not an error: `hits`
is `[]`, `total` is `0`, and `hint` says what to try next — Norwegian names are
registered upper-case and often carry an 'AS', 'ASA' or 'NUF' suffix, and UK names a
'LIMITED', 'LTD', 'PLC' or 'LLP' one, worth dropping before concluding a company does
not exist.
On error, this tool raises with the error text `{"error": {"code", "message",
"hint"}}`. `bad_request` means `limit` was out of range or `name` was empty — fix and
retry. `unsupported_country` means call `list_countries` first. `not_implemented` means
that country's register has no name-search operation (Sweden) — use `lookup_company`
with an identifier instead; retrying the search will never succeed.
`upstream_error`/`upstream_timeout` means the national register is unavailable; wait
roughly a minute and retry at most once more.