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

POST

/v1/merchantCatalog/effective/variants

For account owner or regular merchant: Searches in their enabled catalog.
For subaccount: Searches in owned enabled catalog, assigned catalog, or inherited catalog from the account owner.
Falls back to global catalog if no enabled catalog is found.

Request

Body Params

application/json

Examples

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' \
--header 'Content-Type: application/json' \
--data '{
    "merchantId": "merchant-123",
    "skus": [
        "SKU-001",
        "SKU-002",
        "SKU-003"
    ]
}'

Response Example

200 - Success

{
    "merchantVariants": [
        {
            "sku": "SKU-001",
            "merchantSku": "MERCHANT-SKU-001",
            "merchantPrice": {
                "currencies": [
                    {
                        "amount": 19.99,
                        "currency": "USD"
                    }
                ],
                "amount": 19.99,
                "currency": "USD"
            },
            "skipImageManipulation": null,
            "productId": "product-123",
            "decorations": [
                {
                    "area": "Front",
                    "width": 1000,
                    "height": 1000,
                    "dpi": 300,
                    "method": null,
                    "price": null,
                    "printImage": null
                }
            ],
            "attributes": [
                {
                    "name": "Color",
                    "value": "Red"
                },
                {
                    "name": "Size",
                    "value": "Large"
                }
            ]
        }
    ],
    "merchantHasCustomCatalog": true
}

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

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

Get audit logs of a merchant catalog