model management

Model Info V2

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:

{
    "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
}
get/v2/model/info

Query parameters

modelstring nullable

Specify the model name (optional)

Specify the model name (optional)

user_models_onlyboolean nullable

Only return models added by this user

Only return models added by this user

include_team_modelsboolean nullable

Return all models across all teams user is in.

Return all models across all teams user is in.

debugboolean nullable
pageinteger

Page number

Page number

sizeinteger

Page size

Page size

searchstring nullable

Search model names (case-insensitive partial match)

Search model names (case-insensitive partial match)

modelIdstring nullable

Search for a specific model by its unique ID

Search for a specific model by its unique ID

teamIdstring nullable

Filter models by team ID. Returns models with direct_access=True or teamId in access_via_team_ids

Filter models by team ID. Returns models with direct_access=True or teamId in access_via_team_ids

sortBystring nullable

Field to sort by. Options: model_name, created_at, updated_at, costs, status

Field to sort by. Options: model_name, created_at, updated_at, costs, status

sortOrderstring nullable

Sort order. Options: asc, desc

Sort order. Options: asc, desc

exclude_auto_routersboolean 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

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_groupstring nullable

Only return deployments whose model_info.access_groups contains this access group

Only return deployments whose model_info.access_groups contains this access group

wildcard_onlyboolean nullable

Only return wildcard deployments, i.e. those whose model_name contains *

Only return wildcard deployments, i.e. those whose model_name contains *

Response

Successful Response

{"stackTrail":"paths:/v2/model/info:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes