---
title: "List versions of the models"
method: GET
path: "/models/{model_id}/versions"
tags: ["version"]
---

# List versions of the models

`GET /models/{model_id}/versions`

## Path parameters

- `model_id` integer, required

## Query parameters

- `limit` integer
- `cursor` string
- `search` string

## Response `200`

OK

## Other responses

- `404` — Model with given `model_id` not found

## Changes

> 34 revisions in range; 4 not diffed, 2 could not be searched.

- **2024-03-01** `d877210ee347` — 2 breaking, 1 warning, 5 info
  - removed the required property `items/model_schema/spec/model_prediction_output/oneOf[#/components/schemas/RankingOutput]/prediction_group_id_column` from the response with the `200` status
  - removed the required property `items/model_schema/spec/prediction_id_column` from the response with the `200` status
  - removed the optional property `items/model_schema/spec/model_prediction_output/oneOf[#/components/schemas/BinaryClassificationOutput]/actual_label_column` from the response with the `200` status
  - added the optional property `items/model_schema/spec/feature_orders` to the response with the `200` status
  - …4 more
- **2024-01-26** `ab97b531bbc1` — 3 info
  - the response property `items/model_schema/spec/model_prediction_output/oneOf[#/components/schemas/BinaryClassificationOutput]/output_class` became required for the status `200`
  - the response property `items/model_schema/spec/model_prediction_output/oneOf[#/components/schemas/RankingOutput]/output_class` became required for the status `200`
  - the response property `items/model_schema/spec/model_prediction_output/oneOf[#/components/schemas/RegressionOutput]/output_class` became required for the status `200`
- **2024-01-23** `c3ef0b1c733b` — 1 info
  - added the media type `*/*` for the response with the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/caraml-dev/apis/merlin/changes/models/:model_id/versions/get.md)

---

[API](https://skmtc.dev/caraml-dev/apis/merlin.md) · [All operations](https://skmtc.dev/caraml-dev/apis/merlin/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/caraml-dev/merlin/revisions/a1e12cbeeebc/schema)