How do I get the holdings of an ETF or fund by ISIN?

Where it is in the response

Sample for iShares Core MSCI World UCITS ETF (IE00B4L5Y983):

json
"topHoldings": [
  { "name": "NVIDIA", "weight": 5.48 },
  { "name": "APPLE", "weight": 5.24 },
  { "name": "MICROSOFT", "weight": 3.88 }
],
"keyFacts": { "holdings": 1253 },
"profile": { "concentration": "diversified" }

Where the figure comes from

Holdings are read from the issuer's holdings file where one is published (most large ETF ranges publish a daily CSV or XLSX) and from the factsheet's top-ten table otherwise. Names are the issuer's own labels, so "NVIDIA" from one house and "NVIDIA CORP" from another are matched by name when GET /overlap compares two funds.

The request

bash
curl -s --max-time 300 https://fundfactsapi.com/api/v1/funds/IE00B4L5Y983 \
  -H "Authorization: Bearer $FUNDFACTS_API_KEY" | jq '.data.topHoldings[:5]'

python
import os, requests
r = requests.get("https://fundfactsapi.com/api/v1/funds/IE00B4L5Y983",
                 headers={"Authorization": f"Bearer {os.environ['FUNDFACTS_API_KEY']}"}, timeout=300)
fund = r.json()
print(fund["name"], fund['data']['topHoldings'])

javascript
const res = await fetch("https://fundfactsapi.com/api/v1/funds/IE00B4L5Y983", {
  headers: { Authorization: `Bearer ${process.env.FUNDFACTS_API_KEY}` },
  signal: AbortSignal.timeout(300_000),
});
const fund = await res.json();
console.log(fund.name, fund.data.topHoldings);

Sign up at fundfactsapi.com/signup for a key; the Free plan is 15 lookups a month with no card. Without a key, GET https://fundfactsapi.com/api/v1/demo/funds/IE00B4L5Y983 returns the same payload for funds already in the store (30 calls a minute per IP; it never loads a new fund).

Caveats

• The full constituent list is only available where the fund house publishes one. For an active fund whose factsheet shows ten names, ten names is what you get; the payload never invents the rest.
• Holdings files are usually one trading day old, factsheet tables one month old. data.dataAsOf tells you which.
• To compare two ETFs' holdings, GET /overlap?isins=A,B (Pro and above) returns the shared names and the overlap percentage without you having to reconcile the lists.

Several funds at once

POST /funds with { "isins": ["…", "…"], "wait": true } returns the same payload for up to 10 ISINs per call on Starter, 50 on Pro and 200 on Scale. One request is counted per ISIN answered. X-RateLimit-Remaining on every response tells you how many are left this month; a 429 rate_limited response carries Retry-After. Search and /me are free.

A fund nobody has requested in the last 24 hours is loaded on demand from the documents the fund house publishes. That first call takes 15 seconds to about 3 minutes; set your client timeout to 300 seconds and do not fire a second request for the same ISIN while the first is running. Every later call within 24 hours returns from the store in well under a second with cached: true.

Everything else in the payload is listed in the field reference.