Orders

Introduction

Through the endpoints included in the Orders section, you will be able to:

Retrieve all the orders
Retrieve details about a specific order
Create orders
Accept orders
Update orders' shipping address

Blueprints vs. Pre-configured products

There are two main ways to place an order through the API:

Using SKUs from Blueprints You provide the SKU and attach a custom print file. This is like sending us a blank T-shirt or canvas and telling us what to print on it — flexible and ideal for on-demand or user-generated content.
Using Pre-configured products In contrast, you can also order ready-made products that were created via our product configurator in the dashboard (see the products section of the docs).
- These already have artwork/designs attached
- No need to send a print file with the order — you just reference the pre-made product_sku

This distinction is important — blueprint-based SKUs are customizable templates, while Products are finalized and ready for sale. Both are valid paths depending on your business model and integration.

Attribute

Blueprint-based SKU

Product (from Configurator)

Artwork attached?

No – print file must be provided when ordering (either via URL or image_id from the Library)

Yes – artwork is embedded in the product definition

SKU Format

Plain (e.g., CVS0200201LWF2)

With artwork code (e.g., CVS0200201LWF2-APO12345678)

Created via

API programmatically

Dashboard Configurator

Best for

Personalized/unique orders with dynamic content

Selling pre-made or branded product collections

Order method

Use product_sku + artwork with URL or image_id via /orders

Use product_sku only — no need to re-send artwork

Endpoints

Get orders

get

This API endpoint retrieves a list of all orders

Authorizations

Responses

200

application/json

401

Unauthorized

get

GET /api/v1/orders HTTP/1.1
Host: api.merchone.com
Authorization: Basic username:password
Accept: */*

{
  "data": [
    {
      "order_id": "PPO12345678",
      "external_id": null,
      "country": "DE",
      "shipping_type": "Tracked",
      "is_test": false,
      "total_amount": 100,
      "created_at": "2025-01-01T00:00:00+00:00",
      "updated_at": "2025-01-01T00:00:00+00:00",
      "fulfilled_at": null,
      "status": "Draft"
    }
  ]
}

Show order

get

This API endpoint retrieves information about the order

Authorizations

Path parameters

orderstringRequired

The ID of the order.

Responses

200

application/json

401

Unauthorized

get

GET /api/v1/orders/{order} HTTP/1.1
Host: api.merchone.com
Authorization: Basic username:password
Accept: */*

{
  "data": {
    "order_id": "PPO12345678",
    "external_id": null,
    "status": "Draft",
    "shipping": {
      "email": null,
      "firstname": "John",
      "lastname": "Doe",
      "company": null,
      "street_primary": "275 Wyman St.",
      "street_secondary": null,
      "city": "BE",
      "postcode": "01234",
      "country": "DE",
      "telephone": "+1234567890"
    },
    "shipping_type": "Tracked",
    "is_test": true,
    "total_amount": {
      "amount": 100,
      "currency": "EUR"
    },
    "sub_total": {
      "amount": 90,
      "currency": "EUR"
    },
    "shipping_total": {
      "amount": 10,
      "currency": "EUR"
    },
    "customs_shipping": {
      "amount": 0,
      "currency": "EUR"
    },
    "customs_costs": {
      "amount": 0,
      "currency": "EUR"
    },
    "created_at": "2023-01-01T00:00:00+00:00",
    "updated_at": "2023-01-01T11:00:00+00:00",
    "fulfilled_at": null,
    "packages": [],
    "items": [
      {
        "external_id": "1",
        "sku": "CVS0200201LWF2",
        "article": {
          "id": 1,
          "sku": "CVS0200201LWF2-APO12345678"
        },
        "description": "20x20 cm - White - 2 cm",
        "quantity": 1,
        "unit_cost": {
          "amount": 7,
          "currency": "EUR"
        },
        "taxes": {
          "amount": 10,
          "currency": "EUR"
        },
        "total_item": {
          "amount": 10,
          "currency": "EUR"
        },
        "metadata": null
      }
    ]
  }
}

Create order

post

Authorizations

Body

one ofOptional

Responses

200

application/json

401

Unauthorized

422

Unprocessable Entity

post

POST /api/v1/orders HTTP/1.1
Host: api.merchone.com
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 375

{
  "external_id": "",
  "shipping_type": "tracked",
  "is_test": true,
  "shipping": {
    "firstname": "Sophie",
    "lastname": "Muller",
    "email": "[email protected]",
    "street_primary": "101 Elm Road",
    "country": "DE",
    "city": "Berlin",
    "postcode": "10115",
    "customs_shipping": 2.99
  },
  "items": [
    {
      "quantity": 1,
      "product_sku": "CVS0200201LWF2",
      "file": {
        "front": {
          "url": "https://example.com/images/image.png"
        }
      }
    }
  ]
}

{
  "order_id": "PPO12345678"
}

Accept order

put

Authorizations

Path parameters

orderstringRequired

The ID of the order.

Responses

200

application/json

401

Unauthorized

put

PUT /api/v1/orders/{order}/accept HTTP/1.1
Host: api.merchone.com
Authorization: Basic username:password
Accept: */*

{
  "message": "Order has been accepted"
}

Update order's address

put

Authorizations

Path parameters

orderstringRequired

The ID of the order.

Body

emailstring · emailOptional

telephonestringOptional

firstnamestringRequired

lastnamestringRequired

companystringOptional

street_primarystringRequired

street_secondarystringOptional

Responses

200

application/json

401

Unauthorized

403

Forbidden

put

PUT /api/v1/orders/{order}/update-address HTTP/1.1
Host: api.merchone.com
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 193

{
  "email": "[email protected]",
  "telephone": "+1234567890",
  "firstname": "Sophie",
  "lastname": "Muller",
  "company": "Example Company",
  "street_primary": "101 Elm Road",
  "street_secondary": "Apt 123"
}

{
  "message": "Address has been updated"
}

Parameters

PreviousBlueprints NextLibrary

Last updated 12 days ago