Ungroup Product Variants

Ungroup a set of grouped Product Variants  (Delete Variant Group Request)

This API is used to disassociate the provided SellerPartNumber from its current variant group. Once executed, all products within the same group as the specified item will be ungrouped. After ungrouping, each item in the original group becomes an independent (standalone) product with no variant linkage.

 

Resource URL

Newegg.com: https://api.newegg.com /marketplace/contentmgmt/item /ungroup-product-variants?sellerid={sellerid}
Newegg.ca: https://api.newegg.com /marketplace/can/contentmgmt/item /ungroup-product-variants?sellerid={sellerid}

Note: Please make sure your request URL is all in lower case (except for Seller ID) and cannot contain any blank spaces or line breaks.

 

Parameters

Name	Required?	Description
sellerid	Yes	Your seller ID on Newegg Marketplace

 

Resource Information

HTTP Method	Authentication?	Request Formats	Response Formats	Rate Limited?
PUT	Required	XML, Json	XML, Json	10,000 request per hour

 

Request Body

Attribute	Required?	Format	Description
SellerPartNumber	Yes	String	Unique identifier for the variant.

 

Schema: DeleteVariantGroupRequest.xsd

 

Example: XML, Request

<DeleteVariantGroupRequest>
    <SellerPartNumber>as_20250520_0937</SellerPartNumber>
</DeleteVariantGroupRequest>

Example: Json, Request
{
    "SellerPartNumber": "as_20250520_0939"
}

 

Response Body

Attribute	Format	Description
ItemGroupID	Int	The unique identifier for the created or updated product variant group.
ItemVariantGroupStatusList	List<ItemVariantStatus>	An empty array is returned if the unbinding is successful, indicating that the current group no longer has any variant products.
IsSuccess	boolean	Overall result of the group creation/update operation. true = success.

 

Example: XML, Response

<?xml version="1.0" encoding="utf-16"?>
<VariantGroupResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <ItemGroupID>2110011070</ItemGroupID>
    <ItemVariantGroupStatusList />
    <IsSuccess>true</IsSuccess>
</VariantGroupResponse>

Example: JSON, Response

{
    "ItemGroupID": 2110011080,
    "ItemVariantGroupStatusList": [],
    "IsSuccess": true
}

 

Request Failure Errors

For common HTTP error responses, please refer to Failed Response Error Code List.

Error Code	Description
CE003	Validation failed: SellerPartNumber cannot be empty.
CE027	System Error, please try again. If problem persists, please contact Marketplace Support.

 

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Mkpl.Sdk.Core.Api.Entity">
    <Error>
        <Code>CE003</Code>
        <Message>Validation failed: SellerPartNumber cannot be empty.</Message>
    </Error>
</Errors>

Example: JSON, Response

[
    {
        "Code": "CE003",
        "Message": "Validation failed: SellerPartNumber cannot be empty."
    }
]