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

POST

/v1/merchantCatalog/effective/variants

Vendor Access: Forbidden — This endpoint is not accessible to vendor users.

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

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Body Params

application/json

Examples

Responses

🟢200

application/json

Body

🟠400

🟠401

🟠403

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.dev.ordermesh.io/catalog/v1/merchantCatalog/effective/variants' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "merchantId": "merchant-123",
    "skus": [
        "SKU-001",
        "SKU-002",
        "SKU-003"
    ],
    "pageSize": null,
    "cursor": null
}'

Response Example

200 - Success

{
    "merchantVariants": [
        {
            "id": null,
            "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": "DirectToGarment",
                    "price": null,
                    "printImage": null,
                    "attributes": [
                        {
                            "name": "Placement",
                            "value": "Center Chest"
                        }
                    ]
                }
            ],
            "attributes": [
                {
                    "name": "Color",
                    "value": "Red"
                },
                {
                    "name": "Size",
                    "value": "Large"
                }
            ],
            "options": [
                {
                    "name": "Packaging",
                    "value": "Gift Box"
                }
            ],
            "extras": [
                {
                    "name": "Care Instructions",
                    "value": "Machine wash cold"
                }
            ],
            "shippingGroupId": null
        }
    ],
    "merchantHasCustomCatalog": true,
    "nextCursor": ""
}

Modified at 2026-09-08 16:59:39

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

Get audit logs of a merchant catalog