---
title: "Get model details"
method: GET
path: "/models/{model_id}"
tags: ["models"]
---

# Get model details

`GET /models/{model_id}`

Get detailed information about a specific custom model. The user must either own the model or the model must be shared with the user's organization via the model registry. Returns 404 if the model is not found or not accessible.

## Path parameters

- `model_id` string, required

## Headers

- `Api-Key` string, required

## Response `200`

Model retrieved successfully

- GetModelResponse
  - `model` CustomModel, required — A custom model.
    - `model_id` string, required — Unique identifier for the model (base64 URL-safe encoded UUID).
    - `custom_model_uri` string, nullable — A custom model URI in the format model/<model_name>/version/<version_name>. Use this URI when generating images with this model. Only present for models that have been registered in the model registry.
    - `name` string, required — Display name of the model.
    - `status` 'CREATING' | 'DRAFT' | 'TRAINING' | 'COMPLETED' | 'ERRORED' | 'ARCHIVED', required — The status of a custom model.
    - `dataset_id` string, nullable — ID of the dataset (collection) the model was trained from.
    - `creation_time` string, date-time, required — When the model was created.
    - `last_update_time` string, date-time, nullable — When the model was last updated.
    - `is_available_for_generation` boolean, required — Whether the model is available for image generation.
    - `is_owned` boolean, required — Whether the authenticated user owns this model.

## Other responses

- `401` — Unauthorized
- `404` — Model not found

---

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