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

get

This API endpoint retrieves a list of all available products.

Authorizations
Responses
200
Request completed successfully.
application/json
get
GET /api/beta/products HTTP/1.1
Host: api.merchone.com
Authorization: Basic username:password
Accept: */*
{
  "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"
        }
      ]
    }
  ]
}

Product's variants

Show product's variants

get

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

Authorizations
Path parameters
product_idinteger · int64Required

ID of product to return

Responses
200
Request completed successfully.
application/json
get
GET /api/beta/products/{product_id} HTTP/1.1
Host: api.merchone.com
Authorization: Basic username:password
Accept: */*
{
  "data": [
    {
      "id": 30,
      "code": "QUAD-100X100-1",
      "variant_id": 30,
      "variant_code": "QUAD-100X100-1",
      "sku": "1001001",
      "name": "100x100 cm",
      "printfile": {
        "format_width": 1000,
        "format_height": 1000
      },
      "price": 29.8,
      "price_details": {
        "currency": "EUR",
        "formatted": "29.09 €",
        "in_subunit": 298
      },
      "shipping_countries": [
        276,
        826,
        246
      ],
      "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
              }
            }
          ]
        }
      }
    }
  ]
}

Variant's options

SKU's variant options

Last updated