---
title: "List models"
method: GET
path: "/models"
tags: ["models"]
---

# List models

`GET /models`

Lists custom models for the authenticated user. Use the `scope` parameter to control which models are returned. If omitted, returns both owned models and models shared with the user's organization via the model registry. `owned` returns only models created by the user. `shared` returns only models shared via the model registry, excluding the user's own models.

## Query parameters

- `scope` 'owned' | 'shared'
- `status` ModelStatus[]

## Headers

- `Api-Key` string, required

## Response `200`

Models retrieved successfully

- ListModelsResponse
  - `models` CustomModel[], required — List of models.
    - `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

---

[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)