---
title: "Model List"
method: GET
path: "/v1/models"
tags: ["model management"]
---

# Model List

`GET /v1/models`

Use `/model/info` - to get detailed model information, example - pricing, mode, etc.

This is just for compatibility with openai projects like aider.

Query Parameters:
- include_metadata: Include additional metadata in the response with fallback information
- fallback_type: Type of fallbacks to include ("general", "context_window", "content_policy")
                Defaults to "general" when include_metadata=true
- scope: Optional scope parameter. Currently only accepts "expand".
         When scope=expand is passed, proxy admins, team admins, and org admins
         will receive all proxy models as if they are a proxy admin.
- healthy_only: When true, hide models whose backing deployments are all marked
                unhealthy by background health checks. Set
                `general_settings.model_list_healthy_only: true` to apply this
                to every caller without the query parameter. Requires
                `background_health_checks: true` in general_settings, plus
                either `model_list_healthy_only` or `enable_health_check_routing`
                to keep deployment health state cached; without health state
                the listing is returned unfiltered (fail open).
                Models expanded from wildcard routes (e.g. `openai/*`) are not
                filtered, and nothing is hidden when `allowed_fails_policy` is
                configured (cooldown remains the sole exclusion mechanism).
                Hiding is presentation-only: a hidden model can still be
                called directly.

## Query parameters

- `return_wildcard_routes` boolean, nullable
- `team_id` string, nullable
- `include_model_access_groups` boolean, nullable
- `only_model_access_groups` boolean, nullable
- `include_metadata` boolean, nullable
- `fallback_type` string, nullable
- `scope` string, nullable
- `healthy_only` boolean, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-18** `082b5fabd909` — 3 info
  - added the new optional `query` request parameter `healthy_only`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/v1/models/get.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/c71315002afa?raw)