Get a list of variants the merchant can use in accordance with their enabled catalog

GET

/v1/merchantCatalog/effective/variants/list

Returns empty list if no enabled catalog is found or the catalog is empty.
For account owner or regular merchant: Gets variants from their enabled catalog.
For subaccount: Gets variants from their owned enabled catalog, or falls back to assigned or inherited catalog from the account owner.
Filters out orphaned variants (those deleted from global catalog).

Request

Query Params

Responses

🟢200

application/json

Body

🟠400

🟠401

🟠403

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.qa.ordermesh.io/catalog/v1/merchantCatalog/effective/variants/list?page=undefined&pageSize=undefined'

Response Example

200 - Example 1

{
    "variants": [
        {
            "sku": "string",
            "merchantSku": "string",
            "merchantPrice": {
                "amount": 0,
                "currency": "string",
                "currencies": [
                    {
                        "amount": 0,
                        "currency": "string"
                    }
                ]
            },
            "skipImageManipulation": true,
            "productId": "string",
            "decorations": [
                {
                    "area": "string",
                    "width": 0,
                    "height": 0,
                    "dpi": 0,
                    "method": 0,
                    "price": {
                        "amount": 0,
                        "currency": "string",
                        "currencies": [
                            {
                                "amount": 0,
                                "currency": "string"
                            }
                        ]
                    },
                    "printImage": {
                        "sourcePrintFileUrl": "string",
                        "imageUploadStatus": 0,
                        "imageUploadStatusDesc": "string",
                        "ourPrintFileId": "string",
                        "ourPrintFileUrl": "string"
                    }
                }
            ],
            "attributes": [
                {
                    "name": "string",
                    "value": "string"
                }
            ]
        }
    ],
    "totalVariants": 0
}

Modified at 2026-05-27 12:48:16

Get a merchant catalog with variants

Search for variants in enabled merchant catalog with fallback to global catalog