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

# Model Info V2

`GET /v2/model/info`

## Request

- Base URL: `https://api.mammouth.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mammouth.ai/v2/model/info`
- Auth: API key in header `x-litellm-api-key`
- TypeScript: <https://skmtc.dev/mammouth/apis/mammouth-api/docs/v2/model/info/get.ts> (a function with typed inputs; its response is checked against the schema)

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-10-16** `8efc7e7a4ee4`: 3 info
  - added the new optional `query` request parameter `access_group`
  - added the new optional `query` request parameter `exclude_auto_routers`
  - added the new optional `query` request parameter `wildcard_only`

[Operation history](https://skmtc.dev/mammouth/apis/mammouth-api/changes/v2/model/info/get.md)

---

[API](https://skmtc.dev/mammouth/apis/mammouth-api.md) - [All operations](https://skmtc.dev/mammouth/apis/mammouth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mammouth/apis/mammouth-api/revisions/0221c7d45bb1?raw)