Skip to main content

  • Important: Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made by EU/UK sellers. Please refer to Digital Signatures for APIs to learn more on the impacted APIs and the process to create signature to be included in the HTTP payload.

  • OpenAPI Specification - Version 2.0 for all of our RESTful APIs will no longer be available starting April 5, 2023. We will continue leveraging OpenAPI Specification - Version 3.0 for new features in our RESTful APIs.

The Negotiations 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.


Method NameHTTP MethodPathSummarySamples
findEligibleItemsGET/find_eligible_itemsRetrieves listings that are eligible for a seller-initiated offer to a buyer.View findEligibleItems - /find_eligible_items
sendOfferToInterestedBuyersPOST/send_offer_to_interested_buyersSends eligible buyers an offer to purchase items at a discount.View sendOfferToInterestedBuyers - /send_offer_to_interested_buyers