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

> Retrieves stored Store display data for a Tilt owned by the API key's organization.



## OpenAPI

````yaml GET /api/v1/tilts/{tilt_uuid}
openapi: 3.0.3
info:
  title: TILT
  version: 0.0.1
servers: []
security: []
paths:
  /api/v1/tilts/{tilt_uuid}:
    get:
      tags:
        - api
      description: >-
        Retrieves stored Store display data for a Tilt owned by the API key's
        organization.
      operationId: api_v1_tilts_retrieve
      parameters:
        - in: path
          name: tilt_uuid
          schema:
            type: string
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalTiltDetail'
          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:
    ExternalTiltDetail:
      type: object
      description: Store detail fields backed only by persisted display data.
      properties:
        uuid:
          type: string
          format: uuid
          readOnly: true
        version_group_sqid:
          type: string
        version_number:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          nullable: true
        name:
          type: string
          nullable: true
          maxLength: 256
        status:
          allOf:
            - $ref: '#/components/schemas/ExternalTiltPublicationStatusEnum'
          readOnly: true
        creation_status:
          $ref: '#/components/schemas/CreationStatusEnum'
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
        published_at:
          type: string
          format: date-time
          nullable: true
        asset_type:
          allOf:
            - $ref: '#/components/schemas/TiltAssetTypeEnum'
          readOnly: true
          description: >-
            The asset type of this Tilt's constituents (equity or
            event_contract), derived from its scores. A Tilt is homogeneous -
            all equity Tickers or all EventContracts.


            * `equity` - Equity

            * `event_contract` - Event Contract
        image:
          type: string
          format: uri
          nullable: true
        image_mask:
          $ref: '#/components/schemas/ImageMaskEnum'
        ticker_count:
          type: integer
          readOnly: true
        one_year_returns:
          type: string
          format: decimal
          pattern: ^-?\d{0,3}(?:\.\d{0,10})?$
          readOnly: true
          nullable: true
        backtest_values:
          type: object
          additionalProperties:
            type: string
          readOnly: true
        explanation:
          type: string
          nullable: true
        objective_target:
          type: string
          nullable: true
        topics:
          type: array
          items:
            $ref: '#/components/schemas/Topic'
          readOnly: true
        themes:
          type: array
          items:
            $ref: '#/components/schemas/TiltTheme'
          readOnly: true
        content_sources:
          type: array
          items:
            $ref: '#/components/schemas/ContentSource'
          readOnly: true
        snapshot:
          allOf:
            - $ref: '#/components/schemas/ExternalTiltSnapshot'
          nullable: true
          readOnly: true
          description: >-
            Frozen published composition metadata. Null when no published
            snapshot exists.
        holdings:
          type: array
          items:
            $ref: '#/components/schemas/ExternalTiltHolding'
          readOnly: true
        sector_composition:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/SectorComposition'
          readOnly: true
      required:
        - asset_type
        - backtest_values
        - content_sources
        - created_at
        - creation_status
        - holdings
        - one_year_returns
        - sector_composition
        - snapshot
        - status
        - themes
        - ticker_count
        - topics
        - updated_at
        - uuid
        - version_group_sqid
    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
    ExternalTiltPublicationStatusEnum:
      enum:
        - draft
        - published
      type: string
      description: |-
        * `draft` - draft
        * `published` - published
    CreationStatusEnum:
      enum:
        - in_progress
        - failed
        - completed
      type: string
      description: |-
        * `in_progress` - In Progress
        * `failed` - Failed
        * `completed` - Completed
    TiltAssetTypeEnum:
      enum:
        - equity
        - event_contract
      type: string
      description: |-
        * `equity` - Equity
        * `event_contract` - Event Contract
    ImageMaskEnum:
      enum:
        - t_mask
        - none
      type: string
      description: |-
        * `t_mask` - T Mask
        * `none` - None
    Topic:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        name:
          type: string
        display_name:
          type: string
          readOnly: true
        thumbnail_image:
          type: string
          format: uri
      required:
        - display_name
        - name
        - uuid
    TiltTheme:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        name:
          type: string
        statement:
          type: string
        score:
          type: string
          format: decimal
          pattern: ^-?\d{0,1}(?:\.\d{0,10})?$
          nullable: true
        rationale:
          type: string
          nullable: true
        summary:
          type: string
          nullable: true
        thesis_relevance:
          type: string
          nullable: true
        evidence_quality:
          type: string
          nullable: true
        parent_theme:
          type: string
          format: uuid
          nullable: true
        rank:
          type: integer
          nullable: true
      required:
        - name
        - statement
        - uuid
    ContentSource:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
          readOnly: true
        source_type:
          type: string
          readOnly: true
        title:
          type: string
          nullable: true
          readOnly: true
        publisher:
          allOf:
            - $ref: '#/components/schemas/Publisher'
          readOnly: true
        description:
          type: string
          nullable: true
          readOnly: true
        image_url:
          type: string
          format: uri
          readOnly: true
          nullable: true
        primary_url:
          type: string
          format: uri
          readOnly: true
        links:
          readOnly: true
        metadata:
          readOnly: true
        fetched_at:
          type: string
          format: date-time
          readOnly: true
          nullable: true
        created:
          type: string
          format: date-time
          readOnly: true
        modified:
          type: string
          format: date-time
          readOnly: true
      required:
        - created
        - description
        - fetched_at
        - image_url
        - links
        - metadata
        - modified
        - primary_url
        - publisher
        - source_type
        - title
        - uuid
    ExternalTiltSnapshot:
      type: object
      properties:
        effective_date:
          type: string
          format: date
      required:
        - effective_date
    ExternalTiltHolding:
      type: object
      properties:
        ticker:
          allOf:
            - $ref: '#/components/schemas/ExternalTiltHoldingConstituent'
          readOnly: true
        weight:
          type: string
          format: decimal
          pattern: ^-?\d{0,1}(?:\.\d{0,10})?$
        score:
          type: string
          format: decimal
          pattern: ^-?\d{0,20}(?:\.\d{0,10})?$
          nullable: true
      required:
        - score
        - ticker
        - weight
    SectorComposition:
      type: object
      properties:
        weight:
          type: number
          format: double
        ticker_count:
          type: integer
      required:
        - ticker_count
        - weight
    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
    Publisher:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
          readOnly: true
        name:
          type: string
          readOnly: true
      required:
        - name
        - uuid
    ExternalTiltHoldingConstituent:
      oneOf:
        - $ref: '#/components/schemas/ExternalTiltTicker'
        - $ref: '#/components/schemas/EventContract'
    ExternalTiltTicker:
      type: object
      properties:
        asset_type:
          type: string
          readOnly: true
        tilt_asset_id:
          type: string
          nullable: true
          readOnly: true
        symbol:
          type: string
          readOnly: true
        exchange:
          type: string
          readOnly: true
        name:
          type: string
          readOnly: true
        image_url:
          type: string
          format: uri
          readOnly: true
          nullable: true
      required:
        - asset_type
        - exchange
        - image_url
        - name
        - symbol
        - tilt_asset_id
    EventContract:
      type: object
      description: >-
        Display serializer for an event-contract constituent.


        Mirrors the public shape of ``TickerSerializer`` (tilt_asset_id / symbol
        / name) so a

        constituent slot renders uniformly, and adds a constant ``asset_type``
        so clients can tell an

        event contract apart from an equity ticker in the same slot.
      properties:
        asset_type:
          type: string
          readOnly: true
        tilt_asset_id:
          type: string
          readOnly: true
        symbol:
          type: string
          readOnly: true
        name:
          type: string
          readOnly: true
        event_title:
          type: string
          nullable: true
          readOnly: true
        outcome_label:
          type: string
          nullable: true
          readOnly: true
        venue:
          type: string
          nullable: true
          readOnly: true
        market_links:
          type: array
          items:
            $ref: '#/components/schemas/EventContractMarketLink'
          readOnly: true
          nullable: true
        status:
          type: string
          nullable: true
          readOnly: true
        series_category:
          type: string
          nullable: true
          readOnly: true
        settlement_value:
          type: number
          format: double
          readOnly: true
          nullable: true
      required:
        - asset_type
        - event_title
        - market_links
        - name
        - outcome_label
        - series_category
        - settlement_value
        - status
        - symbol
        - tilt_asset_id
        - venue
    EventContractMarketLink:
      type: object
      properties:
        venue:
          type: string
        url:
          type: string
          format: uri
      required:
        - url
        - venue
  securitySchemes:
    ProAPIToken:
      type: apiKey
      in: header
      name: X-Api-Key

````