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 |
|---|---|---|
| Version 1.18.4 | 2025-07-15 | New error and warning added for new P&A Returns Policy. |
| Version 1.18.3 | 2025-06-27 | This release adds 57 new error codes for createOrReplaceInventoryItem. |
| Version 1.18.2 | 2025-01-22 | Added two new ConditionEnum values: PRE_OWNED_EXCELLENT and PRE_OWNED_FAIR. |
| Version 1.18.1 | 2025-01-16 | Added a new field, contactUrl, to Manufacturer and ResponsiblePerson types. |
| 2024-10-22 |
Added three new location mapping methods to the listing resource, as well as a new fulfillment center location type to support this feature. |
|
| 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. |
Version 1.18.4
Starting July 15, eBay requires Parts & Accessories sellers to offer free returns for 30 days or longer on US domestic shipping, with a 50% discount on return shipping labels. For more details, visit Seller Updates page. For support, visit support related to easy returns in P&A.
Initially, eBay will automatically update return policy settings as applicable and return a warning, but beginning in late August, eBay will start blocking listing creation and revisions through API calls with an error. The following warning and error messages were added to the bulkCreateOrReplaceInventoryItem, createOrReplaceInventoryItem, createOrReplaceProductCompatibility, createOrReplaceInventoryItemGroup, bulkPublishOffer, publishOffer, publishOfferByInventoryItemGroup, and updateOffer methods:
-
Error code: 25123: This P&A listing has a non-compliant domestic return policy. Please update the return window to 30-days (or more) and/or update return shipping cost payer to Seller, and then make another call. Sellers using business policies must make the same changes to their return business policy and then make another call. To learn more, visit https://www.ebay.com/sellercenter/news/2025-june/parts-accessories-return-policy.
-
Error code: 25124: This P&A listing requires a minimum 30-day return period and seller-paid return shipping. eBay automatically updated the listing's return policy settings to meet these requirements. Sellers using business policies should update their return business policy for future P&A listings. To learn more, visit https://www.ebay.com/sellercenter/news/2025-june/parts-accessories-return-policy.
Version 1.18.3
-
57 new error codes were added to createOrReplaceInventoryItem reference docs. Any of these error codes can be triggered when this method is used to revise an active listing. See the Error Codes section for the full list.
Version 1.18.2
This release of the Inventory API adds two new pre-owned condition enumeration values for apparel categories to the ConditionEnum type:
-
PRE_OWNED_EXCELLENT: The item has been previously owned, but is in excellent condition. This enumeration value should be used if the Condition ID value is
2990. -
PRE_OWNED_FAIR: The item has been previous owned and is in fair condition. This enumeration value should be used if the Condition ID value is
3010.
In addition, the USED_EXCELLENT condition has been mapped to the PRE_OWNED_GOOD condition value for apparel categories. When used in apparel categories, this condition means the item has been previously owned, but is in good condition.
Note: These enumeration values and Condition IDs are only supported for apparel categories. Currently, these conditions are only available in the EBAY_AU (Australia) marketplace. These values will be supported in all other marketplaces on February 4th, 2025.
Version 1.18.1
This release added a new field, contactUrl, that can be included when adding GPSR information to a listing.
Schema changes
The contactUrl field has been added to the Manufacturer and ResponsiblePerson types. This field allows sellers to input a URL as an electronic contact for a manufacturer or responsible person when adding GPSR information to a listing.
Error Code changes
The following error code has been added to the bulkCreateOffer, createOffer, getOffer, getOffers, and updateOffer methods to support this feature:
-
25122: The contact URL is incorrectly formatted. Please update the formatting.
The following error codes have been updated to support this feature:
-
25118: Seller must provide at least one form of contact info for Manufacturer - either address, email, contact URL or phone.
-
25119: Seller must provide at least one form of contact info for Responsible Person - either address, email, contact URL or phone.
Version 1.18.0
This release added three new methods, createSkuLocationMapping, getSkuLocationMapping, and deleteSkuLocationMapping, to the listing resource. These methods sellers selling products through the Multi-warehouse program to get improved estimated delivery dates on their listings.
In addition, a new location type, FULFILLMENT_CENTER, has been added to StoreTypeEnum to support this feature.
New methods
The following methods have been added as part of the listing resource to support location mapping features:
-
createSkuLocationMapping: This method allows sellers to map multiple fulfillment center locations to single-SKU listing, or to a single SKU within a multiple-variation listing.
-
getSkuLocationMapping: This method allows sellers to remove all location mappings associated with a specific SKU within a listing.
-
DeleteSkuLocationmapping: This method allows sellers to retrieve the locations mapped to a specific SKU within a listing.
New location type
A new location type, fulfillment center, is now available when creating/updating an inventory location and has been added to StoreTypeEnum. The following fields have been added to the createInventoryLocation , updateInventoryLocation, getInventoryLocation, and getInventoryLocations methods to support this new location type:
-
timeZoneId: Used to specify the time zone of the inventory location being created.
-
fulfillmentCenterSpecifications: Used to specify information about a fulfillment center's shipping specifications, such as the weekly cut-off time schedule for order handling and any cut-off time overrides.
In addition, sellers can now update the following fields for a location using the updateInventoryLocation:
-
location (only for warehouse and store location types)
-
geoCoordinates
-
timeZoneId
-
locationTypes
-
fulfillmentCenterSpecifications (only for fulfillment center location types)
New error codes
The following error codes has been added to the deleteInventoryLocationMethod:
-
25806: Deletion is not allowed when the location type of an inventory location has been set to fulfillment center. However, you may disable it.
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.
Announcement
Condition grading is now available in the United Kingdom (GB) marketplace for select trading card categories.