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

Indicates if the logged in member can place feedback. This will be false if feedback has already been placed, or if feedback has previously been deleted.

CanEdit Boolean

Indicates if the logged in member can edit their placed feedback. This will be false if no feedback is present, or if the user has edited their feedback too many times.

CanDelete Boolean

Indicates if the logged in member can delete feedback. Currently this is always true if feedback has been placed.

FeedbackPlaced <FeedbackItem> or null

Details of the feedback that the logged in member has placed, if any.

IsSeller Boolean

Indicates whether the feedback is from the seller.

DateEntered DateTime

The date and time the feedback was entered.

Text String or null

The text of the feedback.

ListingId Long Integer

The ID of the listing the feedback was about.

BuyNowPrice Number

The Buy Now price.

IsAnOffer Boolean

Determines if the sale was an offer.

MaximumBidAmount Number

The final bid amount.

OfferPrice Number

The offer price (if it was a fixed price offer).

DateResponded DateTime

The date and time the response was given to the feedback.

Response String or null

The response to the feedback.

HasReturnedFeedback Boolean

Indicates whether a response has been given to the feedback.

IsEdited Boolean

Indicates whether the feedback has been edited.

SellerId Integer

The member ID of the seller.

FeedbackType Enumeration

The type of feedback given (positive, negative, etc).

Negative 0

Negative feedback.

Positive 1

Positive feedback.

Neutral 2

Neutral feedback.

TradeMe 3

Feedback from the Trade Me customer service team.

FeedbackFrom <Member> or null

The member who gave the feedback.

MemberId Integer

The ID of the member. This may be 0, if we determine it is necessary to protect the member's privacy.

Nickname String or null

The nickname of the member. Some characters may be changed, if we determine it is necessary to protect the member's privacy.

DateAddressVerified DateTime

The date the member was address verified.

DateJoined DateTime

The date the member joined.

UniqueNegative Integer

The number of distinct members who have placed negative feedback against this member.

UniquePositive Integer

The number of distinct members who have placed positive feedback against this member.

FeedbackCount Integer

The member's total feedback (UniquePositive minus UniqueNegative).

IsAddressVerified Boolean

Indicates whether the member has been address verified.

IsDealer Boolean

Indicates whether the member is a car dealer.

IsAuthenticated Boolean

Indicates whether the member is authenticated.

IsInTrade Boolean

Indicates whether the member is a professional trader.

FeedbackId Integer

The ID of the the feedback.

PurchaseId Integer

The purchase-specific ID (or auction sold id). Can only be provided for feedback against listings less than 45 days old, or eCommerce listings. Feedback cannot be placed against purchases older than 45 days regardless.

FeedbackReceived <FeedbackItem> or null

Details of the feedback that the other party to the purchase has placed against the logged in member, if any.

(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>
    </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
    },
    "FeedbackId": 123,
    "PurchaseId": 123
  },
  "FeedbackReceived": {
  }
}