Find funds holding a security
Find fund portfolios that reported holding a specific security and see their matching positions.
How it works
- Choose the security. An ISIN identifies a specific security. An exchange-qualified ticker works when it resolves to a single ISIN.
-
Choose the report dates. Each fund uses its latest eligible disclosure before matching positions.
as_oflimits the portfolio date.known_bylimits the filing date or, for issuer snapshots, the date the snapshot was collected. Both cutoffs are inclusive. The selected report date can differ by fund. -
Read the matching positions. A weight of
7.5means 7.5% of that fund's portfolio. Separate positions are returned as separate rows. Anisin_sourceidentifies the reference used to link a position when its disclosure supplied an exchange-qualified symbol. Useget_fund_holdingsto see the full portfolio and its disclosure source. -
Page through funds. Results are ordered by fund name, then portfolio identifier. Pass
next_offsetasoffsetwith the same filters until it is null. -
Check coverage. This lookup searches the same sources as the full portfolio endpoint. An empty
fundslist can mean the identifier did not resolve to a single ISIN or that no eligible disclosure matched. Empty results do not count toward your request allowance.
Request
GET /api/v1/funds/holding with your API key. AI assistants call it as the get_funds_holding_security tool, with the same parameters.
Parameters
qstringrequired
Held security identifier, such as an ISIN or an exchange-qualified ticker (AAPL:XNAS).
More parameters
include_sourcesboolean
Include available source documents and supporting evidence. Omit for data only.
Default: false
as_ofdate
Latest eligible portfolio date, inclusive.
YYYY-MM-DD
known_bydate
Latest eligible filing or collection date, inclusive.
YYYY-MM-DD
limitinteger
Maximum number of fund portfolios.
Default: 20 · From 1 to 100
offsetinteger
Fund portfolios to skip.
Default: 0 · From 0 to 9007199254740991
Response
JSON with these fields. A field the source doesn't report is null or left out.
queryRequested security identifier
next_offsetrequired
Offset of the next page, or null on the last page
fundsarray of objectsrequired
Show child attributes
nameReported fund or portfolio name
identifierobject
Show child attributes
typeType of portfolio identifier
valueIdentifier of the reported portfolio
as_ofPortfolio date, when known
publication_dateDisclosure publication date, when known
net_assetsobject
Show child attributes
amountReported portfolio net assets in currency units
currencyCurrency of net assets, when known
positionsarray of objectsrequired
Show child attributes
nameReported position name
security_titleReported security title
isinReported or exchange-verified ISIN
cusipReported CUSIP
isin_sourceobject
Show child attributes
urlExchange or issuer reference used to verify an ISIN absent from the holdings file
publishedReference publication date, when known
sha256Fingerprint of the reference version
asset_classAsset class of the position, with other for uncategorized positions
weight_percentPortfolio weight in percent
quantityReported position quantity
quantity_unitshares, units, principal_amount, contracts or null
instrument_currencyReported currency of the instrument, when known
market_valueobject
Show child attributes
amountReported position value, when its denomination is established
currencyCurrency in which the position value is denominated
source_noticeobject
Show child attributes
sourceData provider
noticeRequired attribution and reuse notice
source_urlPublic source catalogue
terms_urlReuse terms
sourcesarray of objects
Show child attributes
kindSource type
urlLink to the disclosure or source archive
matchIdentifier lookup outcome. A found match can still have an empty page.
Errors
| Status | Meaning |
|---|---|
| 400 | Missing, unknown or invalid parameter, or an identifier that can't be looked up |
| 401 | Missing, unknown or revoked API key |
| 402 | No active plan or trial, or the included request allowance is used |
| 403 | API access of the account is suspended |
| 404 | The identifier matches nothing or is ambiguous. The match field identifies the outcome |
| 429 | Over the plan's rate limit; Retry-After says when to retry |
| 500 | Internal error; the same request is unlikely to succeed on retry |
| 503 | The data couldn't be loaded right now; Retry-After says when to retry, when known |
Errors are JSON with an error message saying what to fix. Errors are free. See Errors and limits.