/wantslist[/:idWantslist]

Allowed HTTP Methods

• GET - Returns all wants lists for the authenticated user
• GET (with idWantslist) - Returns all wants at a single wants list specified by its ID
• POST - Creates a new wants list for the authenticated user
• PUT - Adds, edits, or removes wants to, at, or from a wants list specified by its ID for the authenticated user
• DELETE - Deletes a wants list specified by its ID for the authenticated user

Resource Information

• Authentication - Required
• Request Object - Wantslist, Want
• Response Format - XML or JSON
• Response Object - Wantslist, Want
• API Version - 1.0
• Resource URI - https://api.cardmarket.com/ws/v1.1/wantslist[/:idWantslist]

Parameters

• idWantslist
  • Wants list ID
  • Type: integer
  • Mandatory/Optional depending on HTTP method and purpose

Request Object

Creating a Wants list:

<wantslist>
    <idGame />
    <name />
</wantslist>

Adding a product to a wants list:

<product>
    <idProduct />
    <count />
    <idLanguage />
    <minCondition />
    <wishPrice />
    <isFoil />
    <isAltered />
    <isPlayset />
    <isSigned />
    <isFirstEd />
</product>

Adding a metaproduct to a wants list:

<metaproduct>
    <idMetaproduct />
    <count />
    <idLanguage />
    <minCondition />
    <wishPrice />
    <isFoil />
    <isAltered />
    <isPlayset />
    <isSigned />
    <isFirstEd />
</metaproduct>

Editing a want at a wants list:

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

Example Request

1. Retrieving all user's wants lists:

GET https://api.cardmarket.com/ws/v1.1/wantslist

---

2. Retrieving a single user's wants list with all wants on it:

GET https://api.cardmarket.com/ws/v1.1/wantslist/211682

---

3. Creating a wants list:

POST https://api.cardmarket.com/ws/v1.1/wantslist

<?xml version="1.0" encoding="UTF-8" ?>
<request>
    <wantslist>
        <idGame>1</idGame>
        <name>Crazy Deck</name>
    </wantslist>
</request>

---

4. Adding wants to a wants list: PUT https://api.cardmarket.com/ws/v1.1/wantslist/211682

<?xml version="1.0" encoding="UTF-8" ?>
<request>
    <action>add</action>
    <product>
    	<idProduct>258288</idProduct>
        <count>2</count>
        <idLanguage>1</idLanguage>
        <idLanguage>3</idLanguage>
        <minCondition>NM</minCondition>
        <wishPrice>5.00</wishPrice>
    </product>
    <metaproduct>
    	<idMetaproduct>5395</idMetaproduct>
        <count>2</count>
        <minCondition>EX</minCondition>
        <wishPrice>0.90</wishPrice>
    </product>
</request>

---

5. Changing wants at a wants list:

PUT https://api.cardmarket.com/ws/v1.1/wantslist/211682

<?xml version="1.0" encoding="UTF-8" ?>
<request>
    <action>edit</action>
    <want>
    	<idWant>53d1143c63367bc8078b4b68</idWant>
        <count>2</count>
        <idLanguage>1</idLanguage>
        <idLanguage>2</idLanguage>
        <minCondition>NM</minCondition>
    </want>
</request>

---

6. Deleting a want from a wants list:

PUT https://api.cardmarket.com/ws/v1.1/wantslist/211682

<?xml version="1.0" encoding="UTF-8" ?>
<request>
    <action>remove</action>
    <want>
    	<idWant>53d1143c63367bc8078b4b68</idWant>
    </want>
</request>

---

7. Deleting a wants list:

DELETE https://api.cardmarket.com/ws/v1.1/wantslist/211682