# 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"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.merchone.com/api-reference/api-v1/products.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.