Skip to main content

List All Variants

Use this API to list all variants for a store in Zoho Commerce.

OAuthScope

ZohoCommerce.items.READ

 

HTTP Request

GET https://commerce.zoho.com/store/api/v1/variants

Query Parameters

ParameterValues
statusstring: active, inactive
item_typestring: ItemType.Inventory, ItemType.NonInventory
sort_columnstring: name, last_modified_time, actual_available_stock
sort_orderchar: A ,D
pageinteger: 1 to n
per_pageinteger: 10,25,50,100,200
variant_idslong: list of unique variant ids separated by comma to get specific variant details
limit: 50

 

Request Example

Copiedcurl -i -X GET \
   -H "Authorization:Zoho-oauthtoken ******" \
   -H "X-com-zoho-store-organizationid:687591958" \
 'https://commerce.zoho.com/store/api/v1/variants?sort_column=last_modified_time&sort_order=D&page=1&per_page=40&status=active&item_type=ItemType.Inventory'

Success Response

Copied{
    "code": 0,
    "message": "success",
    "variants": [
        {
            "variant_id": "1831511000001401129",
            "name": "The Way of Life-Book-Publisher-Product1-Book-Publisher-Product1-Book-Publishing Date",
            "product_name": "The Way of Life",
            "product_id": "1831511000001401127",
            "brand": "Book-Author",
            "category_id": "1831511000000068277",
            "purchase_rate": 0.00,
            "rate": 56.90,
            "label_rate": 69.90,
            "sku": "9780768442748",
            "minimum_order_quantity": 1.000000,
            "maximum_order_quantity": 10.000000,
            "reorder_level": 5.000000,
            "document_id": "",
            "document_name": "",
            "is_combo_product": false,
            "status": "active",
            "last_modified_time": "2021-08-23T01:03:37-0400",
            "stock_on_hand": 10.000000,
            "actual_available_stock": 10.000000,
            "available_stock": 10.000000,
            "available_sale_stock": 10.000000,
            "committed_stock": 0.000000,
            "track_serial_number": false,
            "track_batch_number": false
        },
        {.....},
        {.....},
        {.....},
         ............
    ],
    "page_context": {
        "page": 1,
        "per_page": 40,
        "has_more_page": true,
        "applied_filter": "Status.All",
        "sort_column": "last_modified_time",
        "sort_order": "D",
        "search_criteria": [
            {
                "column_name": "item_type",
                "search_text": "ItemType.Inventory",
                "search_text_formatted": "ItemType.Inventory",
                "comparator": "equal"
            },
            {
                "column_name": "status",
                "search_text": "active",
                "search_text_formatted": "active",
                "comparator": "equal"
            }
        ]
    }
}

Show full

Show less