Retrieve product variant details

GET

/v1/products/{id}/variants

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

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Success

{
    "total": 2,
    "variants": [
        {
            "id": "73534",
            "productId": "1194",
            "productType": null,
            "categories": null,
            "sku": "Mug11oz-White-RedAccent",
            "attributes": [
                {
                    "id": "AA9081EC-37A3-43C5-A9D0-9BEC266E77AD",
                    "name": "Color",
                    "value": "White With Red Accents",
                    "valueId": "70AAD8E6-0A49-44B9-86E1-FA7984803FAE"
                },
                {
                    "id": "44E5C8AA-9932-47AC-A5FE-A97278C7279F",
                    "name": "Size",
                    "value": "11 oz",
                    "valueId": "3960F42D-8BCF-4612-AC16-699A114CA7E4"
                }
            ],
            "options": [],
            "decorations": [
                {
                    "area": "Default",
                    "width": 2538,
                    "height": 945,
                    "dpi": 300,
                    "method": null,
                    "price": null,
                    "printImage": null
                }
            ],
            "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
        },
        {
            "id": "73529",
            "productId": "1194",
            "productType": null,
            "categories": null,
            "sku": "Mug11oz-White-BlackAccent",
            "attributes": [
                {
                    "id": "AA9081EC-37A3-43C5-A9D0-9BEC266E77AD",
                    "name": "Color",
                    "value": "White With Black Accents",
                    "valueId": "C477A809-40CD-4BB4-9C30-A650B61CBFA8"
                },
                {
                    "id": "44E5C8AA-9932-47AC-A5FE-A97278C7279F",
                    "name": "Size",
                    "value": "11 oz",
                    "valueId": "3960F42D-8BCF-4612-AC16-699A114CA7E4"
                }
            ],
            "options": [],
            "decorations": [
                {
                    "area": "Default",
                    "width": 2538,
                    "height": 945,
                    "dpi": 300,
                    "method": null,
                    "price": null,
                    "printImage": null
                }
            ],
            "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
        }
    ]
}

Modified at 2026-05-27 12:49:07

View all products

Create a new product