Website logo

Remove a listing from your watchlist

Removes a listing from the authenticated user's watchlist.

Note: an auction that the user has bid on cannot be removed.

URL: https://api.trademe.co.nz/v1/mytrademe/WatchList/{listingId}.{file_format}
HTTP Method: DELETE
Requires Authentication? Yes
Permission Required: MyTradeMeWrite: Maintain your watchlist, answer questions and post comments.
Supported Formats: XML, JSON
Rate Limited? Yes

URL parameters

listingId Integer (required)

The ID of the listing to remove.

file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

Returns

<WatchListResponse>

Details on whether the operation succeeded. Attempting to remove an auction that doesn't exist or is not on the watchlist will not produce an error.

Success Boolean Success
Description String or null Description

Example XML Response (switch to JSON)

<WatchListResponse xmlns="http://api.trademe.co.nz/v1">
  <Success>false</Success>
  <Description>ABC</Description>
</WatchListResponse>

Example JSON Response (switch to XML)

{
  "Success": false,
  "Description": "ABC"
}