--- title: Negotiation API description: "The **Negotiation API** gives sellers the ability to proactively send discount offers to buyers who have shown an \"interest\" in their listings. By sending buyers discount offers on listings where they have shown an interest, sellers can increase the velocity of their sales. There are various ways for a buyer to show _interest_ in a listing. For example, if a buyer adds the listing to their **Watch** list, or if they add the listing to their shopping cart and later abandon the cart, they are deemed to have shown an interest in the listing. In the offers that sellers send, they can discount their listings by either a percentage off the listing price, or they can set a new discounted price that is lower than the original listing price. For details about how seller offers work, see [Sending offers to buyers](https://developer.ebay.com/api-docs/sell/static/marketing/offers-to-buyers.html \"\\\\\"Selling\")." api_version: 1.0 api_name: negotiation_api api_type: REST api_group: sell/negotiation_api source_url: html: https://developer.ebay.com/develop/api/sell/negotiation_api md: https://developer.ebay.com/develop/api/sell/negotiation_api.md --- # Negotiation API API The **Negotiation API** gives sellers the ability to proactively send discount offers to buyers who have shown an "interest" in their listings. By sending buyers discount offers on listings where they have shown an interest, sellers can increase the velocity of their sales. There are various ways for a buyer to show _interest_ in a listing. For example, if a buyer adds the listing to their **Watch** list, or if they add the listing to their shopping cart and later abandon the cart, they are deemed to have shown an interest in the listing. In the offers that sellers send, they can discount their listings by either a percentage off the listing price, or they can set a new discounted price that is lower than the original listing price. For details about how seller offers work, see [Sending offers to buyers](https://developer.ebay.com/api-docs/sell/static/marketing/offers-to-buyers.html "\\"Selling"). ## API Methods The following API methods are available: ### findEligibleItems #### GET /find_eligible_items **Description:** This method evaluates a seller's current listings and returns the set of IDs that are eligible for a seller-initiated discount offer to a buyer. A listing ID is returned only when one or more buyers have shown an "interest" in the listing. If any buyers have shown interest in a listing, the seller can initiate a "negotiation" with them by calling [sendOfferToInterestedBuyers](/api-docs/sell/negotiation/resources/offer/methods/sendOfferToInterestedBuyers), which sends all interested buyers a message that offers the listing at a discount. For details about how to create seller offers to buyers, see [Sending offers to buyers](/api-docs/sell/static/marketing/offers-to-buyers.html "Selling Integration Guide"). **Parameters:** - **limit** (string) - This query parameter specifies the maximum number of items to return from the result set on a page in the paginated response. **Minimum:** 1 **Maximum:** 200 **Default:** 10 - **offset** (string) - This query parameter specifies the number of results to skip in the result set before returning the first result in the paginated response. Combine **offset** with the **limit** query parameter to control the items returned in the response. For example, if you supply an **offset** of `0` and a **limit** of `10`, the first page of the response contains the first 10 results from the complete list of items retrieved by the call. If **offset** is `10` and **limit** is `20`, the first page of the response contains items 11-30 from the complete result set. **Default:** 0 - **X-EBAY-C-MARKETPLACE-ID** (string) *required* - The eBay marketplace on which you want to search for eligible listings. For a complete list of supported marketplaces, see [Negotiation API requirements and restrictions](/api-docs/sell/negotiation/overview.html#requirements "Negotiation API Overview"). ### sendOfferToInterestedBuyers #### POST /send_offer_to_interested_buyers **Description:** This method sends eligible buyers offers to purchase items in a listing at a discount. When a buyer has shown _interest_ in a listing, they become "eligible" to receive a seller-initiated offer to purchase the item(s). Sellers use [findEligibleItems](/api-docs/sell/negotiation/resources/offer/methods/findEligibleItems) to get the set of listings that have interested buyers. If a listing has interested buyers, sellers can use this method (**sendOfferToInterestedBuyers**) to send an offer to the buyers who are interested in the listing. The offer gives buyers the ability to purchase the associated listings at a discounted price. For details about how to create seller offers to buyers, see [Sending offers to buyers](/api-docs/sell/static/marketing/offers-to-buyers.html "Selling Integration Guide"). **Parameters:** - **X-EBAY-C-MARKETPLACE-ID** (string) *required* - The eBay marketplace on which your listings with "eligible" buyers appear. For a complete list of supported marketplaces, see [Negotiation API requirements and restrictions](/api-docs/sell/negotiation/overview.html#requirements "Negotiation API Overview"). - **Content-Type** (string) *required* - 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](/api-docs/static/rest-request-components.html#HTTP). ## Error Codes The following error codes may be returned by this API: ### REQUEST Errors #### 150001 - API_NEGOTIATION **Description:** Mandatory headers are missing. #### 150002 - API_NEGOTIATION **Description:** The marketplace value {marketplaceId} is not supported. The supported values are: {marketplaceIds} #### 150003 - API_NEGOTIATION **Description:** Invalid limit. Limit should be between {minLimit} and {maxLimit}. #### 150004 - API_NEGOTIATION **Description:** Invalid offset. Offset cannot be less than 0. #### 150005 - API_NEGOTIATION **Description:** Offer contains multiple listings {listingIds}. #### 150006 - API_NEGOTIATION **Description:** Request cannot be null/empty. #### 150007 - API_NEGOTIATION **Description:** Both offer price and discount percentage cannot be present in the request. #### 150008 - API_NEGOTIATION **Description:** Price must be at least {minPercentageDifference} less than your Buy It Now price. #### 150009 - API_NEGOTIATION **Description:** Invalid value for {fieldName}. {additionalInfo} #### 150027 - API_NEGOTIATION **Description:** Offer is invalid. Please specify a valid duration of {durationValue} {durationUnit} ### APPLICATION Errors #### 150000 - API_NEGOTIATION **Description:** Internal error. Please try the call again after a minute or two. If the error persists, contact eBay developer support for assistance. ### BUSINESS Errors #### 150010 - API_NEGOTIATION **Description:** Invalid message. Message cannot contain HTML or blocked words and cannot exceed maximum character limit of 2000. #### 150011 - API_NEGOTIATION **Description:** Invalid listingId {listingId}. The listing for this offer has ended. #### 150012 - API_NEGOTIATION **Description:** Invalid listingId {listingId}. No such listing for this seller. #### 150013 - API_NEGOTIATION **Description:** Invalid listingId {listingId}. {additionalInfo} #### 150014 - API_NEGOTIATION **Description:** Current available quantity for this listing {listingId} is less than the offer quantity. #### 150015 - API_NEGOTIATION **Description:** Invalid price for listing {listingId}. Minimum offer price of {minPrice} not met. #### 150016 - API_NEGOTIATION **Description:** Invalid price for listing {listingId}. Price value exceeds the listing price. #### 150017 - API_NEGOTIATION **Description:** Listing {listingId} does not support offer. #### 150018 - API_NEGOTIATION **Description:** Offer is invalid. A best offer currently exists on the listing {listingId}. #### 150019 - API_NEGOTIATION **Description:** Offer is invalid. Listing {listingId} currently has a seller-initiated negotiation. #### 150020 - API_NEGOTIATION **Description:** Listing {listingId} has no interested buyers. #### 150021 - API_NEGOTIATION **Description:** Seller initiating the offer is not active. #### 150022 - API_NEGOTIATION **Description:** Offer is invalid. Maximum allowed offer limit reached. #### 150023 - API_NEGOTIATION **Description:** Offer is invalid. Seller has exceeded their seller-initiated offer limit. #### 150024 - API_NEGOTIATION **Description:** Offer is invalid. Items are listed on different sites. #### 150025 - API_NEGOTIATION **Description:** Offer is invalid. {additionalInfo} #### 150026 - API_NEGOTIATION **Description:** Listing ID {listingId} is invalid, sellers cannot initiate an offer to a buyer for a Motors listing. ## Rate Limits See [API Call Limits](https://developer.ebay.com/develop/get-started/api-call-limits) on the eBay Developer Program. ## Resources ### Documentation - [eBay Developer Program](https://developer.ebay.com/) - [API Documentation](https://developer.ebay.com/develop/api/) - [SDKs and Widgets](https://developer.ebay.com/develop/sdks-and-widgets) - [Developer Community Forum](https://community.ebay.com/t5/Developer-Groups/ct-p/developergroup) ### Tools - [API Explorer](https://developer.ebay.com/my/api_test_tool) - [GraphQL Explorer](https://developer.ebay.com/my/graphql_explorer) ### Support - [Developer Support](https://developer.ebay.com/support/) - [API Status](https://developer.ebay.com/support/api-status) - [Release Notes](https://developer.ebay.com/develop/api/release_notes/) --- *Generated on 2026-07-28T16:30:13.696Z*