Search product variants with cursor pagination

POST

/v1/variants/search/paged

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

Cursor-paginated sibling of variants/search. Each response contains at most pageSize variants and a nextCursor. Replay the cursor with the same search terms to get the next page. An empty nextCursor means the walk is complete.

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/variants/search/paged' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "skus": [
        "string"
    ],
    "variantIds": [
        "string"
    ],
    "pageSize": 0,
    "cursor": "string"
}'

Response Example

200 - Example 1

{
    "variants": [
        {
            "id": "string",
            "productId": "string",
            "productType": "string",
            "categories": [
                "string"
            ],
            "sku": "string",
            "attributes": [
                {
                    "id": "string",
                    "name": "string",
                    "value": "string",
                    "valueId": "string"
                }
            ],
            "options": [
                {
                    "id": "string",
                    "name": "string",
                    "value": "string",
                    "valueId": "string"
                }
            ],
            "decorations": [
                {
                    "area": "string",
                    "width": 0,
                    "height": 0,
                    "dpi": 0,
                    "method": "string",
                    "price": {
                        "amount": 0,
                        "currency": "string",
                        "currencies": [
                            {
                                "amount": 0,
                                "currency": "string"
                            }
                        ]
                    },
                    "printImage": {
                        "sourcePrintFileUrl": "string",
                        "imageUploadStatus": 0,
                        "imageUploadStatusDesc": "string",
                        "ourPrintFileId": "string",
                        "ourPrintFileUrl": "string",
                        "placementX": 0,
                        "placementY": 0,
                        "placementScale": 0,
                        "placementAngle": 0
                    },
                    "attributes": [
                        {
                            "name": "string",
                            "value": "string"
                        }
                    ]
                }
            ],
            "price": {
                "amount": 0,
                "currency": "string",
                "currencies": [
                    {
                        "amount": 0,
                        "currency": "string"
                    }
                ]
            },
            "status": "string",
            "images": [
                "string"
            ],
            "gtin": "string",
            "upc": "string",
            "partNumber": "string",
            "extras": [
                {
                    "name": "string",
                    "value": "string"
                }
            ]
        }
    ],
    "nextCursor": "string"
}

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

Search product variants

Get audit logs of a variant