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

# List models

> Returns the model catalog for the caller. Each entry describes the model's lifecycle, limits, modalities, capabilities, supported request wires, deployment facts, and the rate limits enforced for this caller on that model.

[Download JSON schema](https://docs.subconscious.dev/schemas/catalog.schema.json)


## OpenAPI

````yaml api-reference/openapi.json GET /models
openapi: 3.1.0
info:
  title: Subconscious API
  version: 1.0.0
  description: OpenAI-compatible inference API
servers:
  - url: https://api.subconscious.dev/v1
security:
  - bearerAuth: []
paths:
  /models:
    get:
      summary: List models available to this API key
      description: >-
        Returns the model catalog for the caller. Each entry describes the
        model's lifecycle, limits, modalities, capabilities, supported request
        wires, deployment facts, and the rate limits enforced for this caller on
        that model.
      operationId: listModels
      responses:
        '200':
          description: The caller's model catalog
          content:
            application/json:
              example:
                object: list
                data:
                  - schema_version: '1'
                    id: subconscious/glm-5.3-marathon
                    object: model
                    created: 1762060800
                    owned_by: subconscious
                    name: GLM 5.3 Marathon
                    lifecycle:
                      status: active
                    limits:
                      context_length: 200000
                      max_output_tokens: 32000
                    modalities:
                      input:
                        - text
                      output:
                        - text
                    capabilities:
                      reasoning:
                        supported: true
                        efforts:
                          - low
                          - medium
                          - high
                      tools: true
                      structured_output: true
                      streaming: true
                      temperature: true
                    api:
                      chat_completions: true
                      responses: true
                      anthropic_messages: true
                    deployment:
                      tokenizer: glm
                      ready: true
                    rate_limits:
                      requests_per_minute: 120
                      tokens_per_minute: 400000
              schema:
                type: object
                properties:
                  object:
                    type: string
                    enum:
                      - list
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        schema_version:
                          type: string
                          enum:
                            - '1'
                        id:
                          type: string
                          description: The model id to send in inference requests.
                          example: subconscious/glm-5.3-marathon
                        object:
                          type: string
                          enum:
                            - model
                        created:
                          type: integer
                        owned_by:
                          type: string
                          example: subconscious
                        name:
                          type: string
                          example: GLM 5.3 Marathon
                        lifecycle:
                          type: object
                          properties:
                            status:
                              type: string
                              enum:
                                - active
                                - deprecated
                                - retired
                            deprecation_date:
                              type: string
                              description: >-
                                Calendar date the model stops being served, as
                                YYYY-MM-DD (end of that date, UTC).
                              example: '2026-11-05'
                            replacement:
                              type: string
                              description: Model id to migrate to.
                              example: subconscious/glm-5.3-marathon
                        limits:
                          type: object
                          properties:
                            context_length:
                              type: integer
                              description: Context window in tokens.
                            max_output_tokens:
                              type: integer
                        modalities:
                          type: object
                          properties:
                            input:
                              type: array
                              items:
                                type: string
                                enum:
                                  - text
                                  - image
                                  - audio
                                  - video
                                  - file
                            output:
                              type: array
                              items:
                                type: string
                                enum:
                                  - text
                                  - image
                                  - audio
                                  - video
                                  - file
                        capabilities:
                          type: object
                          description: Absent means unknown, not unsupported.
                          properties:
                            reasoning:
                              type: object
                              properties:
                                supported:
                                  type: boolean
                                efforts:
                                  type: array
                                  items:
                                    type: string
                                    enum:
                                      - low
                                      - medium
                                      - high
                            tools:
                              type: boolean
                            structured_output:
                              type: boolean
                            streaming:
                              type: boolean
                            temperature:
                              type: boolean
                        api:
                          type: object
                          properties:
                            chat_completions:
                              type: boolean
                            responses:
                              type: boolean
                            anthropic_messages:
                              type: boolean
                        deployment:
                          type: object
                          properties:
                            quantization:
                              type: string
                            tokenizer:
                              type: string
                            ready:
                              type: boolean
                        rate_limits:
                          type: object
                          description: >-
                            The strictest enforced limit per kind and window for
                            this model, across the caller's organization and key
                            scopes. An all-models limit is enforced
                            independently per hosted model. Absent when no limit
                            is configured; an absent field means no limit of
                            that kind and window is enforced.
                          properties:
                            requests_per_minute:
                              type: integer
                            requests_per_hour:
                              type: integer
                            requests_per_day:
                              type: integer
                            requests_per_month:
                              type: integer
                            tokens_per_minute:
                              type: integer
                            tokens_per_hour:
                              type: integer
                            tokens_per_day:
                              type: integer
                            tokens_per_month:
                              type: integer
        '401':
          description: Missing or invalid API key
      security:
        - bearerAuth: []
        - apiKeyAuth: []
      x-codeSamples:
        - lang: python
          label: Python (OpenAI SDK)
          source: |-
            from openai import OpenAI

            client = OpenAI(
                api_key="your-api-key",
                base_url="https://api.subconscious.dev/v1",
            )

            for model in client.models.list():
                print(model.id, model.name)
        - lang: javascript
          label: Node.js (fetch)
          source: >-
            const response = await
            fetch("https://api.subconscious.dev/v1/models", {
              headers: { Authorization: `Bearer ${process.env.SUBCONSCIOUS_API_KEY}` },
            });

            const catalog = await response.json();

            console.log(catalog.data.map((model) => model.id));

            console.log(catalog.data.map((model) => model.rate_limits));
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key from your Subconscious dashboard
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key from your Subconscious dashboard. Accepted by the Anthropic
        Messages endpoints in place of the Authorization header, for use with
        the Anthropic SDK.

````

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