Product

Product in the catalog

Schema

| Property | Type | Required | Description | |----------|------|----------|-------------| | id | string (uuid) | ✓ | Unique identifier for the product | | slug | string | ✓ | URL-friendly slug for the product | | name | string | ✓ | Product name | | description | string | | Product description | | price | number | ✓ | Product price | | currency | string | ✓ | Currency code (ISO 4217, e.g., USD, EUR, AUD) | | in_stock | boolean | ✓ | Whether the product is in stock | | stock_quantity | integer | | Number of units in stock | | images | string[] | | Product image URLs | | categories | string[] | | Product categories | | tags | string[] | | Product tags for search | | created_at | string (date-time) | | When the product was created | | updated_at | string (date-time) | | When the product was last updated |

Example

{
  "id": "d4e5f6a7-b8c9-0123-def4-567890123456",
  "slug": "cuppa-pro-subscription",
  "name": "Cuppa Pro Subscription",
  "description": "Monthly subscription for Cuppa Pro features including AI chat and premium content",
  "price": 9.99,
  "currency": "USD",
  "in_stock": true,
  "stock_quantity": 999999,
  "images": [
    "https://mycuppa.io/products/cuppa-pro.png"
  ],
  "categories": [
    "subscription",
    "software"
  ],
  "tags": [
    "pro",
    "premium",
    "subscription"
  ],
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2025-11-06T10:00:00Z"
}