Retrieve your won items

Retrieves a list of purchases for the authenticated user. Multiple-quantity auctions can be purchased multiple times.

URL:	https://api.trademe.co.nz/v1/mytrademe/won/{filter}.{file_format}
HTTP Method:	GET
Requires Authentication?	Yes
Permission Required:	MyTradeMeRead: Read your membership & listing data.
Supported Formats:	XML, JSON
Rate Limited?	Yes

URL parameters

filter

String (required)

A filter on the results.

All	Return all won items in the last 45 days.
Last30Days	Returns items won in the last 30 days.
Last7Days	Returns items won in the last 7 days.
Last24Hours	Returns items won in the last 24 hours.

file_format

Enumeration (required)

The format of the response.

xml	Serialize responses into XML.
json	Serialize responses into JSON.

Query String parameters

page

Integer (optional)

The page number of the set of results to return, starting from 1. Defaults to 1.

photo_size

Enumeration (optional)

The size of the images to return in the results. Defaults to Thumbnail.

Thumbnail	Thumbnail
List	List
Medium	Medium
Gallery	Gallery
Large	Large
FullSize	FullSize
JobSearchCard	JobSearchCard

rows

Integer (optional)

The number of results per page; also the maximum number of results to return. Defaults to 50.

Returns

A list of items the authenticated user has purchased.

TotalCount

Integer

TotalCount

Page

Integer

Page

PageSize

Integer

PageSize

List

Collection of <WonItem> or null

InnerList

ListingId

Integer

ListingId

Title

String or null

Title

Example XML Response (switch to JSON)

<WonItems xmlns="http://api.trademe.co.nz/v1">
  <TotalCount>123</TotalCount>
  <Page>123</Page>
  <PageSize>123</PageSize>
  <List>
    <WonItem>
      <ListingId>123</ListingId>
      <Title>ABC</Title>
      <Category>ABC</Category>
      <StartPrice>123.0</StartPrice>
      <StartDate>2018-01-01T00:00:00Z</StartDate>
      <EndDate>2018-01-01T00:00:00Z</EndDate>
      <AsAt>2018-01-01T00:00:00Z</AsAt>
      <CategoryPath>ABC</CategoryPath>
      <PictureHref>ABC</PictureHref>
      <PhotoId>123</PhotoId>
      <Seller>
        <MemberId>123</MemberId>
        <Nickname>ABC</Nickname>
        <DateAddressVerified>2018-01-01T00:00:00Z</DateAddressVerified>
        <DateJoined>2018-01-01T00:00:00Z</DateJoined>
        <Email>ABC</Email>
        <UniqueNegative>123</UniqueNegative>
        <UniquePositive>123</UniquePositive>
        <FeedbackCount>123</FeedbackCount>
        <IsAddressVerified>false</IsAddressVerified>
        <IsDealer>false</IsDealer>
      </Seller>
      <HasPayNow>false</HasPayNow>
      <IsNew>false</IsNew>
      <BidCount>123</BidCount>
      <IsReserveMet>false</IsReserveMet>
      <HasReserve>false</HasReserve>
      <HasBuyNow>false</HasBuyNow>
      <Note>ABC</Note>
      <NoteId>123</NoteId>
      <NoteDate>2018-01-01T00:00:00Z</NoteDate>
      <CategoryName>ABC</CategoryName>
      <ReserveState>None</ReserveState>
      <IsClassified>false</IsClassified>
      <RelistedItemId>123</RelistedItemId>
      <Subtitle>ABC</Subtitle>
      <IsBuyNowOnly>false</IsBuyNowOnly>
      <Quantity>123</Quantity>
      <IsFlatShippingCharge>false</IsFlatShippingCharge>
      <RemainingGalleryPlusRelists>123</RemainingGalleryPlusRelists>
      <IsClearance>false</IsClearance>
      <WasPrice>123.0</WasPrice>
      <PercentageOff>123</PercentageOff>
      <Options>
        <Option />
        <Option />
      </Options>
      <ListingGroupId>123</ListingGroupId>
      <HasPing>false</HasPing>
      <StatusDate>2018-01-01T00:00:00Z</StatusDate>
      <AuctionAttribute>ABC</AuctionAttribute>
      <BuyerFeedbackPlaced>123</BuyerFeedbackPlaced>
      <SellerFeedbackPlaced>123</SellerFeedbackPlaced>
      <DeliveryId>123</DeliveryId>
      <FpoDecisionViaMobile>false</FpoDecisionViaMobile>
      <HasPaidByCreditCard>false</HasPaidByCreditCard>
      <InvoiceId>123</InvoiceId>
      <OfferId>123</OfferId>
      <PaymentInfo>ABC</PaymentInfo>
      <Price>123.0</Price>
      <SelectedShipping>ABC</SelectedShipping>
      <ShippingPrice>123.0</ShippingPrice>
      <ShippingType>None</ShippingType>
      <SoldDate>2018-01-01T00:00:00Z</SoldDate>
      <SoldType>ABC</SoldType>
      <PaymentInstructions>ABC</PaymentInstructions>
      <PurchaseId>123</PurchaseId>
      <ReferenceNumber>ABC</ReferenceNumber>
      <SubtotalPrice>123.0</SubtotalPrice>
      <TotalShippingPrice>123.0</TotalShippingPrice>
      <TotalSalePrice>123.0</TotalSalePrice>
      <CreditCardLastFourDigits>ABC</CreditCardLastFourDigits>
      <OrderId>123</OrderId>
      <TrackedParcels>
        <TrackedParcel>
          <CourierParcelId>123</CourierParcelId>
          <CourierCompanyName>ABC</CourierCompanyName>
          <TrackingReference>ABC</TrackingReference>
          <TrackingUrl>ABC</TrackingUrl>
          <Status>Unknown</Status>
          <DateAdded>2018-01-01T00:00:00Z</DateAdded>
        </TrackedParcel>
        <TrackedParcel>
          <CourierParcelId>123</CourierParcelId>
          <CourierCompanyName>ABC</CourierCompanyName>
          <TrackingReference>ABC</TrackingReference>
          <TrackingUrl>ABC</TrackingUrl>
          <Status>Unknown</Status>
          <DateAdded>2018-01-01T00:00:00Z</DateAdded>
        </TrackedParcel>
      </TrackedParcels>
      <TaxSubTotal>123.0</TaxSubTotal>
      <HasPaidByDeferredPayment>false</HasPaidByDeferredPayment>
    </WonItem>
    <WonItem>
      <ListingId>123</ListingId>
      <Title>ABC</Title>
      <Category>ABC</Category>
      <StartPrice>123.0</StartPrice>
      <StartDate>2018-01-01T00:00:00Z</StartDate>
      <EndDate>2018-01-01T00:00:00Z</EndDate>
      <AsAt>2018-01-01T00:00:00Z</AsAt>
      <CategoryPath>ABC</CategoryPath>
      <PictureHref>ABC</PictureHref>
      <PhotoId>123</PhotoId>
      <Seller>
        <MemberId>123</MemberId>
        <Nickname>ABC</Nickname>
        <DateAddressVerified>2018-01-01T00:00:00Z</DateAddressVerified>
        <DateJoined>2018-01-01T00:00:00Z</DateJoined>
        <Email>ABC</Email>
        <UniqueNegative>123</UniqueNegative>
        <UniquePositive>123</UniquePositive>
        <FeedbackCount>123</FeedbackCount>
        <IsAddressVerified>false</IsAddressVerified>
        <IsDealer>false</IsDealer>
      </Seller>
      <HasPayNow>false</HasPayNow>
      <IsNew>false</IsNew>
      <BidCount>123</BidCount>
      <IsReserveMet>false</IsReserveMet>
      <HasReserve>false</HasReserve>
      <HasBuyNow>false</HasBuyNow>
      <Note>ABC</Note>
      <NoteId>123</NoteId>
      <NoteDate>2018-01-01T00:00:00Z</NoteDate>
      <CategoryName>ABC</CategoryName>
      <ReserveState>None</ReserveState>
      <IsClassified>false</IsClassified>
      <RelistedItemId>123</RelistedItemId>
      <Subtitle>ABC</Subtitle>
      <IsBuyNowOnly>false</IsBuyNowOnly>
      <Quantity>123</Quantity>
      <IsFlatShippingCharge>false</IsFlatShippingCharge>
      <RemainingGalleryPlusRelists>123</RemainingGalleryPlusRelists>
      <IsClearance>false</IsClearance>
      <WasPrice>123.0</WasPrice>
      <PercentageOff>123</PercentageOff>
      <Options>
        <Option />
        <Option />
      </Options>
      <ListingGroupId>123</ListingGroupId>
      <HasPing>false</HasPing>
      <StatusDate>2018-01-01T00:00:00Z</StatusDate>
      <AuctionAttribute>ABC</AuctionAttribute>
      <BuyerFeedbackPlaced>123</BuyerFeedbackPlaced>
      <SellerFeedbackPlaced>123</SellerFeedbackPlaced>
      <DeliveryId>123</DeliveryId>
      <FpoDecisionViaMobile>false</FpoDecisionViaMobile>
      <HasPaidByCreditCard>false</HasPaidByCreditCard>
      <InvoiceId>123</InvoiceId>
      <OfferId>123</OfferId>
      <PaymentInfo>ABC</PaymentInfo>
      <Price>123.0</Price>
      <SelectedShipping>ABC</SelectedShipping>
      <ShippingPrice>123.0</ShippingPrice>
      <ShippingType>None</ShippingType>
      <SoldDate>2018-01-01T00:00:00Z</SoldDate>
      <SoldType>ABC</SoldType>
      <PaymentInstructions>ABC</PaymentInstructions>
      <PurchaseId>123</PurchaseId>
      <ReferenceNumber>ABC</ReferenceNumber>
      <SubtotalPrice>123.0</SubtotalPrice>
      <TotalShippingPrice>123.0</TotalShippingPrice>
      <TotalSalePrice>123.0</TotalSalePrice>
      <CreditCardLastFourDigits>ABC</CreditCardLastFourDigits>
      <OrderId>123</OrderId>
      <TrackedParcels>
        <TrackedParcel>
          <CourierParcelId>123</CourierParcelId>
          <CourierCompanyName>ABC</CourierCompanyName>
          <TrackingReference>ABC</TrackingReference>
          <TrackingUrl>ABC</TrackingUrl>
          <Status>Unknown</Status>
          <DateAdded>2018-01-01T00:00:00Z</DateAdded>
        </TrackedParcel>
        <TrackedParcel>
          <CourierParcelId>123</CourierParcelId>
          <CourierCompanyName>ABC</CourierCompanyName>
          <TrackingReference>ABC</TrackingReference>
          <TrackingUrl>ABC</TrackingUrl>
          <Status>Unknown</Status>
          <DateAdded>2018-01-01T00:00:00Z</DateAdded>
        </TrackedParcel>
      </TrackedParcels>
      <TaxSubTotal>123.0</TaxSubTotal>
      <HasPaidByDeferredPayment>false</HasPaidByDeferredPayment>
    </WonItem>
  </List>
</WonItems>

Example JSON Response (switch to XML)

{
  "TotalCount": 123,
  "Page": 123,
  "PageSize": 123,
  "List": [
    {
      "ListingId": 123,
      "Title": "ABC",
      "Category": "ABC",
      "StartPrice": 123.0,
      "StartDate": "\/Date(1514764800)\/",
      "EndDate": "\/Date(1514764800)\/",
      "AsAt": "\/Date(1514764800)\/",
      "CategoryPath": "ABC",
      "PictureHref": "ABC",
      "PhotoId": 123,
      "Seller": {
        "MemberId": 123,
        "Nickname": "ABC",
        "DateAddressVerified": "\/Date(1514764800)\/",
        "DateJoined": "\/Date(1514764800)\/",
        "Email": "ABC",
        "UniqueNegative": 123,
        "UniquePositive": 123,
        "FeedbackCount": 123,
        "IsAddressVerified": false,
        "IsDealer": false
      },
      "HasPayNow": false,
      "IsNew": false,
      "BidCount": 123,
      "IsReserveMet": false,
      "HasReserve": false,
      "HasBuyNow": false,
      "Note": "ABC",
      "NoteId": 123,
      "NoteDate": "\/Date(1514764800)\/",
      "CategoryName": "ABC",
      "ReserveState": 0,
      "IsClassified": false,
      "RelistedItemId": 123,
      "Subtitle": "ABC",
      "IsBuyNowOnly": false,
      "Quantity": 123,
      "IsFlatShippingCharge": false,
      "RemainingGalleryPlusRelists": 123,
      "IsClearance": false,
      "WasPrice": 123.0,
      "PercentageOff": 123,
      "Options": [
        {
        },
        {
        }
      ],
      "ListingGroupId": 123,
      "HasPing": false,
      "StatusDate": "\/Date(1514764800)\/",
      "AuctionAttribute": "ABC",
      "BuyerFeedbackPlaced": 123,
      "SellerFeedbackPlaced": 123,
      "DeliveryId": 123,
      "FpoDecisionViaMobile": false,
      "HasPaidByCreditCard": false,
      "InvoiceId": 123,
      "OfferId": 123,
      "PaymentInfo": "ABC",
      "Price": 123.0,
      "SelectedShipping": "ABC",
      "ShippingPrice": 123.0,
      "ShippingType": 0,
      "SoldDate": "\/Date(1514764800)\/",
      "SoldType": "ABC",
      "PaymentInstructions": "ABC",
      "PurchaseId": 123,
      "ReferenceNumber": "ABC",
      "SubtotalPrice": 123.0,
      "TotalShippingPrice": 123.0,
      "TotalSalePrice": 123.0,
      "CreditCardLastFourDigits": "ABC",
      "OrderId": 123,
      "TrackedParcels": [
        {
          "CourierParcelId": 123,
          "CourierCompanyName": "ABC",
          "TrackingReference": "ABC",
          "TrackingUrl": "ABC",
          "Status": 0,
          "DateAdded": "\/Date(1514764800)\/"
        },
        {
          "CourierParcelId": 123,
          "CourierCompanyName": "ABC",
          "TrackingReference": "ABC",
          "TrackingUrl": "ABC",
          "Status": 0,
          "DateAdded": "\/Date(1514764800)\/"
        }
      ],
      "TaxSubTotal": 123.0,
      "HasPaidByDeferredPayment": false
    },
    {
      "ListingId": 123,
      "Title": "ABC",
      "Category": "ABC",
      "StartPrice": 123.0,
      "StartDate": "\/Date(1514764800)\/",
      "EndDate": "\/Date(1514764800)\/",
      "AsAt": "\/Date(1514764800)\/",
      "CategoryPath": "ABC",
      "PictureHref": "ABC",
      "PhotoId": 123,
      "Seller": {
        "MemberId": 123,
        "Nickname": "ABC",
        "DateAddressVerified": "\/Date(1514764800)\/",
        "DateJoined": "\/Date(1514764800)\/",
        "Email": "ABC",
        "UniqueNegative": 123,
        "UniquePositive": 123,
        "FeedbackCount": 123,
        "IsAddressVerified": false,
        "IsDealer": false
      },
      "HasPayNow": false,
      "IsNew": false,
      "BidCount": 123,
      "IsReserveMet": false,
      "HasReserve": false,
      "HasBuyNow": false,
      "Note": "ABC",
      "NoteId": 123,
      "NoteDate": "\/Date(1514764800)\/",
      "CategoryName": "ABC",
      "ReserveState": 0,
      "IsClassified": false,
      "RelistedItemId": 123,
      "Subtitle": "ABC",
      "IsBuyNowOnly": false,
      "Quantity": 123,
      "IsFlatShippingCharge": false,
      "RemainingGalleryPlusRelists": 123,
      "IsClearance": false,
      "WasPrice": 123.0,
      "PercentageOff": 123,
      "Options": [
        {
        },
        {
        }
      ],
      "ListingGroupId": 123,
      "HasPing": false,
      "StatusDate": "\/Date(1514764800)\/",
      "AuctionAttribute": "ABC",
      "BuyerFeedbackPlaced": 123,
      "SellerFeedbackPlaced": 123,
      "DeliveryId": 123,
      "FpoDecisionViaMobile": false,
      "HasPaidByCreditCard": false,
      "InvoiceId": 123,
      "OfferId": 123,
      "PaymentInfo": "ABC",
      "Price": 123.0,
      "SelectedShipping": "ABC",
      "ShippingPrice": 123.0,
      "ShippingType": 0,
      "SoldDate": "\/Date(1514764800)\/",
      "SoldType": "ABC",
      "PaymentInstructions": "ABC",
      "PurchaseId": 123,
      "ReferenceNumber": "ABC",
      "SubtotalPrice": 123.0,
      "TotalShippingPrice": 123.0,
      "TotalSalePrice": 123.0,
      "CreditCardLastFourDigits": "ABC",
      "OrderId": 123,
      "TrackedParcels": [
        {
          "CourierParcelId": 123,
          "CourierCompanyName": "ABC",
          "TrackingReference": "ABC",
          "TrackingUrl": "ABC",
          "Status": 0,
          "DateAdded": "\/Date(1514764800)\/"
        },
        {
          "CourierParcelId": 123,
          "CourierCompanyName": "ABC",
          "TrackingReference": "ABC",
          "TrackingUrl": "ABC",
          "Status": 0,
          "DateAdded": "\/Date(1514764800)\/"
        }
      ],
      "TaxSubTotal": 123.0,
      "HasPaidByDeferredPayment": false
    }
  ]
}