---
title: "Holdings"
method: GET
path: "/api/fund/holdings"
tags: ["ETF/MF"]
---

# Holdings

`GET /api/fund/holdings`

## Request

- Base URL: `https://api.stockfit.io/v1`
- URL: `https://api.stockfit.io/v1/api/fund/holdings`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/stockfit/apis/stockfit-api/docs/api/fund/holdings/get.ts> (a function with typed inputs; its response is checked against the schema)

![Starter](https://img.shields.io/badge/Starter-3b82f6) ![ETF](https://img.shields.io/badge/ETF-14b8a6) ![Pro](https://img.shields.io/badge/Pro-8b5cf6)

Returns the individual holdings of a fund from a single SEC N-PORT filing, with pagination. Defaults to the most recent filing; pass `reportDate` to retrieve the holdings as of a specific historical quarter. Holdings are sorted by portfolio weight descending. Where possible, holdings are mapped to their CIK and ticker symbol.

Use `/api/fund/profile` to discover which quarter-end `reportDate` values are available for a fund.

## Query parameters

- `symbol` string
- `cik` integer
- `cusip` string
- `composite_figi` string
- `share_class_figi` string
- `page` integer
- `pageSize` integer
- `reportDate` string, date

## Response `200`

Paginated ETF holdings

- object
  - `page` integer: Current page number (1-indexed)
  - `pageSize` integer: Number of results per page
  - `totalPages` integer: Total number of pages
  - `totalResults` integer: Total number of holdings
  - `reportDate` string, nullable: Quarter end date of the N-PORT filing
  - `data` object[]
    - `name` string: Holding name
    - `cusip` string: CUSIP identifier
    - `isin` string: ISIN identifier
    - `ticker` string: Ticker symbol as reported in the filing
    - `title` string: Security title
    - `valueUsd` number: Market value of the holding (USD)
    - `pctVal` number: Percentage of net assets
    - `balance` number: Number of shares or units held
    - `units` string: Unit type (NS = number of shares, PA = principal amount, etc.)
    - `assetCat` string: Asset category (EC = equity common, DBT = debt, etc.)
    - `issuerCat` string: Issuer category (CORP = corporate, SOVN = sovereign, etc.)
    - `country` string: Country of issuer (ISO 2-letter code)
    - `payoffProfile` string: Payoff profile (Long, Short, or N/A)
    - `fairValueLevel` integer: Fair value hierarchy level (1, 2, or 3)
    - `mappedCik` integer: SEC CIK of the held company (mapped by us; omitted when unmapped)
    - `mappedSymbol` string: Ticker symbol of the held company (mapped by us; omitted when unmapped)
    - `reportDate` string: Report date of the N-PORT filing (YYYY-MM-DD)

## Other responses

- `400`: Symbol not found or not a fund (ETF or mutual fund)
- `403`: Feature not available on current plan

---

[API](https://skmtc.dev/stockfit/apis/stockfit-api.md) - [All operations](https://skmtc.dev/stockfit/apis/stockfit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stockfit/apis/stockfit-api/revisions/6063af256548?raw)