Catalog

Introduction

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

• Retrieve all the available products

• Get information about the products' variants

• Retrieve information about the options available for a specific store (corresponding to a determined printing/fulfillment location i.e. North America or Europe)

Endpoints

Products

Show products

This API endpoint retrieves a list of all available products.

get

/products

Authorizations

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.merchone.com/api/beta/products' \
  --header 'Authorization: Basic username:password'

200

401

200

{
  "data": [
    {
      "id": 2,
      "name": "Canvas",
      "variants": 64,
      "sku": "CVS",
      "dpi": 36,
      "type": "PRINT",
      "images": [
        {
          "id": 1,
          "original": "https://dummyimage.com/4000x3000/fff/000&text=api.merchone.com",
          "thumb": "https://dummyimage.com/400x300/fff/000&text=api.merchone.com"
        }
      ]
    },
    {
      "id": 4,
      "name": "Magic Mug",
      "variants": 5,
      "sku": "MGM",
      "dpi": 72,
      "type": "PRINT",
      "images": [
        {
          "id": 2,
          "original": "https://dummyimage.com/4000x3000/fff/000&text=api.merchone.com",
          "thumb": "https://dummyimage.com/400x300/fff/000&text=api.merchone.com"
        }
      ]
    }
  ]
}

Request completed successfully.

Product's variants

Show product's variants

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

get

/products/{product_id}

Authorizations

Path parameters

product_idinteger · int64required

ID of product to return

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.merchone.com/api/beta/products/{product_id}' \
  --header 'Authorization: Basic username:password'

200

401

422

200

{
  "data": [
    {
      "id": 30,
      "code": "QUAD-100X100-1",
      "variant_id": 30,
      "variant_code": "QUAD-100X100-1",
      "sku": "1001001",
      "name": "100x100 cm",
      "price": 29.8,
      "shipping_countries": [
        276,
        826,
        246
      ],
      "printfile": {
        "format_width": 1000,
        "format_height": 1000
      },
      "price_details": {
        "currency": "EUR",
        "formatted": "29.09 €",
        "in_subunit": 298
      },
      "options": {
        "1": {
          "name": "Canvas border",
          "description": null,
          "image": null,
          "is_required": true,
          "values": [
            {
              "id": 1,
              "name": "Mirrored",
              "sku": "",
              "image": null,
              "price": 0,
              "price_details": {
                "currency": "EUR",
                "formatted": "29.09 €",
                "in_subunit": 298
              }
            }
          ]
        }
      }
    }
  ]
}

Request completed successfully.

Variant's options

Show variant's options

This API endpoint retrieves a list of all available variant's options.<br /><br />The variant_id can be checked at /api/beta/products/{product_id}

get

/variants/{variant_id}

Authorizations

Path parameters

variant_idinteger · int64required

ID of the variant

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.merchone.com/api/beta/variants/{variant_id}' \
  --header 'Authorization: Basic username:password'

200

401

422

200

{
  "data": {
    "id": 30,
    "code": "QUAD-100X100-1",
    "variant_id": 30,
    "variant_code": "QUAD-100X100-1",
    "sku": "1001001",
    "name": "100x100 cm",
    "price": 29.8,
    "shipping_countries": [
      276,
      826,
      246
    ],
    "printfile": {
      "format_width": 1000,
      "format_height": 1000
    },
    "price_details": {
      "currency": "EUR",
      "formatted": "29.09 €",
      "in_subunit": 298
    },
    "options": {
      "1": {
        "name": "Canvas border",
        "description": null,
        "image": null,
        "is_required": true,
        "values": [
          {
            "id": 1,
            "name": "Mirrored",
            "sku": "",
            "image": null,
            "price": 0,
            "price_details": {
              "currency": "EUR",
              "formatted": "29.09 €",
              "in_subunit": 298
            }
          }
        ]
      }
    }
  }
}

Request completed successfully.

SKU's variant options

Show SKU's variant options

This API endpoint retrieves a list of all available SKU's variant options.<br /><br />The variant_id can be checked at /api/beta/products/{product_id}

get

/variants/{variant_id}/combinations

Authorizations

Path parameters

variant_idinteger · int64required

ID of variant to return

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.merchone.com/api/beta/variants/{variant_id}/combinations' \
  --header 'Authorization: Basic username:password'

200

401

422

200

{
  "data": {
    "sku": "CVS0200201F2HCLMSB",
    "name": "20x20 cm, Canvas border: Mirrored,Stretcher frame: 2 cm,Frame: Floating Frame Black Matt,Hanger Set for Canvas: Hanger Set for Canvas",
    "price": 13.02,
    "price_details": {
      "currency": "EUR",
      "formatted": "13.02 €",
      "in_subunit": 1302
    },
    "options": [
      {
        "id": 1,
        "name": "Canvas border",
        "image": null,
        "description": "",
        "is_required": true,
        "value": {
          "id": 1,
          "name": "Mirrored",
          "price": 0.2,
          "image": {
            "id": 1228,
            "original": "https://euc-premiumprint-testing.s3.eu-central-1.amazonaws.com/images/image/dE/DU/dEDUgdRkTyh9EFtfirS3gfHvPmn466OJ4mQUqqYW.jpeg"
          },
          "price_details": {
            "currency": "EUR",
            "formatted": "0.20 €",
            "in_subunit": 20
          }
        }
      },
      {
        "id": 2,
        "name": "Stretcher frame",
        "image": null,
        "description": "",
        "is_required": true,
        "value": {
          "id": 6,
          "name": "2 cm",
          "price": 2,
          "image": {
            "id": 194,
            "original": "https://euc-premiumprint-testing.s3.eu-central-1.amazonaws.com/images/image/lK/jc/lKjcoc347fqYciukY9Aw8VSRajNNRr9v0H1W2Erd.jpeg"
          },
          "price_details": {
            "currency": "EUR",
            "formatted": "2.00 €",
            "in_subunit": 200
          }
        }
      },
      {
        "id": 5,
        "name": "Frame",
        "image": null,
        "description": "",
        "is_required": false,
        "value": {
          "id": 18,
          "name": "Floating Frame Black Matt",
          "price": 5.76,
          "image": {
            "id": 6581,
            "original": "https://euc-premiumprint-testing.s3.eu-central-1.amazonaws.com/images/image/tU/9N/tU9NxIOS0PJ0iqPrIcfZ3K69hvxQIsm7AlbxcKPN.jpg"
          },
          "price_details": {
            "currency": "EUR",
            "formatted": "5.76 €",
            "in_subunit": 576
          }
        }
      },
      {
        "id": 17,
        "name": "Hanger Set for Canvas",
        "image": null,
        "description": null,
        "is_required": false,
        "value": {
          "id": 38,
          "name": "Hanger Set for Canvas",
          "price": 1.27,
          "image": {
            "id": 6279,
            "original": "https://euc-premiumprint-testing.s3.eu-central-1.amazonaws.com/images/image/KV/MS/KVMSFrC87rFCTkrAYSD9psNDIsvlCDfrApT74TaM.jpg"
          },
          "price_details": {
            "currency": "EUR",
            "formatted": "1.27 €",
            "in_subunit": 127
          }
        }
      }
    ]
  }
}

Request completed successfully.