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

# List Models

`GET /v1/models`

List all available models.

Args:
    http_request: FastAPI request object (for accessing app state).

Returns:
    List of all models with their info.

## Response `200`

Successful Response

- ModelsListResponse — Response for listing models.
  - `models` ModelInfo[], required
    - `name` string, required
    - `inputs` string[], required
    - `outputs` string[], required
    - `dims` object, required
    - `loaded` boolean, required
    - `state` 'available' | 'loading' | 'loaded' | 'unloading' | 'failed'
    - `last_error` ModelLoadError — Diagnostic detail for a recorded load failure. Surfaced in :class:`ModelInfo` when the registry has a sticky failure for the model. Attributes mirror the server-side :class:`sie_server.core.load_errors.LoadFailure`.
      - `code` string, required
      - `message` string, required
      - `attempts` integer, required
      - `permanent` boolean, required
    - `max_sequence_length` integer, nullable
    - `profiles` object
    - `revision` string, nullable
    - `capabilities` ModelCapabilities — Advertised generation capabilities for a model. Mirrors the gateway ``capabilities`` wire shape (``ModelCapabilitiesWire``) for the keys derivable from the loaded model config's :class:`~sie_server.config.model.GenerateCapabilities`. ``code``/``sql``/``guard`` are informational flags advertising validated generation jobs that back the ``model="code"`` / ``model="sql"`` / ``model="guard"`` aliases. Populated only for models that declare ``tasks.generate``; ``None`` otherwise. These flags mean the model *supports* a task — they are NOT a precision-independent quality SLA. A flag is true at the model level even when quality is profile/precision-dependent (e.g. ``sql`` quality regresses under FP8; route SQL-critical traffic to a BF16 bundle via the ``sql`` alias).
      - `grammar` string[]
      - `tools` boolean
      - `code` boolean
      - `sql` boolean
      - `guard` boolean

---

[API](https://skmtc.dev/superlinked/apis/sie-server.md) · [All operations](https://skmtc.dev/superlinked/apis/sie-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/superlinked/sie-server/revisions/26ac644915a4/schema)