---
title: "List Models"
method: GET
path: "/v1/models"
tags: ["Models", "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

## Changes

- **2026-06-03** `7914e6f947be` — 1 breaking, 1 info
  - for the `query` request parameter `limit`, default value was changed from `20` to `100`
  - added the required property `data/items/capabilities/anyOf[subschema #1: ModelCapabilitiesOutput]/effort/xhigh` to the response with the `200` status
- **2026-06-02** `c711b911f68e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zylon-ai/apis/private-gpt-api/changes/v1/models/get.md)

---

[API](https://skmtc.dev/zylon-ai/apis/private-gpt-api.md) · [All operations](https://skmtc.dev/zylon-ai/apis/private-gpt-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zylon-ai/private-gpt-api/revisions/4e828cf153c4/schema)