> ## 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 a Tilt

> Get a Tilt and its saved methodology.



## OpenAPI

````yaml api-reference/index-construction-preview-openapi.yaml GET /api/v1/tilts/{tilt_uuid}
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}:
    parameters:
      - $ref: '#/components/parameters/TiltUuid'
    get:
      tags:
        - Tilts
      summary: Get a Tilt
      description: |
        Returns the addressed Tilt version and its saved construction. The
        existing `snapshot` property remains the frozen published-composition
        metadata; it is not a draft evaluation summary.
      operationId: getTilt
      responses:
        '200':
          description: The Tilt.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Tilt'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    TiltUuid:
      name: tilt_uuid
      in: path
      required: true
      schema:
        type: string
        format: uuid
  schemas:
    Tilt:
      allOf:
        - $ref: '#/components/schemas/TiltSummary'
        - type: object
          required:
            - revision
            - universe_preset
            - assignment_expression
            - filter_expression
            - score_expression
            - weight_expression
            - included_tickers
            - excluded_tickers
            - rules
            - snapshot
          properties:
            revision:
              type: string
              format: date-time
            universe_preset:
              type:
                - string
                - 'null'
            size_segment_base_date:
              type:
                - string
                - 'null'
              format: date
            assignment_expression:
              type:
                - string
                - 'null'
            filter_expression:
              type:
                - string
                - 'null'
            score_expression:
              type:
                - string
                - 'null'
            weight_expression:
              type:
                - string
                - 'null'
            included_tickers:
              type: array
              items:
                $ref: '#/components/schemas/TickerReference'
            excluded_tickers:
              type: array
              items:
                $ref: '#/components/schemas/TickerReference'
            rules:
              $ref: '#/components/schemas/ConstructionRules'
            snapshot:
              oneOf:
                - $ref: '#/components/schemas/PublishedSnapshot'
                - type: 'null'
              description: >-
                Existing frozen published-composition metadata; not the latest
                draft evaluation.
    TiltSummary:
      type: object
      required:
        - uuid
        - version_group_sqid
        - version_number
        - name
        - status
        - creation_status
        - created_at
        - updated_at
        - asset_type
      properties:
        uuid:
          type: string
          format: uuid
          description: Address of this Tilt version.
        version_group_sqid:
          type: string
          description: Stable identifier shared by versions of this Tilt project.
        version_number:
          type: integer
        name:
          type: string
        status:
          type: string
          enum:
            - draft
            - published
        creation_status:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        published_at:
          type:
            - string
            - 'null'
          format: date-time
        asset_type:
          type: string
    TickerReference:
      type: object
      required:
        - tilt_asset_id
        - symbol
        - name
        - exchange
      properties:
        tilt_asset_id:
          type: string
        symbol:
          type: string
        name:
          type: string
        exchange:
          type:
            - string
            - 'null'
    ConstructionRules:
      type: object
      required:
        - rebalancing_period
        - capping_methodology
        - max_position_weight
        - top_n_positions
        - top_n_position_weight
        - top_n_position_threshold
        - max_constituents
      properties:
        rebalancing_period:
          oneOf:
            - $ref: '#/components/schemas/RebalancePeriod'
            - type: 'null'
        capping_methodology:
          $ref: '#/components/schemas/CappingMethodology'
        max_position_weight:
          $ref: '#/components/schemas/NullableRatio'
        top_n_positions:
          type:
            - integer
            - 'null'
        top_n_position_weight:
          $ref: '#/components/schemas/NullableRatio'
        top_n_position_threshold:
          $ref: '#/components/schemas/NullableRatio'
        max_constituents:
          type:
            - integer
            - 'null'
          minimum: 1
    PublishedSnapshot:
      type: object
      required:
        - effective_date
      properties:
        effective_date:
          type: string
          format: date
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          additionalProperties: false
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
    RebalancePeriod:
      type: string
      enum:
        - MONTHLY
        - QUARTERLY
        - SEMI_ANNUALLY
        - ANNUALLY
    CappingMethodology:
      type: string
      enum:
        - NONE
        - FIXED_TOP_N
        - THRESHOLD_BASED
    NullableRatio:
      type:
        - string
        - 'null'
      pattern: ^(0(\.\d+)?|1(\.0+)?)$
      description: Decimal portfolio fraction from 0 through 1, encoded as a string.
  responses:
    Unauthorized:
      description: The API key is missing or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: The Tilt was not found in the API key's organization.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-Api-Key

````