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

# Get Model

> Retrieve a specific model by its ID

## Query Parameters

<ParamField query="id" type="string" required>
  The unique identifier of the model to retrieve. Can contain '/' characters.
</ParamField>

## Response

<ResponseField name="id" type="string">
  The model's unique identifier used in API calls
</ResponseField>

<ResponseField name="user_id" type="string">
  ID of the user who created the model
</ResponseField>

<ResponseField name="base_model_id" type="string">
  Optional pointer to the actual model used when proxying requests
</ResponseField>

<ResponseField name="name" type="string">
  Human-readable display name of the model
</ResponseField>

<ResponseField name="params" type="object">
  JSON object containing model parameters (flexible schema)
</ResponseField>

<ResponseField name="meta" type="object">
  Metadata about the model

  <ResponseField name="profile_image_url" type="string">
    URL or data URI for the model's profile image (defaults to "/static/favicon.png")
  </ResponseField>

  <ResponseField name="description" type="string">
    User-facing description of the model
  </ResponseField>

  <ResponseField name="capabilities" type="object">
    Object describing model capabilities
  </ResponseField>
</ResponseField>

<ResponseField name="access_grants" type="array">
  Array of access grant objects defining who can access this model and with what permissions
</ResponseField>

<ResponseField name="is_active" type="boolean">
  Whether the model is currently active and available for use
</ResponseField>

<ResponseField name="write_access" type="boolean">
  Whether the current user has write access to modify this model
</ResponseField>

<ResponseField name="user" type="object">
  Information about the user who created the model

  <ResponseField name="id" type="string">
    User ID
  </ResponseField>

  <ResponseField name="name" type="string">
    User's display name
  </ResponseField>

  <ResponseField name="email" type="string">
    User's email address
  </ResponseField>
</ResponseField>

<ResponseField name="created_at" type="integer">
  Unix timestamp (in seconds) of when the model was created
</ResponseField>

<ResponseField name="updated_at" type="integer">
  Unix timestamp (in seconds) of when the model was last updated
</ResponseField>

## Example Request

```bash theme={null}
curl -X GET "https://api.example.com/api/models/model?id=gpt-4-custom" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Example Response

```json theme={null}
{
  "id": "gpt-4-custom",
  "user_id": "user123",
  "base_model_id": "gpt-4",
  "name": "Custom GPT-4",
  "params": {
    "temperature": 0.7,
    "max_tokens": 2000,
    "top_p": 1.0
  },
  "meta": {
    "profile_image_url": "/static/favicon.png",
    "description": "A customized GPT-4 model optimized for code generation",
    "capabilities": {
      "vision": true,
      "function_calling": true
    }
  },
  "access_grants": [
    {
      "access_type": "user",
      "access_id": "user456",
      "permission": "read"
    }
  ],
  "is_active": true,
  "write_access": true,
  "user": {
    "id": "user123",
    "name": "John Doe",
    "email": "john@example.com"
  },
  "created_at": 1704067200,
  "updated_at": 1704153600
}
```

## Error Responses

<ResponseField name="404">
  Model not found

  ```json theme={null}
  {
    "detail": "Model not found"
  }
  ```
</ResponseField>

<ResponseField name="401">
  Unauthorized - User does not have access to this model

  ```json theme={null}
  {
    "detail": "Access prohibited"
  }
  ```
</ResponseField>
