Just getting started with the Negotiation API? See the following documents for details on using this API:
- Using eBay RESTful APIs
- Selling Integration Guide
- Negotiation API overview
Requirements and restrictions - Negotiation API Reference
Announcements
See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.
The API release history
The following table lists the releases for the Negotiation API:
| Version | Release Date | Summary of Release |
|---|---|---|
|
2025-01-16 |
Updated default offerDuration time to 4 days for US and UK marketplaces |
|
| v1.1.0 | 2019-10-11 | Added support for the Canadian marketplace (EBAY_CA). |
| v1.0.0 | 2019-09-25 | First release of Version 1.0. |
Negotiation API – v1.1.1
This release of the Negotiation API updates the default offer duration time on the US and UK marketplaces to 4 days.
API feature updates
When sending an offer through the sendOfferToInterestedBuyers method, each supported marketplace has a default site-specific length of time an offer is valid that is defined in the offerDuration field. For this release, the site-specific default value for the EBAY_US and EBAY_GB marketplaces has been updated from 2 days to 4 days.
Note: Currently, both 2 and 4 days are supported on EBAY_US and EBAY_GB marketplaces. In the future, 4 days will be the only valid value for EBAY_US and EBAY_GB marketplaces.
Negotiation API – v1.1.0
This release of the Negotiation API expands the list of supported marketplaces to include Canada.
API feature updates
The list of marketplaces supported by the Negotiation API is expanded to include the Canadian marketplace, EBAY_CA.
Both the English and French versions of the marketplace are supported via the Content-Language HTTP request header.
Set Content-Language to the locale you want to target. For the English site, set the header to CA_en; for the French site set the header to CA_fr. The English site is the default site.
Negotiation API – v1.0.0
This is the first release of the Negotiation API, Version 1.0.0.
For a list of resources and methods, see the Negotiation API Reference.