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

# Resolve ticker listings

> Resolve security listings for construction overrides.



## OpenAPI

````yaml api-reference/index-construction-preview-openapi.yaml GET /api/v1/tickers/search
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/tickers/search:
    get:
      tags:
        - Tickers
      summary: Resolve exact security listings
      description: |
        Searches Tilt's listed-security index using exact identifiers and
        optional exchange/type filters. At least one filter is required. This
        existing public endpoint does not support free-text company-name search.
        A symbol can match multiple listings: compare returned names and
        exchanges, then use the intended listing's `tilt_asset_id` in
        construction overrides. Do not assume the first result is the intended
        security.
      operationId: searchTickers
      parameters:
        - name: symbols
          in: query
          style: form
          explode: false
          schema:
            type: array
            items:
              type: string
          description: Comma-separated ticker symbols.
        - name: isins
          in: query
          style: form
          explode: false
          schema:
            type: array
            items:
              type: string
          description: Comma-separated ISINs.
        - name: cusips
          in: query
          style: form
          explode: false
          schema:
            type: array
            items:
              type: string
          description: Comma-separated CUSIPs.
        - name: exchange
          in: query
          schema:
            type: string
          description: Case-insensitive partial exchange match.
        - name: tilt_asset_ids
          in: query
          style: form
          explode: false
          schema:
            type: array
            items:
              type: string
          description: Comma-separated Tilt asset IDs.
        - name: ticker_types
          in: query
          style: form
          explode: false
          schema:
            type: array
            items:
              type: string
          description: Comma-separated ticker types.
        - $ref: '#/components/parameters/Page'
        - $ref: '#/components/parameters/PageSize'
      responses:
        '200':
          description: Matching security listings with exact Tilt asset IDs.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedTickerSearchResults'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  parameters:
    Page:
      name: page
      in: query
      schema:
        type: integer
        minimum: 1
    PageSize:
      name: page_size
      in: query
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 10
  schemas:
    PaginatedTickerSearchResults:
      type: object
      required:
        - count
        - next
        - previous
        - results
      properties:
        count:
          type: integer
        next:
          type:
            - string
            - 'null'
          format: uri
        previous:
          type:
            - string
            - 'null'
          format: uri
        results:
          type: array
          items:
            $ref: '#/components/schemas/TickerSearchResult'
    TickerSearchResult:
      type: object
      required:
        - symbol
        - name
        - exchange
        - isin
        - cusip
        - ticker_type
        - tilt_asset_id
      properties:
        symbol:
          type: string
        name:
          type: string
        exchange:
          type:
            - string
            - 'null'
        isin:
          type:
            - string
            - 'null'
        cusip:
          type:
            - string
            - 'null'
        ticker_type:
          type:
            - string
            - 'null'
        tilt_asset_id:
          type: string
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          additionalProperties: false
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
  responses:
    BadRequest:
      description: The request is invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    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

````