EXPERIMENTAL — Search company registries for a company with its officers and shareholders.
Find company registrations across worldwide registries, including
directors, officers, and beneficial owners (PSC/shareholders).
Every entity found is automatically screened against sanctions lists.
You MUST specify at least one jurisdiction. "ALL" is not supported.
Available jurisdictions: AM, AT, AU, BR, CA, CH, CZ, DE, DK, EE, FI,
FR, IE, IL, IS, LT, LV, NL, NO, PL, SG, UK, XX. Call
company_registries() for the live list — this one can go stale.
XX is GLEIF LEI, a GLOBAL registry rather than a country. Reach for it
whenever the company sits outside the national registries above — a
supplier in Hong Kong, mainland China, the US or the UAE. Hits carry an
LEI, a registered address and a search.gleif.org URL the user can open.
A jurisdiction NOT on that list is dropped silently by the backend: you
get total_results 0 with status "completed" and no error. That means the
company was never searched for — it is NOT evidence that it is
unregistered or fake, and saying so to someone checking a counterparty
before wiring money is the most damaging thing this tool can do. Check
`jurisdictions_not_searched` and `coverage_warning` in the response
before you report an empty result.
Args:
name: Company name to search for.
jurisdictions: Country codes to search (required, e.g. ["UK"]).
"ALL" is not supported — specify individual countries.
include_sanctions_check: Auto-screen results against sanctions DB (default: true).
include_officers: Include directors and officers (default: true).
include_shareholders: Include PSC/beneficial owners (default: true).
include_only_active: Filter to active companies only (default: false).
api_key: Your Ohmyfin API key (prod-...). Can also be passed
via KEY header or Authorization: Bearer header.
Examples:
company_search_company("Equinor", jurisdictions=["NO"])
company_search_company("Acme Corp", jurisdictions=["UK", "DE"], include_only_active=True)
