---
title: "List Models"
method: GET
path: "/v1/models"
tags: ["models"]
---

# List Models

`GET /v1/models`

List Models

## Query parameters

- `before_id` string, nullable
- `after_id` string, nullable
- `limit` integer

## Response `200`

Successful Response

- ModelListOutput — Paginated model list payload.
  - `data` ModelInfoOutput[], required — List of model objects.
    - `id` string, required — Unique model identifier.
    - `created_at` string, date-time, required — Model release timestamp (RFC3339).
    - `display_name` string, required — Human-readable model name.
    - `type` 'model', required — Object type "model".
    - `max_tokens` integer, nullable, required — Maximum value allowed for max_tokens for this model.
    - `max_input_tokens` integer, nullable, required — Maximum input context window for this model.
    - `embed_dim` integer, nullable — Embedding vector dimension for embedding models.
    - `capabilities` ModelCapabilitiesOutput, required — ModelCapabilitiesOutput schema.
      - `batch` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
        - `supported` boolean, required — Whether a capability is supported.
      - `citations` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
        - `supported` boolean, required — Whether a capability is supported.
      - `code_execution` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
        - `supported` boolean, required — Whether a capability is supported.
      - `context_management` ContextManagementCapabilityOutput, required — ContextManagementCapabilityOutput schema.
        - `clear_thinking_20251015` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
          - `supported` boolean, required — Whether a capability is supported.
        - `clear_tool_uses_20250919` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
          - `supported` boolean, required — Whether a capability is supported.
        - `compact_20260112` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
          - `supported` boolean, required — Whether a capability is supported.
        - `supported` boolean, required — Whether context management is supported.
      - `effort` EffortCapabilityOutput, required — EffortCapabilityOutput schema.
        - `supported` boolean, required — Whether effort control is supported.
        - `low` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
          - `supported` boolean, required — Whether a capability is supported.
        - `medium` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
          - `supported` boolean, required — Whether a capability is supported.
        - `high` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
          - `supported` boolean, required — Whether a capability is supported.
        - `max` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
          - `supported` boolean, required — Whether a capability is supported.
        - `xhigh` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
          - `supported` boolean, required — Whether a capability is supported.
      - `image_input` CountCapabilitySupportOutput, required — CountCapabilitySupportOutput schema.
        - `supported` boolean, required — Whether a capability is supported.
        - `maximum` integer — Maximum number of allowed elements.
      - `audio_input` CountCapabilitySupportOutput — CountCapabilitySupportOutput schema.
        - `supported` boolean, required — Whether a capability is supported.
        - `maximum` integer — Maximum number of allowed elements.
      - `pdf_input` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
        - `supported` boolean, required — Whether a capability is supported.
      - `structured_outputs` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
        - `supported` boolean, required — Whether a capability is supported.
      - `thinking` ThinkingCapabilityOutput, required — ThinkingCapabilityOutput schema.
        - `supported` boolean, required — Whether thinking is supported.
        - `types` ThinkingTypesOutput, required — ThinkingTypesOutput schema.
          - `adaptive` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
            - `supported` boolean, required — Whether a capability is supported.
          - `enabled` CapabilitySupportOutput, required — CapabilitySupportOutput schema.
            - `supported` boolean, required — Whether a capability is supported.
  - `first_id` string, nullable, required — First model id in page, usable as before_id.
  - `has_more` boolean, required — Whether more models are available.
  - `last_id` string, nullable, required — Last model id in page, usable as after_id.

## Other responses

- `401` — Unauthorized
- `422` — Validation Error

---

[API](https://skmtc.dev/privategpt/apis/api-reference.md) · [All operations](https://skmtc.dev/privategpt/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/privategpt/api-reference/revisions/15d9ccfd68da/schema)