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

# List Discoverable Models

`GET /v1/models/discoverable`

List every model the configured provider credentials can reach.

Operator-facing counterpart to GET /v1/models, which serves a curated catalog
to API callers. This reports each provider separately and keeps its error, so
a provider with a bad key is distinguishable from one with no models. It is
master-key gated because a provider error message describes the gateway's own
configuration.

## Response `200`

Successful Response

- DiscoverableModelsResponse — Per-provider discovery results for operator model selection.
  - `providers` DiscoverableProvider[], required
    - `error` string, nullable — Why discovery failed. Null when `ok` is true.
    - `models` DiscoverableModel[], required
      - `id` string, required — Bare model id as the provider reports it.
      - `key` string, required — Selector to send as `model`, in `instance:model` form.
    - `ok` boolean, required — False when this instance could not be queried.
    - `provider` string, required

## Changes

- **2026-07-20** `d9a87177ce4a` — 1 info
  - the endpoint scheme security `XApiKeyAuth` was added to the API
- **2026-07-17** `db57bd46e3eb` — 1 info
  - endpoint added
- **2026-04-17** `0f43605bdc13` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/mozilla-ai/apis/otari/changes/v1/models/discoverable/get.md)

---

[API](https://skmtc.dev/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.dev/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mozilla-ai/otari/revisions/bcd0082085cb/schema)