Website logo

Relist an item

Relist an item that has expired. Relists an item without modifying editable fields.

Relist copies all data from original listing and applies them to the new listing. The only exceptions are where there are default durations that are applied on relisted items.

Some categories are currently unsupported (including subcategories): 98 (Livestock), 1349 (Horses).

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

URL parameters

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

POST Data

<RelistListingRequest>

ListingId Integer (required) ListingId
ReturnListingDetails Boolean (optional) ReturnListingDetails

Returns

<ListingResponse>

Success Boolean Success
Description String or null Description
ListingId Integer ListingId
Listing <ListedItemDetail> or null Listing
(This type is defined elsewhere)
ListingGroupId Integer or null ListingGroupId
Variants Collection of <Variant> or null Variants
(This type has already been defined)

Example XML Request (switch to JSON)

<RelistListingRequest xmlns="http://api.trademe.co.nz/v1">
  <ListingId>123</ListingId>
  <ReturnListingDetails>false</ReturnListingDetails>
</RelistListingRequest>

Example JSON Request (switch to XML)

{
  "ListingId": 123,
  "ReturnListingDetails": false
}

Example XML Response (switch to JSON)

<ListingResponse xmlns="http://api.trademe.co.nz/v1">
  <Success>false</Success>
  <Description>ABC</Description>
  <ListingId>123</ListingId>
  <Listing> ... </Listing>
  <ListingGroupId>123</ListingGroupId>
  <Variants>
    <Variant />
    <Variant />
  </Variants>
</ListingResponse>

Example JSON Response (switch to XML)

{
  "Success": false,
  "Description": "ABC",
  "ListingId": 123,
  "Listing": { ... },
  "ListingGroupId": 123,
  "Variants": [
    {
    },
    {
    }
  ]
}