Reference

Companies and identifiers

How to refer to a company in requests.

The company parameter accepted by most endpoints is deliberately flexible so that you can pass whatever identifier you already have. The resolver tries each form in turn:

  1. Exact ticker match. NESTE, AAPL, FSKRS.HE. Case-insensitive.
  2. ISIN. FI0009005961.
  3. CIK (US only). 0000320193.
  4. Exact company name. "Neste Oyj", "Apple Inc.".
  5. Fuzzy name match. "Neste", "Apple", "60 Degrees Pharma".

Fuzzy matching is conservative: it requires high similarity scores and a single dominant candidate. If two issuers are plausible matches the request returns error: "Ambiguous company name" with a list of candidates.

Best practice

  • For production pipelines, store the canonical identifier that comes back in the response (display_name, ticker, company_id). Re-use it on subsequent calls to avoid re-resolving the same input.
  • For ad-hoc tooling, fuzzy names are convenient and safe.
  • When you need to be 100% sure (e.g. compliance contexts), pass the ticker for US issuers and the ISIN for Nordic issuers.

Display names

display_name is the friendly form rendered on the Clarifo web app (e.g. "Fiskars Oyj Abp"). The underlying company_name may be the filing-normalised version (e.g. "fiskars" for case-folded internal keys). Always prefer display_name for user-facing output.