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

Answers from the discovery cache, which a background refresher keeps warm, so
the call does not wait on a slow or unreachable provider. Each provider
carries the ``checked_at`` its result was produced at; a null one has not been
dialed yet. Pass ``refresh=true`` to force a live re-dial of every provider.

## Query parameters

- `refresh` boolean — Re-dial every provider instead of answering from the discovery cache.

## Response `200`

Successful Response

- DiscoverableModelsResponse — Per-provider discovery results for operator model selection.
  - `providers` DiscoverableProvider[], required
    - `checked_at` string, nullable — When this instance was last dialed, ISO 8601. Null when it has not been checked yet, which is what the first read after a restart sees while the background refresh runs.
    - `discovery_unsupported` boolean — True when discovery failed only because this backend serves no model-listing endpoint. The provider may still handle requests for models declared in config.
    - `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

## Other responses

- `422` — Validation Error

---

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