Getting started

How do I search a fund by name and get its ISIN?

GET /api/v1/search?q=msci world returns matching share classes with ISIN, issuer, currency, distribution policy and category. Free and not counted; covers funds already loaded.Updated 12 September 2026 · by FundFacts API

Short answer

Call GET https://fundfactsapi.com/api/v1/search?q=<name>&limit=10 with your API key. Each result carries isin, name, issuer, currency, assetClass, shareClass, income (accumulating or distributing), category and dataAsOf, so you can pick the exact share class before spending a request on the full payload. Search is free and not counted. It covers funds that have been loaded into the store; a brand-new ISIN is found by ISIN, not by name.

The call

bash
curl -s "https://fundfactsapi.com/api/v1/search?q=msci%20world&limit=5" -H "Authorization: Bearer $FUNDFACTS_API_KEY"
json
{
  "results": [
    { "isin": "IE00B4L5Y983", "name": "iShares Core MSCI World UCITS ETF", "issuer": "iShares", "currency": "USD", "assetClass": "Equities", "shareClass": "USD Acc", "income": "Accumulating", "category": "Global Equity", "dataAsOf": "2026-09-01" }
  ]
}

q matches on name, issuer and ISIN prefix; two characters minimum. Results are ordered by relevance.

Picking the right share class

One fund often has a dozen share classes: accumulating and distributing, several currencies, hedged and unhedged, retail and institutional. The search result's currency, shareClass and income fields let you choose before you call /funds/{isin}, which is where the request is counted. Share classes explained covers the naming conventions.

Scope

Search runs over the store, so it finds funds that someone has loaded. Large UCITS ETF ranges and popular funds are there; a niche fund nobody has requested is not, until you look it up by ISIN once. The ISIN is printed on every factsheet, KID and broker page.

In the SDKs and MCP

ff.search("msci world") in the JavaScript and Python clients, and the search_funds tool on the MCP server, call the same endpoint.

Verify it yourself

The demo endpoint returns the live payload for a fund that is already in the store, without a key. Everything on this page can be checked against it.
bash
curl -s https://fundfactsapi.com/api/v1/demo/funds/IE00B4L5Y983 | jq '{name, asOf: .data.dataAsOf, ter: .data.headlineMetrics.ter, risk: .data.riskRating, top: .data.topHoldings[:3]}'

Terms used on this page

ISINShare classTicker

Reference

Docs: Endpoints

Frequently asked questions

Can I search by ticker or WKN?

Search matches names, issuers and ISIN prefixes. Tickers and WKNs are not indexed; the name usually gets you there in one step, and the glossary explains how the identifiers map.

Which ISINs work?

Any share class of a UCITS fund, ETF, money-market fund or open-end fund whose management company publishes a product page, factsheet and KID. Each share class has its own ISIN and is looked up on its own. Stocks, bonds and indices are not funds and return 404 fund_not_found.

Try it on your own ISINs

One request returns key facts, holdings, risk and performance as JSON. Free plan, no card.
Get a free API keySee the live demo

Related questions

By field

How do I get a fund's name from its ISIN?

Resolve any fund or ETF ISIN to its official name, issuer, share class, currency and category with one API call, or search the other way from name to ISIN for free.
Getting started

How do I look up a fund or ETF by its ISIN?

One GET request per ISIN returns the fund's name, key facts, fees, risk indicator, holdings, exposures, returns and as-of date as JSON. The request, the response and the rules.
Workflows

How do I validate an ISIN before calling an API?

An ISIN is 12 characters: a two-letter country code, nine alphanumerics and a Luhn check digit computed over the letters expanded to digits. Validation code in Python, TypeScript and SQL, and why it saves requests.
Getting started

What is FundFacts API?

FundFacts API is a REST and MCP API that turns any fund or ETF ISIN into one structured JSON factsheet (fees, risk indicator, holdings, exposures, returns, as-of date) read from the fund house's own documents and refreshed daily. What it returns, what it is for, what it is not, and the plans.

Guides

IdentifiersISIN

ISIN vs ticker vs SEDOL vs WKN vs CUSIP: fund identifiers explained

What each fund identifier is for, which ones are unique per share class, how they nest inside an ISIN, and which one to use as the key in a database or API.
13 September 2026 · 6 min read
Share classesISIN

Fund share classes explained: Acc vs Dist, hedged, retail vs institutional, clean vs bundled

Why one fund has many ISINs: accumulating vs distributing, currency-hedged, retail vs institutional and clean classes, and how to pick the right one in code.
8 September 2026 · 6 min read