---
title: "Get Model"
method: GET
path: "/v1/models/{model_id}"
tags: ["v1", "models"]
---

# Get Model

`GET /v1/models/{model_id}`

Get information about a specific model.

Returns detailed information about a specific model by ID.
The model must be available to your API key's configured providers.

Args:
    model_id: The ID of the model to retrieve (e.g., 'gpt-4', 'claude-3-5-sonnet-20241022')
    user: Authenticated user obtained from API key validation

Returns:
    Model: Information about the requested model

Raises:
    HTTPException:
        - 401 if authentication fails
        - 404 if model not found or not accessible with current API key
        - 500 if internal error occurs

Requires:
    Valid API key with 'read' scope permission

Example:
    ```python
    import dedalus_labs

    client = dedalus_labs.Client(api_key="your-api-key")
    model = client.models.retrieve("gpt-4")

    print(f"Model: {model.id}")
    print(f"Owner: {model.owned_by}")
    ```

    Response:
    ```json
    {
        "id": "gpt-4",
        "object": "model",
        "created": 1687882411,
        "owned_by": "openai"
    }
    ```

## Path parameters

- `model_id` string, required

## Response `200`

Successful Response

- Model — Model information compatible with OpenAI API. Represents a language model available through the Dedalus API. Models are aggregated from multiple providers (OpenAI, Anthropic, etc.) and made available through a unified interface. Attributes: id: Unique model identifier (e.g., 'gpt-4', 'claude-3-5-sonnet-20241022') object: Always 'model' for compatibility with OpenAI API created: Unix timestamp when model was created (may be None) owned_by: Provider organization that owns the model root: Base model identifier if this is a fine-tuned variant parent: Parent model identifier for hierarchical relationships permission: Access permissions (reserved for future use) Example: { "id": "gpt-4", "object": "model", "created": 1687882411, "owned_by": "openai" }
  - `id` string, required — Model identifier
  - `object` string — Object type
  - `created` integer, nullable — Creation timestamp
  - `owned_by` string — Model owner
  - `root` string, nullable — Root model
  - `parent` string, nullable — Parent model
  - `permission` object[], nullable — Permissions

## Other responses

- `422` — Validation Error

## Changes

- **2025-08-18** `f788f74915ca` — 1 breaking, 23 warning, 6 info
  - response property `created` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - removed the optional property `attributes` from the response with the `200` status
  - removed the optional property `frequency_penalty` from the response with the `200` status
  - removed the optional property `logit_bias` from the response with the `200` status
  - …26 more
- **2025-08-18** `7e70f823f200` — 3 warning, 27 info
  - removed the optional property `parent` from the response with the `200` status
  - removed the optional property `permission` from the response with the `200` status
  - removed the optional property `root` from the response with the `200` status
  - api tag `models` removed
  - …26 more
- **2025-08-18** `f788f74915ca` — 23 warning, 3 info
  - removed the optional property `attributes` from the response with the `200` status
  - removed the optional property `frequency_penalty` from the response with the `200` status
  - removed the optional property `logit_bias` from the response with the `200` status
  - removed the optional property `logprobs` from the response with the `200` status
  - …22 more
- …earlier changes not shown

[Full history](https://skmtc.dev/dedalus-labs/apis/dedalus-api/changes/v1/models/:model_id/get.md)

---

[API](https://skmtc.dev/dedalus-labs/apis/dedalus-api.md) · [All operations](https://skmtc.dev/dedalus-labs/apis/dedalus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dedalus-labs/dedalus-api/revisions/f788f74915ca/schema)
