{ "openapi": "3.0.0", "info": { "title": "Feedback API", "description": "The Feedback API includes resources for retrieving items awaiting feedback, retrieving and submitting feedback entries, providing feedback rating summaries, and responding to feedback. These methods allow users to manage feedback across buying and selling activities.

Note: Feedback is tracked at the line item level within an order, not for the whole order. Each line item can have its own feedback record.

", "contact": { "name": "eBay Inc," }, "license": { "name": "eBay API License Agreement", "url": "https://developer.ebay.com/join/api-license-agreement" }, "version": "v1.0.0" }, "servers": [ { "url": "https://api.ebay.com{basePath}", "description": "Production", "variables": { "basePath": { "default": "/commerce/feedback/v1" } } } ], "paths": { "/awaiting_feedback": { "get": { "tags": [ "awaiting_feedback" ], "description": "This method retrieves line items awaiting feedback from the user's order partner. You can refine the results using optional filter query parameters, such as item ID, user name, or user role in the transaction. Sorting and pagination features help organize and navigate returned items efficiently.

For sellers, only sold items that have not yet received feedback are included. For buyers, only purchased items for which feedback is still pending are included. If the user is both a buyer and a seller, this API returns items awaiting feedback for transactions where the user acted as either. Applying filters can limit results to either buyer-only or seller-only transactions.

The response provides an overview of feedback yet to be left for completed transactions (as filtered), with counts for both the buyer and seller roles. It includes an array of line items, each containing the listing ID, title, price (with currency and value). For each line item, the response offers feedback templates specifying which ratings are available.

Note: Detailed seller ratings are for sellers only, and are created from buyer feedback.

", "operationId": "getItemsAwaitingFeedback", "parameters": [ { "name": "filter", "in": "query", "description": "Use this parameter to limit the response based on the specified filter parameters. Supported filter parameters include:

Send the filter as a query parameter in a comma-separated name:value list. For example:
filter=listingId:123,receiverName:user,userRole:BUYER

", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "This parameter sets the maximum number of line items to return per page of data.

Use this parameter in conjunction with the offset parameter to control the pagination of the output. For example, with offset set to 20 and limit set to 10, the call retrieves entries 21 through 30 from the result set.

Although this field is optional, if omitted the default value of 25 is used.

Default: 25

Minimum: 25

Maximum: 200

", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "description": "Use this parameter to specify the number of items to skip in the result set. This is used with the limit field to control the pagination of the output. For example:

Note: This feature employs a zero-based list, where the first line item in the list has an offset of 0.

If this parameter is not set, its value defaults to 0 which returns the first page of records.

Default: 0

", "required": false, "schema": { "type": "string" } }, { "name": "sort", "in": "query", "description": "Use this parameter to configure the order of the returned listings. The time is based on when the buyer paid for the line item. Acceptable values:

If this parameter is omitted, its value defaults to END_TIME_DESC.

Default: END_TIME_DESC

", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AwaitingFeedbackResponse" } } } }, "400": { "description": "Bad Request", "x-response-codes": { "errors": { "501024": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Input sort value is invalid." }, "501025": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Input user role value is invalid." } } } }, "401": { "description": "Not Authorized", "x-response-codes": { "errors": { "1001": { "domain": "API_FEEDBACK", "category": "APPLICATION", "description": "Invalid access token. Check the value of the Authorization HTTP request header." } } } }, "500": { "description": "Internal Server Error", "x-response-codes": { "errors": { "2003": { "domain": "API_FEEDBACK", "category": "APPLICATION", "description": "There was a problem with an eBay internal system or process. Contact eBay developer support for assistance." } } } } }, "security": [ { "api_auth": [ "https://api.ebay.com/oauth/api_scope/commerce.feedback" ] } ] } }, "/feedback": { "get": { "tags": [ "feedback" ], "description": "This method enables users to retrieve feedback for any specified user ID and feedback type (sent or received). You can refine the results using optional query parameters such as its feedback ID, listing ID, or order line item ID, or applying one or more filters.

Applying filters can narrow results using criteria such as comment type, photos, or topics identified through AI-based analysis. When filtering for feedback with photos (filterImage:true), only entries with images (entries that include image URLs) are returned. Additionally, feedback can be refined for the number of days to look back, the role of the user providing the feedback, and whether to include automated feedback entries left by eBay.

Sorting and pagination features help organize and navigate returned items efficiently.

Returned data includes feedback details (such as comment text and type), feedback ratings (covering criteria like overall experience, and for sellers item description, shipping time, and communication), role and attributes of the feedback giver, line item and transaction summaries, images, and any available topics. See filter for additional information. Privacy is safeguarded by restricting the amount of detail visible to users, depending on their context. When accessing another user's feedback without logging in, buyer names are masked and seller names are shown. Logged-in users viewing their own feedback see all names, while those viewing other users' feedback will encounter some masking.

", "operationId": "getFeedback", "parameters": [ { "name": "feedback_id", "in": "query", "description": "Use this field to only return a specific feedback record by its feedback ID.

Note: If this query parameter is used, no other filters will be applicable.

", "required": false, "schema": { "type": "string" } }, { "name": "feedback_type", "in": "query", "description": "Use this field to specify the type of feedback records to return. Acceptable values:

If not specified, both feedback received and feedback left for the user shall be retrieved.

Note: When using FEEDBACK_SENT, it is recommended to also filter feedback_id to target results accurately.

", "required": true, "schema": { "type": "string" } }, { "name": "filter", "in": "query", "description": "Use this parameter to limit the response based on the specified filter parameters as follows:
Send the filter as a query parameter in a comma-separated name:value list. For example:

filter=commentType:POSITIVE,filterImage:true,topics:fit,period:30,role:SELLER,showAutomatedFeedback:true

", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Use this parameter to set the maximum number of items to return per page of data.

Use this parameter in conjunction with the offset parameter to control the pagination of the output. For example, with offset set to 20 and limit set to 10, the call retrieves entries 21 through 30 from the result set.

Although this field is optional, if omitted the default value of 25 is used.

Default: 25

Minimum: 25

Maximum: 200

", "required": false, "schema": { "type": "string" } }, { "name": "listing_id", "in": "query", "description": "Use this field to limit feedback entries to those associated with a specified listing.", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "description": "Use this field to specify the number of line items to skip in the result set. This is used with the limit field to control the pagination of the output. For example:

Note: This feature employs a zero-based list, where the first line item in the list has an offset of 0.

If this parameter is not set, its value defaults to 0 which returns the first page of records.

Default: 0

", "required": false, "schema": { "type": "string" } }, { "name": "order_line_item_id", "in": "query", "description": "Use this field to retrieve specific feedback entries related to an order line item ID. A maximum of two entries may be retrieved: feedback left by the buyer and feedback left by the seller.

Note: If this query parameter is set, no other filters will be applicable.

", "required": false, "schema": { "type": "string" } }, { "name": "sort", "in": "query", "description": "Use this parameter to configure the order of the returned items. The time is based on when the buyer paid for the line item. Acceptable values:

If this parameter is omitted, its value defaults to RELEVANCE.

Default: RELEVANCE

", "required": false, "schema": { "type": "string" } }, { "name": "transaction_id", "in": "query", "description": "Use this field to limit feedback entries to those associated with the specified transaction ID.", "required": false, "schema": { "type": "string" } }, { "name": "user_id", "in": "query", "description": "Use this field to specify the unique identifier user ID (eBay username of the user) of the account for which feedback is being retrieved.

Note: Both usernames and public user IDs will be accepted in this field. For more information, please refer to Data Handling Compliance.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetFeedbackResponse" } } } }, "400": { "description": "Bad Request", "x-response-codes": { "errors": { "501000": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Username request parameter is required or is invalid." }, "501001": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Feedback type request parameter is required or invalid. Must be FEEDBACK_RECEIVED or FEEDBACK_SENT." }, "501002": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Unsupported request parameter combination." }, "501003": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Listing id request parameter is invalid." }, "501025": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Input user role value is invalid." }, "501035": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Invalid sort type value. Must be RELEVANCE or TIME." }, "501036": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Invalid overall rating value. Must be POSITIVE, NEUTRAL, or NEGATIVE." }, "501037": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Invalid period value. Must be 30, 60, or 365." }, "501038": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Invalid topics value. Must be from the allowed topics list." }, "501039": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Feedback not found for the given request parameters." } } } }, "401": { "description": "Not Authorized", "x-response-codes": { "errors": { "1001": { "domain": "API_FEEDBACK", "category": "APPLICATION", "description": "Invalid access token. Check the value of the Authorization HTTP request header." } } } }, "500": { "description": "Internal Server Error", "x-response-codes": { "errors": { "2003": { "domain": "API_FEEDBACK", "category": "APPLICATION", "description": "There was a problem with an eBay internal system or process. Contact eBay developer support for assistance." } } } } }, "security": [ { "api_auth": [ "https://api.ebay.com/oauth/api_scope/commerce.feedback", "https://api.ebay.com/oauth/api_scope/commerce.feedback.readonly" ] } ] }, "post": { "tags": [ "feedback" ], "description": "This method creates and submits feedback to the user's order partner for a line item in the order. For each order, the order partner is the other participant in the transaction, either the buyer or seller, depending on the eBay user associated with the user token. This method allows users to provide detailed information about the transaction, including the feedback rating, comments, and seller delivery. You can also add images to your feedback.

Note: A seller can only provide a comment for a buyer, but a buyer can provide a comment plus provides ratings on a number of metrics for a seller.

Note: The feedback must adhere to community guidelines and be relevant to the transaction.

When leaving feedback, keep the following in mind:

For additional information on leaving feedback, see the following:

A successful call to this method returns a feedback ID, which is a unique identifier for the newly created feedback and allows for reference and tracking.

", "operationId": "leaveFeedback", "parameters": [ { "name": "Content-Type", "in": "header", "description": "This header indicates the format of the request body provided by the client. Its value should be set to application/json.

For more information, refer to HTTP request headers.", "required": true, "schema": { "type": "string" } } ], "requestBody": { "description": "Request body for leaving feedback. Required fields: commentText (the text of the feedback comment), commentType (acceptable values - [POSITIVE, NEUTRAL, NEGATIVE]), listingId (the listingId of the item the feedback is being left for), transactionId (the transactionId for the order), orderLineItemId (Search by order line item ID. order line item id is a concatenation of listing ID and transaction ID, joined by `-`. Ex `listing_id-transaction_id`), sellerRatings (array of ratings with keys - [ON_TIME_DELIVERY, ITEM_AS_DESCRIBED, COMMUNICATION, SHIPPING_CHARGES, SHIPPING_TIME]), images (array of images with url field, can add upto 5 images)", "content": { "application/json": { "schema": { "description": "Request body for leaving feedback. Required fields: commentText (the text of the feedback comment), commentType (acceptable values - [POSITIVE, NEUTRAL, NEGATIVE]), listingId (the listingId of the item the feedback is being left for), transactionId (the transactionId for the order), orderLineItemId (Search by order line item ID. order line item id is a concatenation of listing ID and transaction ID, joined by `-`. Ex `listing_id-transaction_id`), sellerRatings (array of ratings with keys - [ON_TIME_DELIVERY, ITEM_AS_DESCRIBED, COMMUNICATION, SHIPPING_CHARGES, SHIPPING_TIME]), images (array of images with url field, can add upto 5 images)", "$ref": "#/components/schemas/LeaveFeedbackRequest" } } }, "required": false }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LeaveFeedbackResponse" } } } }, "400": { "description": "Bad Request", "x-response-codes": { "errors": { "501003": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Listing id request parameter is invalid." }, "501004": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Transaction id request parameter is invalid." }, "501005": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Comment text request parameter is invalid." }, "501006": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Comment type request parameter is invalid." }, "501007": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Seller ratings are not valid type." }, "501013": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Comment text is too long, maximum length is 500 characters." }, "501014": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Comment text value is invalid." }, "501015": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Comment text contains profanity." }, "501016": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Seller ratings value is invalid." }, "501017": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Seller ratings type is not supported for this provider role." }, "501018": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Item rating type is invalid." }, "501019": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "On time delivery rating value is invalid." }, "501034": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Only 5 images can be attached to a feedback." } } } }, "401": { "description": "Not Authorized", "x-response-codes": { "errors": { "1001": { "domain": "API_FEEDBACK", "category": "APPLICATION", "description": "Invalid access token. Check the value of the Authorization HTTP request header." } } } }, "409": { "description": "Conflict", "x-response-codes": { "errors": { "501008": { "domain": "API_FEEDBACK", "category": "BUSINESS", "description": "Feedback already left for this listing." }, "501009": { "domain": "API_FEEDBACK", "category": "BUSINESS", "description": "Leaving feedback for this listing is blocked due to policy, please contact eBay support." }, "501010": { "domain": "API_FEEDBACK", "category": "BUSINESS", "description": "Feedback receiver is not eligible to receive feedback." }, "501011": { "domain": "API_FEEDBACK", "category": "BUSINESS", "description": "Feedback provider is not eligible to leave feedback." }, "501012": { "domain": "API_FEEDBACK", "category": "BUSINESS", "description": "Feedback provider is relatively new to eBay. Provider should be at least 5 days on ebay." }, "501020": { "domain": "API_FEEDBACK", "category": "BUSINESS", "description": "Seller cannot leave negative or neutral feedback." }, "501021": { "domain": "API_FEEDBACK", "category": "BUSINESS", "description": "Seller cannot receive negative or neutral feedback." } } } }, "500": { "description": "Internal Server Error", "x-response-codes": { "errors": { "2003": { "domain": "API_FEEDBACK", "category": "APPLICATION", "description": "There was a problem with an eBay internal system or process. Contact eBay developer support for assistance." } } } } }, "security": [ { "api_auth": [ "https://api.ebay.com/oauth/api_scope/commerce.feedback" ] } ] } }, "/feedback_rating_summary": { "get": { "tags": [ "feedback_rating_summary" ], "description": "This method provides a detailed overview of feedback ratings associated with a user in the eBay marketplace. Specify a user ID and apply filters to retrieve summarized feedback data categorized by rating types and user roles. These returned metrics are aggregated, which offers insight into user experiences and performance.

Tip: You can use this method to help sellers and buyers understand their marketplace reputation and identify areas for improvement.

Returned data provides a summary of feedback ratings for a user by rating type (such as overall experience, communication, or delivery timeliness) for both buyer and seller roles. Each type of rating includes aggregated metrics like averages, counts, unique feedback givers, and the percentage of positive ratings (excluding neutrals). The response also details the distribution of specific rating values, their frequency, and time period (with period units like days or months) over which these metrics were calculated.

", "operationId": "getFeedbackRatingSummary", "parameters": [ { "name": "filter", "in": "query", "description": "Use this parameter to limit the response based on specified filter values:

You can send the filter as a query parameter, either with the required ratingType only, or combining the filter values with a comma-separated name:value list. For example:

filter=ratingType:OVERALL_EXPERIENCE,excludeRepeatFeedback:true,period:365

", "required": true, "schema": { "type": "string" } }, { "name": "user_id", "in": "query", "description": "Use this parameter to specify the unique identifier (the eBay username associated with the account) for the eBay user whose feedback summary is being retrieved.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetFeedbackRatingSummaryResponse" } } } }, "400": { "description": "Bad Request", "x-response-codes": { "errors": { "501002": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Unsupported request parameter combination." }, "501007": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Seller ratings are not valid type." }, "501022": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Rating type request parameter is invalid." }, "501037": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Invalid period value. Must be 30, 60, or 365." } } } }, "401": { "description": "Not Authorized", "x-response-codes": { "errors": { "1001": { "domain": "API_FEEDBACK", "category": "APPLICATION", "description": "Invalid access token. Check the value of the Authorization HTTP request header." } } } }, "404": { "description": "Not Found", "x-response-codes": { "errors": { "501023": { "domain": "API_FEEDBACK", "category": "APPLICATION", "description": "Feedback rating summary user not found." } } } }, "500": { "description": "Internal Server Error", "x-response-codes": { "errors": { "2003": { "domain": "API_FEEDBACK", "category": "APPLICATION", "description": "There was a problem with an eBay internal system or process. Contact eBay developer support for assistance." } } } } }, "security": [ { "api_auth": [ "https://api.ebay.com/oauth/api_scope/commerce.feedback", "https://api.ebay.com/oauth/api_scope/commerce.feedback.readonly" ] } ] } }, "/respond_to_feedback": { "post": { "tags": [ "respond_to_feedback" ], "description": "This method allows users to respond to feedback provided by the order partner for a specific line item in an order. For each order, the order partner is the other participant in the transaction, either the buyer or seller, depending on the eBay user associated with the user token. This method allows the user to provide additional context or address the order partner's feedback.

Note: The feedback response must adhere to community guidelines and be relevant to the transaction.

You can only use this method if feedback has been provided by the order partner and you have not yet responded to it.

When responding to feedback, your feedback score is not affected when you respond to feedback.

For additional information on leaving feedback, see the following:

A successful call returns an HTTP status of 200 Success.

", "operationId": "respondToFeedback", "parameters": [ { "name": "Content-Type", "in": "header", "description": "This header indicates the format of the request body provided by the client. Its value should be set to application/json.

For more information, refer to HTTP request headers.", "required": true, "schema": { "type": "string" } } ], "requestBody": { "description": "This provides the request body for responding to feedback.", "content": { "application/json": { "schema": { "description": "This provides the request body for responding to feedback.", "$ref": "#/components/schemas/RespondToFeedbackRequest" } } }, "required": false }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad Request", "x-response-codes": { "errors": { "501013": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Comment text is too long, maximum length is 500 characters." }, "501014": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Comment text value is invalid." }, "501015": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Comment text contains profanity." }, "501026": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Feedback ID request parameter is required or is invalid." }, "501027": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Response type request parameter is required or is invalid. Must be REPLY or FOLLOW_UP." }, "501028": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Response text request parameter is required." }, "501029": { "domain": "API_FEEDBACK", "category": "REQUEST", "description": "Recipient user ID request parameter is required." } } } }, "401": { "description": "Not Authorized", "x-response-codes": { "errors": { "1001": { "domain": "API_FEEDBACK", "category": "APPLICATION", "description": "Invalid access token. Check the value of the Authorization HTTP request header." } } } }, "403": { "description": "Forbidden", "x-response-codes": { "errors": { "501031": { "domain": "API_FEEDBACK", "category": "BUSINESS", "description": "Reply not allowed for automated feedback." } } } }, "409": { "description": "Conflict", "x-response-codes": { "errors": { "501011": { "domain": "API_FEEDBACK", "category": "BUSINESS", "description": "Feedback provider is not eligible to leave feedback." }, "501032": { "domain": "API_FEEDBACK", "category": "BUSINESS", "description": "Reply already left for feedback." }, "501033": { "domain": "API_FEEDBACK", "category": "BUSINESS", "description": "Follow up comment already left for feedback." } } } }, "500": { "description": "Internal Server Error", "x-response-codes": { "errors": { "2003": { "domain": "API_FEEDBACK", "category": "APPLICATION", "description": "There was a problem with an eBay internal system or process. Contact eBay developer support for assistance." } } } } }, "security": [ { "api_auth": [ "https://api.ebay.com/oauth/api_scope/commerce.feedback" ] } ] } } }, "components": { "schemas": { "AwaitingFeedback": { "type": "object", "properties": { "listingId": { "type": "string", "description": "This is the unique identifier for the listing associated with the line item. It is used to reference the specific listing for which feedback is being awaited." }, "listingPrice": { "description": "This container shows the sales price of the listing.", "$ref": "#/components/schemas/ListingPrice" }, "listingTitle": { "type": "string", "description": "The title of the listing." }, "orderLineItemId": { "type": "string", "description": "The unique identifier for the eBay order line item associated with the listing. It is used to pinpoint the exact line item for which feedback is being awaited." }, "ratingTemplates": { "type": "array", "description": "This array contains a list of available values for use in a particular rating, and whether the value is enabled. This is dependent on what seller ratings the buyer's order partner qualifies.

Note: Rating templates should only be returned to the user in their role as a buyer; only sellers have Detailed Seller Ratings (DSRs).

Use the metadata returned here when leaving DSR ratings through the leaveFeedback method. The key field in this container is the ratingKey field. See FeedbackRatingTypeEnum for its values. The other metadata returned in this container apply to each ratingKey value that is returned.

", "items": { "$ref": "#/components/schemas/FeedbackRatingTemplateType" } }, "transactionId": { "type": "string", "description": "The unique identifier of the sales transaction." } }, "description": "This type contains the details for each line item awaiting feedback." }, "AwaitingFeedbackResponse": { "type": "object", "properties": { "itemsAwaitingFeedbackCount": { "description": "This container returns the number of line items awaiting feedback. The asSeller and asBuyer fields return the total count of items awaiting feedback as seller and buyer and are not affected by the userRole filter.", "$ref": "#/components/schemas/ItemsAwaitingFeedbackCount" }, "lineItems": { "type": "array", "description": "This array contains the details for each line item awaiting feedback. An empty array is returned if no line items are awaiting feedback or that match the filter criteria.", "items": { "$ref": "#/components/schemas/AwaitingFeedback" } }, "pagination": { "description": "This container provides pagination information for the returned line items awaiting feedback (as filtered).", "$ref": "#/components/schemas/Pagination" } }, "description": "This type defines the fields for the getItemsAwaitingFeedback response." }, "Comment": { "type": "object", "properties": { "commentPeriod": { "description": "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:
", "$ref": "#/components/schemas/CommentCommentPeriod" }, "commentText": { "type": "string", "description": "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." }, "commentTextRemovedPerPolicy": { "type": "boolean", "description": "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." }, "state": { "type": "string", "description": "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. For implementation help, refer to eBay API documentation" } }, "description": "This type provides the details of the feedback comment left by the user." }, "CommentCommentPeriod": { "type": "object", "properties": { "unit": { "type": "string", "description": "Unit of time for the value. Supported values: DAY, or YEAR." }, "value": { "type": "integer", "description": "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.

", "format": "int32" } }, "description": "This type provides fields that descrbes timing associated with the comment." }, "Error": { "type": "object", "properties": { "category": { "type": "string", "description": "Identifies the type of erro." }, "domain": { "type": "string", "description": "Name for the primary system where the error occurred. This is relevant for application errors." }, "errorId": { "type": "integer", "description": "A unique number to identify the error.", "format": "int32" }, "inputRefIds": { "type": "array", "description": "An array of request elements most closely associated to the error.", "items": { "type": "string" } }, "longMessage": { "type": "string", "description": "A more detailed explanation of the error." }, "message": { "type": "string", "description": "Information on how to correct the problem, in the end user's terms and language where applicable." }, "outputRefIds": { "type": "array", "description": "An array of request elements most closely associated to the error.", "items": { "type": "string" } }, "parameters": { "type": "array", "description": "An array of name/value pairs that describe details the error condition. These are useful when multiple errors are returned.", "items": { "$ref": "#/components/schemas/ErrorParameter" } }, "subdomain": { "type": "string", "description": "Further helps indicate which subsystem the error is coming from. System subcategories include: Initialization, Serialization, Security, Monitoring, Rate Limiting, etc." } }, "description": "This type defines the fields that can be returned in an error." }, "ErrorParameter": { "type": "object", "properties": { "name": { "type": "string", "description": "The object of the error." }, "value": { "type": "string", "description": "The value of the object." } } }, "FeedbackDetail": { "type": "object", "properties": { "automatedFeedback": { "type": "boolean", "description": "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.

" }, "commentType": { "type": "string", "description": "This enumerated value indicates the type of feedback: POSITIVE, NEUTRAL, NEGATIVE.

Note: Sellers can only leave positive feedback for buyers.

For implementation help, refer to eBay API documentation" }, "eligibleForRevision": { "type": "boolean", "description": "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." }, "feedbackComment": { "description": "This container provides the feedback comment left by a user when submitting feedback for a seller or buyer.", "$ref": "#/components/schemas/Comment" }, "feedbackEnteredDate": { "type": "string", "description": "The timestamp when the feedback was submitted." }, "feedbackEnteredPeriod": { "description": "This container represents the duration since feedback was entered, expressed as a numeric value and a unit of time in days.", "$ref": "#/components/schemas/FeedbackEnteredPeriod" }, "feedbackId": { "type": "string", "description": "The unique identifier of the feedback entry." }, "feedbackRatings": { "type": "array", "description": "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).

", "items": { "$ref": "#/components/schemas/FeedbackRating" } }, "feedbackScore": { "type": "integer", "description": "The feedback receiver's feedback score after receiving this specific feedback.", "format": "int32" }, "feedbackState": { "type": "string", "description": "This enumerated value indicates the current state of the feedback entry (for example, ENTERED). For implementation help, refer to eBay API documentation" }, "followupComment": { "description": "This container provides the details of any follow-up comment left.

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

", "$ref": "#/components/schemas/Comment" }, "hasImages": { "type": "boolean", "description": "If returned as true, this boolean indicates that the feedback entry has one or more images attached. If false, there are no images attached." }, "images": { "type": "array", "description": "This array contains the list of attached images.", "items": { "$ref": "#/components/schemas/Image" } }, "orderLineItemSummary": { "description": "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.

", "$ref": "#/components/schemas/OrderLineItemSummary" }, "providerUserDetail": { "description": "This container details the attributes of the user who provided the feedback.", "$ref": "#/components/schemas/ProviderUserDetail" }, "repliedBeforeFollowup": { "type": "boolean", "description": "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." }, "replyComment": { "description": "This container provides the details of any reply to the feedback.

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

", "$ref": "#/components/schemas/Comment" }, "topics": { "type": "array", "description": "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.

", "items": { "$ref": "#/components/schemas/Topic" } } }, "description": "This type provides attributes for returned feedback entries." }, "FeedbackEnteredPeriod": { "type": "object", "properties": { "unit": { "type": "string", "description": "The unit for the feedback entry period's value. Supported value: DAY." }, "value": { "type": "integer", "description": "The value for the feedback entry period, specified in units of unit. Supported values: 7, 30, 90, 180, or 365.", "format": "int32" } }, "description": "This type specifies the amount of time elapsed associated with a feedback entry." }, "FeedbackMetrics": { "type": "object", "properties": { "metricName": { "type": "string", "description": "This enumerated value specifies the type of feedback aggregation. For example, AVG would indicate the feedback returned represents the average value of the feedback. See metricValue for the value of the returned feedback. For implementation help, refer to eBay API documentation" }, "metricValue": { "type": "number", "description": "The decimal value of the specified metric. For example, 55.8 would represent a value associated with the metricName (see metricName for interpretation and units)." } }, "description": "This type provides fields for the array of metrics associated with feedback aggregation." }, "FeedbackRating": { "type": "object", "properties": { "ratingType": { "type": "string", "description": "This enumerated value indicates the type of rating (for example, OVERALL_EXPERIENCE, DSR_ITEM_AS_DESCRIBED). For implementation help, refer to eBay API documentation" }, "value": { "type": "string", "description": "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." } }, "description": "This type provides for fields in ratings attached to feedback." }, "FeedbackRatingAcceptableValue": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "If true, this boolean indicates that this value is enabled and selectable." }, "value": { "type": "string", "description": "The value that can be selected for feedback. For most ratingType values, this is 1 through 5, with 1 representing the lowest rating and 5 representing the highest rating. For ratingType of OVERALL_EXPERIENCE, this can be POSITIVE, NEGATIVE, and NEUTRAL. These are the same values as used with the leaveFeedback methods." }, "valueLabel": { "type": "string", "description": "This field provides information about the corresponding value." } }, "description": "This type provides fields for available values for use in a particular rating, and whether the value is enabled." }, "FeedbackRatingSummary": { "type": "object", "properties": { "ratingSummaryByRatingType": { "type": "array", "description": "An array that includes metrics and distributions for each rating type.", "items": { "$ref": "#/components/schemas/RatingSummaryByRatingType" } }, "ratingType": { "type": "string", "description": "This enumerated value indicates the type of rating being summarized. For example, OVERALL_EXPERIENCE indicates the rating applies to the overall transaction experience. For implementation help, refer to eBay API documentation" } }, "description": "This type provides fields for an array containing a summary of feedback ratings. Each element provides detailed metrics and distributions for specific rating types." }, "FeedbackRatingTemplateType": { "type": "object", "properties": { "acceptableValues": { "type": "array", "description": "This array contains a list of available values for use in a particular rating, and whether the value is enabled. Provided if ratingValueType is RANGE or PREDEFINED.

The following is an example of a predefined list:

[
  {
    \"value\": \"POSITIVE\",
    \"valueLabel\": \"Positive\",
    \"enabled\": true
  },
  {
    \"value\": \"NEUTRAL\",
    \"valueLabel\": \"Neutral\",
    \"enabled\": true
  },
  {
    \"value\": \"NEGATIVE\",
    \"valueLabel\": \"Negative\",
    \"enabled\": true
  }
]
For other examples, see the Using rating templates.", "items": { "$ref": "#/components/schemas/FeedbackRatingAcceptableValue" } }, "defaultValue": { "type": "string", "description": "The default value preselected for the rating, if set." }, "earlyFeedbackMessage": { "type": "string", "description": "For eligible sellers, a message may be shown requiring a wait period before you can leave neutral or negative feedback." }, "enabled": { "type": "boolean", "description": "If returned as true, this boolean indicates that the corresponding feedback rating template is enabled for the user to provide feedback for this line item. This value will generally be true when the user role is a buyer, but false when the user role is a seller because buyers do not have Detailed Seller Ratings (DSRs)." }, "maximumCharactersAllowed": { "type": "integer", "description": "The maximum number of characters allowed to be used for a rating that uses free text. It is only applicable for a rating whose ratingValueType is FREETEXT.

Maximum: 500

", "format": "int32" }, "multiValueRating": { "type": "boolean", "description": "If returned as true, multiple values can be specified for the rating." }, "ratingKey": { "type": "string", "description": "This enumerated value indicates the type of rating that is tracked for the seller. All of the metadata returned under each node for the ratingTemplates array will apply to this rating type. For example, the value OVERALL_EXPERIENCE indicates the rating is for the overall transaction experience. For implementation help, refer to eBay API documentation" }, "ratingLabel": { "type": "string", "description": "This field provides more details about and/or provides guidance on the corresponding rating type. For example, the rating label of Rate this transaction describes the feedback for the user to enter for an OVERALL_EXPERIENCE ratingKey." }, "ratingValueType": { "type": "string", "description": "This enumerated value indicates the type of data used to provide the specific feedback rating.

If set to PREDEFINED or RANGE, is returned here, more information on the supported values will be returned under the acceptableValues array. If FREETEXT is returned here, the maximum number of characters supported can be seen in the maximumCharactersAllowed field.

For implementation help, refer to eBay API documentation" }, "required": { "type": "boolean", "description": "If returned as true, this rating type is required when leaving feedback." } }, "description": "This type defines fields for user feedback collection, including acceptable values, a default preselection value, and an early feedback message. It also provides fields to enable the template, and limits and options for freetext character, multi-value rating, and other similar features." }, "FeedbackRatingValueDistribution": { "type": "object", "properties": { "count": { "type": "integer", "description": "An integer representing the number of occurrences for a specific feedback rating value. For example, for the POSITIVE value, a 3 returned as the count represents three positive ratings were returned.", "format": "int32" }, "value": { "type": "string", "description": "A string indicating the specific feedback rating value. Supported values include: POSITIVE, NEUTRAL, NEGATIVE, 1, 2, 3, 4, and 5." } }, "description": "This type provides field for an array listing the distribution values of the feedback ratings." }, "GetFeedbackRatingSummaryResponse": { "type": "object", "properties": { "feedbackRatingSummary": { "type": "array", "description": "An array containing a summary of feedback ratings. Each element provides detailed metrics and distributions for specific rating types.", "items": { "$ref": "#/components/schemas/FeedbackRatingSummary" } } }, "description": "This type defines the fields for the getFeedbackRatingSummary response." }, "GetFeedbackResponse": { "type": "object", "properties": { "feedbackEntries": { "type": "array", "description": "This array contains a list of feedback entries that meet the specified criteria.", "items": { "$ref": "#/components/schemas/FeedbackDetail" } }, "pagination": { "description": "This container provides pagination information for the returned feedback response (as filtered).", "$ref": "#/components/schemas/Pagination" } }, "description": "This type defines the fields for the getFeedback response." }, "Image": { "type": "object", "properties": { "url": { "type": "string", "description": "This field provides the URL of an attached image and is included in the response whenever an image is attached." } }, "description": "This type provides a field for image URLs." }, "ItemsAwaitingFeedbackCount": { "type": "object", "properties": { "asBuyer": { "type": "integer", "description": "The number of line items for which feedback is pending from the user in the buyer role.", "format": "int32" }, "asSeller": { "type": "integer", "description": "The number of line items for which feedback is pending from the user in the seller role.", "format": "int32" } }, "description": "This type returns the number of line items awaiting feedback." }, "LeaveFeedbackRequest": { "type": "object", "properties": { "commentText": { "type": "string", "description": "Use this field to provide the feedback left by the user, describing their experience with the line item of the transaction. No HTML formatting or personal information (such as phone numbers) is permitted.

Maximum length: 500 characters

" }, "commentType": { "type": "string", "description": "Set this enumerated value to indicate the overall rating of the transaction: POSITIVE, NEUTRAL, or NEGATIVE.

Note: Sellers can only provide positive feedback.

For implementation help, refer to eBay API documentation" }, "images": { "type": "array", "description": "Use this array to optionally list up to 5 images attached to the feedback.", "items": { "$ref": "#/components/schemas/Image" } }, "listingId": { "type": "string", "description": "Use this field to provide the listing ID related to the transaction." }, "orderLineItemId": { "type": "string", "description": "Use this field to provide the unique identifier of the line item for this feedback." }, "sellerRatings": { "type": "array", "description": "Use this array to list ratings for specific aspects of the seller's performance.", "items": { "$ref": "#/components/schemas/SellerRating" } }, "transactionId": { "type": "string", "description": "Use this field to provide the unique identifier of the transaction for this feedback." } }, "description": "This type provides fields available to leave feedback in the leaveFeedback request." }, "LeaveFeedbackResponse": { "type": "object", "properties": { "feedbackId": { "type": "string", "description": "The unique ID assigned to the submitted feedback." } }, "description": "This type defines the fields for the leaveFeedback response for feedback that has been left." }, "ListingPrice": { "type": "object", "properties": { "currency": { "type": "string", "description": "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." }, "value": { "type": "number", "description": "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." } }, "description": "This type provides details about the price of the listing awaiting feedback." }, "OrderLineItemAttribute": { "type": "object", "properties": { "name": { "type": "string", "description": "This enumerated value indicates an attribute of the line item. The value field indicates if the attribute applies. For implementation help, refer to eBay API documentation" }, "value": { "type": "string", "description": "If returned as true, the line item attribute name applies; if returned as false, the attribute does not apply." } }, "description": "This type describes line item attributes." }, "OrderLineItemSummary": { "type": "object", "properties": { "listingId": { "type": "string", "description": "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." }, "listingPrice": { "description": "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.", "$ref": "#/components/schemas/ListingPrice" }, "listingTitle": { "type": "string", "description": "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." }, "orderLineItemAttributes": { "type": "array", "description": "This array describes order line attributes including names and values of a transaction.", "items": { "$ref": "#/components/schemas/OrderLineItemAttribute" } }, "orderLineItemId": { "type": "string", "description": "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." }, "transactionPeriod": { "description": "This container indicates if the time since the item was bought on ebay is less than, more than, or equal to 90 days", "$ref": "#/components/schemas/TransactionPeriod" } }, "description": "This type provides fields for a summary of the line item related to feedback." }, "Pagination": { "type": "object", "properties": { "count": { "type": "integer", "description": "This value indicates the number of feedback entries on the current response page.", "format": "int32" }, "limit": { "type": "integer", "description": "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

", "format": "int32" }, "next": { "type": "string", "description": "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." }, "offset": { "type": "integer", "description": "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

", "format": "int32" }, "prev": { "type": "string", "description": "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.

" }, "total": { "type": "integer", "description": "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.

", "format": "int32" } }, "description": "This type provides pagination information for the returned line items." }, "Period": { "type": "object", "properties": { "unit": { "type": "string", "description": "The unit of the period's value. Supported value: DAY." }, "value": { "type": "integer", "description": "The value for the feedback period, specified in units of unit. Supported value: 90.", "format": "int32" } }, "description": "This type provides fields for the time period on which the feedback summary is calculated." }, "ProviderUserDetail": { "type": "object", "properties": { "feedbackScore": { "type": "integer", "description": "This integer indicates the feedback score of the feedback provider at the time of providing this specific feedback.", "format": "int32" }, "feedbackStar": { "type": "string", "description": "This enumerated value provides the visual star representation of the feedback score (for example, YELLOW_STAR). For implementation help, refer to eBay API documentation" }, "role": { "type": "string", "description": "This enumerated value indicates the user's role in the transaction (BUYER or SELLER). For implementation help, refer to eBay API documentation" }, "userAttributes": { "type": "array", "description": "This array lists additional attributes that relate to the user (such as verification status).", "items": { "$ref": "#/components/schemas/ProviderUserDetailUserAttributes" } }, "userId": { "type": "string", "description": "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." } }, "description": "This type provides the details of the user who provided the feedback of a getFeedback response." }, "ProviderUserDetailUserAttributes": { "type": "object", "properties": { "name": { "type": "string", "description": "This enumerated value indicates an attribute of the user (for example, USER_VERIFIED). The value field indicates if the attribute applies. For implementation help, refer to eBay API documentation" }, "value": { "type": "string", "description": "If returned as true, the user attribute name applies; if returned as false, the attribute does not apply." } }, "description": "This type defines the attributes of the user who provided the feedback of a getFeedback response." }, "RatingSummaryByRatingType": { "type": "object", "properties": { "feedbackMetrics": { "type": "array", "description": "An array of metrics associated with feedback aggregation.", "items": { "$ref": "#/components/schemas/FeedbackMetrics" } }, "feedbackRatingValueDistribution": { "type": "array", "description": "An array listing the distribution values of the feedback ratings.", "items": { "$ref": "#/components/schemas/FeedbackRatingValueDistribution" } }, "period": { "description": "The time period on which the feedback summary is calculated.", "$ref": "#/components/schemas/Period" }, "userRoleType": { "type": "string", "description": "This enumerated value indicates the user's role in the feedback (BUYER or SELLER). For implementation help, refer to eBay API documentation" } }, "description": "This type provides fields for an array that includes metrics and distributions for each rating type." }, "RespondToFeedbackRequest": { "type": "object", "properties": { "feedbackId": { "type": "string", "description": "Use this field to provide the unique identifier for the feedback being responded to, used to specify the feedback entry associated with the feedback response. This value can be returned using the getFeedback method (feedbackId field)." }, "recipientUserId": { "type": "string", "description": "Use this field to provide the identifier of the user who provided the original feedback. This value can be returned using the getFeedback method (userId field).

Note: Both usernames and public user IDs will be accepted in this field. For more information, please refer to Data Handling Compliance." }, "responseText": { "type": "string", "description": "Use this field to provide the text content of the response. This field is used to provide additional context or address the feedback given by the order partner. No HTML formatting or personal information (such as phone numbers) is permitted.

Maximum length: 500 characters." }, "responseType": { "type": "string", "description": "Set this enumerated value to describe the type of response being submitted (for example, a REPLY or a FOLLOW_UP). For implementation help, refer to eBay API documentation" } }, "description": "The type that defines the fields for the respondToFeedback request." }, "SellerRating": { "type": "object", "properties": { "key": { "type": "string", "description": "The enumerated value of the category being rated, such as delivery timeliness (ON_TIME_DELIVERY). For implementation help, refer to eBay API documentation" }, "value": { "type": "string", "description": "The value assigned for the selected category. Use a value of 1 through 5, with the 1 being the lowest rating and 5 being the highest." } }, "description": "This type provides fields for specific aspects of the seller's performance." }, "Topic": { "type": "object", "properties": { "coarseTopic": { "type": "string", "description": "The main topic (or category) detected in the comment. See the available topics in filter." }, "fineTopic": { "type": "string", "description": "

Note: Fine topics are not currently supported.

A more specific detail or subtopic related to the coarse topic. " }, "highlightedTexts": { "type": "array", "description": "This array lists any text snippets, phrases, or examples, from the feedback that supports the detected topic.", "items": { "type": "string" } }, "sentiment": { "type": "string", "description": "This field indicates a classification of the feedback, whether the feedback is Positive, Negative, or Neutral." } }, "description": "This type provides subject-based fields derived from feedback." }, "TransactionPeriod": { "type": "object", "properties": { "period": { "description": "This container indicates if the time since the item was bought on ebay is less than, more than, or equal to 90 days.", "$ref": "#/components/schemas/Period" }, "thresholdType": { "type": "string", "description": "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. For implementation help, refer to eBay API documentation" } }, "description": "This type specifies the amount of time elapsed and the threshold associated with a transaction." } }, "securitySchemes": { "api_auth": { "type": "oauth2", "description": "The security definitions for this API. Please check individual operations for applicable scopes.", "flows": {} } } } }