> ## 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 products

> Your studio's full product catalog, drafts included, with public metadata and publish state.

Lists every non-archived product in the studio, **including unpublished drafts**, this is your own data, so nothing is hidden. Each item carries the public product shape plus owner-only publish-state fields.

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

## Request

```bash theme={null}
curl "https://nmcrate.com/api/public/v1/studio/products?status=published&limit=20" \
  -H "x-api-key: nmk_studio_..."
```

### Query parameters

| Parameter | Type    | Default | Description                                              |
| --------- | ------- | ------- | -------------------------------------------------------- |
| `page`    | integer | `0`     | Zero-indexed page number.                                |
| `limit`   | integer | `20`    | Items per page, max `100`.                               |
| `status`  | string  | `all`   | `all`, `published`, or `draft` (anything not published). |

## Response

```json theme={null}
{
  "items": [
    {
      "id": "prod_8f3a2c",
      "slug": "dungeon-pack",
      "name": "Dungeon Pack",
      "shortDescription": "50 rooms of doom.",
      "category": "plugin",
      "tags": ["dungeon", "adventure"],
      "price": 14.99,
      "currency": "USD",
      "isPaid": true,
      "license": "Proprietary",
      "imageUrl": "https://cdn.example.com/dungeon.png",
      "imageUrls": [],
      "currentVersion": "2.1.0",
      "downloadCount": 5321,
      "rating": 4.8,
      "ratingCount": 96,
      "minecraftVersion": { "min": "1.19", "max": "1.21" },
      "modelCompatibility": [],
      "createdAt": "2025-11-02T10:20:00.000Z",
      "updatedAt": "2026-06-30T08:12:00.000Z",
      "url": "/products/dungeon-pack",
      "status": "published",
      "isPublic": true,
      "isArchived": false
    }
  ],
  "page": 0,
  "limit": 20,
  "total": 12,
  "hasMore": false
}
```

| Field                                     | Description                                                               |
| ----------------------------------------- | ------------------------------------------------------------------------- |
| `items[]`                                 | Products sorted by last update, newest first.                             |
| `items[].status`                          | Publish state (`published`, or the review/draft state), owner-only field. |
| `items[].isPublic` / `items[].isArchived` | Visibility flags, owner-only fields.                                      |
| `hasMore`                                 | `true` when another page exists.                                          |