> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tulipai.app/llms.txt
> Use this file to discover all available pages before exploring further.

# List canonical models



## OpenAPI

````yaml /gateway-reference/openapi.yaml get /v1/models
openapi: 3.1.0
info:
  title: Tulip Gateway API
  version: 2.0.0
  description: >-
    Offer-aware model discovery, quotes, OpenAI-compatible inference, provider
    onboarding, and settlement for Tulip v1 model markets.
servers: []
security: []
tags:
  - name: Service
  - name: Models
  - name: Inference
  - name: Providers
  - name: Settlement
paths:
  /v1/models:
    get:
      tags:
        - Models
      summary: List canonical models
      operationId: listModels
      responses:
        '200':
          description: Canonical model list.
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    const: list
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Model'
      security:
        - TulipApiKey: []
components:
  schemas:
    Model:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
          const: model
        model_id:
          $ref: '#/components/schemas/Hex32'
        repository:
          type: string
        revision:
          type: string
        task:
          type: string
        creator:
          $ref: '#/components/schemas/Address'
        credit_token:
          $ref: '#/components/schemas/Address'
        pool_id:
          $ref: '#/components/schemas/Hex32'
        position_token_id:
          type: string
        provider_count:
          type: integer
        status:
          type: string
          enum:
            - pending
            - active
            - paused
            - retired
      required:
        - id
        - object
        - model_id
        - repository
        - revision
        - task
        - creator
        - credit_token
        - pool_id
        - position_token_id
        - provider_count
        - status
    Hex32:
      type: string
      pattern: ^0x[0-9a-fA-F]{64}$
    Address:
      type: string
      pattern: ^0x[0-9a-fA-F]{40}$
  securitySchemes:
    TulipApiKey:
      type: http
      scheme: bearer
      bearerFormat: Tulip API key

````