Search the products of the merchant's custom catalog, with live global product data

POST

/v1/merchantCatalog/effective/products/enriched/search

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

The enriched products endpoint with filters in a JSON body; the catalog resolution, response and paging are those of
GET merchantCatalog/effective/products/enriched. The filters select the catalog's merchant variants and the page
holds the products of the matching variants: skus and merchantSkus match case-insensitively,
variantIds are merchant-variant ids and productIds are global product ids. The lists combine with AND,
the values inside one list with OR; an empty or omitted list does not filter, and a value outside the catalog matches
nothing. A cursor is valid only with the filters it was issued with.

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

🟠404

🟠409

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.ordermesh.io/catalog/v1/merchantCatalog/effective/products/enriched/search' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "merchantId": "681abd18c61bccfab89bc63e",
    "page": 1,
    "pageSize": 50,
    "skus": [
        "MUG-ACC-11OZ-BLUE",
        "MUG-ACC-11OZ-RED"
    ],
    "merchantSkus": [],
    "variantIds": [],
    "productIds": [
        "1194"
    ],
    "useCursor": false,
    "cursor": null
}'

Response Example

200 - Page by number

{
    "merchantHasCustomCatalog": true,
    "items": [
        {
            "id": "1194",
            "title": "Accent Mugs",
            "description": "Ceramic mug with a colored handle and interior, printed edge to edge.",
            "brand": "Print",
            "model": "Accent Mug 11oz",
            "modelId": "mdl-1194-11",
            "status": "ACTIVE",
            "categories": [
                "Home & Living",
                "All"
            ],
            "subCategories": [
                "Drinkware"
            ],
            "images": [
                "https://az412349.cdn.gooten.com/product-accentmugs/CatalogPreviews/AccentMugBlue-1.jpg"
            ],
            "attributes": [
                {
                    "name": "Color",
                    "values": [
                        {
                            "name": "Blue"
                        },
                        {
                            "name": "Red"
                        }
                    ]
                }
            ],
            "options": [
                {
                    "name": "Handle Color",
                    "values": [
                        {
                            "name": "White"
                        },
                        {
                            "name": "Black"
                        }
                    ]
                }
            ],
            "extras": [
                {
                    "name": "Gift Wrap",
                    "values": [
                        "Yes",
                        "No"
                    ]
                }
            ],
            "globalResolved": true,
            "globalResolution": null
        },
        {
            "id": "1203",
            "title": null,
            "description": null,
            "brand": null,
            "model": null,
            "modelId": null,
            "status": null,
            "categories": [],
            "subCategories": [],
            "images": [],
            "attributes": [],
            "options": [],
            "extras": [],
            "globalResolved": false,
            "globalResolution": "DELETED"
        },
        {
            "id": "9001",
            "title": null,
            "description": null,
            "brand": null,
            "model": null,
            "modelId": null,
            "status": null,
            "categories": [],
            "subCategories": [],
            "images": [],
            "attributes": [],
            "options": [],
            "extras": [],
            "globalResolved": false,
            "globalResolution": "NOT_FOUND"
        }
    ],
    "page": 1,
    "pageSize": 50,
    "totalCount": 3,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false,
    "nextCursor": ""
}

Modified at 2026-10-26 16:22:03

Get the products of the merchant's custom catalog with live global product data

View all products