[Notice] Mandatory Purchase Option Entry and API Specification Changes (Effective Feb 2, 2026)

Hello, this is Coupang.

In accordance with existing product information policies, the attributes requested by Coupang are mandatory requirements for sellers. To provide customers with a better shopping experience, we plan to strengthen our monitoring of whether the mandatory purchase options required for specific categories have been provided for both new and existing listings.

Please review the technical details below carefully, as missing mandatory purchase options may result in restricted product exposure or listing failure via API.

Please note that the updates mentioned in this article apply only to the Korean market and do not affect sellers in Taiwan.

1. Policy Overview

• Effective Date: Sequentially from February 2, 2026
• Applicable Categories: Certain consumer goods categories (Please refer to the [Attached File] for the full list. Categories may be expanded in the future.)
• Key Enforcement:
  • Product exposure restriction: Existing products missing mandatory options will be marked as "Exposure restricted."
  • Product listing failure: New listing requests via API will fail if required purchase options are missing.

2. API Specific Changes

1）Product Creation

The API will now provide a more detailed response to help identify missing or invalid mandatory attributes.

• Update in Response Spec: Enhanced details and errorItems to specify "Mandatory purchase option (registration/exposure restrictions if not entered) does not exist."
• Response Example (ERROR):

{
    "code": "ERROR",
    "message": "[]. Invalid purchase option values or units exist.",
    "details": "... Please enter the Mandatory Purchase Option (registration/exposure restrictions if not entered): 'Total Quantity'. For details, check 'errorItems' below or refer to the Category Metadata API.",
    "errorItems": [
        {
            "itemIndex": 0,
            "itemName": "190ml 30pk",
            "itemAttributes": [
                {
                    "attributeTypeName": "Total Quantity",
                    "attributeValueName": null,
                    "message": "Mandatory purchase option (registration/exposure restrictions if not entered) does not exist."
                }
            ]
        }
    ]
}

2）Modify Product

The modification logic now helps you handle "Open Attributes" and incorporates validation checks for any invalid or incorrect attribute values.

• Managing Open Attributes:
  • Deleting Open Attributes: You can now delete open attributes from product options by simply omitting the attribute's entire element from the attributes array in the payload.
  • Identifying Open Attributes: To identify these, call the Category Metadata Query API; if the attributeTypeName does not exist in the response, it is an open attribute.
• Updated Error Specifications
  • Invalid Attribute Value(s)
  • Incorrect attributeValueName

3）Product List Paging Query

New parameters have been added to help identify products that require updates in Mandatory Purchase Options 

• New Query String Parameters:
  • violationTypes (String List): Filters products by violation type. Currently supported values: ['NO_VA_V2', 'MOTA_V2', 'ATTR'].
    • NO_VA_V2:  Products needed to be verified (suppressed) 
    • MOTA_V2: Products missing mandatory option values (suppressed) 
    • ATTR: Products with invalid attributes (low impression)
  • violationTypeAndOr (String): Logical operator for filtering with above violationTypes. Optional values: ['AND', 'OR'].

• Sample Request: GET /api/v1/marketplace/seller-products?vendorId={vendorId}&violationTypes=ATTR&violationTypes=MOTA_V2&violationTypeAndOr=OR

   

3. Required Actions for Developers

1. Handle Error Specs: Update your system to parse the detailed errorItems in the Product Creation API so sellers can see which specific attributes are missing.
2. Audit Existing Products: Use the updated Product List Paging Query API with violationTypes “MOTA_V2” to identify products that are currently "Exposure Restricted." due to missing Mandatory Purchase Options.
3. Update Information: Use the Modify Product API to enter valid mandatory purchase options to resolve exposure restrictions. Once updated, the status will change to “Under Review” and will be displayed normally after approval.

Accurate product information is key to boosting customer purchase conversions. Your cooperation would be much appreciated.

Your success is our success. Thank you.