> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nmcrate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List product versions

> Complete version history of one of your products, every status, with changelogs and file metadata.

Returns the full version history of one of your products. Unlike the general public API, this includes versions in **every status** (drafts, pending review, published) and always includes file metadata, it's your own product.

<Info>
  **Tier:** Free, any studio key.
</Info>

## Request

```bash theme={null}
curl https://nmcrate.com/api/public/v1/studio/products/dungeon-pack/versions \
  -H "x-api-key: nmk_studio_..."
```

### Path parameters

| Parameter | Type   | Description                           |
| --------- | ------ | ------------------------------------- |
| `slug`    | string | Product slug, public id, or ObjectId. |

## Response

```json theme={null}
{
  "product": {
    "id": "prod_8f3a2c",
    "slug": "dungeon-pack",
    "name": "Dungeon Pack"
  },
  "items": [
    {
      "id": "66a1b2c3d4e5f60718293a4b",
      "version": "2.1.0",
      "status": "published",
      "changelog": "Added 10 new rooms.",
      "releaseNotes": null,
      "releaseType": "minor",
      "isStable": true,
      "isCurrentVersion": true,
      "publishedAt": "2026-06-30T08:12:00.000Z",
      "downloadCount": 812,
      "supportedMinecraftVersions": ["1.20", "1.21"],
      "supportedPlatforms": ["paper", "spigot"],
      "fileSize": 4831204,
      "fileCount": 1
    }
  ],
  "total": 7
}
```

Versions are sorted newest first (by publish date, then creation date).

<Note>
  This endpoint returns file **metadata** only (`fileSize`, `fileCount`), never raw storage URLs. Downloads always go through the store's download endpoints so per-buyer protection (license keys, watermarks, placeholders) is applied.
</Note>

## Errors

| HTTP | Code        | When                                            |
| ---- | ----------- | ----------------------------------------------- |
| 404  | `NOT_FOUND` | No product with that identifier in this studio. |