ClousDocs
API Reference

Fund Holdings (N-PORT)

Reference for the live Clous Fund Holdings endpoint — query N-PORT portfolio holdings by fund, security (CUSIP/ISIN), asset category, value, and date.

Fund Holdings (N-PORT)

The fund holdings endpoint exposes individual portfolio positions reported on Form N-PORT (registered fund monthly portfolio holdings), resolved to canonical funds and securities. Use it to see what a fund holds, or to find every fund holding a given security.

  • Base URL: https://api.clous.ai
  • Auth: Authorization: Bearer clous_live_...

List / search fund holdings

GET /v1/funds/holdings

List and filter N-PORT portfolio holdings. Results are returned through the standard envelope and are cursor-paginated.

Query parameters

Prop

Type

Example request

Every fund holding Apple Inc. (CUSIP 037833100):

curl -s "https://api.clous.ai/v1/funds/holdings?cusip=037833100&limit=2" \
  -H "Authorization: Bearer clous_live_..."
import requests

resp = requests.get(
    "https://api.clous.ai/v1/funds/holdings",
    params={"cusip": "037833100", "limit": 2},
    headers={"Authorization": "Bearer clous_live_..."},
)
resp.raise_for_status()
data = resp.json()
const resp = await fetch(
  "https://api.clous.ai/v1/funds/holdings?cusip=037833100&limit=2",
  {
    headers: { Authorization: "Bearer clous_live_..." },
  },
);
const data = await resp.json();

Example response

{
  "data": [
    {
      "id": 3988372,
      "accession_number": "0001752724-22-274726",
      "registrant_cik": "0000036405",
      "fund_name": "VANGUARD TOTAL STOCK MARKET INDEX FUND",
      "series_id": "S000002848",
      "class_id": null,
      "form_type": "NPORT-P",
      "filed_date": "2022-11-29",
      "report_date": "2022-12-31",
      "holding_idx": 392,
      "security_name": "Apple Inc",
      "cusip": "037833100",
      "isin": "US0378331005",
      "ticker": null,
      "lei": "HWUPKR0MPOU8FGXBT394",
      "asset_category": "EC",
      "issuer_cat": "CORP",
      "inv_country": "US",
      "payoff_profile": "Long",
      "currency_code": "USD",
      "balance": 455109365,
      "value_usd": 62896114243,
      "pct_net_assets": 5.91011144,
      "principal_amount": 0,
      "fair_value_level": 1,
      "debt_maturity_dt": null,
      "debt_coupon_kind": null,
      "debt_annualized_rt": 0,
      "restricted_security_flag": false,
      "source_url": "https://www.sec.gov/Archives/edgar/data/36405/000175272422274726/primary_doc.xml"
    },
    {
      "id": 3968117,
      "accession_number": "0001752724-22-274736",
      "registrant_cik": "0000036405",
      "fund_name": "VANGUARD 500 INDEX FUND",
      "series_id": "S000002839",
      "class_id": null,
      "form_type": "NPORT-P",
      "filed_date": "2022-11-29",
      "report_date": "2022-12-31",
      "holding_idx": 50,
      "security_name": "Apple Inc",
      "cusip": "037833100",
      "isin": "US0378331005",
      "ticker": null,
      "lei": "HWUPKR0MPOU8FGXBT394",
      "asset_category": "EC",
      "issuer_cat": "CORP",
      "inv_country": "US",
      "payoff_profile": "Long",
      "currency_code": "USD",
      "balance": 342453760,
      "value_usd": 47327109632,
      "pct_net_assets": 6.89478713,
      "principal_amount": 0,
      "fair_value_level": 1,
      "debt_maturity_dt": null,
      "debt_coupon_kind": null,
      "debt_annualized_rt": 0,
      "restricted_security_flag": false,
      "source_url": "https://www.sec.gov/Archives/edgar/data/36405/000175272422274736/primary_doc.xml"
    }
  ],
  "page": {
    "limit": 2,
    "next_cursor": "NDczMjcxMDk2MzJ8Mzk2ODExNw",
    "has_more": true
  },
  "as_of": "2026-06-12T04:10:29.797016Z",
  "source": "form_nport",
  "query_echo": {
    "cusip": "037833100",
    "limit": 2
  },
  "warnings": []
}

Each record is one reported position: the fund identity (registrant_cik, fund_name, series_id), the security (security_name, cusip, isin, lei), the position economics (balance, value_usd, pct_net_assets), N-PORT classification (asset_category, issuer_cat, payoff_profile, fair_value_level), and provenance (accession_number, source_url).

Status codes

StatusMeaning
200Success. An empty result still returns 200 with data: [] and a warnings entry.
401Missing or invalid API key.
402Out of credits.
422Validation error — a parameter was the wrong type or out of range.
429Rate limited.

See Pagination, Errors & Rate limits for full error semantics.

Notes

  • Source data is Form N-PORT portfolio holdings. The source field reports form_nport.
  • ticker is frequently unpopulated in N-PORT filings — match securities on cusip, isin, or lei rather than ticker.
  • asset_category uses N-PORT codes (EC, DBT, LON, ABS-MBS, DFE, STIV, …); pass those codes verbatim.
  • Use query_echo in the response to confirm exactly which typed parameters Clous applied to your request.
  • All data derives from public SEC EDGAR filings; Clous is independent of the SEC.
  • For paging through large result sets, follow page.next_cursor — see Pagination, Errors & Rate limits.

Ownership (13D/G)

Full reference for the live Clous ownership endpoint — search 13D/13G beneficial-ownership records and activist stakes by issuer, filer, person, form type, and filing date.

Fund Providers (N-CEN)

Reference for the live Clous Fund Providers endpoint — list/search the service providers (custodian, administrator, auditor, etc.) that registered funds report on Form N-CEN.

On this page

Fund Holdings (N-PORT)List / search fund holdingsQuery parametersExample requestExample responseStatus codesNotes