Mix and Match: REST API Reference

REST API support requires Mix and Match Products 1.10.0

This is a advanced document is written for WooCommerce developers looking to extend or customize WooCommerce Mix and Match Products.

WooCommerce 2.6 added support for REST API endpoints based on the WordPress REST API infrastructure.

Mix and Match Products extends the /products/ and /orders/ endpoint responses with a new properties. mnm_child_items appears in both contexts.

• In product context, mnm_child_itemslists the products that are available as part of a Mix and Match container product.
• In order context, mnm_child_itemsis applicable to the Mix and Match container line item and lists the order item IDs of the line item products that were selected as part of the Mix and Match container product. The mnm_child_of property is applicable to child order items and references the order item ID of their parent.

Product properties only applicable only for Mix and Match type products.

The properties of each array in the mnm_child_items response.

Creating a Mix and Match Product from products

curl -X POST https://example.com/wp-json/wc/v3/products \
    -u consumer_key:consumer_secret \
    -H "Content-Type: application/json" \
    -d '{
    "name": "Sample Six Pack",
    "type": "mix-and-match",
    "regular_price": "0",
    "short_description": "Pick 6.",
    "mnm_layout": "grid",
    "mnm_form_location": "after_summary",
    "mnm_min_container_size": 6,
    "mnm_max_container_size": 6,
    "mnm_discount": "25",
    "mnm_priced_per_product": true,
    "mnm_packing_mode": "together",
    "mnm_content_source": "products"
    "mnm_child_items": [
        { 
            "product_id": 7
        },
        { 
            "product_id": 9
        },
        { 
            "product_id": 14
        },
        { 
            "product_id": 16
        },
        { 
            "product_id": 17
        },
        { 
            "product_id": 10,
            "variation_id": 12
        }
    ]
}'

Adding a Child Product

curl -X POST https://example.com/wp-json/wc/v3/products/1351 \
    -u consumer_key:consumer_secret \
    -H "Content-Type: application/json" \
    -d '{
    "mnm_child_items": [
        { 
            "product_id": 1281
        }
    ]
}'

Deleting a Child Product

curl -X POST https://example.com/wp-json/wc/v3/products/1351 \
    -u consumer_key:consumer_secret \
    -H "Content-Type: application/json" \
    -d '{
    "mnm_child_items": [
        { 
            "child_item_id": 9,
            "delete": true
        }
    ]
}'

Creating a Mix and Match Product from categories

curl -X POST https://example.com/wp-json/wc/v3/products \
    -u consumer_key:consumer_secret \
    -H "Content-Type: application/json" \
    -d '{
    "name": "Sample Six Pack by Category",
    "type": "mix-and-match",
    "regular_price": "99",
    "description": "So many products to choose from.",
    "mnm_min_container_size": 6,
    "mnm_max_container_size": 6,
    "mnm_content_source": "categories"
    "mnm_child_category_ids": [ 53, 54 ]
}'

Note: Individual products cannot be added or deleted when the allowed contents are pulled from categories.

The following extensions have known compatibility issues with Name Your Price. This list is not exhaustive. Other extensions and third-party plugins may cause issues to Name Your Price, or not work as expected with it.

Adding a Mix and Match container to order

curl -X POST https://example.com/wp-json/wc/v3/orders/199 \
    -u consumer_key:consumer_secret \
    -H "Content-Type: application/json" \
    -d '{
    "line_items": [
        {
            "product_id": 1351,
            "quantity": 1,
            "mnm_configuration": [
                {
                    "product_id": 17,
                    "quantity": 3
                },
                {
                    "product_id": 10,
                    "variation_id": 12,
                    "quantity": 3
                }
            ]
        }
    ]
}'