Website logo

Retrieve your lost items

Retrieves listings the authenticated user lost. A listing counts as "lost" if it is on the user's watchlist when it closes.

URL: https://api.trademe.co.nz/v1/mytrademe/lost/{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.

AllReturn all lost items.
Last7DaysReturns items lost in the last 7 days.
Last24HoursReturns items lost 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

exclude_fpo Boolean (optional)

If true, excludes listings with active fixed price offers.
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

<LostItems>

FullListedItemCollection for the authenticated user.

TotalCount Integer TotalCount
Page Integer Page
PageSize Integer PageSize
List Collection of <LostItem> or null InnerList
ListingId Integer ListingId
Title String or null Title
Category String or null Category
StartPrice Number StartPrice
BuyNowPrice Number BuyNowPrice
StartDate DateTime StartDate
EndDate DateTime EndDate
MaxBidAmount Number MaxBidAmount
AsAt DateTime AsAt
CategoryPath String or null CategoryPath
PictureHref String or null PictureHref
PhotoId Integer PhotoId
HasPayNow Boolean HasPayNow
IsNew Boolean IsNew
BidCount Integer BidCount
IsReserveMet Boolean IsReserveMet
HasReserve Boolean HasReserve
HasBuyNow Boolean HasBuyNow
Note String or null Note
NoteId Integer NoteId
NoteDate DateTime NoteDate
CategoryName String or null CategoryName
ReserveState Enumeration ReserveState
None 0 None
Met 1 Met
NotMet 2 NotMet
NotApplicable 3 NotApplicable
Attributes Collection of <Attribute> or null Attributes
Name String or null Name
DisplayName String or null DisplayName
Value String or null Value
IsClassified Boolean IsClassified
RelistedItemId Integer RelistedItemId
Subtitle String or null Subtitle
IsBuyNowOnly Boolean IsBuyNowOnly
RemainingGalleryPlusRelists Integer or null RemainingGalleryPlusRelists
PriceDisplay String or null PriceDisplay
CanRequestRelist Boolean CanRequestRelist
CanRequestOffer Boolean CanRequestOffer
IsClearance Boolean IsClearance
WasPrice Number or null WasPrice
PercentageOff Integer or null PercentageOff
Options Collection of <Option> or null Options
(This type has already been defined)
ListingGroupId Integer or null ListingGroupId
IsWithdrawn Boolean IsWithdrawn
HasRelistBeenRequested Boolean HasRelistBeenRequested
HasOfferBeenRequested Boolean HasOfferBeenRequested
OfferStatus Enumeration OfferStatus
None 0 None
Active 1 Active
Withdrawn 2 Withdrawn
Expired 3 Expired
Declined 4 Declined
Accepted 5 Accepted
IsSold Boolean IsSold

Example XML Response (switch to JSON) 

<LostItems xmlns="http://api.trademe.co.nz/v1">
  <TotalCount>123</TotalCount>
  <Page>123</Page>
  <PageSize>123</PageSize>
  <List>
    <LostItem>
      <ListingId>123</ListingId>
      <Title>ABC</Title>
      <Category>ABC</Category>
      <StartPrice>123.0</StartPrice>
      <BuyNowPrice>123.0</BuyNowPrice>
      <StartDate>2018-01-01T00:00:00Z</StartDate>
      <EndDate>2018-01-01T00:00:00Z</EndDate>
      <MaxBidAmount>123.0</MaxBidAmount>
      <AsAt>2018-01-01T00:00:00Z</AsAt>
      <CategoryPath>ABC</CategoryPath>
      <PictureHref>ABC</PictureHref>
      <PhotoId>123</PhotoId>
      <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>
      <Attributes>
        <Attribute>
          <Name>ABC</Name>
          <DisplayName>ABC</DisplayName>
          <Value>ABC</Value>
        </Attribute>
        <Attribute>
          <Name>ABC</Name>
          <DisplayName>ABC</DisplayName>
          <Value>ABC</Value>
        </Attribute>
      </Attributes>
      <IsClassified>false</IsClassified>
      <RelistedItemId>123</RelistedItemId>
      <Subtitle>ABC</Subtitle>
      <IsBuyNowOnly>false</IsBuyNowOnly>
      <RemainingGalleryPlusRelists>123</RemainingGalleryPlusRelists>
      <PriceDisplay>ABC</PriceDisplay>
      <CanRequestRelist>false</CanRequestRelist>
      <CanRequestOffer>false</CanRequestOffer>
      <IsClearance>false</IsClearance>
      <WasPrice>123.0</WasPrice>
      <PercentageOff>123</PercentageOff>
      <Options>
        <Option />
        <Option />
      </Options>
      <ListingGroupId>123</ListingGroupId>
      <IsWithdrawn>false</IsWithdrawn>
      <HasRelistBeenRequested>false</HasRelistBeenRequested>
      <HasOfferBeenRequested>false</HasOfferBeenRequested>
      <OfferStatus>None</OfferStatus>
      <IsSold>false</IsSold>
    </LostItem>
    <LostItem>
      <ListingId>123</ListingId>
      <Title>ABC</Title>
      <Category>ABC</Category>
      <StartPrice>123.0</StartPrice>
      <BuyNowPrice>123.0</BuyNowPrice>
      <StartDate>2018-01-01T00:00:00Z</StartDate>
      <EndDate>2018-01-01T00:00:00Z</EndDate>
      <MaxBidAmount>123.0</MaxBidAmount>
      <AsAt>2018-01-01T00:00:00Z</AsAt>
      <CategoryPath>ABC</CategoryPath>
      <PictureHref>ABC</PictureHref>
      <PhotoId>123</PhotoId>
      <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>
      <Attributes>
        <Attribute>
          <Name>ABC</Name>
          <DisplayName>ABC</DisplayName>
          <Value>ABC</Value>
        </Attribute>
        <Attribute>
          <Name>ABC</Name>
          <DisplayName>ABC</DisplayName>
          <Value>ABC</Value>
        </Attribute>
      </Attributes>
      <IsClassified>false</IsClassified>
      <RelistedItemId>123</RelistedItemId>
      <Subtitle>ABC</Subtitle>
      <IsBuyNowOnly>false</IsBuyNowOnly>
      <RemainingGalleryPlusRelists>123</RemainingGalleryPlusRelists>
      <PriceDisplay>ABC</PriceDisplay>
      <CanRequestRelist>false</CanRequestRelist>
      <CanRequestOffer>false</CanRequestOffer>
      <IsClearance>false</IsClearance>
      <WasPrice>123.0</WasPrice>
      <PercentageOff>123</PercentageOff>
      <Options>
        <Option />
        <Option />
      </Options>
      <ListingGroupId>123</ListingGroupId>
      <IsWithdrawn>false</IsWithdrawn>
      <HasRelistBeenRequested>false</HasRelistBeenRequested>
      <HasOfferBeenRequested>false</HasOfferBeenRequested>
      <OfferStatus>None</OfferStatus>
      <IsSold>false</IsSold>
    </LostItem>
  </List>
</LostItems>

Example JSON Response (switch to XML) 

{
  "TotalCount": 123,
  "Page": 123,
  "PageSize": 123,
  "List": [
    {
      "ListingId": 123,
      "Title": "ABC",
      "Category": "ABC",
      "StartPrice": 123.0,
      "BuyNowPrice": 123.0,
      "StartDate": "\/Date(1514764800)\/",
      "EndDate": "\/Date(1514764800)\/",
      "MaxBidAmount": 123.0,
      "AsAt": "\/Date(1514764800)\/",
      "CategoryPath": "ABC",
      "PictureHref": "ABC",
      "PhotoId": 123,
      "HasPayNow": false,
      "IsNew": false,
      "BidCount": 123,
      "IsReserveMet": false,
      "HasReserve": false,
      "HasBuyNow": false,
      "Note": "ABC",
      "NoteId": 123,
      "NoteDate": "\/Date(1514764800)\/",
      "CategoryName": "ABC",
      "ReserveState": 0,
      "Attributes": [
        {
          "Name": "ABC",
          "DisplayName": "ABC",
          "Value": "ABC"
        },
        {
          "Name": "ABC",
          "DisplayName": "ABC",
          "Value": "ABC"
        }
      ],
      "IsClassified": false,
      "RelistedItemId": 123,
      "Subtitle": "ABC",
      "IsBuyNowOnly": false,
      "RemainingGalleryPlusRelists": 123,
      "PriceDisplay": "ABC",
      "CanRequestRelist": false,
      "CanRequestOffer": false,
      "IsClearance": false,
      "WasPrice": 123.0,
      "PercentageOff": 123,
      "Options": [
        {
        },
        {
        }
      ],
      "ListingGroupId": 123,
      "IsWithdrawn": false,
      "HasRelistBeenRequested": false,
      "HasOfferBeenRequested": false,
      "OfferStatus": 0,
      "IsSold": false
    },
    {
      "ListingId": 123,
      "Title": "ABC",
      "Category": "ABC",
      "StartPrice": 123.0,
      "BuyNowPrice": 123.0,
      "StartDate": "\/Date(1514764800)\/",
      "EndDate": "\/Date(1514764800)\/",
      "MaxBidAmount": 123.0,
      "AsAt": "\/Date(1514764800)\/",
      "CategoryPath": "ABC",
      "PictureHref": "ABC",
      "PhotoId": 123,
      "HasPayNow": false,
      "IsNew": false,
      "BidCount": 123,
      "IsReserveMet": false,
      "HasReserve": false,
      "HasBuyNow": false,
      "Note": "ABC",
      "NoteId": 123,
      "NoteDate": "\/Date(1514764800)\/",
      "CategoryName": "ABC",
      "ReserveState": 0,
      "Attributes": [
        {
          "Name": "ABC",
          "DisplayName": "ABC",
          "Value": "ABC"
        },
        {
          "Name": "ABC",
          "DisplayName": "ABC",
          "Value": "ABC"
        }
      ],
      "IsClassified": false,
      "RelistedItemId": 123,
      "Subtitle": "ABC",
      "IsBuyNowOnly": false,
      "RemainingGalleryPlusRelists": 123,
      "PriceDisplay": "ABC",
      "CanRequestRelist": false,
      "CanRequestOffer": false,
      "IsClearance": false,
      "WasPrice": 123.0,
      "PercentageOff": 123,
      "Options": [
        {
        },
        {
        }
      ],
      "ListingGroupId": 123,
      "IsWithdrawn": false,
      "HasRelistBeenRequested": false,
      "HasOfferBeenRequested": false,
      "OfferStatus": 0,
      "IsSold": false
    }
  ]
}