GetFeedback

Use this call to retrieve the accumulated feedback left for a specified user, or the summary feedback data for a specific item listing or order line item.

Usage Details

GetFeedback takes the following values as input filters: UserID, Item ID, Transaction ID, or OrderLineItemID. See the API Reference Input table for more information on these fields. If no input filters are specified, the call returns the aggregate feedback score for the requesting user.

If you specify a UserID, GetFeedback returns the aggregate feedback score for the specified user and the summary feedback data used to calculate that score. If you are retrieving feedback data for a User ID, set DetailLevel to ReturnAll to return the summary data plus the details (the score and associated comment) of each feedback record.

Be default, the call returns all comment types. However, you can use the CommentType input property to specify the type of feedback comments you want to view: positive, negative, or neutral. If desired, include two comment types to exclude the third comment type from your results.

Use the Pagination.EntriesPerPage and Pagination.PageNumber input properties to paginate the results of User ID feedback data. Because pagination works only with detailed feedback entries (and not the summary feedback data), you must set DetailLevel to ReturnAll in order to paginate the result set.

The EntriesPerPage property establishes the maximum number of feedback detail entries returned per call. This value can be set to only 25 (the default), 50, 100, or 200. If you use pagination, the summary data is returned after the last feedback detail entry.

If you are requesting information based on an Item ID, the call returns a maximum number of 100 feedback records, any pagination values are ignored.

Note that you can use feedback-related platform notifications--Feedback, FeedbackLeft, and FeedbackReceived--to update feedback records without making an API call.

Working with the Response

Feedback records change infrequently and are returned with the newest records listed first. If you are developing a seller application that verifies if feedback has been left for a order line item, your application should retrieve pages only until the page contains a feedback record that was previously retrieved.

Testing GetFeedback

You can test GetFeedback in the Sandbox environment. For best results:

• Use a minimum of three test users. This allows for one test user to be the one whose feedback is returned and the others serve as participants in successfully ended listings. Have different test users leave multiple feedback scores for the target user.
• Test GetFeedback on a new test user who does not yet have any feedback. Also test for returning just summary feedback data as well as returning feedback details.
• Test GetFeedback on a test user or item with enough feedback entries to paginate the feedback detail data. For example, if you have a user with 20 feedback records, use pagination to return 10 feedback records per call, and retrieve all records. Succeeding on this test ensures that the application is able to accommodate retrieving voluminous feedback with multiple sequential calls.

Related Information

See Second change offers.

Input

See also Samples.

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are (or soon will be) non-operational.

The XML prototype does not include requester credentials. This is a documentation limitation only (see Standard Requester Credentials for Making Calls).

<?xml version="1.0" encoding="utf-8"?>
<GetFeedbackRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <CommentType> CommentTypeCodeType </CommentType>
  <!-- ... more CommentType values allowed here ... -->
  <FeedbackID> string </FeedbackID>
  <FeedbackType> FeedbackTypeCodeType </FeedbackType>
  <ItemID> ItemIDType (string) </ItemID>
  <OrderLineItemID> string </OrderLineItemID>
  <Pagination> PaginationType
    <EntriesPerPage> int </EntriesPerPage>
    <PageNumber> int </PageNumber>
  </Pagination>
  <TransactionID> string </TransactionID>
  <UserID> UserIDType (string) </UserID>
  <!-- Standard Input Fields -->
  <DetailLevel> DetailLevelCodeType </DetailLevel>
  <!-- ... more DetailLevel values allowed here ... -->
  <ErrorLanguage> string </ErrorLanguage>
  <MessageID> string </MessageID>
  <OutputSelector> string </OutputSelector>
  <!-- ... more OutputSelector values allowed here ... -->
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
</GetFeedbackRequest>

 If the following output selectors are used: 

...
 <OutputSelector>ViewItemURL</OutputSelector>
 <OutputSelector>BuyItNowPrice</OutputSelector> 
... 

 ...the response might look like the following 

  <Item>
 <BuyItNowPrice currencyID="USD">0.0</BuyItNowPrice>
 <ListingDetails>
 <ViewItemURL>http://www.ebay.com/itm/Tag-Heuer-Mens-Watch/182879833261</ViewItemURL>
 </ListingDetails>
 </Item>  

Output

See also Samples.

The box below lists all fields that might be returned in the response. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are not returned (or soon will not be returned) or are not operational (or soon will be non-operational).

<?xml version="1.0" encoding="utf-8"?>
<GetFeedbackResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <EntriesPerPage> int </EntriesPerPage>
  <FeedbackDetailArray> FeedbackDetailArrayType
    <FeedbackDetail> FeedbackDetailType
      <CommentingUser> UserIDType (string) </CommentingUser>
      <CommentingUserScore> int </CommentingUserScore>
      <CommentReplaced> boolean </CommentReplaced>
      <CommentText> string </CommentText>
      <CommentTime> dateTime </CommentTime>
      <CommentType> CommentTypeCodeType </CommentType>
      <Countable> boolean </Countable>
      <FeedbackID> string </FeedbackID>
      <FeedbackRatingStar> FeedbackRatingStarCodeType </FeedbackRatingStar>
      <FeedbackResponse> string </FeedbackResponse>
      <FeedbackRevised> boolean </FeedbackRevised>
      <Followup> string </Followup>
      <FollowUpReplaced> boolean </FollowUpReplaced>
      <ItemID> ItemIDType (string) </ItemID>
      <ItemPrice currencyID="CurrencyCodeType"> AmountType (double) </ItemPrice>
      <ItemTitle> string </ItemTitle>
      <OrderLineItemID> string </OrderLineItemID>
      <ResponseReplaced> boolean </ResponseReplaced>
      <Role> TradingRoleCodeType </Role>
      <TransactionID> string </TransactionID>
    </FeedbackDetail>
    <!-- ... more FeedbackDetail nodes allowed here ... -->
  </FeedbackDetailArray>
  <FeedbackDetailItemTotal> int </FeedbackDetailItemTotal>
  <FeedbackScore> int </FeedbackScore>
  <FeedbackSummary> FeedbackSummaryType
    <BidRetractionFeedbackPeriodArray> FeedbackPeriodArrayType
      <FeedbackPeriod> FeedbackPeriodType
        <Count> int </Count>
        <PeriodInDays> int </PeriodInDays>
      </FeedbackPeriod>
      <!-- ... more FeedbackPeriod nodes allowed here ... -->
    </BidRetractionFeedbackPeriodArray>
    <BuyerRoleMetrics> BuyerRoleMetricsType
      <FeedbackLeftPercent> float </FeedbackLeftPercent>
      <NegativeFeedbackLeftCount> int </NegativeFeedbackLeftCount>
      <NeutralFeedbackLeftCount> int </NeutralFeedbackLeftCount>
      <PositiveFeedbackLeftCount> int </PositiveFeedbackLeftCount>
    </BuyerRoleMetrics>
    <NegativeFeedbackPeriodArray> FeedbackPeriodArrayType
      <FeedbackPeriod> FeedbackPeriodType
        <Count> int </Count>
        <PeriodInDays> int </PeriodInDays>
      </FeedbackPeriod>
      <!-- ... more FeedbackPeriod nodes allowed here ... -->
    </NegativeFeedbackPeriodArray>
    <NeutralCommentCountFromSuspendedUsers> int </NeutralCommentCountFromSuspendedUsers>
    <NeutralFeedbackPeriodArray> FeedbackPeriodArrayType
      <FeedbackPeriod> FeedbackPeriodType
        <Count> int </Count>
        <PeriodInDays> int </PeriodInDays>
      </FeedbackPeriod>
      <!-- ... more FeedbackPeriod nodes allowed here ... -->
    </NeutralFeedbackPeriodArray>
    <PositiveFeedbackPeriodArray> FeedbackPeriodArrayType
      <FeedbackPeriod> FeedbackPeriodType
        <Count> int </Count>
        <PeriodInDays> int </PeriodInDays>
      </FeedbackPeriod>
      <!-- ... more FeedbackPeriod nodes allowed here ... -->
    </PositiveFeedbackPeriodArray>
    <SellerRatingSummaryArray> SellerRatingSummaryArrayType
      <AverageRatingSummary> AverageRatingSummaryType
        <AverageRatingDetails> AverageRatingDetailsType
          <Rating> double </Rating>
          <RatingCount> int </RatingCount>
          <RatingDetail> FeedbackRatingDetailCodeType </RatingDetail>
        </AverageRatingDetails>
        <!-- ... more AverageRatingDetails nodes allowed here ... -->
        <FeedbackSummaryPeriod> FeedbackSummaryPeriodCodeType </FeedbackSummaryPeriod>
      </AverageRatingSummary>
      <!-- ... more AverageRatingSummary nodes allowed here ... -->
    </SellerRatingSummaryArray>
    <SellerRoleMetrics> SellerRoleMetricsType
      <CrossBorderTransactionCount> int </CrossBorderTransactionCount>
      <CrossBorderTransactionPercent> float </CrossBorderTransactionPercent>
      <FeedbackLeftPercent> float </FeedbackLeftPercent>
      <NegativeFeedbackLeftCount> int </NegativeFeedbackLeftCount>
      <NeutralFeedbackLeftCount> int </NeutralFeedbackLeftCount>
      <PositiveFeedbackLeftCount> int </PositiveFeedbackLeftCount>
      <RepeatBuyerCount> int </RepeatBuyerCount>
      <RepeatBuyerPercent> float </RepeatBuyerPercent>
      <TransactionPercent> float </TransactionPercent>
      <UniqueBuyerCount> int </UniqueBuyerCount>
    </SellerRoleMetrics>
    <TotalFeedbackPeriodArray> FeedbackPeriodArrayType
      <FeedbackPeriod> FeedbackPeriodType
        <Count> int </Count>
        <PeriodInDays> int </PeriodInDays>
      </FeedbackPeriod>
      <!-- ... more FeedbackPeriod nodes allowed here ... -->
    </TotalFeedbackPeriodArray>
    <UniqueNegativeFeedbackCount> int </UniqueNegativeFeedbackCount>
    <UniqueNeutralFeedbackCount> int </UniqueNeutralFeedbackCount>
    <UniquePositiveFeedbackCount> int </UniquePositiveFeedbackCount>
  </FeedbackSummary>
  <PageNumber> int </PageNumber>
  <PaginationResult> PaginationResultType
    <TotalNumberOfEntries> int </TotalNumberOfEntries>
    <TotalNumberOfPages> int </TotalNumberOfPages>
  </PaginationResult>
  <!-- Standard Output Fields -->
  <Ack> AckCodeType </Ack>
  <Build> string </Build>
  <CorrelationID> string </CorrelationID>
  <Errors> ErrorType
    <ErrorClassification> ErrorClassificationCodeType </ErrorClassification>
    <ErrorCode> token </ErrorCode>
    <ErrorParameters ParamID="string"> ErrorParameterType
      <Value> string </Value>
    </ErrorParameters>
    <!-- ... more ErrorParameters nodes allowed here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes allowed here ... -->
  <HardExpirationWarning> string </HardExpirationWarning>
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
</GetFeedbackResponse>

Detail Controls

DetailLevel

The DetailLevel input field influences which call-specific fields may be returned. (All standard output fields are returned regardless of DetailLevel.)

The none column indicates the fields that are returned when you do not specify a DetailLevel.

Samples

New to making API calls? Please see Making a Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Retrieves the feedback for the user specified by UserID.

Description

A potential buyer found a book she wants to buy from m***************r and she wants to confirm the seller's feedback score before proceeding. This sample gets summary feedback information for the specified user.

Input

The only input needed for this sample is the UserID of the seller.

XML format.

<?xml version="1.0" encoding="utf-8"?>
<GetFeedbackRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <RequesterCredentials>
    <eBayAuthToken>A*******3</eBayAuthToken>
  </RequesterCredentials>
  <UserID>m***************r</UserID>
</GetFeedbackRequest>

Output

The important information in the response is FeedbackScore, which contains the aggregate feedback score, and the data in FeedbackSummary used to calculate the aggregate feedback score.

From the feedback scores, potential buyer sees that m***************r is a prolific seller on eBay, with a very positive feedback score. With this information, she feels that she can purchase the item knowing that she will get the item as advertised.

XML format.
<?xml version="1.0" encoding="UTF-8"?>
<GetFeedbackResponse 
  xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2019-11-04T20:51:21.345Z</Timestamp>
  <Ack>Success</Ack>
  <Version>1119</Version>
  <Build>E1119_CORE_APIFEEDBACK_19038728_R1</Build>
  <FeedbackSummary>
    <BidRetractionFeedbackPeriodArray>
      <FeedbackPeriod>
        <PeriodInDays>7</PeriodInDays>
        <Count>0</Count>
      </FeedbackPeriod>
      <FeedbackPeriod>
        <PeriodInDays>30</PeriodInDays>
        <Count>0</Count>
      </FeedbackPeriod>
      <FeedbackPeriod>
        <PeriodInDays>180</PeriodInDays>
        <Count>0</Count>
      </FeedbackPeriod>
    </BidRetractionFeedbackPeriodArray>
    <NegativeFeedbackPeriodArray>
      <FeedbackPeriod>
        <PeriodInDays>0</PeriodInDays>
        <Count>18641</Count>
      </FeedbackPeriod>
      <FeedbackPeriod>
        <PeriodInDays>30</PeriodInDays>
        <Count>296</Count>
      </FeedbackPeriod>
      <FeedbackPeriod>
        <PeriodInDays>180</PeriodInDays>
        <Count>1833</Count>
      </FeedbackPeriod>
      <FeedbackPeriod>
        <PeriodInDays>365</PeriodInDays>
        <Count>4758</Count>
      </FeedbackPeriod>
    </NegativeFeedbackPeriodArray>
    <NeutralFeedbackPeriodArray>
      <FeedbackPeriod>
        <PeriodInDays>0</PeriodInDays>
        <Count>15049</Count>
      </FeedbackPeriod>
      <FeedbackPeriod>
        <PeriodInDays>30</PeriodInDays>
        <Count>215</Count>
      </FeedbackPeriod>
      <FeedbackPeriod>
        <PeriodInDays>180</PeriodInDays>
        <Count>1450</Count>
      </FeedbackPeriod>
      <FeedbackPeriod>
        <PeriodInDays>365</PeriodInDays>
        <Count>3676</Count>
      </FeedbackPeriod>
    </NeutralFeedbackPeriodArray>
    <PositiveFeedbackPeriodArray>
      <FeedbackPeriod>
        <PeriodInDays>0</PeriodInDays>
        <Count>3159359</Count>
      </FeedbackPeriod>
      <FeedbackPeriod>
        <PeriodInDays>30</PeriodInDays>
        <Count>40503</Count>
      </FeedbackPeriod>
      <FeedbackPeriod>
        <PeriodInDays>180</PeriodInDays>
        <Count>290379</Count>
      </FeedbackPeriod>
      <FeedbackPeriod>
        <PeriodInDays>365</PeriodInDays>
        <Count>669953</Count>
      </FeedbackPeriod>
    </PositiveFeedbackPeriodArray>
    <TotalFeedbackPeriodArray>
      <FeedbackPeriod>
        <PeriodInDays>30</PeriodInDays>
        <Count>41014</Count>
      </FeedbackPeriod>
      <FeedbackPeriod>
        <PeriodInDays>180</PeriodInDays>
        <Count>293662</Count>
      </FeedbackPeriod>
      <FeedbackPeriod>
        <PeriodInDays>365</PeriodInDays>
        <Count>678387</Count>
      </FeedbackPeriod>
    </TotalFeedbackPeriodArray>
    <NeutralCommentCountFromSuspendedUsers>0</NeutralCommentCountFromSuspendedUsers>
    <UniqueNegativeFeedbackCount>16702</UniqueNegativeFeedbackCount>
    <UniquePositiveFeedbackCount>2187099</UniquePositiveFeedbackCount>
    <UniqueNeutralFeedbackCount>13608</UniqueNeutralFeedbackCount>
    <SellerRatingSummaryArray>
      <AverageRatingSummary>
        <FeedbackSummaryPeriod>FiftyTwoWeeks</FeedbackSummaryPeriod>
        <AverageRatingDetails>
          <RatingDetail>ItemAsDescribed</RatingDetail>
          <Rating>4.9</Rating>
          <RatingCount>415014</RatingCount>
        </AverageRatingDetails>
        <AverageRatingDetails>
          <RatingDetail>Communication</RatingDetail>
          <Rating>4.9</Rating>
          <RatingCount>420302</RatingCount>
        </AverageRatingDetails>
        <AverageRatingDetails>
          <RatingDetail>ShippingTime</RatingDetail>
          <Rating>5.0</Rating>
          <RatingCount>435823</RatingCount>
        </AverageRatingDetails>
        <AverageRatingDetails>
          <RatingDetail>ShippingAndHandlingCharges</RatingDetail>
          <Rating>5.0</Rating>
          <RatingCount>439989</RatingCount>
        </AverageRatingDetails>
      </AverageRatingSummary>
      <AverageRatingSummary>
        <FeedbackSummaryPeriod>ThirtyDays</FeedbackSummaryPeriod>
        <AverageRatingDetails>
          <RatingDetail>ItemAsDescribed</RatingDetail>
          <Rating>4.9</Rating>
          <RatingCount>24027</RatingCount>
        </AverageRatingDetails>
        <AverageRatingDetails>
          <RatingDetail>Communication</RatingDetail>
          <Rating>4.9</Rating>
          <RatingCount>23738</RatingCount>
        </AverageRatingDetails>
        <AverageRatingDetails>
          <RatingDetail>ShippingTime</RatingDetail>
          <Rating>5.0</Rating>
          <RatingCount>25194</RatingCount>
        </AverageRatingDetails>
        <AverageRatingDetails>
          <RatingDetail>ShippingAndHandlingCharges</RatingDetail>
          <Rating>5.0</Rating>
          <RatingCount>25393</RatingCount>
        </AverageRatingDetails>
      </AverageRatingSummary>
    </SellerRatingSummaryArray>
    <SellerRoleMetrics>
      <PositiveFeedbackLeftCount>1618174</PositiveFeedbackLeftCount>
      <NegativeFeedbackLeftCount>0</NegativeFeedbackLeftCount>
      <NeutralFeedbackLeftCount>0</NeutralFeedbackLeftCount>
      <FeedbackLeftPercent>92.0</FeedbackLeftPercent>
      <RepeatBuyerCount>0</RepeatBuyerCount>
      <RepeatBuyerPercent>0.0</RepeatBuyerPercent>
      <UniqueBuyerCount>2</UniqueBuyerCount>
      <TransactionPercent>100.0</TransactionPercent>
      <CrossBorderTransactionCount>19366</CrossBorderTransactionCount>
      <CrossBorderTransactionPercent>1.1</CrossBorderTransactionPercent>
    </SellerRoleMetrics>
    <BuyerRoleMetrics>
      <PositiveFeedbackLeftCount>0</PositiveFeedbackLeftCount>
      <NegativeFeedbackLeftCount>0</NegativeFeedbackLeftCount>
      <NeutralFeedbackLeftCount>0</NeutralFeedbackLeftCount>
      <FeedbackLeftPercent>0.0</FeedbackLeftPercent>
    </BuyerRoleMetrics>
  </FeedbackSummary>
  <FeedbackScore>2171418</FeedbackScore>
  <PaginationResult>
    <TotalNumberOfPages>0</TotalNumberOfPages>
    <TotalNumberOfEntries>0</TotalNumberOfEntries>
  </PaginationResult>
  <EntriesPerPage>25</EntriesPerPage>
  <PageNumber>1</PageNumber>
</GetFeedbackResponse>

Change History