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.

Show blueprints

get

This API endpoint retrieves a list of all available blueprints.

Authorizations

BasicAuth

AuthorizationstringRequired

Responses

200

OK

application/json

401

Unauthorized

get/blueprints

HTTPcURLJavaScriptPython

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

Show blueprint's variants

get

This API endpoint retrieves a list of all available blueprint's variants.

Authorizations

BasicAuth

AuthorizationstringRequired

Path parameters

blueprintstringRequired

The ID of the blueprint.

Responses

200

OK

application/json

401

Unauthorized

404

Not Found

get/blueprints/{blueprint}/variants

HTTPcURLJavaScriptPython

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.

Show blueprint variant options

get

Retrieve options for a specific variant of a blueprint.

Authorizations

BasicAuth

AuthorizationstringRequired

Path parameters

blueprintstringRequired

The ID of the blueprint.

variantstringRequired

The ID of the variant.

Responses

200

OK

application/json

401

Unauthorized

404

Blueprint variant or options not found.

get/blueprints/{blueprint}/variants/{variant}/options

HTTPcURLJavaScriptPython

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
          }
        ]
      }
    ]
  }
}