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

# Get Index Levels

> Index level for a date. With no `date`, returns the most recent published level (the latest level date). A date with no published level returns 404..

## Description

Retrieves the levels 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 levels for the most recent available date


## OpenAPI

````yaml GET /api/v1/indexes/{index_id}/levels
openapi: 3.0.3
info:
  title: TILT
  version: 0.0.1
servers: []
security: []
paths:
  /api/v1/indexes/{index_id}/levels:
    get:
      tags:
        - api
      description: >-
        Index level for a date. With no `date`, returns the most recent
        published level (the latest level date). A date with no published level
        returns 404..
      operationId: api_v1_indexes_levels_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/IndexLevelsResponse'
          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:
    IndexLevelsResponse:
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/IndexLevelsMeta'
        data:
          $ref: '#/components/schemas/IndexLevelsData'
      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
    IndexLevelsMeta:
      type: object
      properties:
        index_id:
          type: string
          format: uuid
      required:
        - index_id
    IndexLevelsData:
      type: object
      properties:
        effective_date:
          type: string
          format: date
        publish_datetime:
          type: string
          format: date-time
          nullable: true
          description: >-
            Timestamp that the level was published. Prior to the index launch
            date, this is null.
        index_name:
          type: string
        currency:
          type: string
        return_type:
          type: string
        index_level:
          type: string
          format: decimal
          pattern: ^-?\d{0,13}(?:\.\d{0,2})?$
        index_market_cap:
          type: string
          format: decimal
          pattern: ^-?\d{0,18}(?:\.\d{0,2})?$
          nullable: true
          description: >-
            Total index market capitalization in USD on the effective date: the
            sum of each constituent's point-in-time market cap. Best-effort —
            constituents without a daily market cap for that date are omitted,
            so this may be a partial sum (constituent_count still reflects full
            membership). Null only when no constituent has market-cap data. This
            is an aggregate market value and is not equal to index_level.
        constituent_count:
          type: integer
          nullable: true
        daily_return:
          type: string
          format: decimal
          pattern: ^-?\d{0,7}(?:\.\d{0,8})?$
          nullable: true
        one_year_return:
          type: string
          format: decimal
          pattern: ^-?\d{0,7}(?:\.\d{0,8})?$
          nullable: true
          description: >-
            Raw (non-annualized) trailing one-year return as of the effective
            date: index_level divided by the level one year earlier, minus 1,
            expressed as a fraction (0.25 = +25%). The earlier level is the most
            recent published level on or before the calendar date one year
            before the effective date. Null when the index has no level reaching
            back that far.
        five_year_return:
          type: string
          format: decimal
          pattern: ^-?\d{0,7}(?:\.\d{0,8})?$
          nullable: true
          description: >-
            Raw (non-annualized) trailing five-year return as of the effective
            date: index_level divided by the level five years earlier, minus 1,
            expressed as a fraction (1.50 = +150%). Uses the same on-or-before
            lookback as one_year_return. Null when the index has no level
            reaching back that far.
      required:
        - constituent_count
        - currency
        - daily_return
        - effective_date
        - five_year_return
        - index_level
        - index_market_cap
        - index_name
        - one_year_return
        - publish_datetime
        - return_type
    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

````