---
title: "List ExternalModels"
method: GET
path: "/api/v1/externalmodel"
tags: ["externalmodels"]
---

# List ExternalModels

`GET /api/v1/externalmodel`

Returns ExternalModels enriched with referenced ExternalProvider details and companion MaaSModelRef endpoint status.

## Query parameters

- `namespace` string, required

## Response `200`

ExternalModel list

- object
  - `data` ExternalModelSummary[]
    - `name` string
    - `namespace` string
    - `displayName` string — Human-readable display name (from openshift.io/display-name annotation)
    - `description` string — Description (from openshift.io/description annotation)
    - `modelName` string
    - `providerRefs` ProviderRef[]
      - `providerName` string, required
      - `weight` integer, required
      - `apiFormat` string, required
      - `path` string, required
      - `targetModel` string, required
      - `config` object — Optional model-provider binding configuration (externalProviderRefs[].config)
      - `authMechanism` 'apikey' | 'sigv4' | 'oauth2' — Auth type override from the ExternalModel providerRef (overrides ExternalProvider auth)
      - `credentialSecretRef` string — Secret name override from the ExternalModel providerRef (overrides ExternalProvider auth.secretRef)
      - `provider` ExternalProviderDetails — ExternalProvider fields not present on the ExternalModel providerRef
        - `displayName` string
        - `description` string
        - `endpointUrl` string
        - `authMechanism` 'apikey' | 'sigv4' | 'oauth2'
        - `credentialSecretRef` string — Name of the Secret holding provider credentials (spec.auth.secretRef.name)
        - `provider` string — Provider identifier (spec.provider)
        - `config` object
        - `phase` string
        - `statusMessage` string — Human-readable status message from the Ready condition in status.conditions
        - `reason` string — Reason from the Ready condition in status.conditions
    - `phase` string
    - `statusMessage` string — Human-readable status message from the Ready condition in status.conditions
    - `reason` string — Reason from the Ready condition in status.conditions
    - `maaSModelRef` ExternalModelMaaSModelRefStatus — Companion MaaSModelRef status (list response only)
      - `phase` string
      - `statusMessage` string — Human-readable status message from the Ready condition in status.conditions
      - `reason` string — Reason from the Ready condition in status.conditions
      - `endpoint` string — Published MaaS endpoint URL (status.endpoint)
      - `governanceAttached` boolean — True when the companion MaaSModelRef has status.conditions type=GovernanceAttached with status=True (active subscription + auth policy pairing).

---

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