> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trylimitless.ai/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. This deployment uses
    sandbox credits and test payments but sends real inference requests. Model
    features depend on the active backend. The OpenAI SDK base URL is
    https://trylimitless.ai/v1.
servers:
  - url: https://trylimitless.ai
    description: >-
      Limitless sandbox API: test payments and real inference. 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
        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
        max_output_length:
          type: integer
        root:
          type: string
        parent:
          anyOf:
            - type: string
            - type: 'null'
      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.