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

# List MaaS Models

`GET /api/v1/models`

Lists available large language models in OpenAI-compatible format.
Incoming HTTP headers on this request are forwarded to the upstream MaaS API unchanged (aside from Content-Type and Authorization, which the BFF sets for the outbound call). Callers may send headers understood by maas-api (for example `X-MaaS-Return-All-Models`).

## Response `200`

List of models

- object
  - `data` ModelListResponse, required
    - `object` string, required — Object type, always "list"
    - `data` Model[], required — Array of model objects
      - `id` string, required — The model identifier
      - `object` string, required — The object type, always "model"
      - `created` integer, required — The Unix timestamp (in seconds) when the model was created
      - `owned_by` string, required — The namespace and MaaSModelRef name (format: namespace/name)
      - `ready` boolean, required — Model ready status
      - `url` string — Model URL (optional)
      - `modelDetails` ModelDetails — Additional model metadata from MaaSModelRef annotations
        - `displayName` string — Human-readable display name (from openshift.io/display-name annotation)
        - `description` string — Model description (from openshift.io/description annotation)
        - `genaiUseCase` string — GenAI use case category (from opendatahub.io/genai-use-case annotation)
        - `contextWindow` string — Context window size (from opendatahub.io/context-window annotation)
        - `modelCapabilities` string[] — Model capability tags from the opendatahub.io/model-capabilities annotation (e.g. text-generation, vision). Absent when the annotation was not set.
      - `kind` string — The model reference kind (e.g., "LLMInferenceService")
      - `subscriptions` SubscriptionInfo[] — Subscriptions that provide access to this model. When `X-MaaS-Return-All-Models` is used, models accessible via multiple subscriptions include multiple entries in this array.
        - `name` string, required — The subscription name
        - `displayName` string — Human-readable display name for the subscription
        - `description` string — Description of the subscription

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/opendatahub-io/apis/maas-bff-api.md) · [All operations](https://skmtc.net/opendatahub-io/apis/maas-bff-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opendatahub-io/maas-bff-api/versions/9112415ceeca/schema)