> ## 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 evaluated constituents

> Get a complete saved constituent snapshot with scores and weights.



## OpenAPI

````yaml api-reference/index-construction-preview-openapi.yaml GET /api/v1/tilts/{tilt_uuid}/constituents
openapi: 3.1.0
info:
  title: 'Tilt Index Construction API: Design Preview'
  version: 0.4.0-design-preview
  summary: >-
    A restrained public projection of Tilt's existing index construction
    workflow.
  description: |
    A Tilt is a persistent project for one index methodology. Its construction
    rules are the source, evaluated constituent snapshots are the build
    artifacts, and methodology history is version history. This bounded
    repository analogy does not imply branches, forks, merges, or cloning.

    This contract covers rules-based equity construction only. Applying
    construction saves the rules, evaluates them, and commits the complete
    weighted constituent snapshot atomically.
servers:
  - url: https://x.invalid
    description: Non-routable design preview
security:
  - ApiKey: []
tags:
  - name: Tilts
    description: Organization-owned Tilt projects and versions.
  - name: Construction
    description: Apply methodology and read its saved weighted evaluation.
  - name: Catalog
    description: >-
      Discover fields, functions, universes, and classifications used in
      expressions.
  - name: Tickers
    description: Resolve security identifiers to exact Tilt asset IDs.
  - name: Backtests
    description: Backtest a saved Tilt using its configured rebalance behavior.
paths:
  /api/v1/tilts/{tilt_uuid}/constituents:
    parameters:
      - $ref: '#/components/parameters/TiltUuid'
    get:
      tags:
        - Construction
      summary: Get the complete saved evaluation
      description: |
        Returns every constituent in the latest evaluation saved for this exact
        Tilt revision. This is a stored snapshot: reading it never re-evaluates
        the methodology or returns drifted current-market weights. `weight` is a
        portfolio fraction, so `0.10` means 10%, and reflects overrides and
        concentration capping. An evaluated empty result is distinct from a Tilt
        that has never been evaluated.
      operationId: getTiltConstituents
      responses:
        '200':
          description: The complete weighted constituent snapshot.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WeightedConstituentSnapshot'
              example:
                tilt_uuid: 6bcfd210-80f5-4f0b-ab27-6b675194a4a1
                revision: '2026-09-29T14:33:02Z'
                as_of_date: '2026-09-26'
                total_constituents: 2
                total_weight: 1
                constituents:
                  - tilt_asset_id: US0378331005-XNAS
                    symbol: AAPL
                    name: Apple Inc.
                    exchange: XNAS
                    score: 1.42
                    weight: 0.54
                  - tilt_asset_id: US5949181045-XNAS
                    symbol: MSFT
                    name: Microsoft Corp.
                    exchange: XNAS
                    score: 1.18
                    weight: 0.46
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: The Tilt does not exist or this revision has no saved evaluation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: snapshot_not_found
                  message: This Tilt revision has not been evaluated.
components:
  parameters:
    TiltUuid:
      name: tilt_uuid
      in: path
      required: true
      schema:
        type: string
        format: uuid
  schemas:
    WeightedConstituentSnapshot:
      type: object
      additionalProperties: false
      required:
        - tilt_uuid
        - revision
        - as_of_date
        - total_constituents
        - total_weight
        - constituents
      properties:
        tilt_uuid:
          type: string
          format: uuid
        revision:
          type: string
          format: date-time
        as_of_date:
          type: string
          format: date
        total_constituents:
          type: integer
        total_weight:
          type: number
          description: >-
            Sum of fractional constituent weights; approximately 1 for a
            nonempty weighted result.
        constituents:
          type: array
          description: Complete saved result, ordered by weight descending.
          items:
            $ref: '#/components/schemas/WeightedConstituent'
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          additionalProperties: false
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
    WeightedConstituent:
      type: object
      additionalProperties: false
      required:
        - tilt_asset_id
        - symbol
        - name
        - exchange
        - score
        - weight
      properties:
        tilt_asset_id:
          type: string
        symbol:
          type: string
        name:
          type: string
        exchange:
          type:
            - string
            - 'null'
        score:
          type:
            - number
            - 'null'
        weight:
          type: number
          minimum: 0
          maximum: 1
          description: Final portfolio fraction after overrides and concentration capping.
  responses:
    Unauthorized:
      description: The API key is missing or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-Api-Key

````