Products
Introduction
Through the endpoints included in the Products section, you will be able to:
Retrieve a list of all the products
Retrieve details about a specific product
Product refers to a fully configured, ready-to-sell item that has been created through the product configurator in merchOne dashboard.
Unlike Blueprints, which are general templates requiring custom artwork and manual selection of options, Products are complete listings — they already have:
A selected blueprint (e.g., Canvas, T-shirt)
Chosen options (e.g., White border, 2 cm frame)
An attached artwork
One or more preview images
A unique, artwork-specific SKU
These products are essentially what a customer would see in the storefront — finished, designed, and ready to order or publish.
Why This Matters?
These pre-configured products are ideal for:
Brands with fixed collections (e.g., an art print series)
Shops that want fast deployment with no need for dynamic customization
Avoiding extra integration work for sending print files with each order
If your use case involves end-user customization or upload (e.g., photo gifts), you'll likely use the Blueprint approach. But if you're selling pre-designed SKUs, these Products are a faster, cleaner path.
Endpoints
The products endpoint returns a list of all configured products, including:
Product name and description
Tags (like “canvas”, “mug”)
Preview images
The full product_sku (including the artwork reference)
Published status (helpful for managing visibility)
This API endpoint retrieves a list of all products
OK
Unauthorized
GET /api/v1/products HTTP/1.1
Host: api.merchone.com
Authorization: Basic username:password
Accept: */*
{
"data": [
{
"id": 1,
"title": "Canvas",
"description": "A versatile design classic updated with HP latex inks...",
"tags": [
"canvas"
],
"product_sku": [
"CVS0200201LWF2-APO12345678"
],
"published": false,
"previews": [
"https://example.com/images/image.png"
]
}
]
}The product's details endpoint returns detailed information about a specific product, such as:
SKU (e.g., CVS0200201LWF2-APO12345678)
The first part represents the blueprint + variant + options
The APO12345678 suffix links to the embedded artwork
Selected options (e.g., border, frame)
Markup and pricing info
Preview images for display or marketing
Whether the product is published or still in draft
This API endpoint retrieves information about the product
OK
Unauthorized
GET /api/v1/products/{product} HTTP/1.1
Host: api.merchone.com
Authorization: Basic username:password
Accept: */*
{
"data": {
"id": 1,
"sku": "CVS0200201LWF2-APO12345678",
"name": "20x20 cm",
"options": {
"Canvas border": "White",
"Stretcher frame": "2 cm"
},
"markup": "100%",
"cost": "7.00 €",
"price": "14.00 €",
"published": false,
"previews": [
"https://example.com/images/image.png"
]
}
}Last updated