Skip to main content
Published: September 17 2010, 2:56:00 PMUpdated: December 01 2022, 3:12:51 PM

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

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 Trading API GetCategoryFeatures call 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 API, 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 AddFixedPriceItem API 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>

Please refer to the following AddFixedPriceItem API document for details. 

 1.   AddFixedPriceItemRequest Item.ConditionID 

 2.  AddFixedPriceItem Request Sample

 

 

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

Got thoughts? Click the feedback button – your insights help us improve!