Website logo

Post feedback on a listing

Places feedback on the buyer or seller of an auction.

URL: https://api.trademe.co.nz/v1/mytrademe/feedback.{file_format}
HTTP Method: POST
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.

POST Data

<FeedbackRequest>

FeedbackType Enumeration (required)

The type of feedback given.
Negative 0

Negative feedback.
Positive 1

Positive feedback.
Neutral 2

Neutral feedback.
TradeMe 3

Feedback from the Trade Me customer service team.
Text String (required)

The text of the feedback.
ListingId Integer (optional)

The ID of the listing this feedback is for.

This field is retained for backwards compatibility; please use PurchaseId instead.

IsForFpo Boolean (optional)

Indicates whether the feedback is for a fixed price offer recipient.

This field is retained for backwards compatibility; please use PurchaseId instead.

PurchaseId Integer (optional)

The ID of the purchase this feedback is for. This field is a replacement for both ListingId and IsForFpo.
KoruTradeItemId String (optional)

The Koru Trade Item ID for the trade that the feedback is for. It should be used instead of PurchaseId for Koru trades.

Returns

<FeedbackResponse>

Details on whether the operation was successful.

Success Boolean

Indicates whether the operation was successful.
Description String or null

The description of the error, if the operation failed.
StatusCode Enumeration

The status code indicating what went wrong if the operation failed.
Ok 0

Success.
AlreadyPlaced 1

Feedback already posted.
AlreadyEdited 2

Feedback already edited.
ErrorDeleting 3

Error deleting.
MemberNotFound 4

The member could not be found.
NotSelf 5

Cannot give feedback on self.
IncorrectMember 6

The feedback is not for this member.
NotWinner 7

The member did not win the auction.
NotWinnerOffer 8

The member did not win the offer.
DatabaseError 10

There was another database error.
NotSupported 11

The feedback type is not supported.
NoFixedPriceOffer 12

There is not a fixed price offer.
InvalidFeedback 13

The feedback text submitted is not valid.
FeedbackId Integer

If the operation succeeded, the ID of the new feedback.

Example XML Request (switch to JSON) 

<FeedbackRequest xmlns="http://api.trademe.co.nz/v1">
  <FeedbackType>Negative</FeedbackType>
  <Text>ABC</Text>
  <ListingId>123</ListingId>
  <IsForFpo>false</IsForFpo>
  <PurchaseId>123</PurchaseId>
  <KoruTradeItemId>ABC</KoruTradeItemId>
</FeedbackRequest>

Example JSON Request (switch to XML) 

{
  "FeedbackType": 0,
  "Text": "ABC",
  "ListingId": 123,
  "IsForFpo": false,
  "PurchaseId": 123,
  "KoruTradeItemId": "ABC"
}

Example XML Response (switch to JSON) 

<FeedbackResponse xmlns="http://api.trademe.co.nz/v1">
  <Success>false</Success>
  <Description>ABC</Description>
  <StatusCode>Ok</StatusCode>
  <FeedbackId>123</FeedbackId>
</FeedbackResponse>

Example JSON Response (switch to XML) 

{
  "Success": false,
  "Description": "ABC",
  "StatusCode": 0,
  "FeedbackId": 123
}