Website logo

Get a list of draft listings

Get all saved draft listings for member

URL: https://api.trademe.co.nz/v1/Selling/Drafts.{file_format}
HTTP Method: GET
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.

Returns

<DraftListingResponse>

Success Boolean Success
StatusCode Enumeration StatusCode
Success 0 Success
MaxLimitExceeded 1 MaxLimitExceeded
Drafts Collection of <Draft> or null Drafts
DraftId Integer DraftId
Name String or null Name
Note String or null Note
Listing <ListingRequest> or null Listing

Example XML Response (switch to JSON)

<DraftListingResponse xmlns="http://api.trademe.co.nz/v1">
  <Success>false</Success>
  <StatusCode>Success</StatusCode>
  <Drafts>
    <Draft>
      <DraftId>123</DraftId>
      <Name>ABC</Name>
      <Note>ABC</Note>
      <Listing />
    </Draft>
    <Draft>
      <DraftId>123</DraftId>
      <Name>ABC</Name>
      <Note>ABC</Note>
      <Listing />
    </Draft>
  </Drafts>
</DraftListingResponse>

Example JSON Response (switch to XML)

{
  "Success": false,
  "StatusCode": 0,
  "Drafts": [
    {
      "DraftId": 123,
      "Name": "ABC",
      "Note": "ABC",
      "Listing": {
      }
    },
    {
      "DraftId": 123,
      "Name": "ABC",
      "Note": "ABC",
      "Listing": {
      }
    }
  ]
}