Just getting started with the Inventory API? See the following documents for details on using this API:
The API release history
The following table lists the most recent releases for the Inventory API. For prior releases, refer to the Inventory API Release Notes Archive.
Release Version | Release Date | Description of Release |
---|---|---|
2024-08-01 | This release adds support for GPSR information. | |
2024-05-29 |
New requirement when adding EPA approved products | |
2024-02-27 |
This release adds support for irregular shipping. |
|
2024-02-05 |
This release adds support for required Economic Operator information. |
|
2023-10-23 |
This release includes the following changes:
|
|
2023-08-29 |
Made changes to indicate that all DSA-related fields will become available on all eBay marketplaces, and is no longer restricted to just a couple of marketplaces. |
|
2023-06-26 |
Added support for condition grading for select trading card categories. |
|
2023-05-24 |
Added support for:
Note: Energy Efficiency labeling and Global Custom Policies are currently available only on the German (DE) marketplace. Hazmat information is now available on the German (DE) marketplace. |
|
2023-01-23 |
Added support for Hazmat and Repair Score information for items being sold on eBay. |
|
2022-11-14 |
Updated picture limit |
|
2022-01-10 |
Adds support for three new refurbished condition enumeration values. |
|
2021-12-15 |
Adds support for the extended producer responsibility regulations and for custom policies including new and updated containers, types, error codes, and warnings. |
|
2021-07-20 |
Added the field |
|
2021-04-21 |
A new |
|
2021-02-17 |
Added support for auction listing capabilities, including new and updated types, and new error codes. |
Version 1.17.6
In preparation for new legal requirements by the European Union taking effect on December 13th, 2024, this release adds support for General Product Safety Regulation (GPSR) information. GPSR information will be conditionally required for products shipped or sold in EU-based countries or Northern Ireland.
Schema changes
To support the upcoming regulatory requirements, schema changes have been made to support GPSR information. The following types have been added to the bulkCreateOffer, createOffer, getOffer, getOffers, and updateOffer methods to provide GPSR information:
-
regulatory.documents: Provides a collection of regulatory documents associated with the listing.
-
regulatory.manufacturer: Provides name and contact information for the manufacturer of the item.
-
regulatory.productSafety: Provides product safety and compliance related information for the listing.
-
regulatory.responsiblePersons: Provides name and contact information for the EU-based Responsible Persons or entities associated with the listing.
Economic Operator changes
Economic Operator is being decommissioned and being replaced by the manufacturer and responsiblePersons containers. Economic Operator related fields should no longer be used for the create or update methods. As it is currently still supported, Economic Operator-related fields will be returned if applicable for the getOffer method.
Version 1.17.5
A new requirement adding support for EPA approved tuning devices and software products was added to category Id 173651 (Auto Performance Tuning Devices & Software). When listing in categoryID 173651 (Tuning devices & software), use of catalog products is required. For more information, see Tuning devices and software.
Version 1.17.4
This release adds support for shipping irregular items.
Schema changes
To support shipping irregular items, the shippingIrregular boolean field was added to the bulkCreateOrReplaceInventoryItem, bulkGetInventoryItem, createOrReplaceInventoryItem, getInventoryItem, and getInventoryItems methods through the PackageWeightAndSizeInventory type.
Version 1.17.3
This release adds support for required Economic Operator information.
Schema changes
To support new legal requirements by the European Union and the UK to provide Economic Operator information, schema changes have been made. The following table contains the changes and the affected methods.
Type | Change | Used By |
---|---|---|
New type including fields:
|
|
The EconomicOperator type provides required Economic Operator information about the manufacturer and/or supplier of the item. The economicOperator field has also been added to the Regulatory type.
New Error Codes
The following new error codes were added with this release to the bulkPublishOffer, publishOffer, publishOfferByInventoryItemGroup, and updateOffer methods:
Error Code | Error Message |
---|---|
25085 | Economic Operator address information is incomplete. When providing the address, please provide the company name, street, city, state, postal code and country. |
25087 | Economic Operator information is incomplete. Please provide the company name. |
25088 | The email address provided is formatted incorrectly. |
Version 1.17.2
This release includes the following changes:
- When listings are on hold due to policy violation then new boolean listingOnHold field is returned in getOffer/getOffers method. See the type Listing Details .
- An official date January 22, 2024 is added to the note about revising single trading card listings with conditionDescriptors data. See the method createorReplaceInventoryItem.
Version 1.17.1
Made changes to indicate that all DSA-related fields will become available on all eBay marketplaces, and is no longer restricted to just a couple of marketplaces.
The Inventory API now supports the following features:
- Energy Efficiency Labels
- Hazmat
- Regional Product Compliance Policies
- Regional Take-back Policies
- Repair Score
- Eco-Participation Fee
Version 1.17.0
This release of the Inventory API adds support for condition grading for following trading card categories:
- Non-Sport Trading Card Singles
- CCG Individual Cards
- Sports Trading Card Singles
Schema changes
The following new type has been added to the bulkCreateOrReplaceInventoryItem, bulkGetInventoryItem, createOrReplaceInventoryItem, getInventoryItem, and getInventoryItems methods:
-
ConditionDescriptor: Provides information about the condition of an item in a structured format.
Announcments
Condition grading is now available in the United Kingdom (GB) marketplace for select trading card categories.
Version 1.16.3
This release of the Inventory API adds support for Energy Efficiency labeling for durable goods and Global Custom Policies.
Note: Energy Efficiency labeling and Global Custom Policies are currently available only on the German (DE) marketplace.
Schema changes
The following new types have been added to the bulkCreateOffer, createOffer, getOffer, getOffers, and updateOffer methods:
- EnergyEfficiencyLabel: Provides information about the energy efficiency for certain durable goods.
- CountryPolicy: Specifies custom product compliance and/or take-back policies that apply to a specified country.
- RegionalProductCompliancePolicies: Lists regional product compliance policies to be used by an offer when it is published and converted to a listing.
- RegionalTakeBackPolicies: Lists regional take-back policies to be used by an offer when it is published and converted to a listing.
New error codes
The following new error codes have been added to the bulkPublishOffer, publishOffer, publishOfferByInventoryItemGroup, updateOffer methods:
- 25083: Energy efficiency image is missing. Image is required with image description.
- 25084: The listing must have both an energy efficiency label and a product information sheet.
- 25086: The URL provided must be an eBay Picture Service URL.
Announcements
Hazmat information is now available on the German (DE) marketplace.
Version 1.16.2
This release of the Inventory API adds support for Hazmat and Repair Score information for items being sold on eBay.
Schema changes
The following new types have been added to the bulkCreateOffer, createOffer, getOffer, getOffers, and updateOffer methods:
- Hazmat: Provides hazardous material information for a listing.
- Regulatory: Provides hazardous material related information and the repair score for a listing.
New error codes
The following new error codes have been added to the bulkPublishOffer, publishOffer, publishOfferByInventoryItemGroup, updateOffer methods:
- 25076: {replaceable_value} ID(s) {replaceable_value} not found. Please use valid ID(s).
- 25077: Duplicate Regulatory ID(s) {replaceable_value} sent in the request. Duplicate ID(s) have been ignored.
- 25078: Hazmat structure incorrect for {replaceable_value}.
- 25079: Repair score invalid. Repair score must be in the range from {replaceable_value} to {replaceable_value} with one decimal place.
- 25080: The value of the {0} field is invalid. Field must not exceed {replaceable_value} characters.
- 25081: Hazardous material information incomplete. Your listing must include pictograms, hazardous statements and a signal word.
Version 1.16.1
This release of the Inventory API updates the picture limit. With the exception of motor vehicle listings on the US and Canada marketplaces, sellers can now include up to 24 pictures in a listing free of charge in all categories on all marketplaces. The number of included pictures in motor vehicle listings depend on the selected vehicle package (refer to Fees for selling vehicles on eBay Motors).
Picture URLs for an item are specified in the imageUrls array of the createOrReplaceInventoryItem and bulkCreateOrReplaceInventoryItem methods.
Version 1.16.0
This release of the Inventory API adds three new refurbished condition enumeration values to the ConditionEnum type:
- EXCELLENT_REFURBISHED: This enumeration value should be used if the Condition ID value is
2010
. - VERY_GOOD_REFURBISHED: This enumeration value should be used if the Condition ID value is
2020
. - GOOD_REFURBISHED: This enumeration value should be used if the Condition ID value is
2030
.
Note: These enumeration values and Condition IDs are available ONLY for Cell Phones and Smartphones (category ID 9355
) in US, Canada, UK, Germany, and Australia marketplaces.
Version 1.15.0
This release of the Inventory API adds support for the extended producer responsibility regulations and for custom policies. These features are supported by a limited number of sites and specific categories. Use the getExtendedProducerResponsibilityPolicies method of the Sell Metadata API to return the enabled sites and categories.
Extended producer responsibility regulations supported
To support new extended producer responsibility regulations, IDs of the producer or importer related to the new item, packaging, added documentation, or an eco-participation fee can be specified in create or update offer calls.
Custom policies supported
Custom policy IDs that refer to the relevant policy created for compliance or for other purposes can be specified in create or update offer calls.
Schema changes
The following table contains the schema changes made with this release and their affected methods.
Type | Change | Used By |
---|---|---|
ExtendedProducerResponsibility |
New type including fields:
|
|
EbayOfferDetailsWithAll | Modified (added container): extendedProducerResponsibility |
|
EbayOfferDetailsWithId | Modified (added container): extendedProducerResponsibility | updateOffer |
EbayOfferDetailsWithKeys | Modified (added container): extendedProducerResponsibility |
|
ListingPolicies |
Modified (added fields):
|
|
New Error Codes and Warnings
New error codes and warnings were added with this release to the bulkPublishOffer, publishOffer, publishOfferByInventoryItemGroup, and updateOffer methods. The following new error codes were added:
Error Code | Error Message |
---|---|
25029 | {field} is required for this category. |
25031 | {field} is not valid and needs to be a number between {min} and {max} |
25032 | {field} is not valid |
25034 | Only {max value} policies can be specified |
25035 | The specified policy is not found |
25036 | The policy(ies) {PolicyId} is not of type {PolicyEnum} |
25038 | {ItemId} cannot be revised if the item has a bid or a best offer or is ending within 12 hours |
25039 | {ItemId} cannot be revised if the item has a bid or a best offer and is ending within 12 hours |
25040 | {ItemId} cannot be revised if the item has a bid or a best offer and is ending within 12 hours |
The following new warnings were added:
Warning Code | Warning Message |
---|---|
25028 | {field} is not applicable and has been dropped |
25030 | {field} is not applicable for the condition and has been dropped |
25033 | Duplicate policy IDs found |
25037 | Item level Eco Participation Fee will be ignored |
Version 1.14.0
The following section details the updates that have been made for this release.
Support for adding videos to item listings
The field videoIds
has been added to the Product type that is used by the bulkCreateOrReplaceInventoryItem
, bulkGetInventoryItem
, createOrReplaceInventoryItem
, getInventoryItem
, and getInventoryItems
methods for the inventory_item
resource, and the createOrReplaceInventoryItemGroup
and getInventoryItemGroup
methods for the inventory_item_group
resource. This field contains an array of one or more videoId
values for the product. A videoId
is a unique identifier that is automatically created by eBay when a seller successfully uploads a video to eBay using the uploadVideo method of the Media API.
For information about supported marketplaces and platforms, as well as other requirements and limitations of video support, refer to Managing videos.
Version 1.13.0
The following sections detail the updates that have been made for this release.
CERTIFIED_REFURBISHED enum value replaces MANUFACTURER_REFURBISHED
A new CERTIFIED_REFURBISHED
ConditionEnum value has been added. This CERTIFIED_REFURBISHED
value has essentially replaced the MANUFACTURER_REFURBISHED
value, which has been deprecated. The 'Manufacturer Refurbished' item condition is no longer a valid item condition on any eBay marketplace. For any existing inventory items that have MANUFACTURER_REFURBISHED
set as their condition value, eBay will automatically convert the condition of these inventory items to CERTIFIED_REFURBISHED
, so it is not necessary for the developer to update these inventory items with a 'create or replace' call.
To list an item as 'Certified Refurbished', a seller must be pre-qualified by eBay for this feature. Any seller who is not eligible for this feature will be blocked if they try to create a new listing or revise an existing listing with this item condition.
Version 1.12.0
The following sections detail the updates that have been made for this release.
New Features
Auction listings are now supported by the Inventory API resource methods. In order to support this new feature, several schema changes were made in this release (refer to the Schema Changes section for details).
A new auction format has been added, and new fields were created to indicate the reserved inventory quantities that are allocated for both fixed-price and auction offer listings. When auction listing offers are published, the allocated quantity will be reserved for the specified listing duration. If the offer ends without a bid, the allocated quantity will be released and available for fixed-price offers and will remain GTC (Good 'til Canceled).
New error codes were also added in this release to address the new validations and business logic (refer to the New Error Codes section for details).
Schema Changes
The following schema elements were added and/or updated with this release:
Type | Change | Used By |
---|---|---|
AvailabilityWithAll | New type |
|
FormatAllocation | New type |
|
FormatTypeEnum | New enum value added: AUCTION |
|
ListingDurationEnum | Updated type: Auction listing offers now supported |
|
PricingSummary |
New fields added:
|
|
ShipToLocationAvailabilityWithAll | New type |
|
New Error Codes
The following new error codes were added with this release:
Error Code | Error Message |
---|---|
25752 | listingStartDate provided is invalid. |
25753 | listingStartDate is in the past or the offer is live. Value is not updated on the listing. |
25755 | listingDuration is required for auction offer. |
25756 | Auction format is not permitted with a SKU that is part of an InventoryItemGroup. |
25757 | auctionStartPrice is required for auction offer. |
25758 | auctionStartPrice and auctionReservePrice are not supported for fixed price offer. |
25760 | shipToLocationAvailability quantity insufficient to create auction listings. |
25761 | Discount pricing is not applicable for auction offer. |
25762 | availableQuantity is not applicable for auction offer. |
25763 | quantityLimitPerBuyer is not applicable for auction offer. |
25764 | eBayPlusIfEligible is not applicable for auction offer. |