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

# List models

> Read the active backend model catalog using a project key with models:read. This request does not generate tokens.



## OpenAPI

````yaml /openapi.json get /v1/models
openapi: 3.1.0
info:
  title: Limitless API
  version: 0.2.0
  description: >-
    Customer inference, scoped organization administration, policies, and health
    probes for Limitless at https://trylimitless.ai. Monthly plans and
    pay-as-you-go API billing are available through the Limitless console. Model
    features depend on the active backend. The OpenAI SDK base URL is
    https://trylimitless.ai/v1.
servers:
  - url: https://trylimitless.ai
    description: Limitless API. OpenAI SDK clients add /v1 to this origin.
security:
  - customerKey: []
tags:
  - name: Health
  - name: Models
  - name: Inference
  - name: Credits
  - name: Organization
  - name: Projects
  - name: Project keys
  - name: Admin keys
  - name: Spending limits
  - name: Reports
  - name: Policies
paths:
  /v1/models:
    get:
      tags:
        - Models
      summary: List models
      description: >-
        Read the active backend model catalog using a project key with
        models:read. This request does not generate tokens.
      operationId: listModels
      parameters: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicModelListResponse'
          description: Successful response.
          headers:
            X-Request-ID:
              description: Gateway request ID for Activity and support.
              schema:
                type: string
                format: uuid
        '401':
          $ref: '#/components/responses/Api401'
        '403':
          $ref: '#/components/responses/Api403'
        '409':
          $ref: '#/components/responses/Api409'
        '422':
          $ref: '#/components/responses/Api422'
        '500':
          $ref: '#/components/responses/Api500'
      security:
        - customerKey: []
        - customerHeaderKey: []
components:
  schemas:
    PublicModelListResponse:
      properties:
        object:
          type: string
          const: list
          default: list
        data:
          items:
            $ref: '#/components/schemas/PublicModelResponse'
          type: array
      type: object
      required:
        - data
    PublicModelResponse:
      properties:
        id:
          type: string
        object:
          type: string
          const: model
          default: model
        owned_by:
          type: string
          description: Backend-reported model owner.
        name:
          type: string
        display_name:
          type: string
        access:
          $ref: '#/components/schemas/PublicModelAccess'
        created:
          type: integer
        input_modalities:
          items:
            type: string
            enum:
              - text
              - image
              - file
              - audio
              - video
          type: array
          description: >-
            Supported input modalities for this model; catalog schema values do
            not imply every model supports them. DeepSeek text/images; GLM text
            only.
        output_modalities:
          items:
            type: string
            enum:
              - text
              - image
              - file
              - audio
              - video
          type: array
        pricing:
          $ref: '#/components/schemas/PublicModelPricing'
        supported_sampling_parameters:
          items:
            type: string
          type: array
        sampling_limits:
          additionalProperties:
            $ref: '#/components/schemas/PublicSamplingRange'
          type: object
        sampling_limits_revision:
          type: string
          default: ''
        supported_features:
          items:
            type: string
          type: array
        is_ready:
          type: boolean
        quantization:
          type: string
        context_length:
          type: integer
          description: >-
            Combined input/output token window, including reasoning and image
            expansion where applicable.
        max_output_length:
          type: integer
          description: >-
            Output ceiling within the combined context, not an allowance beyond
            it.
        root:
          type: string
        parent:
          anyOf:
            - type: string
            - type: 'null'
        supported_reasoning_efforts:
          type: array
          items:
            type: string
          description: >-
            Named efforts accepted by this model. DeepSeek supports none, low,
            high and max.
        default_reasoning_effort:
          type: string
          description: API behavior when reasoning is omitted. DeepSeek uses high.
        recommended_reasoning_effort:
          type: string
          description: >-
            Suggested explicit client setting. The DeepSeek Playground starts at
            high.
        image_limits:
          type: object
          properties:
            max_images:
              type: integer
              description: >-
                Maximum images across the whole request, including replayed
                history. DeepSeek: 8.
            max_image_bytes:
              type: integer
              description: 'Decoded-byte ceiling per image. DeepSeek: 8,388,608.'
            max_total_image_bytes:
              type: integer
              description: 'Decoded-byte ceiling across images. DeepSeek: 16,777,216.'
            max_image_pixels:
              type: integer
              description: 'Maximum width × height for one image. DeepSeek: 33,554,432.'
            mime_types:
              type: array
              items:
                type: string
              description: >-
                Accepted image MIME types; DeepSeek PNG, JPEG, WebP and
                non-animated GIF.
          additionalProperties: true
          description: >-
            Model-specific upload restrictions. Text-only models do not support
            images.
      additionalProperties: true
      type: object
      required:
        - id
        - object
    ErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      type: object
      required:
        - error
    PublicModelAccess:
      properties:
        required_checks:
          items:
            type: string
          type: array
        available:
          type: boolean
        locked:
          type: boolean
        missing_requirements:
          items:
            type: string
          type: array
      additionalProperties: false
      type: object
      required:
        - required_checks
        - available
        - locked
        - missing_requirements
    PublicModelPricing:
      properties:
        prompt:
          type: string
          description: >-
            Backend catalog USD price per input token; billing uses the
            configured Limitless price catalog.
        completion:
          type: string
          description: Backend catalog USD price per output token.
        image:
          type: string
        request:
          type: string
        input_cache_read:
          type: string
          description: Backend catalog USD price per cached input token.
      additionalProperties: false
      type: object
      required:
        - prompt
        - completion
        - image
        - request
        - input_cache_read
    PublicSamplingRange:
      properties:
        minimum:
          type: number
        maximum:
          type: number
        minimum_inclusive:
          type: boolean
          default: true
        maximum_inclusive:
          type: boolean
          default: true
      type: object
      required:
        - minimum
        - maximum
    ErrorDetail:
      properties:
        code:
          type: string
        message:
          type: string
        type:
          type: string
          description: Error category; policy failures use policy_error.
        param:
          anyOf:
            - type: string
            - type: 'null'
        request_id:
          type: string
        doc_url:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - code
        - message
        - type
  responses:
    Api401:
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Missing or invalid credential.
    Api403:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Credential scope or policy denied this operation.
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
    Api409:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Revision, state or idempotency conflict.
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
    Api422:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Provider request validation failed.
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
    Api500:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Unexpected gateway failure.
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
  securitySchemes:
    customerKey:
      type: http
      scheme: bearer
      bearerFormat: lk_...
      description: >-
        Project customer key. Requires the permission for the requested
        endpoint.
    customerHeaderKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Alternative project-key header. Authorization takes precedence when both
        are supplied.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.