---
title: "Model Info V2"
method: GET
path: "/v2/model/info"
tags: ["model management"]
---

# Model Info V2

`GET /v2/model/info`

Paginated model metadata for proxy deployments (pricing, provider, team access).

Returns configured router deployments with enriched `model_info` (costs, provider,
context window, etc.). Sensitive fields such as API keys and api_base are omitted.

Query parameters:
    model: Filter to a single public `model_name`.
    user_models_only: When true, only return models created by the calling user.
    include_team_models: When true, populate `access_via_team_ids` and `direct_access`
        on each model and filter to deployments the caller can use.
    page / size: Pagination controls (defaults: page=1, size=50).
    search: Case-insensitive partial match on model name or team public name.
    modelId: Return a single deployment by LiteLLM model id.
    teamId: Filter to models with direct access or team membership for this team id.
    sortBy / sortOrder: Sort by model_name, created_at, updated_at, costs, or status.
    access_group: Only return deployments in this model access group.
    wildcard_only: Only return deployments whose `model_name` contains `*`.

Example request:
```
curl -X GET 'http://localhost:4000/v2/model/info?include_team_models=true&page=1&size=50' \
--header 'Authorization: Bearer sk-1234'
```

Example response:
```json
{
    "data": [
        {
            "model_name": "gpt-4",
            "litellm_params": {"model": "openai/gpt-4.1"},
            "model_info": {
                "id": "abc123",
                "litellm_provider": "openai",
                "access_via_team_ids": ["team-1"],
                "direct_access": true
            }
        }
    ],
    "total_count": 1,
    "current_page": 1,
    "total_pages": 1,
    "size": 50
}
```

## Query parameters

- `model` string, nullable — Specify the model name (optional)
- `user_models_only` boolean, nullable — Only return models added by this user
- `include_team_models` boolean, nullable — Return all models across all teams user is in.
- `debug` boolean, nullable
- `page` integer — Page number
- `size` integer — Page size
- `search` string, nullable — Search model names (case-insensitive partial match)
- `modelId` string, nullable — Search for a specific model by its unique ID
- `teamId` string, nullable — Filter models by team ID. Returns models with direct_access=True or teamId in access_via_team_ids
- `sortBy` string, nullable — Field to sort by. Options: model_name, created_at, updated_at, costs, status
- `sortOrder` string, nullable — Sort order. Options: asc, desc
- `exclude_auto_routers` boolean, nullable — Omit auto-router deployments (litellm model prefixed `auto_router/`). They select among deployments rather than being deployments themselves, so a caller rendering a deployment list can leave them out. Defaults to false, so existing callers are unaffected
- `access_group` string, nullable — Only return deployments whose `model_info.access_groups` contains this access group
- `wildcard_only` boolean, nullable — Only return wildcard deployments, i.e. those whose `model_name` contains `*`

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-18** `082b5fabd909` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/v2/model/info/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/b694deb1e459?raw)