> ## Documentation Index
> Fetch the complete documentation index at: https://mifr.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List models

> Aliases currently servable at the gateway trust floor.

Returns an OpenAI `{object:"list", data:[…]}` payload for aliases currently servable at the hardware floor (the union of live, qualified Macs).

This is not the full catalog. A 200 with only `qwen3-4b` means no qualified Mac is advertising `qwen3-8b` right now, not that the alias is gone. The coordinator's public `GET /v1/catalog` is the full pin list (HF ids, revision, SHA-256), independent of who is online.

<ParamField header="Authorization" type="string" required>
  Bearer product key. Format: `Bearer sk-mifr_…`.
</ParamField>

## Response

<ResponseField name="object" type="string">
  Always `list`.
</ResponseField>

<ResponseField name="data" type="object[]">
  Servable catalog aliases. Each item is an OpenAI model object; `id` is the alias (for example `qwen3-4b`).
</ResponseField>

If the directory cannot list, the gateway returns 502 `directory_unavailable` with `mifr_action: wait`.

<RequestExample>
  ```bash cURL theme={null}
  curl https://mifr-gateway-production.up.railway.app/v1/models \
    -H "Authorization: Bearer $MIFR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "object": "list",
    "data": [
      {
        "id": "qwen3-4b",
        "object": "model",
        "owned_by": "mifr"
      }
    ]
  }
  ```
</ResponseExample>