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 ten 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.16.1

2022-11-14

Updated picture limit

Version 1.16.0 2022-01-10 Adds support for three new refurbished condition enumeration values.
Version 1.15.0 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.
Version 1.14.0 2021-07-20 Added the field videoIds to the Product and InventoryItemGroup types to support the addition of videos to item listings.
Version 1.13.0 2021-04-21 A new CERTIFIED_REFURBISHED ConditionEnum value has been added. This new value essentially replaces the existing MANUFACTURER_REFURBISHED enumeration value, which has been deprecated.
Version 1.12.0 2021-02-17 Added support for auction listing capabilities, including new and updated types, and new error codes
Version 1.11.1 2021-01-07 Added 204 return status to updateOffer and corrected OfferResponse documentation, and other documentation updates
Version 1.11.0 2020-09-30 Added location-based inventory, scheduled listing, and private listing capabilities
Version 1.10.0 2020-09-10 Added the ability to list an item in two categories
Version 1.9.0 2020-04-28 Minor release
Version 1.8.0 2020-02-20 Minor release

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 (see 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:

  • producerProductId

  • productPackageId

  • shipmentPackageId

  • productDocumentationId

  • ecoParticipationFee

  • bulkCreateOffer
  • createOffer
  • getOffer
  • getOffers
  • updateOffer

EbayOfferDetailsWithAll

Modified (added container): extendedProducerResponsibility

  • getOffer
  • getOffers

EbayOfferDetailsWithId

Modified (added container): extendedProducerResponsibility

  • updateOffer

EbayOfferDetailsWithKeys

Modified (added container): extendedProducerResponsibility

  • bulkCreateOffer
  • createOffer

ListingPolicies

Modified (added fields):

  • takeBackPolicyId

  • productCompliancePolicyIds

  • bulkCreateOffer
  • createOffer
  • getOffer
  • getOffers
  • updateOffer

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 on supported marketplaces and platforms, as well as other requirements and limitations of video support, please 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 (see 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 (see 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

 

  • getBulkInventoryItem
  • getInventoryItem
  • getInventoryItems

FormatAllocation

 

New type

 

  • getBulkInventoryItem
  • getInventoryItem
  • getInventoryItems

FormatTypeEnum

 

New enum value added: AUCTION

 

  • bulkCreateOffer
  • createOffer
  • getOffer
  • getOffers

ListingDurationEnum

 

Updated type: Auction listing offers now supported

 

  • bulkCreateOffer
  • createOffer
  • getOffer
  • getOffers
  • updateOffer

PricingSummary

 

New fields added:

  • auctionReservePrice
  • auctionStartPrice

  • bulkCreateOffer
  • createOffer
  • getOffer
  • getOffers
  • updateOffer

ShipToLocationAvailabilityWithAll

 

New type

 

  • getBulkInventoryItem
  • getInventoryItem
  • getInventoryItems

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.

Version 1.11.1

This release of the Inventory API includes changes to the documentation and other updates for the following resources:

updateOffer

  • Added http status code of 204 Success. With a successful updateOffer call, an http status code of 204 Success is returned, and there is no response payload.

createOffer

  • Removed 204 status code

createOrReplaceInventoryItem

  • Added 25710 error code

OfferResponse

  • Corrected OfferResponse type documentation. The offerId value is only returned with successful a createOffer call. This field will not be returned in the updateOffer response.

Version 1.11.0

The following sections detail the updates that have been made for this release.

New Features

The following features were added for this release.

Ability to set available quantity at specific warehouse locations

An availabilityDistributions array was added under the shipToLocationAvailability container in inventory_item resource methods to allow the seller to set available quantity at specific warehouse locations.

Scheduled listings now supported

A listingStartDate field was added to offer resource methods to allow the seller to set a 'scheduled listing' time. With scheduled listings, the seller can set the published offer to be become an active listing at a later date/time, and not become active as soon as the publishOffer method is used.

Private listings now supported

A hideBuyerDetailsfield was added to offer resource methods to allow the seller to create a private listing. With private listings, the user IDs of buyers/bidders are only shown to the seller of the listing, and not to any other eBay users.

Schema Changes

The following schema elements were added with this release:

Type

Change

Used By

AvailabilityDistribution

New type

createOrReplaceInventoryItem, getInventoryItem, getInventoryItems, bulkCreateOrReplaceInventoryItem, bulkGetInventoryItem, bulkUpdatePriceQuantity

ShipToLocationAvailability

availabilityDistributions array added createOrReplaceInventoryItem, getInventoryItem, getInventoryItems, bulkCreateOrReplaceInventoryItem, bulkGetInventoryItem, bulkUpdatePriceQuantity

EbayOfferDetailsWithKeys

listingStartDate and hideBuyerDetails fields added createOffer, bulkCreateOffer
EbayOfferDetailsWithId listingStartDate and hideBuyerDetails fields added updateOffer

EbayOfferDetailsWithAll

listingStartDate and hideBuyerDetails fields added getOffer, getOffers
  • secondaryCategoryId field was added to allow sellers to list an item under two categories. This field was added to three types: EbayOfferDetailsWithKeys, EbayOfferDetailsWithAll, and EbayOfferDetailsWithId

Version 1.10.0

The following sections detail the updates that have been made for this release.

New Feature

A secondary category id allows items to be listed in two categories.

Schema Changes

The following schema elements were added with this release:

  • secondaryCategoryId field was added to allow sellers to list an item under two categories. This field was added to three types: EbayOfferDetailsWithKeys, EbayOfferDetailsWithAll, and EbayOfferDetailsWithId

Version 1.9.0

The following sections detail the updates that have been made for this release.

New Feature

The new includeCatalogProductDetails boolean field in the Offer methods gives sellers control over whether they want to use eBay catalog product details for their offer.

This field was added to createOffer, updateOffer, getOffer, getOffers, and bulkCreateOffers methods.

Schema Changes

The following schema elements were added with this release:

  • includeCatalogProductDetails field was added to three types: EbayOfferDetailsWithKeys, EbayOfferDetailsWithAll, and EbayOfferDetailsWithId.

Version 1.8.0

The following sections detail the updates that have been made for this release.

New Features

Charitable Listings Now Supported in Inventory API

Charitable listings are now supported with the Inventory API. With charitable listings, the seller is able to select a charitable organization that will receive a percentage of sale proceeds for each sale generated by the eBay listing. The seller uses the new charity container of the createOffer method to create a charitable listing, the charity container of the bulkCreateOffer method to create multiple charitable listings, or the seller can also use the same charity container in an updateOffer method to update an existing listing as a charitable listing.

The charity container was also added to the getOffer and getOffers methods, and this container will be returned if applicable to the offer(s).

Schema Changes

The following schema elements were added with this release :

  • Charity type was added to support the charitable listings feature