Shopping API

Shopping API Release Notes

Information about the schema location is in the Schema Location section of the Making an API Call topic.

Are you just getting started with the Shopping API? The following describes how to join the eBay Developers Program:

Q3 2020
Version Release Date
1173 2020-Sep-25
1171 No Schema or Doc Updates
1169 No Schema or Doc Updates
1167 No Schema or Doc Updates
1165 No Schema or Doc Updates
1163 No Schema or Doc Updates
1161 No Schema or Doc Updates
Q2 2020
Version Release Date
1159 No Schema or Doc Updates
1157 2020-Jun-05
1155 No Schema or Doc Updates
1153 No Schema or Doc Updates
1151 No Schema or Doc Updates
1149 No Schema or Doc Updates
Q1 2020
Version Release Date
1147 No Schema or Doc Updates
1145 2020-Mar-13
1143 No Schema or Doc Updates
1141 No Schema or Doc Updates
1139 2020-Jan-31
1137 No Schema or Doc Updates
1135 Skipped
Q4 2019
Version Release Date
1133 Not Released
1131 No schema or doc changes
1129 No schema or doc changes

These release notes go back four quarters. For older release notes, see the Release Notes archive.

Version 1173

Index of Changed Calls - 1173

Schema Changes - 1173

Announcements - 1173

New Features - 1173

Changed Functionality - 1173

Documentation Changes and Errata - 1173

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1173

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

No changed calls in this release.

Schema Changes - 1173

Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.

No schema changes in this release.

Announcements - 1173

Change Requests

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.

New Features - 1173

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1173.

None for this release.

Changed Functionality - 1173

This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.

None for this release.

Documentation Changes and Errata - 1173

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1173 and Changed Functionality - 1173.

Minor Doc Updates Made to Numerous Types

Some minor documentation updates made to numerous types in the Shopping API.

Version 1157

Index of Changed Calls - 1157

Schema Changes - 1157

Announcements - 1157

New Features - 1157

Changed Functionality - 1157

Documentation Changes and Errata - 1157

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1157

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

Schema Changes - 1157

Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.

No schema changes in this release.

Announcements - 1157

Change Requests

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.

New Features - 1157

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1157.

Changed Functionality - 1157

This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.

None for this release.

Documentation Changes and Errata - 1157

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1157 and Changed Functionality - 1157.

Clarified the Behavior of Domestic and International Return Policies

Updated return policy-related documentation to make it more clear that if a seller does not add a separate international return policy for an item, the settings in the domestic return policy will be used instead. For more information, see the ReturnPolicy container in GetSingleItem call.

Version 1145

Index of Changed Calls - 1145

Schema Changes - 1145

Announcements - 1145

New Features - 1145

Changed Functionality - 1145

Documentation Changes and Errata - 1145

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1145

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

Schema Changes - 1145

Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.

No schema changes in this release.

Announcements - 1145

Change Requests

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.

CharityNumber Field Scheduled to be Deprecated

The CharityNumber field returned in GetSingleItem and GetMultipleItems has been scheduled for deprecation. It is the CharityID value that should be used instead if the user wishes to retrieve more details on a nonprofit organization by using the Trading API's GetCharities call, or used by a seller in an Add/Revise/Relist call when they want to identify the nonprofit organization that will receive sale proceeds for a listing.

New Features - 1145

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1145.

None for this release.

Changed Functionality - 1145

This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.

None for this release.

Documentation Changes and Errata - 1145

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1145 and Changed Functionality - 1145.

Clarified Difference Between CharityID and CharityNumber Identifiers

Updated the CharityID and CharityNumber field descriptions to make it clear that CharityID is the eBay-assigned unique identifier for an eBay for Charity organization, and CharityNumber is the PayPal Giving Fund identifier. It is the CharityID value that should be used to identify a charity organization in an Add/Revise/Relist or GetCharities call in Trading API

Back to top

Version 1139

Index of Changed Calls - 1139

Schema Changes - 1139

Announcements - 1139

New Features - 1139

Changed Functionality - 1139

Documentation Changes and Errata - 1139

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1139

These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.

New Calls

No new calls in this release.

Changed Calls

Schema Changes - 1139

None for this release.

Announcements - 1139

Change Requests

See the Site Status Updates for bug fixes related to this release.

New Features - 1139

This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.

For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1139.

None for this release.

Changed Functionality - 1139

This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.

PostalCode to Start Being Masked in GetSingleItem/GetMultipleItems

Postal code values returned in the Item.PostalCode field of GetSingleItem/GetMultipleItems will be masked to all users except for the seller of the item. Different countries will mask postal/zip codes in slightly different ways, but an example would be 951**.

Documentation Changes and Errata - 1139

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1139 and Changed Functionality - 1139.

Added Site-Specific Max Length Values for Address Fields

Added site-specific max length values for several address-related fields (in AddressType), including Street1, Street2, CityName, StateOrProvince, and PostalCode. For all five of these fields, the max lengths according eBay marketplace are shown:

Copyright © 2007–2020 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.