> For the complete documentation index, see [llms.txt](https://docs.merchone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.merchone.com/api-reference/api-v1/products.md).

# 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](#get-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) 

## Show products

> This API endpoint retrieves a list of all products

```json
{"openapi":"3.0.3","info":{"title":"MerchOne API","version":"1.0.0"},"servers":[{"url":"https://api.merchone.com/api/v1"}],"security":[{"BasicAuth":[]}],"components":{"securitySchemes":{"BasicAuth":{"type":"http","scheme":"basic"}}},"paths":{"/products":{"get":{"tags":["Products"],"summary":"Show products","description":"This API endpoint retrieves a list of all products","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"title":{"type":"string"},"description":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"product_sku":{"type":"array","items":{"type":"string"}},"published":{"type":"boolean"},"previews":{"type":"array","items":{"type":"string"}}}}}}}}}},"401":{"description":"Unauthorized"}}}}}}
```

***

The [product's details](#get-products-product) 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 

## Show product

> This API endpoint retrieves information about the product

```json
{"openapi":"3.0.3","info":{"title":"MerchOne API","version":"1.0.0"},"servers":[{"url":"https://api.merchone.com/api/v1"}],"security":[{"BasicAuth":[]}],"components":{"securitySchemes":{"BasicAuth":{"type":"http","scheme":"basic"}}},"paths":{"/products/{product}":{"get":{"tags":["Products"],"summary":"Show product","description":"This API endpoint retrieves information about the product","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"sku":{"type":"string"},"name":{"type":"string"},"options":{"type":"object","properties":{"option-key":{"type":"string"}}},"markup":{"type":"string"},"cost":{"type":"string"},"price":{"type":"string"},"published":{"type":"boolean"},"previews":{"type":"array","items":{"type":"string"}}}}}}}}}},"401":{"description":"Unauthorized"}}}}}}
```