---
title: "List the versions of a model"
description: "Lists a model's versions, newest first. Pass a version's id as modelVersionId or loras[].modelId to pin an older version."
canonical: "https://platform.pixai.art/en/docs/api-v2/model/listGenerationModelVersions"
last-updated: "2026-11-02"
---

# List the versions of a model

Lists a model's versions, newest first. Pass a version's `id` as `modelVersionId` or `loras[].modelId` to pin an older version.



## GET https://api.pixai.art/v2/generation-model/{modelId}/versions

Authentication: optional. Send your API key as `Authorization: Bearer <API key>` to read as your account.

Machine-readable OpenAPI spec: https://platform.pixai.art/openapi-spec.v2.yaml

### Parameters

- `modelId` (in path, string, required)
  The model ID.
- `baseModelType` (in query, string, optional)
  Only versions for this base model type.
  Allowed values: `ANY_LORA`, `ANY_MODEL`, `ANY_NON_SDXL_LORA`, `ANY_NON_USER_LORA`, `ANY_SDXL_LORA`, `ANY_USER_LORA`, `ANY_VAE`, `CHAT`, `DIT5A_MODEL_INTERNAL`, `DIT7A_LORA`, `DIT7A_MODEL`, `DIT7A_VAE`, `DIT7B_LORA`, `DIT7B_MODEL`, `DIT7B_VAE`, `DIT7C_LORA`, `DIT7C_MODEL`, `DIT7C_VAE`, `DIT7D_LORA`, `DIT7D_MODEL`, `DIT7D_VAE`, `DIT7_LORA`, `DIT7_MODEL`, `DIT7_VAE`, `DIT9_LORA`, `DIT9_MODEL`, `DIT9_VAE`, `LORA`, `MMDIT26A_MODEL`, `MMDIT26B_MODEL`, `MULTI_LORA`, `SD3_MEDIUM_MODEL`, `SDXL_LORA`, `SDXL_MODEL`, `SDXL_VAE`, `SD_V1_MODEL`, `UNKNOWN_LORA`, `UNKNOWN_MODEL`, `USER_DIT26A_MODEL`, `USER_DIT26B_MODEL`, `USER_LORA`, `USER_MULTI_LORA`, `USER_SDXL_LORA`, `VAE`, `VIDEO_MODEL`, `VIDEO_MODEL_LORA`, `Z_IMAGE_V1_MODEL`.

### Responses

- `200`
  The versions.
  Body fields:
- `404`
  `NOT_FOUND`: no such model or version, or it is private. The two cases are not told apart.