GET
/
products
/
{productId}
Product
curl --request GET \
  --url https://api.marzipan.co/v1/products/{productId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "2e2805a1-738e-4118-8a8b-f9431f0e210c",
  "name": "Cellar Selection Malbec",
  "slug": "cellar-selection-malbec-2015",
  "url": "https://api.marzipan.co/products/cellar-selection-malbec-2015",
  "description": "Id laboris ad aliqua exercitation dolore. Ad, aliqua exercitation dolore est culpa. Dolore est culpa, nostrud. Nostrud ad sed mollit, fugiat. Mollit fugiat, irure adipiscing ipsum id. Adipiscing ipsum id ea cillum deserunt, ipsum lorem.",
  "product_type": "physical",
  "sku": "CSMALBC2015",
  "collections": [
    {
      "id": "885ea507-690b-4598-a8fc-095c0528be24",
      "name": "Store",
      "slug": "store",
      "description": "Store collection"
    }
  ],
  "status": "active",
  "images": {
    "product": [
      {
        "id": "0736c529-a33d-4b8c-8126-eb69779dcdad",
        "path": "1/0736c529-a33d-4b8c-8126-eb69779dcdad.jpg",
        "src": "https://marzipan-cloud-dev.b-cdn.net/1/0736c529-a33d-4b8c-8126-eb69779dcdad.jpg",
        "alt": "Cellar Selection Malbec 2015 bottle",
        "mimeType": "image/jpeg",
        "filename": "0736c529-a33d-4b8c-8126-eb69779dcdad.jpg"
      }
    ],
    "labels": {
      "front": [],
      "back": []
    }
  },
  "primaryImage": {
    "id": "0736c529-a33d-4b8c-8126-eb69779dcdad",
    "path": "1/0736c529-a33d-4b8c-8126-eb69779dcdad.jpg",
    "src": "https://marzipan-cloud-dev.b-cdn.net/1/0736c529-a33d-4b8c-8126-eb69779dcdad.jpg",
    "alt": "Cellar Selection Malbec 2015 bottle",
    "mimeType": "image/jpeg",
    "filename": "0736c529-a33d-4b8c-8126-eb69779dcdad.jpg"
  },
  "price": "£24.99",
  "salePrice": null,
  "subscriberPrice": null,
  "createdAt": "2024-02-05T23:22:56.000000Z",
  "updatedAt": "2024-02-05T23:22:56.000000Z",
  "store_slug": "store",
  "subscriptions_slug": null,
  "availability": "all",
  "upsell_products": [],
  "attributes": [],
  "options": [],
  "related_products": [],
  "awards": [],
  "reviews": [],
  "meta_title": "Cellar Selection Malbec 2015",
  "meta_description": "Cupidatat quis reprehenderit, exercitation quis cillum nulla do.",
  "meta_image": null,
  "store_name": "Wine Collection"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your API token.

Path Parameters

productId
string<uuid>
required

The unique identifier for the product

Query Parameters

include
enum<string>

Comma-separated list of related resources to include in the response. Available options: linkedSubscriptions (includes full subscription details for products with linked subscriptions).

Available options:
linkedSubscriptions

Response

Product details

id
string<uuid>

Unique identifier for the product

name
string

Product name

slug
string

URL-friendly product identifier

url
string

Full URL to the product page

description
string

Product description

product_type
enum<string>

Type of product

Available options:
physical,
event,
subscription,
bundle
subscription_type
enum<string>

Type of subscription. Only present for subscription products

Available options:
picknmix,
variable
sku
string

Stock Keeping Unit

collections
object[]

Collections this product belongs to

status
enum<string>

Product status - automatically set to out_of_stock when quantity is 0

Available options:
active,
inactive,
out_of_stock
images
object

Product images organized by type

primaryImage
object

Primary product image

price
string

Formatted price (e.g., £10.00). For pick-and-mix subscriptions with per-item pricing, may show 'from £X.XX'

salePrice
string | null

Formatted sale price if on sale

subscriberPrice
string | null

Special price for subscribers. Not shown for subscription products

createdAt
string<date-time>

Creation timestamp

updatedAt
string<date-time>

Last update timestamp

store_slug
string

Store URL slug

subscriptions_slug
string

Subscriptions URL slug

availability
enum<string>

Product availability

Available options:
all,
subscribers
upsell_products
object[]

Upsell products with simplified data

linkedSubscriptions
object[]

Full details of linked subscriptions. Only included when requested via the include query parameter.

billing_frequency
integer

Billing frequency in months. Only present for subscription products

billing_frequencies
integer[]

Available billing frequencies. Only present for subscription products

pricing_type
enum<string>

Pricing type for subscriptions. Only present for subscription products

Available options:
fixed,
per_item
bundle_items
object[]

Items included in bundle. Only present for bundle products

attributes
object[]

Product attributes like color, size, etc.

options
object[]

Product options with their possible values

Related products

awards
object[]

Product awards

reviews
object[]

Product reviews

meta_title
string

SEO meta title

meta_description
string

SEO meta description

meta_image
string | null

SEO meta image URL (1200x630)

linked_subscription
boolean

Whether product has linked subscriptions. Only present if product has linked subscriptions

store_name
string

Store name