API Documentation >> API 2.0 Main >> Wants List Management >> Wants List Items

Wants List Items

Allowed HTTP Methods

• GET - Returns the single specified wantslist with its details and items
• PUT - Either changes details (i.e. the name) of the specified wantslist or manages items on it (add, edit, delete)
• DELETE - Deletes the specified wantslist and all items on it

Resource Information

• Authentication - required
• Response Format - XML or JSON
• Response Object - WantsList, WantsListItem
• API Version - 2.0
• Resource URI - https://api.cardmarket.com/ws/v2.0/wantslist/:idWantslist

Parameters

• idWantslist
  • Wants list ID
  • Type: integer
  • Mandatory

Request Object

• Changing the name of the wantslist

<action>editWantslist</action>
<name />

• Adding an item to the wantslist (metaproduct)

<action>addItem</action>
<metaproduct>
    <idMetaproduct />
    <count />
    <minCondition />
    <wishPrice />
    <mailAlert />
    <idLanguage />      // optional
    <isFoil />          // optional
    <isAltered />       // optional
    <isPlayset />       // optional
    <isSigned />        // optional
    <isFirstEd />       // optional
</metaproduct>

• Adding an item to the wantslist (product)

<action>addItem</action>
<product>
    <idProduct />
    <count />
    <minCondition />
    <wishPrice />
    <mailAlert />
    <idLanguage />      // optional
    <isFoil />          // optional
    <isAltered />       // optional
    <isPlayset />       // optional
    <isSigned />        // optional
    <isFirstEd />       // optional
</product>

• Editing an item on the wantslist

<action>editItem</action>
<want>
    <idWant />
    <count />
    <minCondition />
    <wishPrice />
    <mailAlert />
    <idLanguage />
    <isFoil />
    <isAltered />
    <isPlayset />
    <isSigned />
    <isFirstEd />
</want>

Except idWant are all keys optional, if at least one is given. You only need to pass the values you want to edit.

• Deleting an item from the wantslist

<action>deleteItem</action>
<want>
    <idWant />
</want>

Example Request

• Changing the name of a wantslist:

PUT https://api.cardmarket.com/ws/v2.0/wantslist/584744

<?xml version="1.0" encoding="UTF-8" ?>
<request>
    <action>editWantslist</action>
    <name>Main MtG Wantslist 1 (internal)</name>
</request>

• Adding an item to a wantslist (one product and one metaproduct to show that more than one item can be added at the same time):

PUT https://api.cardmarket.com/ws/v2.0/wantslist/584744

<?xml version="1.0" encoding="UTF-8" ?>
<request>
    <action>addItem</action>
    <product>
        <idProduct>269126</idProduct>
        <count>4</count>
        <wishPrice>40.50</wishPrice>
        <minCondition>NM</minCondition>
        <mailAlert>true</mailAlert>
        <idLanguage>1</idLanguage>
        <idLanguage>3</idLanguage>
        <isPlayset>false</isPlayset>
    </product>
    <metaproduct>
        <idMetaproduct>2374</idMetaproduct>
        <count>2</count>
        <wishPrice>1.20</wishPrice>
        <minCondition>EX</minCondition>
        <mailAlert>false</mailAlert>
        <isFoil>true</isFoil>
        <isSigned>false</isSigned>
    </metaproduct>
</request>

• Editing an item on a wantslist:

PUT https://api.cardmarket.com/ws/v2.0/wantslist/584744

<?xml version="1.0" encoding="UTF-8" ?>
<request>
    <action>editItem</action>
    <want>
        <idWant>5762ac3ad9e31afc0700002a</idWant>
        <count>2</count>
        <wishPrice>15.00</wishPrice>
        <idLanguage />
    </want>
</request>

• Deleting an item from the wantslist:

PUT https://api.cardmarket.com/ws/v2.0/wantslist/584744

<?xml version="1.0" encoding="UTF-8" ?>
<request>
    <action>deleteItem</action>
    <want>
        <idWant>5762ac3ad9e31afc0700002a</idWant>
    </want>
    <want>
        <idWant>5762b9e1d9e31ae41700002a</idWant>
    </want>
</request>