---
title: "Health assessment"
method: GET
path: "/api/fund/fund-health"
tags: ["ETF/MF"]
---

# Health assessment

`GET /api/fund/fund-health`

## Request

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

![Pro](https://img.shields.io/badge/Pro-8b5cf6)

Comprehensive fund health assessment sourced from SEC N-CEN and N-PORT filings. Includes tracking quality metrics (for index funds), fair value hierarchy breakdown, liquidity classification, default/arrears status, operational red flags, and service provider summary.

## Query parameters

- `symbol` string
- `cik` integer
- `cusip` string
- `composite_figi` string
- `share_class_figi` string

## Response `200`

Fund health data

- object
  - `reportDate` string, nullable
  - `ncenRecords` object[]: Annual N-CEN census data with tracking quality and red flags
    - `reportDate` string
    - `isIndexFund` boolean
    - `indexReturnDiffBefore` number, nullable: Tracking difference before expenses (%)
    - `indexReturnDiffAfter` number, nullable: Tracking difference after expenses (%)
    - `indexStdevBefore` number, nullable: Tracking error volatility before expenses
    - `indexStdevAfter` number, nullable: Tracking error volatility after expenses
    - `isLendingAuthorized` boolean
    - `didLend` boolean
    - `isLendingLiquidated` boolean
    - `hasMaterialWeakness` boolean: Internal control material weakness reported
    - `hasLegalProceedings` boolean
    - `hasValuationChanges` boolean
    - `hasAccountingChanges` boolean
    - `hasPaymentErrors` boolean
  - `liquidity` object[]: Holdings by liquidity classification (HLI = Highly Liquid, MLI = Moderately Liquid, LLI = Less Liquid, ILI = Illiquid)
    - `category` 'HLI' | 'MLI' | 'LLI' | 'ILI'
    - `count` integer
    - `totalValue` number
    - `totalWeight` number: Percentage of portfolio
  - `fairValue` object[]: Holdings by fair value hierarchy (Level 1 = quoted prices, Level 2 = observable inputs, Level 3 = unobservable/model-based)
    - `level` 1 | 2 | 3
    - `count` integer
    - `totalValue` number
    - `totalWeight` number
  - `defaults` object: Holdings in default or arrears
    - `defaults` integer
    - `arrears` integer
    - `total` integer
  - `serviceProviders` object[]: Service providers from the latest N-CEN filing
    - `providerRole` string
    - `providerName` string
    - `isAffiliated` boolean

## Other responses

- `400`: Symbol not found or no N-CEN data available
- `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/ade8e65563c3?raw)