> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tilt.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Index Constituents

> Index constituents for a date. With no `date`, uses the most recent published level (the latest level date). A date with no published level returns 404; a level present but with no constituent snapshot returns 200 with an empty `data` array.

## Description

Retrieves the constituents for a specific index.

## Parameters

### Path Parameters

| Parameter  | Required | Description                        |
| ---------- | -------- | ---------------------------------- |
| `index_id` | Yes      | The unique identifier of the index |

### Query Parameters

| Parameter | Required | Description                                                                        |
| --------- | -------- | ---------------------------------------------------------------------------------- |
| `date`    | No       | Effective date in `YYYY-MM-DD` format. Defaults to the most recent available date. |

### Default Behavior

* If `date` is not provided, returns constituents for the most recent available date


## OpenAPI

````yaml GET /api/v1/indexes/{index_id}/constituents
openapi: 3.0.3
info:
  title: TILT
  version: 0.0.1
servers: []
security: []
paths:
  /api/v1/indexes/{index_id}/constituents:
    get:
      tags:
        - api
      description: >-
        Index constituents for a date. With no `date`, uses the most recent
        published level (the latest level date). A date with no published level
        returns 404; a level present but with no constituent snapshot returns
        200 with an empty `data` array.
      operationId: api_v1_indexes_constituents_retrieve
      parameters:
        - in: query
          name: date
          schema:
            type: string
          description: >-
            Effective date in YYYY-MM-DD format. Defaults to most recent
            available date.
        - in: path
          name: index_id
          schema:
            type: string
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IndexConstituentsResponse'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IndexAPIError'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IndexAPIError'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IndexAPIError'
          description: ''
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IndexAPIError'
          description: ''
      security:
        - ProAPIToken: []
components:
  schemas:
    IndexConstituentsResponse:
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/IndexConstituentsMeta'
        data:
          type: array
          items:
            $ref: '#/components/schemas/IndexConstituent'
      required:
        - data
        - meta
    IndexAPIError:
      type: object
      description: |-
        Canonical error shape for the index API endpoints: every 4xx response is
        a single object ``{"error": {"code", "message"}}``.
      properties:
        error:
          $ref: '#/components/schemas/IndexAPIErrorDetail'
      required:
        - error
    IndexConstituentsMeta:
      type: object
      properties:
        index_id:
          type: string
          format: uuid
        effective_date:
          type: string
          format: date
      required:
        - effective_date
        - index_id
    IndexConstituent:
      type: object
      properties:
        proprietary_id:
          type: string
          nullable: true
        isin:
          type: string
          nullable: true
        cusip:
          type: string
          nullable: true
        ticker:
          type: string
        active:
          type: boolean
        mic:
          type: string
          nullable: true
        security_name:
          type: string
        country_of_listing:
          type: string
        rbics_sector:
          type: string
          nullable: true
        rbics_sub_sector:
          type: string
          nullable: true
        size_segment:
          type: string
          nullable: true
        local_close_price:
          type: string
          format: decimal
          pattern: ^-?\d{0,16}(?:\.\d{0,4})?$
          nullable: true
        local_currency:
          type: string
        fx_rate:
          type: string
          format: decimal
          pattern: ^-?\d{0,4}(?:\.\d{0,6})?$
        shares_outstanding:
          type: integer
          nullable: true
        free_float_factor:
          type: string
          format: decimal
          pattern: ^-?\d{0,9}(?:\.\d{0,6})?$
          nullable: true
        capping_factor:
          type: string
          format: decimal
          pattern: ^-?\d{0,9}(?:\.\d{0,6})?$
          nullable: true
        index_shares:
          type: string
          format: decimal
          pattern: ^-?\d{0,9}(?:\.\d{0,6})?$
        index_market_cap:
          type: string
          format: decimal
          pattern: ^-?\d{0,18}(?:\.\d{0,2})?$
          nullable: true
        index_weight:
          type: string
          format: decimal
          pattern: ^-?\d{0,1}(?:\.\d{0,6})?$
          nullable: true
        full_market_cap:
          type: string
          format: decimal
          pattern: ^-?\d{0,18}(?:\.\d{0,2})?$
          nullable: true
      required:
        - active
        - capping_factor
        - country_of_listing
        - cusip
        - free_float_factor
        - full_market_cap
        - fx_rate
        - index_market_cap
        - index_shares
        - index_weight
        - isin
        - local_close_price
        - local_currency
        - mic
        - proprietary_id
        - rbics_sector
        - rbics_sub_sector
        - security_name
        - shares_outstanding
        - size_segment
        - ticker
    IndexAPIErrorDetail:
      type: object
      properties:
        code:
          type: string
          description: Machine-readable error code, e.g. not_found, invalid_parameter.
        message:
          type: string
          description: Human-readable error description.
      required:
        - code
        - message
  securitySchemes:
    ProAPIToken:
      type: apiKey
      in: header
      name: X-Api-Key

````