Skip to main content
Published: September 17 2010, 2:56:00 PMUpdated: November 28 2020, 8:58:24 PM

How do I specify the condition of my item when I list it using the API?

As of July 27, 2010, several categories are requiring that you specify the new, more granular Item Condition values using the new ConditionID field.

To find the right condition ID to use in your listing:

  • Use GetCategoryFeatures to determine whether ConditionEnabled is set to Enabled or Required for the category.
  • If this condition model is enabled (or required), look up the list of valid condition IDs in ConditionValues. Each ID also has a human-readable display name, such as "New" or "Manufacturer refurbished". These are returned in GetItem, but you cannot pass them in your listing request.
  • After choosing the most accurate condition ID from GetCategoryFeatures, use Item.ConditionID to specify the condition in listing (or related calls).

Here is a snippet from the listing request that illustrates listing an item with Condition 'New'

<?xml version="1.0" encoding="utf-8"?>
  <AddFixedPriceItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <RequesterCredentials>
  <eBayAuthToken>ABC...123</eBayAuthToken>
  </RequesterCredentials>
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
  <Item>
   ...
<CategoryID>94894</Category> <ConditionID>1000</ConditionID> ... </Item> </AddFixedPriceItemRequest>

How well did this answer your question?
Answers others found helpful