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

# List available models



## OpenAPI

````yaml https://raw.githubusercontent.com/costa-security/openapi/refs/heads/main/openapi.yaml get /models
openapi: 3.1.0
info:
  title: Costa Code API
  version: 0.0.1-rc.1
servers:
  - url: https://{defaultHost}
    variables:
      defaultHost:
        default: ai.costa.app/api/v1
security: []
paths:
  /models:
    get:
      tags:
        - Service
      summary: List available models
      responses:
        '200':
          description: ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelList'
        '401':
          description: unauthorized
      security:
        - bearerAuth: []
components:
  schemas:
    ModelList:
      title: Model List
      description: >
        A **paginated-style list** wrapper that mirrors OpenAI's style.  

        The top-level `object` is a fixed string of `"list"`, and `data`
        contains **Model** items.
      type: object
      properties:
        object:
          type: string
          description: Fixed discriminator for list payloads.
          enum:
            - list
          example: list
        data:
          type: array
          description: The returned models.
          minItems: 0
          items:
            $ref: '#/components/schemas/Model'
      required:
        - object
        - data
      example:
        object: list
        data:
          - id: claude-3-5-sonnet
            object: model
            created: 1686935002
            owned_by: Celestial Farming Corp
    Model:
      title: Model
      description: |
        A single **inference model** available in Costa.  
        Use the `id` in requests (e.g., `claude-3-5-sonnet`).
      type: object
      properties:
        id:
          type: string
          description: Unique model identifier.
          example: claude-3-5-sonnet
        object:
          type: string
          description: Object type. Always `model`.
          enum:
            - model
          example: model
        created:
          type: integer
          format: unixTime
          description: Creation time (seconds since epoch).
          example: 1686935002
        owned_by:
          type: string
          description: Owning org or vendor.
          example: Celestial Farming Corp
      required:
        - id
        - object
        - created
        - owned_by
      example:
        id: claude-3-5-sonnet
        object: model
        created: 1686935002
        owned_by: Celestial Farming Corp
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: APIKey

````