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

# List Tilts

> Returns the current version of each Tilt owned by the API key's organization. Drafts and published Tilts are returned by default.



## OpenAPI

````yaml GET /api/v1/tilts
openapi: 3.0.3
info:
  title: TILT
  version: 0.0.1
servers: []
security: []
paths:
  /api/v1/tilts:
    get:
      tags:
        - api
      description: >-
        Returns the current version of each Tilt owned by the API key's
        organization. Drafts and published Tilts are returned by default.
      operationId: api_v1_tilts_list
      parameters:
        - in: query
          name: expand
          schema:
            type: string
          description: >-
            Comma-separated optional expansions. Currently supports
            backtest_values.
        - name: page
          required: false
          in: query
          description: A page number within the paginated result set.
          schema:
            type: integer
        - name: page_size
          required: false
          in: query
          description: Number of results to return per page.
          schema:
            type: integer
        - in: query
          name: published
          schema:
            type: boolean
            nullable: true
          description: >-
            Filter by publication state. Omit to return both drafts and
            published Tilts.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedExternalTiltListResponseList'
          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: ''
      security:
        - ProAPIToken: []
components:
  schemas:
    PaginatedExternalTiltListResponseList:
      type: object
      required:
        - count
        - results
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=4
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=2
        results:
          type: array
          items:
            $ref: '#/components/schemas/ExternalTiltListResponse'
    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
    ExternalTiltListResponse:
      type: object
      description: OpenAPI list response shape, including the optional expansion.
      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
      required:
        - asset_type
        - created_at
        - creation_status
        - one_year_returns
        - status
        - ticker_count
        - updated_at
        - uuid
        - version_group_sqid
    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
    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
  securitySchemes:
    ProAPIToken:
      type: apiKey
      in: header
      name: X-Api-Key

````