Skip to main content

listing APIv1_beta.3.1

Listing API release notes

Just getting started with the Listing API? See the following documents for details on using this API:

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 Listing API:

Version Release Date Summary of Release
v1_beta.3.1 2021-09-01 Seller Refurbished item condition enumeration values introduced for the Cell Phones & Smartphones category (9355)
v1_beta.3.0 2021-04-19 A new CERTIFIED_REFURBISHED ConditionEnum value has replaced the existing MANUFACTURER_REFURBISHED enumeration value.
v1_beta.2.1 2020-09-10 Added a new error code about unsupported item condition for a marketplace
v1_beta.2.0 2019-01-21 Added a type, fields, and error message to support charitable listings.
v1_beta.1.0 2020-01-15 Added types, fields, and error messages to support auctions.
v1_beta.0.0 2019-10-30 Initial release.

v1_beta.3.1

The following changes have been made to the Listing API.

Seller Refurbished item condition enumeration values introduced for the Cell Phones & Smartphones category (9355)

For the Cell Phones & Smartphones category (9355) only, the SELLER_REFURBISHED condition is being deprecated. Sellers trying to create an item draft in this category (9355) with the condition SELLER_REFURBISHED will return an error. Instead, use one of the additional refurbished items conditions (in the ConditionEnum type):

  • EXCELLENT_REFURBISHED: Indicates the item is in like-new condition, backed by a one-year warranty. It has been professionally refurbished, inspected and cleaned to excellent condition by qualified sellers. The item includes original or new accessories and will come in new generic packaging. See the seller's listing for full details. This value is available as of September 1, 2021 only for the Cell Phones & Smartphones category (9355) and only for the sellers that have gone through the application process.

  • VERY_GOOD_REFURBISHED: Indicates the item shows minimal wear and is backed by a one-year warranty. It is fully functional and has been professionally refurbished, inspected and cleaned to very good condition by qualified sellers. The item includes original or new accessories and will come in new generic packaging. See the seller's listing for full details. This value is available as of September 1, 2021 only for the Cell Phones & Smartphones category (9355) and only for the sellers that have gone through the application process.

  • GOOD_REFURBISHED: Indicates the item shows moderate wear and is backed by a one-year warranty. It is fully functional and has been professionally refurbished, inspected and cleaned to good condition by qualified sellers. The item includes original or new accessories and will come in a new generic packaging. See the seller's listing for full details. This value is available as of September 1, 2021 only for the Cell Phones & Smartphones category (9355) and only for the sellers that have gone through the application process.

Note: For the Cell Phones & Smartphones category (9355) on the US, Canada, UK, Germany, and Australia marketplaces, the SELLER_REFURBISHED item condition is being deprecated. For eligible sellers, the SELLER_REFURBISHED item condition is being replaced by the EXCELLENT_REFURBISHED, VERY_GOOD_REFURBISHED, and GOOD_REFURBISHED values. To be eligible to list with these three new item conditions, sellers must go through an application and qualification process.

v1_beta.3.0

The following changes have been made to the Listing API.

CERTIFIED_REFURBISHED enum value replaces MANUFACTURER_REFURBISHED

A new CERTIFIED_REFURBISHED ConditionEnum value has replaced the MANUFACTURER_REFURBISHED value. The 'Manufacturer Refurbished' item condition is no longer a valid item condition in any eBay marketplace, and has essentially been replaced by the 'Certified Refurbished' value. 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.

Updated error message

The following error message has been updated.

Error ID

Previous Error Message Text

New Error Message Text

155018 The {itemCondition} item condition is no longer supported for the specified marketplace. Please select another item condition. For more details, please refer to the API documentation. The {condition} item condition is restricted. Please select another item condition. For more details, please refer to the API documentation.

This error message will be triggered if a seller who is not eligible to list with the 'Cerfified Refurbished' condition tries to set the condition value to CERTIFIED_REFURBISHED.



v1_beta.2.1

The following changes have been made to the Listing API.

New error message

The following error message has been added.

Error ID

Error Message

155018 The {itemCondition} item condition is no longer supported for the specified marketplace. Please select another item condition. For more details, please refer to the API documentation.

 

v1_beta.2.0

The following changes have been made to the Listing API.

New types and fields

The following types and fields have been added.

Entity

Field/Type Name

Description

Type Charity This type is used to select a charitable organization that will receive a percentage of sale proceeds from each sale.
Request Field (Optional) charity This container is used to select a charitable organization that will receive a percentage of sale proceeds from each sale.
Request Field (Conditional) charity.charityId This field identifies the charitable organization that will receive a percentage of sale proceeds from each sale.
Request Field (Conditional) charity.donationPercentage This field sets the percentage of the sales proceeds that the charitable organization will receive from each sale.

 

New error message

The following error message has been added.

Error ID

Error Message

155017 To enable a charity donation, you must submit both 'charityId' and 'donationPercentage'.

 

v1_beta.1.0

The following changes have been made to the Listing API.

New types and fields

The following types and fields have been added.

Entity

Field/Type Name

Description

Type Amount The type that defines the fields for the currency and a monetary amount.
Type pricingSummary The container that for the information about the cost of an item, such as the price or auction start price.
Type ListingFormatEnum An enumerated type for the values that represent listing format.
Request Field (Optional) categoryId The ID of the leaf category associated with this item. A leaf category is the lowest level in that category and has no children.
Request Field (Optional) format The format of the listing. Valid Values: FIXED_PRICE and AUCTION
Request Field (Optional) PricingSummary.auctionReservePrice The minimum amount the seller is willing to sell the item for, so if the reserve price isn't met, the item won't be sold.
Request Field (Optional) PricingSummary.auctionStartPrice The minimum amount the seller is willing to sell the item for. If the reserve price isn't met, the item won't be sold.
Request Field (Optional) PricingSummary.price The Buy It Now Price for the item.

 

New error messages

The following error messages have been added.

Error ID

Error Message

155007 Invalid field: {fieldName}. The indicated field contains an invalid value. Correct the value and resubmit the call.
155008 The currency {currency} is not supported. The supported currency for the {marketplaceId} marketplace is {supportedCurrencyCode}.
155009 The 'auctionStartPrice' value must be less than 'auctionReservePrice' value.
155010 The 'price' value must be greater than 'auctionReservePrice' value.
155011 The 'AuctionReservePrice' value is not supported for FIXED_PRICE format.
155012 The 'price' value must be greater than 'auctionStartPrice' value.
155013 The 'AuctionStartPrice' value is not supported for FIXED_PRICE format.
155014 The 'Price' value format is a maximum of two decimal points.
155015 The 'AuctionStartPrice' value format is a maximum of two decimal points.
155016 The 'AuctionReservePrice' value format is a maximum of two decimal points.

 

v1_beta.0.0

This is the initial release of the Listing API. It contains the createItemDraft method that enables Partners to create an eBay listing draft for their seller using information from their site.