Website logo

Retrieve feedback details for a purchase

Retrieves feedback for a single purchase, both placed and received.

URL: https://api.trademe.co.nz/v1/Purchases/{purchaseId}/Feedback.{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

purchaseId Integer (required)

The ID of the purchase to retrieve feedback for.

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

Returns

<PurchaseFeedback>

Feedback details for the purchase.

CanCreate Boolean CanCreate
CanEdit Boolean CanEdit
CanDelete Boolean CanDelete
FeedbackPlaced <FeedbackItem> or null FeedbackPlaced
IsSeller Boolean IsSeller
DateEntered DateTime DateEntered
Text String or null Text
ListingId Integer ListingId
BuyNowPrice Number BuyNowPrice
IsAnOffer Boolean IsAnOffer
MaximumBidAmount Number MaximumBidAmount
OfferPrice Number OfferPrice
DateResponded DateTime DateResponded
Response String or null Response
HasReturnedFeedback Boolean HasReturnedFeedback
IsEdited Boolean IsEdited
SellerId Integer SellerId
FeedbackType Enumeration FeedbackType
Negative 0 Negative
Positive 1 Positive
Neutral 2 Neutral
TradeMe 3 TradeMe
FeedbackFrom <Member> or null FeedbackFrom
MemberId Integer MemberId
Nickname String or null Nickname
DateAddressVerified DateTime DateAddressVerified
DateJoined DateTime DateJoined
UniqueNegative Integer UniqueNegative
UniquePositive Integer UniquePositive
FeedbackCount Integer FeedbackCount
IsAddressVerified Boolean IsAddressVerified
IsDealer Boolean IsDealer
IsAuthenticated Boolean IsAuthenticated
IsInTrade Boolean IsInTrade
IsRentiUser Boolean IsRentiUser
FeedbackId Integer FeedbackId
PurchaseId Integer PurchaseId
FeedbackReceived <FeedbackItem> or null FeedbackReceived
(This type has already been defined)

Example XML Response (switch to JSON)

<PurchaseFeedback xmlns="http://api.trademe.co.nz/v1">
  <CanCreate>false</CanCreate>
  <CanEdit>false</CanEdit>
  <CanDelete>false</CanDelete>
  <FeedbackPlaced>
    <IsSeller>false</IsSeller>
    <DateEntered>2018-01-01T00:00:00Z</DateEntered>
    <Text>ABC</Text>
    <ListingId>123</ListingId>
    <BuyNowPrice>123.0</BuyNowPrice>
    <IsAnOffer>false</IsAnOffer>
    <MaximumBidAmount>123.0</MaximumBidAmount>
    <OfferPrice>123.0</OfferPrice>
    <DateResponded>2018-01-01T00:00:00Z</DateResponded>
    <Response>ABC</Response>
    <HasReturnedFeedback>false</HasReturnedFeedback>
    <IsEdited>false</IsEdited>
    <SellerId>123</SellerId>
    <FeedbackType>Negative</FeedbackType>
    <FeedbackFrom>
      <MemberId>123</MemberId>
      <Nickname>ABC</Nickname>
      <DateAddressVerified>2018-01-01T00:00:00Z</DateAddressVerified>
      <DateJoined>2018-01-01T00:00:00Z</DateJoined>
      <UniqueNegative>123</UniqueNegative>
      <UniquePositive>123</UniquePositive>
      <FeedbackCount>123</FeedbackCount>
      <IsAddressVerified>false</IsAddressVerified>
      <IsDealer>false</IsDealer>
      <IsAuthenticated>false</IsAuthenticated>
      <IsInTrade>false</IsInTrade>
      <IsRentiUser>false</IsRentiUser>
    </FeedbackFrom>
    <FeedbackId>123</FeedbackId>
    <PurchaseId>123</PurchaseId>
  </FeedbackPlaced>
  <FeedbackReceived />
</PurchaseFeedback>

Example JSON Response (switch to XML)

{
  "CanCreate": false,
  "CanEdit": false,
  "CanDelete": false,
  "FeedbackPlaced": {
    "IsSeller": false,
    "DateEntered": "\/Date(1514764800)\/",
    "Text": "ABC",
    "ListingId": 123,
    "BuyNowPrice": 123.0,
    "IsAnOffer": false,
    "MaximumBidAmount": 123.0,
    "OfferPrice": 123.0,
    "DateResponded": "\/Date(1514764800)\/",
    "Response": "ABC",
    "HasReturnedFeedback": false,
    "IsEdited": false,
    "SellerId": 123,
    "FeedbackType": 0,
    "FeedbackFrom": {
      "MemberId": 123,
      "Nickname": "ABC",
      "DateAddressVerified": "\/Date(1514764800)\/",
      "DateJoined": "\/Date(1514764800)\/",
      "UniqueNegative": 123,
      "UniquePositive": 123,
      "FeedbackCount": 123,
      "IsAddressVerified": false,
      "IsDealer": false,
      "IsAuthenticated": false,
      "IsInTrade": false,
      "IsRentiUser": false
    },
    "FeedbackId": 123,
    "PurchaseId": 123
  },
  "FeedbackReceived": {
  }
}