---
title: "List model versions of the specified registered model."
method: GET
path: "/models/{full_name}/versions"
tags: ["ModelVersions"]
---

# List model versions of the specified registered model.

`GET /models/{full_name}/versions`

## Request

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

Gets the paginated list of all available model versions under the specified registered model.
There is no guarantee of a specific ordering of the elements in the array.

## Response `200`

The model versions list was successfully retrieved.

- ListModelVersionsResponse
  - `model_versions` ModelVersionInfo[]: An array of model version information objects.
    - `model_name` string: The name of the parent registered model of the model version, relative to parent schema
    - `catalog_name` string: The name of the catalog containing the model version
    - `schema_name` string: The name of the schema containing the model version, relative to parent catalog
    - `version` integer: Integer model version number, used to reference the model version in API requests.
    - `source` string: URI indicating the location of the source artifacts (files) for the model version
    - `run_id` string: The run id used by the ML package that generated the model.
    - `status` 'MODEL_VERSION_STATUS_UNKNOWN' | 'PENDING_REGISTRATION' | 'FAILED_REGISTRATION' | 'READY': All possible model version statuses.
    - `storage_location` string: The storage location on the cloud under which model version data files are stored
    - `comment` string: The comment attached to the model version
    - `created_at` integer: Time at which this model version was created, in epoch milliseconds.
    - `created_by` string: The identifier of the user who created the model version
    - `updated_at` integer: Time at which this model version was last modified, in epoch milliseconds.
    - `updated_by` string: The identifier of the user who updated the model version last time
    - `id` string: Unique identifier for the model version.
  - `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, 1 info
  - removed the optional property `model_versions/items/model_version_id` from the response with the `200` status
  - added the optional property `model_versions/items/id` to the response with the `200` status
- **2024-08-27** `20b40ddf5893`: 1 info
  - added the new optional `query` request parameter `max_results` to all path's operations

[Operation history](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/changes/models/:full_name/versions/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)