Blueprints
Introduction
Through the endpoints included in the Blueprints section, you will be able to:
Retrieve all the available blueprints
Retrieve all the available blueprint variants
Retrieve all the available blueprint variant options
Endpoints
Blueprint is the foundation for any customizable product we offer — like a poster, mug, blanket, or canvas. Think of it as the template or base model of the product, before it has been customized by your customer.
In simple terms, a Blueprint defines what kind of product your store can sell — and how it can be produced.
For example:
Blueprint: Canvas
Variants: 20×20 cm, 30×30 cm, etc.
Options: Add-ons like different frames, hanger sets, or canvas borders
While most products follow the general structure outlined above, some product types — especially apparel — may be structured differently.
For example:
Blueprint: T-shirt
Variants: Different types (e.g., Premium Men's T Shirt, Women’s T Shirt)
Options: Sizes (e.g., S, M, L, XL)
This flexible hierarchy allows us to support a wide range of product types.
This API endpoint retrieves a list of all available blueprints.
OK
Unauthorized
GET /api/v1/blueprints HTTP/1.1
Host: api.merchone.com
Authorization: Basic username:password
Accept: */*
{
"data": [
{
"id": 1,
"name": "Canvas",
"description": "A versatile design classic updated with HP latex inks...",
"tags": [
"canvas"
],
"type": "PRINT",
"images": [],
"variants_count": 1
},
{
"id": 2,
"name": "Magic Mug",
"description": "A quality ceramic photo mug with a twist...",
"type": "PRINT",
"tags": [],
"images": [],
"variants_count": 1
}
]
}The blueprint's variants endpoint provides detailed information about all variants of a specific blueprint. A variant typically represents a different version of the product — like a size, format, or type.
When you call this endpoint, you’ll receive:
The ID of each variant
This is required when fetching related options via the options endpoint
The name and type of the variant
Design area – the safe area for the print file on the variant (in mm)
Print file – full print area of the variant (in mm)
The price and formatted price
The production location (e.g., Europe or US)
Additional fields like tags, images, and design area specifications
This API endpoint retrieves a list of all available blueprint's variants.
The ID of the blueprint.
OK
Unauthorized
Not Found
GET /api/v1/blueprints/{blueprint}/variants HTTP/1.1
Host: api.merchone.com
Authorization: Basic username:password
Accept: */*
{
"data": [
{
"id": 1,
"name": "20x20 cm",
"production": "Europe",
"type": "PRINT",
"trim": null,
"design_area": {
"width": 200,
"height": 200
},
"printfile": {
"width": 200,
"height": 200
},
"description": null,
"tags": [],
"images": [],
"price": 10,
"price_details": {
"currency": "EUR",
"formatted": "10.00 €",
"in_subunit": 1000
}
},
{
"id": 1,
"name": "30x20 cm",
"production": "Europe",
"type": "PRINT",
"trim": null,
"design_area": {
"width": 300,
"height": 200
},
"printfile": {
"width": 300,
"height": 200
},
"description": null,
"tags": [],
"images": [],
"price": 12,
"price_details": {
"currency": "EUR",
"formatted": "12.00 €",
"in_subunit": 1200
}
}
]
}The variant's options endpoint returns a list of predefined SKU combinations for a specific variant of a blueprint. Each item in the response represents a complete configuration — a unique combination of options that can be ordered. Once you’ve selected a base product (Blueprint) and a variant (like size or type), this endpoint gives you all the valid option combinations that define how the product can be manufactured.
What kind of data will you receive?
A list of SKU-level configurations — each SKU represents a unique combination of a variant with specific options
The SKU identifier and descriptive name
The price of the SKU, including currency breakdown
The option attributes, such as:
Border types
Frame sizes
T-shirt colors
Print area and design file requirements (dimensions, DPI, and positioning)
How It Connects to Orders?
These SKUs act as blank product templates — they are used when placing an order programmatically via the orders endpoint. When using this approach:
You provide the SKU (from this endpoint) in the product_sku field of your order payload
Alongside the SKU, you include a print file (design or artwork) via a URL.
This is ideal for dynamically personalized or user-uploaded designs that aren’t pre-configured in your product catalog.
Alternatively, if you have already uploaded artwork to the Library, you can place orders using the associated image_id. This allows you to reference existing assets without re-uploading them for every order.
Retrieve options for a specific variant of a blueprint.
The ID of the blueprint.
The ID of the variant.
OK
Unauthorized
Blueprint variant or options not found.
GET /api/v1/blueprints/{blueprint}/variants/{variant}/options HTTP/1.1
Host: api.merchone.com
Authorization: Basic username:password
Accept: */*
{
"data": {
"id": 1,
"name": "20x20 cm",
"variants": [
{
"sku": "CVS0200201LWF2",
"name": "White / 2 cm",
"price": 10,
"price_details": {
"currency": "EUR",
"formatted": "10.00 €",
"in_subunit": 1000
},
"options": [
{
"id": 4,
"Canvas border": "White",
"price": 1,
"price_details": {
"currency": "EUR",
"formatted": "1.00 €",
"in_subunit": 100
}
},
{
"id": 6,
"Stretcher frame": "2 cm",
"price": 1,
"price_details": {
"currency": "EUR",
"formatted": "1.00 €",
"in_subunit": 100
}
}
],
"print_areas": [
{
"position": "front",
"width": 200,
"height": 200,
"dpi": 36,
"type": "PRINT",
"required": true
}
]
}
]
}
}Last updated