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

# List models

`GET /models`

## Request

- Base URL: `http://localhost:8080/api/2.1/unity-catalog`
- URL: `http://localhost:8080/api/2.1/unity-catalog/models`
- Auth: none declared

Gets a paginated list of all available models either under the specified parent catalog and schema, or all models stored in UC.
There is no guarantee of a specific ordering of the elements in the array.

## Query parameters

- `catalog_name` string
- `schema_name` string
- `max_results` integer
- `page_token` string

## Response `200`

The models list was successfully retrieved.

- ListRegisteredModelsResponse
  - `registered_models` RegisteredModelInfo[]: An array of model information objects.
    - `name` string: The name of the registered model
    - `catalog_name` string: The name of the catalog where the schema and the registered model reside
    - `schema_name` string: The name of the schema where the registered model resides
    - `storage_location` string: The storage location on the cloud under which model version data files are stored
    - `full_name` string: The three-level (fully qualified) name of the registered model
    - `comment` string: The comment attached to the registered model
    - `owner` string: The identifier of the user who owns the registered model
    - `created_at` integer: Creation timestamp of the registered model in milliseconds since the Unix epoch
    - `created_by` string: The identifier of the user who created the registered model
    - `updated_at` integer: Last-update timestamp of the registered model in milliseconds since the Unix epoch
    - `updated_by` string: The identifier of the user who updated the registered model last time
    - `id` string: Unique identifier for the registered model.
  - `next_page_token` string: Opaque token to retrieve the next page of results. Absent if there are no more pages. __page_token__ should be set to this value for the next request (for the next page of results).

## Changes

- **2024-09-12** `2dd9fd4253e0`: 1 warning, 2 info
  - removed the optional property `registered_models/items/model_id` from the response with the `200` status
  - added the optional property `registered_models/items/id` to the response with the `200` status
  - added the optional property `registered_models/items/owner` to the response with the `200` status
- **2024-09-04** `c480cce16063`: 2 info
  - the `query` request parameter `catalog_name` became optional
  - the `query` request parameter `schema_name` became optional
- **2024-08-12** `6fd9940ca119`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/changes/models/get.md)

---

[API](https://skmtc.dev/unitycatalog/apis/unity-catalog-api.md) - [All operations](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/revisions/c84507f0d7e0?raw)