ebay-mcp 1.4.3

package/build/types/sell-apps/communication/commerceFeedbackV1BetaOas3.d.ts

@@ -0,0 +1,705 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    '/awaiting_feedback': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @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.<p>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. </p><p>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.</p><p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>Detailed seller ratings are for sellers only, and are created from buyer feedback.</span></p> */
+        get: operations['getItemsAwaitingFeedback'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/feedback': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @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.<p>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 (<code>filterImage:true</code>), 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.</p><p>Sorting and pagination features help organize and navigate returned items efficiently.</p><p>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 <a href="/api-docs/commerce/feedback/resources/feedback/methods/getFeedback#uri.filter" >filter</a> 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.</p> */
+        get: operations['getFeedback'];
+        put?: never;
+        /** @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.<p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>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.</span></p> <p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>The feedback must adhere to community guidelines and be relevant to the transaction.</span></p> <p>When leaving feedback, keep the following in mind:<ul><li>Your feedback score is not affected when you leave feedback</li><li>Feedback can only be revised once after it is submitted</li></ul></p><p>For additional information on leaving feedback, see the following:<ul><li><a href="https://www.ebay.com/help/buying/leaving-feedback-sellers/leaving-feedback-sellers?id=4007"  target="_blank">Leaving feedback for sellers</a></li><li><a href="https://www.ebay.com/help/selling/leaving-feedback-buyers/leaving-feedback-buyers?id=4078"  target="_blank">Leaving feedback for buyers</a></li></ul></p><p>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. </p> */
+        post: operations['leaveFeedback'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/feedback_rating_summary': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @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. <p class="msgbox_tipInDiv" ><div class="msgbox_tip"><span><b><span style="color: #478415;">Tip:</span></b></span></span> You can use this method to help sellers and buyers understand their marketplace reputation and identify areas for improvement.</div></p><p>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.</p> */
+        get: operations['getFeedbackRatingSummary'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/respond_to_feedback': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @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.<p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>The feedback response must adhere to community guidelines and be relevant to the transaction.</span></p><p>You can only use this method if feedback has been provided by the order partner and you have not yet responded to it. </p> <p>When responding to feedback, your feedback score is not affected when you respond to feedback.</p><p>For additional information on leaving feedback, see the following:<ul><li><a href="https://www.ebay.com/help/buying/leaving-feedback-sellers/leaving-feedback-sellers?id=4007"  target="_blank">Leaving feedback for sellers</a></li><li><a href="https://www.ebay.com/help/selling/leaving-feedback-buyers/leaving-feedback-buyers?id=4078"  target="_blank">Leaving feedback for buyers</a></li></ul></p><p>A successful call returns an HTTP status of <b>200 Success</b>.</p> */
+        post: operations['respondToFeedback'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /** @description This type contains the details for each line item awaiting feedback. */
+        AwaitingFeedback: {
+            /** @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. */
+            listingId?: string;
+            /** @description This container shows the sales price of the listing. */
+            listingPrice?: components['schemas']['ListingPrice'];
+            /** @description The title of the listing. */
+            listingTitle?: 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. */
+            orderLineItemId?: string;
+            /** @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.<br><p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>Rating templates should only be returned to the user in their role as a buyer; only sellers have Detailed Seller Ratings (DSRs). </span></p><p>Use the metadata returned here when leaving DSR ratings through the <b>leaveFeedback</b> method. The key field in this container is the <b>ratingKey</b> field. See <a href="/api-docs/commerce/feedback/types/fdb:FeedbackRatingTypeEnum" >FeedbackRatingTypeEnum</a> for its values. The other metadata returned in this container apply to each <b>ratingKey</b> value that is returned.</p> */
+            ratingTemplates?: components['schemas']['FeedbackRatingTemplateType'][];
+            /** @description The unique identifier of the sales transaction. */
+            transactionId?: string;
+        };
+        /** @description This type defines the fields for the <b>getItemsAwaitingFeedback</b> response. */
+        AwaitingFeedbackResponse: {
+            /** @description This container returns the number of line items awaiting feedback. The <b>asSeller</b> and <b>asBuyer</b> fields return the total count of items awaiting feedback as seller and buyer and are not affected by the <b>userRole</b> filter. */
+            itemsAwaitingFeedbackCount?: components['schemas']['ItemsAwaitingFeedbackCount'];
+            /** @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. */
+            lineItems?: components['schemas']['AwaitingFeedback'][];
+            /** @description This container provides pagination information for the returned line items awaiting feedback (as filtered). */
+            pagination?: components['schemas']['Pagination'];
+        };
+        /** @description This type provides the details of the feedback comment left by the user. */
+        Comment: {
+            /** @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: <br><ul><li>Less than 30 days: 30 DAY</li> <li>Over 30 but less than 90 days: 90 DAY</li> <li>Over 90 but less than 180 days: 180 DAY</li> <li>Over 180 but less than 365 days: 365 DAY</li> <li>More than 365 days: 5 YEAR</li></ul> */
+            commentPeriod?: components['schemas']['CommentCommentPeriod'];
+            /** @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 '<code>--</code>' and the <b>commentTextRemovedPerPolicy</b> field will return <code>true</code>. */
+            commentText?: string;
+            /** @description If <code>true</code>, this boolean indicates the feedback follow-up or reply comment text was removed per eBay policy.  This field is only returned when a <b>followupComment</b> container is returned. */
+            commentTextRemovedPerPolicy?: boolean;
+            /** @description This enumerated value indicates the state of the feedback (for example, <code>ENTERED</code>). This can be the state of the feedback comment, the follow-up comment, or the reply comment. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:FeedbackCommentStateEnum'>eBay API documentation</a> */
+            state?: string;
+        };
+        /** @description This type provides fields that descrbes timing associated with the comment. */
+        CommentCommentPeriod: {
+            /** @description Unit of time for the <b>value</b>. Supported values: <code>DAY</code>, or <code>YEAR</code>. */
+            unit?: string;
+            /**
+             * Format: int32
+             * @description Value of the time period expressed in the period contained in the <b>unit</b>. Supported values: <code>30</code>, <code>60</code>, or <code>365</code>. <p>See the <a href="/api-docs/commerce/feedback/resources/feedback/methods/getFeedback#response.feedbackEntries.feedbackComment.commentPeriod">commentPeriod</a> container for more information.</p>
+             */
+            value?: number;
+        };
+        /** @description This type defines the fields that can be returned in an error. */
+        Error: {
+            /** @description Identifies the type of erro. */
+            category?: string;
+            /** @description Name for the primary system where the error occurred. This is relevant for application errors. */
+            domain?: string;
+            /**
+             * Format: int32
+             * @description A unique number to identify the error.
+             */
+            errorId?: number;
+            /** @description An array of request elements most closely associated to the error. */
+            inputRefIds?: string[];
+            /** @description A more detailed explanation of the error. */
+            longMessage?: string;
+            /** @description Information on how to correct the problem, in the end user's terms and language where applicable. */
+            message?: string;
+            /** @description An array of request elements most closely associated to the error. */
+            outputRefIds?: string[];
+            /** @description An array of name/value pairs that describe details the error condition. These are useful when multiple errors are returned. */
+            parameters?: components['schemas']['ErrorParameter'][];
+            /** @description Further helps indicate which subsystem the error is coming from. System subcategories include: Initialization, Serialization, Security, Monitoring, Rate Limiting, etc. */
+            subdomain?: string;
+        };
+        ErrorParameter: {
+            /** @description The object of the error. */
+            name?: string;
+            /** @description The value of the object. */
+            value?: string;
+        };
+        /** @description This type provides attributes for returned feedback entries. */
+        FeedbackDetail: {
+            /** @description If the returned value is <code>true</code>, 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. <br><p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>Detailed Seller Ratings (DSRs) are not provided by ebay, only a predefined comment and a positive rating.</span></p> */
+            automatedFeedback?: boolean;
+            /** @description This enumerated value indicates the type of feedback: <code>POSITIVE</code>, <code>NEUTRAL</code>, <code>NEGATIVE</code>. <br><p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>Sellers can only leave positive feedback for buyers.</span></p> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:FeedbackRatingValuesEnum'>eBay API documentation</a> */
+            commentType?: string;
+            /** @description This boolean indicates whether the feedback is eligible for revision. If returned as <code>true</code>, 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. */
+            eligibleForRevision?: boolean;
+            /** @description This container provides the feedback comment left by a user when submitting feedback for a seller or buyer. */
+            feedbackComment?: components['schemas']['Comment'];
+            /** @description The timestamp when the feedback was submitted. */
+            feedbackEnteredDate?: string;
+            /** @description This container represents the duration since feedback was entered, expressed as a numeric value and a unit of time in days. */
+            feedbackEnteredPeriod?: components['schemas']['FeedbackEnteredPeriod'];
+            /** @description The unique identifier of the feedback entry. */
+            feedbackId?: string;
+            /** @description This array contains a list of ratings attached to feedback.<br><p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>This array only applies to buyers feedback for sellers (sellers can only give positive feedback to buyers).</span></p> */
+            feedbackRatings?: components['schemas']['FeedbackRating'][];
+            /**
+             * Format: int32
+             * @description The feedback receiver's feedback score after receiving this specific feedback.
+             */
+            feedbackScore?: number;
+            /** @description This enumerated value indicates the current state of the feedback entry (for example, <code>ENTERED</code>). For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:FeedbackStateEnum'>eBay API documentation</a> */
+            feedbackState?: string;
+            /** @description This container provides the details of any follow-up comment left. <br><p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>A buyer leaves followup comments, and a seller leaves reply comments.</span></p> */
+            followupComment?: components['schemas']['Comment'];
+            /** @description If returned as <code>true</code>, this boolean indicates that the feedback entry has one or more images attached. If <code>false</code>, there are no images attached. */
+            hasImages?: boolean;
+            /** @description This array contains the list of attached images. */
+            images?: components['schemas']['Image'][];
+            /** @description This container provides a summary of the line item associated with the feedback entry. <p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>Certain fields within this container are returned only when the request uses the <b>Authorization code grant flow</b> (user access token) and the <b>user_id</b> matches the authenticated user. These fields are not returned when accessing a different <b>user_id</b> or when using the <b>Client credentials grant flow</b> (application access token). See <a href="#h3-oauth-scope">OAuth scope</a> for for details on the flows and required permissions.</span></p> */
+            orderLineItemSummary?: components['schemas']['OrderLineItemSummary'];
+            /** @description This container details the attributes of the user who provided the feedback. */
+            providerUserDetail?: components['schemas']['ProviderUserDetail'];
+            /** @description If returned as <code>true</code>, this boolean indicates the feedback reply was given by the seller before the follow-up comment was given buy the buyer. */
+            repliedBeforeFollowup?: boolean;
+            /** @description This container provides the details of any reply to the feedback.<br><p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>A buyer leaves followup comments, and a seller leaves reply comments.</span></p> */
+            replyComment?: components['schemas']['Comment'];
+            /** @description This array provides descriptions of AI-generated insights related to a feedback entry for the specified <a href="/api-docs/commerce/feedback/resources/feedback/methods/getFeedback#uri.filter" >filter</a> topic. The feedback provided is considered relevant to the requested <b>topic</b>. For example, when using the request parameter filter of <code>topics:product-satisfaction</code>, the returned array might be: <p><pre>{<br>  "coarseTopic" : "product-satisfaction",<br>  "highlightedTexts" : [<br>    "This machine is amazing",<br>    "Very happy with this purchase"<br>    ],<br>  "sentiment" : "Positive"<br>}</pre></p><p>If no topics exist for that feedback, an empty array is returned.</p> */
+            topics?: components['schemas']['Topic'][];
+        };
+        /** @description This type specifies the amount of time elapsed associated with a feedback entry. */
+        FeedbackEnteredPeriod: {
+            /** @description The unit for the feedback entry period's <b>value</b>. Supported value: <code>DAY</code>. */
+            unit?: string;
+            /**
+             * Format: int32
+             * @description The value for the feedback entry period, specified in units of <b>unit</b>. Supported values: <code>7</code>, <code>30</code>, <code>90</code>, <code>180</code>, or <code>365</code>.
+             */
+            value?: number;
+        };
+        /** @description This type provides fields for the array of metrics associated with feedback aggregation. */
+        FeedbackMetrics: {
+            /** @description This enumerated value specifies the type of feedback aggregation. For example, <code>AVG</code> would indicate the feedback returned represents the average value of the feedback. See <b>metricValue</b> for the value of the returned feedback. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:FeedbackAggregationTypeEnum'>eBay API documentation</a> */
+            metricName?: string;
+            /** @description The decimal value of the specified metric. For example, 55.8 would represent a value associated with the <b>metricName</b> (see <b>metricName</b> for interpretation and units). */
+            metricValue?: number;
+        };
+        /** @description This type provides for fields in ratings attached to feedback. */
+        FeedbackRating: {
+            /** @description This enumerated value indicates the type of rating (for example, <code>OVERALL_EXPERIENCE</code>, <code>DSR_ITEM_AS_DESCRIBED</code>). For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:FeedbackRatingTypeEnum'>eBay API documentation</a> */
+            ratingType?: string;
+            /** @description The value assigned to the rating, specified as a string representing a number from <code>1</code> to <code>5</code>, with <code>1</code> representing the lowest rating and <code>5</code> representing the highest rating. */
+            value?: string;
+        };
+        /** @description This type provides fields for available values for use in a particular rating, and whether the value is enabled. */
+        FeedbackRatingAcceptableValue: {
+            /** @description If <code>true</code>, this boolean indicates that this value is enabled and selectable. */
+            enabled?: boolean;
+            /** @description The value that can be selected for feedback. For most <b>ratingType</b> values, this is <code>1</code> through <code>5</code>, with <code>1</code> representing the lowest rating and <code>5</code> representing the highest rating. For <b>ratingType</b> of <code>OVERALL_EXPERIENCE</code>, this can be <code>POSITIVE</code>, <code>NEGATIVE</code>, and <code>NEUTRAL</code>. These are the same values as used with the <b>leaveFeedback</b> methods. */
+            value?: string;
+            /** @description This field provides information about the corresponding <b>value</b>. */
+            valueLabel?: string;
+        };
+        /** @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. */
+        FeedbackRatingSummary: {
+            /** @description An array that includes metrics and distributions for each rating type. */
+            ratingSummaryByRatingType?: components['schemas']['RatingSummaryByRatingType'][];
+            /** @description This enumerated value indicates the type of rating being summarized. For example, <code>OVERALL_EXPERIENCE</code> indicates the rating applies to the overall transaction experience. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:FeedbackRatingTypeEnum'>eBay API documentation</a> */
+            ratingType?: string;
+        };
+        /** @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. */
+        FeedbackRatingTemplateType: {
+            /** @description This array contains a list of available values for use in a particular rating, and whether the value is enabled. Provided if <b>ratingValueType</b> is <code>RANGE</code> or <code>PREDEFINED</code>.<p>The following is an example of a predefined list:<pre>[<br>  {<br>    "value": "POSITIVE",<br>    "valueLabel": "Positive",<br>    "enabled": true<br>  },<br>  {<br>    "value": "NEUTRAL",<br>    "valueLabel": "Neutral",<br>    "enabled": true<br>  },<br>  {<br>    "value": "NEGATIVE",<br>    "valueLabel": "Negative",<br>    "enabled": true<br>  }</br>]</pre>For other examples, see the <a href="/develop/guides-v2/communications/sell-communications-guide#using-rating-templates"  target="_blank">Using rating templates</a>. */
+            acceptableValues?: components['schemas']['FeedbackRatingAcceptableValue'][];
+            /** @description The default value preselected for the rating, if set. */
+            defaultValue?: string;
+            /** @description For eligible sellers, a message may be shown requiring a wait period before you can leave neutral or negative feedback. */
+            earlyFeedbackMessage?: string;
+            /** @description If returned as <code>true</code>, 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 <code>true</code> when the user role is a buyer, but <code>false</code> when the user role is a seller because buyers do not have Detailed Seller Ratings (DSRs). */
+            enabled?: boolean;
+            /**
+             * Format: int32
+             * @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 <b>ratingValueType</b> is <code>FREETEXT</code>. <p><b>Maximum: </b>500</p>
+             */
+            maximumCharactersAllowed?: number;
+            /** @description If returned as <code>true</code>, multiple values can be specified for the rating. */
+            multiValueRating?: boolean;
+            /** @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 <b>ratingTemplates</b> array will apply to this rating type. For example, the value <code>OVERALL_EXPERIENCE</code> indicates the rating is for the overall transaction experience. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:FeedbackRatingTypeEnum'>eBay API documentation</a> */
+            ratingKey?: string;
+            /** @description This field provides more details about and/or provides guidance on the corresponding rating type. For example, the rating label of <b>Rate this transaction</b> describes the feedback for the user to enter for an <code>OVERALL_EXPERIENCE</code> <b>ratingKey</b>. */
+            ratingLabel?: string;
+            /** @description This enumerated value indicates the type of data used to provide the specific feedback rating.<br><p>If set to <code>PREDEFINED</code> or <code>RANGE</code>, is returned here, more information on the supported values will be returned under the <b>acceptableValues</b> array. If <code>FREETEXT</code> is returned here, the maximum number of characters supported can be seen in the <b>maximumCharactersAllowed</b> field.</p> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:FeedbackRatingValueTypeEnum'>eBay API documentation</a> */
+            ratingValueType?: string;
+            /** @description If returned as <code>true</code>, this rating type is required when leaving feedback. */
+            required?: boolean;
+        };
+        /** @description This type provides field for an array listing the distribution values of the feedback ratings. */
+        FeedbackRatingValueDistribution: {
+            /**
+             * Format: int32
+             * @description An integer representing the number of occurrences for a specific feedback rating <b>value</b>. For example, for the <code>POSITIVE</code> <b>value</b>, a <code>3</code> returned as the <b>count</b> represents three positive ratings were returned.
+             */
+            count?: number;
+            /** @description A string indicating the specific feedback rating value. Supported values include: <code>POSITIVE</code>, <code>NEUTRAL</code>, <code>NEGATIVE</code>, <code>1</code>, <code>2</code>, <code>3</code>, <code>4</code>, and <code>5</code>. */
+            value?: string;
+        };
+        /** @description This type defines the fields for the <b>getFeedbackRatingSummary</b> response. */
+        GetFeedbackRatingSummaryResponse: {
+            /** @description An array containing a summary of feedback ratings. Each element provides detailed metrics and distributions for specific rating types. */
+            feedbackRatingSummary?: components['schemas']['FeedbackRatingSummary'][];
+        };
+        /** @description This type defines the fields for the <b>getFeedback</b> response. */
+        GetFeedbackResponse: {
+            /** @description This array contains a list of feedback entries that meet the specified criteria. */
+            feedbackEntries?: components['schemas']['FeedbackDetail'][];
+            /** @description This container provides pagination information for the returned feedback response (as filtered). */
+            pagination?: components['schemas']['Pagination'];
+        };
+        /** @description This type provides a field for image URLs. */
+        Image: {
+            /** @description This field provides the URL of an attached image and is included in the response whenever an image is attached. */
+            url?: string;
+        };
+        /** @description This type returns the number of line items awaiting feedback. */
+        ItemsAwaitingFeedbackCount: {
+            /**
+             * Format: int32
+             * @description The number of line items for which feedback is pending from the user in the buyer role.
+             */
+            asBuyer?: number;
+            /**
+             * Format: int32
+             * @description The number of line items for which feedback is pending from the user in the seller role.
+             */
+            asSeller?: number;
+        };
+        /** @description This type provides fields available to leave feedback in the <b>leaveFeedback</b> request. */
+        LeaveFeedbackRequest: {
+            /** @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.<br><p><b>Maximum length:</b> 500 characters</p> */
+            commentText?: string;
+            /** @description Set this enumerated value to indicate the overall rating of the transaction: <code>POSITIVE</code>, <code>NEUTRAL</code>, or <code>NEGATIVE</code>.<br><p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>Sellers can only provide positive feedback.</span></p> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:FeedbackRatingValuesEnum'>eBay API documentation</a> */
+            commentType?: string;
+            /** @description Use this array to optionally list up to 5 images attached to the feedback. */
+            images?: components['schemas']['Image'][];
+            /** @description Use this field to provide the listing ID related to the transaction. */
+            listingId?: string;
+            /** @description Use this field to provide the unique identifier of the line item for this feedback. */
+            orderLineItemId?: string;
+            /** @description Use this array to list ratings for specific aspects of the seller's performance. */
+            sellerRatings?: components['schemas']['SellerRating'][];
+            /** @description Use this field to provide the unique identifier of the transaction for this feedback. */
+            transactionId?: string;
+        };
+        /** @description This type defines the fields for the <b>leaveFeedback</b> response for feedback that has been left. */
+        LeaveFeedbackResponse: {
+            /** @description The unique ID assigned to the submitted feedback. */
+            feedbackId?: string;
+        };
+        /** @description This type provides details about the price of the listing awaiting feedback. */
+        ListingPrice: {
+            /** @description This field provides the three-letter <a href="https://www.iso.org/iso-4217-currency-codes.html"  target="_blank">ISO 4217</a> code that represents the currency of the amount in the value field. Both the <b>value</b> and <b>currency</b> fields are always returned when expressing prices. */
+            currency?: string;
+            /** @description This field contains the numerical value of the listing price in the currency specified in the <b>currency</b> field. Both the <b>value</b> and <b>currency</b> fields are always returned when expressing prices. */
+            value?: number;
+        };
+        /** @description This type describes line item attributes. */
+        OrderLineItemAttribute: {
+            /** @description This enumerated value indicates an attribute of the line item. The <b>value</b> field indicates if the attribute applies. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:OrderLineItemAttributesEnum'>eBay API documentation</a> */
+            name?: string;
+            /** @description If returned as <code>true</code>, the line item attribute <b>name</b> applies; if returned as <code>false</code>, the attribute does not apply. */
+            value?: string;
+        };
+        /** @description This type provides fields for a summary of the line item related to feedback. */
+        OrderLineItemSummary: {
+            /** @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 <a href="/api-docs/commerce/feedback/resources/feedback/methods/getFeedback#response.feedbackEntries.orderLineItemSummary">orderLineItemSummary</a> for details on when this field is included. */
+            listingId?: string;
+            /** @description This container provides the sale price of the listing. Conditionally returned based on the authorization flow and user context. See <a href="/api-docs/commerce/feedback/resources/feedback/methods/getFeedback#response.feedbackEntries.orderLineItemSummary">orderLineItemSummary</a> for details on when this field is included. */
+            listingPrice?: components['schemas']['ListingPrice'];
+            /** @description This field contains the title of the listing. Conditionally returned based on the authorization flow and user context. See <a href="/api-docs/commerce/feedback/resources/feedback/methods/getFeedback#response.feedbackEntries.orderLineItemSummary">orderLineItemSummary</a> for details on when this field is included. */
+            listingTitle?: string;
+            /** @description This array describes order line attributes including names and values of a transaction. */
+            orderLineItemAttributes?: components['schemas']['OrderLineItemAttribute'][];
+            /** @description The unique identifier of the line item for this feedback. Conditionally returned based on the authorization flow and user context. See <a href="/api-docs/commerce/feedback/resources/feedback/methods/getFeedback#response.feedbackEntries.orderLineItemSummary">orderLineItemSummary</a> for details on when this field is included. */
+            orderLineItemId?: string;
+            /** @description This container indicates if the time since the item was bought on ebay is less than, more than, or equal to 90 days */
+            transactionPeriod?: components['schemas']['TransactionPeriod'];
+        };
+        /** @description This type provides pagination information for the returned line items. */
+        Pagination: {
+            /**
+             * Format: int32
+             * @description This value indicates the number of feedback entries on the current response page.
+             */
+            count?: number;
+            /**
+             * Format: int32
+             * @description The value of the <b>limit</b> 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. <p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>If this is the last or only page of the result set, the page may contain fewer line items than the <b>limit</b> value. </span></p><p>If a <b>limit</b> parameter was not included in the request, this value will default to <code>25</code>, returning up to 25 line items on each page.</p><p><b>Default: </b>25</p>
+             */
+            limit?: number;
+            /** @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. */
+            next?: string;
+            /**
+             * Format: int32
+             * @description The value of the <b>offset</b> parameter submitted in the request. This field indicates how many results were skipped in the response. If an <b>offset</b> parameter was not included in the request, this value will default to <code>0</code>, returning the first page of results.<p><b>Default: </b>0</p>
+             */
+            offset?: number;
+            /** @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.</p> */
+            prev?: string;
+            /**
+             * Format: int32
+             * @description The total number of line items available that match the filter criteria. <p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>If the total value exceeds the limit value, there are multiple pages of results.</span></p>
+             */
+            total?: number;
+        };
+        /** @description This type provides fields for the time period on which the feedback summary is calculated. */
+        Period: {
+            /** @description The unit of the period's <b>value</b>. Supported value: <code>DAY</code>. */
+            unit?: string;
+            /**
+             * Format: int32
+             * @description The value for the feedback period, specified in units of <b>unit</b>. Supported value: <code>90</code>.
+             */
+            value?: number;
+        };
+        /** @description This type provides the details of the user who provided the feedback of a <b>getFeedback</b> response. */
+        ProviderUserDetail: {
+            /**
+             * Format: int32
+             * @description This integer indicates the feedback score of the feedback provider at the time of providing this specific feedback.
+             */
+            feedbackScore?: number;
+            /** @description This enumerated value provides the visual star representation of the feedback score (for example, <code>YELLOW_STAR</code>). For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:FeedbackStarTypeEnum'>eBay API documentation</a> */
+            feedbackStar?: string;
+            /** @description This enumerated value indicates the user's role in the transaction (<code>BUYER</code> or <code>SELLER</code>). For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:UserRoleEnum'>eBay API documentation</a> */
+            role?: string;
+            /** @description This array lists additional attributes that relate to the user (such as verification status). */
+            userAttributes?: components['schemas']['ProviderUserDetailUserAttributes'][];
+            /** @description This field indicates the unique identifier of the user who gave the feedback.<br><br><span class="tablenote"><b>Note:</b> 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 <a href="/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>.</span> */
+            userId?: string;
+        };
+        /** @description This type defines the attributes of the user who provided the feedback of a <b>getFeedback</b> response. */
+        ProviderUserDetailUserAttributes: {
+            /** @description This enumerated value indicates an attribute of the user (for example, <code>USER_VERIFIED</code>). The <b>value</b> field indicates if the attribute applies. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:UserAttributeEnum'>eBay API documentation</a> */
+            name?: string;
+            /** @description If returned as <code>true</code>, the user attribute <b>name</b> applies; if returned as <code>false</code>, the attribute does not apply. */
+            value?: string;
+        };
+        /** @description This type provides fields for an array that includes metrics and distributions for each rating type. */
+        RatingSummaryByRatingType: {
+            /** @description An array of metrics associated with feedback aggregation. */
+            feedbackMetrics?: components['schemas']['FeedbackMetrics'][];
+            /** @description An array listing the distribution values of the feedback ratings. */
+            feedbackRatingValueDistribution?: components['schemas']['FeedbackRatingValueDistribution'][];
+            /** @description The time period on which the feedback summary is calculated. */
+            period?: components['schemas']['Period'];
+            /** @description This enumerated value indicates the user's role in the feedback  (<code>BUYER</code> or <code>SELLER</code>). For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:UserRoleEnum'>eBay API documentation</a> */
+            userRoleType?: string;
+        };
+        /** @description The type that defines the fields for the <b>respondToFeedback</b> request. */
+        RespondToFeedbackRequest: {
+            /** @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 <a href="/api-docs/commerce/feedback/resources/feedback/methods/getFeedback"  target="_blank">getFeedback</a> method (<a href="/api-docs/commerce/feedback/resources/feedback/methods/getFeedback#response.feedbackEntries.feedbackId"  target="_blank">feedbackId</a> field). */
+            feedbackId?: string;
+            /** @description Use this field to provide the identifier of the user who provided the original feedback. This value can be returned using the <a href="/api-docs/commerce/feedback/resources/feedback/methods/getFeedback"  target="_blank">getFeedback</a> method (<a href="/api-docs/commerce/feedback/resources/feedback/methods/getFeedback#response.feedbackEntries.providerUserDetail.userId"  target="_blank">userId</a> field).<br><br><span class="tablenote"><b>Note:</b> Both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>.</span> */
+            recipientUserId?: 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.<br><br><b>Maximum length:</b> 500 characters. */
+            responseText?: string;
+            /** @description Set this enumerated value to describe the type of response being submitted (for example, a <code>REPLY</code> or a <code>FOLLOW_UP</code>). For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/api:ResponseTypeEnum'>eBay API documentation</a> */
+            responseType?: string;
+        };
+        /** @description This type provides fields for specific aspects of the seller's performance. */
+        SellerRating: {
+            /** @description The enumerated value of the category being rated, such as delivery timeliness (<code>ON_TIME_DELIVERY</code>). For implementation help, refer to <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/api:KeyEnum'>eBay API documentation</a> */
+            key?: string;
+            /** @description The value assigned for the selected category. Use a value of <code>1</code> through <code>5</code>, with the <code>1</code> being the lowest rating and <code>5</code> being the highest. */
+            value?: string;
+        };
+        /** @description This type provides subject-based fields derived from feedback. */
+        Topic: {
+            /** @description The main topic (or category) detected in the comment. See the available <b>topics</b> in <a href="/api-docs/commerce/feedback/resources/feedback/methods/getFeedback#uri.filter">filter</a>. */
+            coarseTopic?: string;
+            /** @description <p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>Fine topics are not currently  supported.</span></p>A more specific detail or subtopic related to the coarse topic. */
+            fineTopic?: string;
+            /** @description This array lists any text snippets, phrases, or examples, from the feedback that supports the detected topic. */
+            highlightedTexts?: string[];
+            /** @description This field indicates a classification of the feedback, whether the feedback is <code>Positive</code>, <code>Negative</code>, or <code>Neutral</code>. */
+            sentiment?: string;
+        };
+        /** @description This type specifies the amount of time elapsed and the threshold associated with a transaction. */
+        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. */
+            period?: components['schemas']['Period'];
+            /** @description This enumerated value indicates whether a transaction <a href="/api-docs/commerce/feedback/resources/feedback/methods/getFeedback#response.feedbackEntries.orderLineItemSummary.transactionPeriod.period" >period</a> 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 <a href='https://developer.ebay.com/api-docs/commerce/feedback/types/fdb:ThresholdTypeEnum'>eBay API documentation</a> */
+            thresholdType?: string;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    getItemsAwaitingFeedback: {
+        parameters: {
+            query?: {
+                /** @description Use this parameter to limit the response based on the specified filter parameters. Supported filter parameters include:<br><p><ul><li><b>listingId</b>: Filter results by the specific listing ID</li><li><b>receiverName</b>: Filter results by the user's order partner name involved in the transaction</li><li><b>userRole</b>: Use this filter to only retrieve feedback due from the user in role as a seller or a buyer. If this filter is not used, all feedback due in both user roles is retrieved (<code>BUYER</code> or <code>SELLER</code>)</li></ul></p><p>Send the filter as a query parameter in a comma-separated <em>name</em>:<em>value</em> list. For example: <br><code>filter=listingId:123,receiverName:user,userRole:BUYER</code><p> */
+                filter?: string;
+                /** @description This parameter sets the maximum number of line items to return per page of data.<br><p>Use this parameter in conjunction with the <b>offset</b> parameter to control the pagination of the output. For example, with offset set to <code>20</code> and limit set to <code>10</code>, the call retrieves entries 21 through 30 from the result set.</p><p> Although this field is optional, if omitted the default value of <code>25</code> is used.</p><p><b>Default: </b>25</p><p><b>Minimum: </b>25</p><p><b>Maximum: </b>200</p> */
+                limit?: string;
+                /** @description Use this parameter to specify the number of items to skip in the result set. This is used with the <code>limit</code> field to control the pagination of the output. For example:<br><ul><li>If <b>offset</b> is <code>0</code> and <b>limit</b> is <code>10</code>, the method will retrieve items 1-10 from the list of line items returned</li><li>If <b>offset</b> is <code>10</code> and <b>limit</b> is <code>10</code>, the method will retrieve items 11-20 from the list of line items returned.</li></ul><p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>This feature employs a zero-based list, where the first line item in the list has an offset of 0.</span></p><p>If this parameter is not set, its value defaults to <code>0</code> which returns the first page of records.</p><p><b>Default:</b> 0</p> */
+                offset?: string;
+                /** @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:<br><ul><li><b>END_TIME_ASC:</b> Sorts listings by end time from oldest to newest</li><li><b>END_TIME_DESC:</b> Sorts listings by end time from newest to oldest (default)</li></ul><p>If this parameter is omitted, its value defaults to <b>END_TIME_DESC</b>.</p><p><b>Default: </b><code>END_TIME_DESC</code></p> */
+                sort?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Success */
+            200: {
+                headers: Record<string, unknown>;
+                content: {
+                    'application/json': components['schemas']['AwaitingFeedbackResponse'];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+            /** @description Not Authorized */
+            401: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+        };
+    };
+    getFeedback: {
+        parameters: {
+            query: {
+                /** @description Use this field to only return a specific feedback record by its feedback ID. <br><p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>If this query parameter is used, no other filters will be applicable.</span></p> */
+                feedback_id?: string;
+                /** @description Use this field to specify the type of feedback records to return. Acceptable values: <br><ul><li><b>FEEDBACK_RECEIVED</b>: Retrieve feedback received by the specified user.</li><li><b>FEEDBACK_SENT</b>: Retrieve feedback sent by the specified user.</li></ul><p>If not specified, both feedback received and feedback left for the user shall be retrieved.</p><p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>When using <b>FEEDBACK_SENT</b>, it is recommended to also filter <b>feedback_id</b> to target results accurately.</span></p> */
+                feedback_type: string;
+                /** @description Use this parameter to limit the response based on the specified filter parameters as follows: <br><ul><li><b>commentType</b>: Return only feedback with the set type of comments. Comment types available: <code>POSITIVE</code>, <code>NEUTRAL</code>, or <code>NEGATIVE</code> <p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>Sellers can only provide positive feedback.</span></p> </li><li><b>filterImage</b>: Return feedback dependent on if images are included. Filter values available:<ul><li><code>true</code>: Return only feedback with images</li><li><code>false</code>: Return feedback with or without images</li></ul></li><li><b>topics</b>: Use AI to generate items returned that are associated to the set topic. For example, if you set <code>topics:shipping</code>, only feedback comments about shipping are returned. Topics available: <code>shipping</code>, <code>service</code>, <code>packaging</code>, <code>description</code>, <code>seller-satisfaction</code>, <code>overall-satisfaction</code>, <code>refund</code>, <code>inventory</code>, <code>customer loyalty</code>, <code>seller-other</code>, <code>quality</code>, <code>price</code>, <code>condition</code>, <code>fit</code>, <code>appearance</code>, <code>dimensions</code>, <code>usage</code>, <code>product-satisfaction</code>, <code>product-other</code>, <code>extras</code><br><br>See <a href="/develop/guides-v2/communications/sell-communications-guide#retrieve-ai-filtered-items" target="_blank">Retrieve AI-filtered feedback</a> for an example.</li><li><b>period</b>: Filter results by the number of days to look back for feedback. If not set, lifetime results are returned. Supported values available: <code>7</code>, <code>30</code>, <code>90</code>, <code>180</code>, or <code>365</code></li><li><b>role</b>: Filter results by the role of the user providing feedback. Roles available: <code>BUYER </code>or <code>SELLER</code></li><li><b>showAutomatedFeedback</b>: Filter results to include automated feedback left by eBay  entries. For sellers with less than a 10 feedback score, an automated feedback message on behalf of eBay is returned.<ul><li><code>true</code>: Return automated feedback including both user and eBay generated feedback</li><li><code>false</code>: Do not return eBay's automatic feedback for seller in response (default)</li></ul></li></ul>Send the filter as a query parameter in a comma-separated <em>name</em>:<em>value</em> list. For example:  <br><br><code>filter=commentType:POSITIVE,filterImage:true,topics:fit,period:30,role:SELLER,showAutomatedFeedback:true</code></p> */
+                filter?: string;
+                /** @description Use this parameter to set the maximum number of items to return per page of data.<br><p>Use this parameter in conjunction with the <b>offset</b> parameter to control the pagination of the output. For example, with offset set to <code>20</code> and limit set to <code>10</code>, the call retrieves entries 21 through 30 from the result set.</p><p> Although this field is optional, if omitted the default value of <code>25</code> is used.</p><p><b>Default: </b>25</p><p><b>Minimum: </b>25</p><p><b>Maximum: </b>200</p> */
+                limit?: string;
+                /** @description Use this field to limit feedback entries to those associated with a specified listing. */
+                listing_id?: string;
+                /** @description Use this field to specify the number of line items to skip in the result set. This is used with the <code>limit</code> field to control the pagination of the output. For example:<br><ul><li>If <b>offset</b> is <code>0</code> and <b>limit</b> is <code>10</code>, the method will retrieve items 1-10 from the list of line items returned</li><li>If <b>offset</b> is <code>10</code> and <b>limit</b> is <code>10</code>, the method will retrieve items 11-20 from the list of line items returned.</li></ul><p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>This feature employs a zero-based list, where the first line item in the list has an offset of 0.</span></p><p>If this parameter is not set, its value defaults to <code>0</code> which returns the first page of records.</p><p><b>Default:</b> 0</p> */
+                offset?: string;
+                /** @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. <br><p><span class="tablenote"><span style="color:#004680"><strong>Note: </strong>If this query parameter is set, no other filters will be applicable.</span></p> */
+                order_line_item_id?: string;
+                /** @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:<br><ul><li><b>RELEVANCE</b>: Sorts items by relevance (default). This sort takes into account any available factors such as a comment score, comment type (positive, negative, neutral), how long ago the comment was left, or the length of the comment</li><li><b>TIME</b>: Sorts items by end time from newest to oldest.</li></ul><p>If this parameter is omitted, its value defaults to <b>RELEVANCE</b>.</p><p><b>Default: </b><code>RELEVANCE</code></p> */
+                sort?: string;
+                /** @description Use this field to limit feedback entries to those associated with the specified transaction ID. */
+                transaction_id?: string;
+                /** @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.<br><br><span class="tablenote"><b>Note:</b> Both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>.</span> */
+                user_id: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Success */
+            200: {
+                headers: Record<string, unknown>;
+                content: {
+                    'application/json': components['schemas']['GetFeedbackResponse'];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+            /** @description Not Authorized */
+            401: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+        };
+    };
+    leaveFeedback: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description This header indicates the format of the request body provided by the client. Its value should be set to <b>application/json</b>. <br><br> For more information, refer to <a href="/api-docs/static/rest-request-components.html#HTTP" target="_blank ">HTTP request headers</a>. */
+                'Content-Type': string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        /** @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) */
+        requestBody?: {
+            content: {
+                'application/json': components['schemas']['LeaveFeedbackRequest'];
+            };
+        };
+        responses: {
+            /** @description Success */
+            200: {
+                headers: Record<string, unknown>;
+                content: {
+                    'application/json': components['schemas']['LeaveFeedbackResponse'];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+            /** @description Not Authorized */
+            401: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+            /** @description Conflict */
+            409: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+        };
+    };
+    getFeedbackRatingSummary: {
+        parameters: {
+            query: {
+                /** @description Use this parameter to limit the response based on specified filter values:<br><ul><li><b>ratingType</b>: Specifies the type of rating being summarized and returned <b>(Required)</b>. Available values: <code>OVERALL_EXPERIENCE</code>, <code>OVERALL_EXPERIENCE_COMMENT</code>, <code>ON_TIME_DELIVERY</code>, <code>DSR_ITEM_AS_DESCRIBED</code>, <code>DSR_COMMUNICATION</code>, <code>DSR_SHIPPING_CHARGES</code>, <code>DSR_SHIPPING_TIME</code>, <code>ITEM_RATING</code><br>See <a href="/api-docs/commerce/feedback/types/fdb:FeedbackRatingTypeEnum" >FeedbackRatingTypeEnum</a> for descriptions of values. </li><li><b>excludeRepeatFeedback</b>: Set to <code>true</code> to exclude repeat feedback.</li><li><b>lookbackPeriodInDays</b>: Limit the response to a previous period of days. Available values: <code>7</code>, <code>30</code>, <code>90</code>, <code>180</code>, or <code>365</code></li></ul><p>You can send the filter as a query parameter, either with the required <b>ratingType</b> only, or combining the filter values with a comma-separated <em>name</em><b>:</b><em>value</em> list. For example:</p><p><code>filter=ratingType:OVERALL_EXPERIENCE,excludeRepeatFeedback:true,period:365</code></p> */
+                filter: string;
+                /** @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. */
+                user_id: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Success */
+            200: {
+                headers: Record<string, unknown>;
+                content: {
+                    'application/json': components['schemas']['GetFeedbackRatingSummaryResponse'];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+            /** @description Not Authorized */
+            401: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+            /** @description Not Found */
+            404: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+        };
+    };
+    respondToFeedback: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description This header indicates the format of the request body provided by the client. Its value should be set to <b>application/json</b>. <br><br> For more information, refer to <a href="/api-docs/static/rest-request-components.html#HTTP" target="_blank ">HTTP request headers</a>. */
+                'Content-Type': string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        /** @description This provides the request body for responding to feedback. */
+        requestBody?: {
+            content: {
+                'application/json': components['schemas']['RespondToFeedbackRequest'];
+            };
+        };
+        responses: {
+            /** @description Success */
+            200: {
+                headers: Record<string, unknown>;
+                content: {
+                    'application/json': Record<string, never>;
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+            /** @description Not Authorized */
+            401: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+            /** @description Forbidden */
+            403: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+            /** @description Conflict */
+            409: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: Record<string, unknown>;
+                content?: never;
+            };
+        };
+    };
+}