---
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

## Changes

- **2026-07-13** `41f9c4a9d8d9` — 1 info
  - added the optional property `data/data/items/modelDetails/modelCapabilities` to the response with the `200` status
- **2026-05-08** `91e6269dfa24` — 2 breaking, 2 info
  - the `data` response's property type/format changed from `array`/`` to `object`/`` for status `200`
  - removed the required property `object` from the response with the `200` status
  - added the required property `data/data` to the response with the `200` status
  - added the required property `data/object` to the response with the `200` status
- **2026-05-07** `1c92de0246f4` — 3 info
  - added the optional property `data/items/kind` to the response with the `200` status
  - added the optional property `data/items/modelDetails` to the response with the `200` status
  - added the optional property `data/items/subscriptions` to the response with the `200` status
- **2026-03-16** `9380b41a2304` — 4 info
  - api tag `models` added
  - added the media type `application/json` for the response with the status `500`
  - the response property `data` became required for the status `200`
  - added the required property `object` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/opendatahub-io/apis/maas-bff-api/changes/api/v1/models/get.md)

---

[API](https://skmtc.dev/opendatahub-io/apis/maas-bff-api.md) · [All operations](https://skmtc.dev/opendatahub-io/apis/maas-bff-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opendatahub-io/maas-bff-api/revisions/f8bfb089642f/schema)