---
title: "One index's current constituent list, heaviest first, with the fund and filing it came from. fundShares and fundValueUsd size the TRACKING FUND's position, never the company. Rows that could not be matched to a tracked company keep the name the fund reported and carry isLinked=false rather than being dropped."
method: GET
path: "/v1/indexes/{index}"
tags: ["Indexes"]
---

# One index's current constituent list, heaviest first, with the fund and filing it came from. fundShares and fundValueUsd size the TRACKING FUND's position, never the company. Rows that could not be matched to a tracked company keep the name the fund reported and carry isLinked=false rather than being dropped.

`GET /v1/indexes/{index}`

## Request

- Base URL: `https://api.equibles.com`
- URL: `https://api.equibles.com/v1/indexes/{index}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/equibles/apis/equibles-api/docs/v1/indexes/:index/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `index` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- IndexConstituentsPagedResponse: A page of constituents plus where the whole list came from.
  - `slug` string, nullable
  - `name` string, nullable
  - `asOfDate` string, date, nullable: The date the list was reported for.
  - `source` string, nullable: The fund and filing this list came from, in one sentence.
  - `isDaily` boolean: True when the list came from a fund's daily holdings file or an exchange's daily published list rather than a quarterly filing.
  - `constituentCount` integer: Companies in the whole list, not in this page.
  - `unlinkedCount` integer: Rows held but not matched to a tracked company; listed under the fund's own name rather than dropped.
  - `listingNotice` ListingNotice: What happened to a requested ticker that no longer trades. "delisted": the company has no current US listing, so the answer is its history. "renamed": the company now trades as successorTicker, its current US presentation ticker (possibly another share class). A listed series (short volume, short interest, off-exchange volume, fails-to-deliver, congressional trades) is the retired ticker's own; a company-level read is the company's data.
    - `status` string, nullable: "delisted" or "renamed".
    - `ticker` string, nullable: The retired ticker as listed.
    - `delistedOn` string, date, nullable: The day the retired listing stopped trading, when known.
    - `successorTicker` string, nullable: For "renamed", the company's current US presentation ticker; null for "delisted".
  - `data` IndexConstituentDto[], nullable
    - `rank` integer: Position by weight, 1 = heaviest.
    - `ticker` string, nullable: The company's ticker, or null when the fund's row could not be matched to a tracked company.
    - `name` string, nullable
    - `isLinked` boolean: True when this row resolved to a company in the Equibles universe.
    - `weight` number, double: The company's share of the index, as a fraction (0.0721 = 7.21%).
    - `fundShares` number, double, nullable: Shares held by the TRACKING FUND, never the company's shares outstanding; null when the list is an exchange's publication.
    - `fundValueUsd` number, double, nullable: Value of the TRACKING FUND's position in USD, never the company's market value; null when the list is an exchange's publication.
  - `meta` PageMeta
    - `limit` integer
    - `offset` integer
    - `count` integer
    - `hasMore` boolean
    - `total` integer, nullable

## Other responses

- `400`: Invalid request — a malformed parameter value or a query parameter this endpoint does not support.
- `404`: Not Found

---

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