getFeedback

This array contains a list of feedback entries that meet the specified criteria.

Occurrence: Always

If the returned value is true, feedback was generated and added automatically by eBay. If a seller has a feedback score 10 or less, eBay automatically leaves feedback. The buyer can choose to override the eBay feedback and leave feedback normally.

Note: Detailed Seller Ratings (DSRs) are not provided by ebay, only a predefined comment and a positive rating.

Occurrence: Always

This enumerated value indicates the type of feedback: POSITIVE, NEUTRAL, NEGATIVE.

Note: Sellers can only leave positive feedback for buyers.

Occurrence: Always

This boolean indicates whether the feedback is eligible for revision. If returned as true, it means the feedback can be modified. Feedback that is older than 30 days or has already been revised once cannot be erased or further revised.

Occurrence: Always

This container provides the feedback comment left by a user when submitting feedback for a seller or buyer.

Occurrence: Always

This container indicates the timing of a feedback comment based on when it was left. It is only returned if a comment was provided. Possible values are 30 days, 90 days, 180 days, 365 days, or 5 years:

• Less than 30 days: 30 DAY
• Over 30 but less than 90 days: 90 DAY
• Over 90 but less than 180 days: 180 DAY
• Over 180 but less than 365 days: 365 DAY
• More than 365 days: 5 YEAR

Occurrence: Always

Unit of time for the value. Supported values: DAY, or YEAR.

Occurrence: Always

Value of the time period expressed in the period contained in the unit. Supported values: 30, 60, or 365.

See the commentPeriod container for more information.

Occurrence: Conditional

The text of the feedback comment, follow-up, or reply. HTML formatting and personal information (for example, phone numbers) are not allowed. This field is returned if a comment was provided for the feedback entry. If the comment was removed due to eBay policy, this field will contain '--' and the commentTextRemovedPerPolicy field will return true.

Occurrence: Always

If true, this boolean indicates the feedback follow-up or reply comment text was removed per eBay policy. This field is only returned when a followupComment container is returned.

Occurrence: Always

This enumerated value indicates the state of the feedback (for example, ENTERED). This can be the state of the feedback comment, the follow-up comment, or the reply comment.

Occurrence: Always

The timestamp when the feedback was submitted.

Occurrence: Always

This container represents the duration since feedback was entered, expressed as a numeric value and a unit of time in days.

Occurrence: Conditional

The unit for the feedback entry period's value. Supported value: DAY.

Occurrence: Conditional

The value for the feedback entry period, specified in units of unit. Supported values: 7, 30, 90, 180, or 365.

Occurrence: Conditional

The unique identifier of the feedback entry.

Occurrence: Always

This array contains a list of ratings attached to feedback.

Note: This array only applies to buyers feedback for sellers (sellers can only give positive feedback to buyers).

Occurrence: Conditional

This enumerated value indicates the type of rating (for example, OVERALL_EXPERIENCE, DSR_ITEM_AS_DESCRIBED).

Occurrence: Conditional

The value assigned to the rating, specified as a string representing a number from 1 to 5, with 1 representing the lowest rating and 5 representing the highest rating.

Occurrence: Conditional

The feedback receiver's feedback score after receiving this specific feedback.

Occurrence: Conditional

This enumerated value indicates the current state of the feedback entry (for example, ENTERED).

Occurrence: Always

This container provides the details of any follow-up comment left.

Note: A buyer leaves followup comments, and a seller leaves reply comments.

Occurrence: Conditional

This container indicates the timing of a feedback comment based on when it was left. It is only returned if a comment was provided. Possible values are 30 days, 90 days, 180 days, 365 days, or 5 years:

• Less than 30 days: 30 DAY
• Over 30 but less than 90 days: 90 DAY
• Over 90 but less than 180 days: 180 DAY
• Over 180 but less than 365 days: 365 DAY
• More than 365 days: 5 YEAR

Occurrence: Always

Unit of time for the value. Supported values: DAY, or YEAR.

Occurrence: Always

Value of the time period expressed in the period contained in the unit. Supported values: 30, 60, or 365.

See the commentPeriod container for more information.

Occurrence: Conditional

The text of the feedback comment, follow-up, or reply. HTML formatting and personal information (for example, phone numbers) are not allowed. This field is returned if a comment was provided for the feedback entry. If the comment was removed due to eBay policy, this field will contain '--' and the commentTextRemovedPerPolicy field will return true.

Occurrence: Always

If true, this boolean indicates the feedback follow-up or reply comment text was removed per eBay policy. This field is only returned when a followupComment container is returned.

Occurrence: Always

This enumerated value indicates the state of the feedback (for example, ENTERED). This can be the state of the feedback comment, the follow-up comment, or the reply comment.

Occurrence: Always

If returned as true, this boolean indicates that the feedback entry has one or more images attached. If false, there are no images attached.

Occurrence: Always

This array contains the list of attached images.

Occurrence: Conditional

This field provides the URL of an attached image and is included in the response whenever an image is attached.

Occurrence: Always

This container provides a summary of the line item associated with the feedback entry.

Note: Certain fields within this container are returned only when the request uses the Authorization code grant flow (user access token) and the user_id matches the authenticated user. These fields are not returned when accessing a different user_id or when using the Client credentials grant flow (application access token). See OAuth scope for for details on the flows and required permissions.

Occurrence: Always

This field provides the unique identifier for the listing associated with the feedback entry. Conditionally returned based on the authorization flow and user context. See orderLineItemSummary for details on when this field is included.

Occurrence: Conditional

This container provides the sale price of the listing. Conditionally returned based on the authorization flow and user context. See orderLineItemSummary for details on when this field is included.

Occurrence: Conditional

This field provides the three-letter ISO 4217 code that represents the currency of the amount in the value field. Both the value and currency fields are always returned when expressing prices.

Occurrence: Always

This field contains the numerical value of the listing price in the currency specified in the currency field. Both the value and currency fields are always returned when expressing prices.

Occurrence: Always

This field contains the title of the listing. Conditionally returned based on the authorization flow and user context. See orderLineItemSummary for details on when this field is included.

Occurrence: Conditional

This array describes order line attributes including names and values of a transaction.

Occurrence: Conditional

This enumerated value indicates an attribute of the line item. The value field indicates if the attribute applies.

Occurrence: Conditional

If returned as true, the line item attribute name applies; if returned as false, the attribute does not apply.

Occurrence: Conditional

The unique identifier of the line item for this feedback. Conditionally returned based on the authorization flow and user context. See orderLineItemSummary for details on when this field is included.

Occurrence: Conditional

This container indicates if the time since the item was bought on ebay is less than, more than, or equal to 90 days

Occurrence: Always

This container indicates if the time since the item was bought on ebay is less than, more than, or equal to 90 days.

Occurrence: Always

The unit of the period's value. Supported value: DAY.

Occurrence: Always

The value for the feedback period, specified in units of unit. Supported value: 90.

Occurrence: Always

This enumerated value indicates whether a transaction period exceeds, falls short, or matches the threshold. You can use this field to trigger specific logic or actions based on whether a transaction period exceeds, falls short, or matches the threshold.

Occurrence: Always

This container details the attributes of the user who provided the feedback.

Occurrence: Always

This integer indicates the feedback score of the feedback provider at the time of providing this specific feedback.

Occurrence: Always

This enumerated value provides the visual star representation of the feedback score (for example, YELLOW_STAR).

Occurrence: Always

This enumerated value indicates the user's role in the transaction (BUYER or SELLER).

Occurrence: Always

This array lists additional attributes that relate to the user (such as verification status).

Occurrence: Always

This enumerated value indicates an attribute of the user (for example, USER_VERIFIED). The value field indicates if the attribute applies.

Occurrence: Always

If returned as true, the user attribute name applies; if returned as false, the attribute does not apply.

Occurrence: Always

This field indicates the unique identifier of the user who gave the feedback.

Note: Select developers will not receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to Data Handling Compliance.

Occurrence: Always

If returned as true, this boolean indicates the feedback reply was given by the seller before the follow-up comment was given buy the buyer.

Occurrence: Conditional

This container provides the details of any reply to the feedback.

Note: A buyer leaves followup comments, and a seller leaves reply comments.

Occurrence: Conditional

This container indicates the timing of a feedback comment based on when it was left. It is only returned if a comment was provided. Possible values are 30 days, 90 days, 180 days, 365 days, or 5 years:

• Less than 30 days: 30 DAY
• Over 30 but less than 90 days: 90 DAY
• Over 90 but less than 180 days: 180 DAY
• Over 180 but less than 365 days: 365 DAY
• More than 365 days: 5 YEAR

Occurrence: Always

Unit of time for the value. Supported values: DAY, or YEAR.

Occurrence: Always

Value of the time period expressed in the period contained in the unit. Supported values: 30, 60, or 365.

See the commentPeriod container for more information.

Occurrence: Conditional

The text of the feedback comment, follow-up, or reply. HTML formatting and personal information (for example, phone numbers) are not allowed. This field is returned if a comment was provided for the feedback entry. If the comment was removed due to eBay policy, this field will contain '--' and the commentTextRemovedPerPolicy field will return true.

Occurrence: Always

If true, this boolean indicates the feedback follow-up or reply comment text was removed per eBay policy. This field is only returned when a followupComment container is returned.

Occurrence: Always

This enumerated value indicates the state of the feedback (for example, ENTERED). This can be the state of the feedback comment, the follow-up comment, or the reply comment.

Occurrence: Always

This array provides descriptions of AI-generated insights related to a feedback entry for the specified filter topic. The feedback provided is considered relevant to the requested topic. For example, when using the request parameter filter of topics:product-satisfaction, the returned array might be:

{
  "coarseTopic" : "product-satisfaction",
  "highlightedTexts" : [
    "This machine is amazing",
    "Very happy with this purchase"
    ],
  "sentiment" : "Positive"
}

If no topics exist for that feedback, an empty array is returned.

Occurrence: Conditional

The main topic (or category) detected in the comment. See the available topics in filter.

Occurrence: Conditional

Note: Fine topics are not currently supported.

Occurrence: Conditional

This array lists any text snippets, phrases, or examples, from the feedback that supports the detected topic.

Occurrence: Conditional

This field indicates a classification of the feedback, whether the feedback is Positive, Negative, or Neutral.

Occurrence: Conditional

This container provides pagination information for the returned feedback response (as filtered).

Occurrence: Conditional

This value indicates the number of feedback entries on the current response page.

Occurrence: Always

The value of the limit parameter submitted in the request. This is the maximum number of line items, as filtered, awaiting feedback to return per page from the result set. This field indicates the number of line items returned per page of data.

Note: If this is the last or only page of the result set, the page may contain fewer line items than the limit value.

If a limit parameter was not included in the request, this value will default to 25, returning up to 25 line items on each page.

Default: 25

Occurrence: Always

The relative URI for the next page of results starting with the resource name. This URI is returned if there is an additional page of results in the result set.

Occurrence: Conditional

The value of the offset parameter submitted in the request. This field indicates how many results were skipped in the response. If an offset parameter was not included in the request, this value will default to 0, returning the first page of results.

Default: 0

Occurrence: Always

The relative URI for the previous page of results starting with the resource name. This URI is returned if there is a previous page of results in the result set.

Occurrence: Conditional

The total number of line items available that match the filter criteria.

Note: If the total value exceeds the limit value, there are multiple pages of results.

Occurrence: Always