Retrieve product variant details

GET

/v1/products/{id}/variants

Vendor Access: Allowed — Vendor users can access this endpoint.

This API request allows you to retrieve all available variants along with their details for a specific product using the product's unique identifier you have previously obtained from the ‘View all products’ endpoint - Product ID. You also have the option to specify the size and number of pages you wish to get in the response, by including the parameters in the request URL.

Request

Authorization

Add the parameter

Authorization

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

Example:

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

Path Params

Query Params

Responses

🟢200

application/json

Body

🟠400

🟠401

🟠403

🟠409

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.ordermesh.io/catalog/v1/products//variants?page=&pageSize=&useCursor=&cursor=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "total": 2,
    "variants": [
        {
            "id": "73534",
            "productId": "1194",
            "productType": null,
            "categories": null,
            "subCategories": null,
            "sku": "Mug11oz-White-RedAccent",
            "attributes": [
                {
                    "name": "Color",
                    "value": "White With Red Accents"
                },
                {
                    "name": "Size",
                    "value": "11 oz"
                }
            ],
            "options": [],
            "decorations": [
                {
                    "area": "Default",
                    "width": 2538,
                    "height": 945,
                    "dpi": 300,
                    "method": "DirectToGarment",
                    "price": null,
                    "printImage": null,
                    "attributes": [
                        {
                            "name": "Placement",
                            "value": "Center Chest"
                        }
                    ]
                }
            ],
            "price": {
                "currencies": null,
                "amount": 7.9,
                "currency": "USD"
            },
            "status": "active",
            "images": [
                "http://cdn.print.io/temp/b372005663144e6699af3c2c58b7ea9bMug_red_PreviewImage.png"
            ],
            "gtin": null,
            "upc": null,
            "partNumber": null,
            "extras": [
                {
                    "name": "PimVariantId",
                    "value": "PIM-VAR-73534"
                },
                {
                    "name": "LegacySku",
                    "value": "OLD-SKU-XYZ"
                }
            ]
        },
        {
            "id": "73529",
            "productId": "1194",
            "productType": null,
            "categories": null,
            "subCategories": null,
            "sku": "Mug11oz-White-BlackAccent",
            "attributes": [
                {
                    "name": "Color",
                    "value": "White With Black Accents"
                },
                {
                    "name": "Size",
                    "value": "11 oz"
                }
            ],
            "options": [],
            "decorations": [
                {
                    "area": "Default",
                    "width": 2538,
                    "height": 945,
                    "dpi": 300,
                    "method": "DirectToGarment",
                    "price": null,
                    "printImage": null,
                    "attributes": [
                        {
                            "name": "Placement",
                            "value": "Center Chest"
                        }
                    ]
                }
            ],
            "price": {
                "currencies": null,
                "amount": 7.9,
                "currency": "USD"
            },
            "status": "active",
            "images": [
                "http://cdn.print.io/temp/38977dab92ba4699a79d84230e32fa85Mug_black_PreviewImage.png"
            ],
            "gtin": null,
            "upc": null,
            "partNumber": null,
            "extras": null
        }
    ],
    "nextCursor": ""
}

Modified at 2026-10-23 15:21:26

View all products

Create a new product