Listing an Item

Defines default or required values for requests in the payload. The numeric eBay Site Code for which to route the requests in the payload. E.g. 77 for eBay Germany. BulkDataExchange Yes Default version for each request in the payload. Can be overridden at the request level. BulkDataExchange Yes Authentication information for the user on whose behalf the application is making the request. Only registered eBay users are allowed to make API calls. To verify that a user is registered, your application needs to pass a user-specific value called an "authentication token" in the request. This is equivalent to signing in on the eBay Web site. As API calls do not pass session information, you need to pass the user's authentication token every time you invoke a call on their behalf. All calls require an authentication token, except the calls you use to retrieve a token in the first place. (For such calls, you use the eBay member's username and password instead.) Yes Note: Large Merchant Services (LMS) functionality as a SOAP service has been decommissioned. It is fully migrated into the REST-based <a href="/api-docs/sell/feed/resources/methods" target=\"_blank\" >Sell Feed API</a> The Sell Feed API supports the same XML data files that LMS supported but through REST methods. For more information, see the <a href="/api-docs/sell/static/feed/lms-feeds.html" target="_blank" >LMS Feed Guide</a>. A report that contains price and quantity information for all of the active listings for a specific seller. A seller can use this information to maintain their inventory on eBay. The eBay servers read the token information passed in by the seller's application to determine which seller's data to retrieve.

Reports price and quantity details for a seller's active listings.

Trading https://developer.ebay.com/devzone/xml/docs/reference/ebay ReviseInventoryStatus

Enables a seller to change the price and quantity of currently active fixed-price items. Can be uploaded in bulk with Large Merchant Services.

ReviseFixedPriceItem

Enables a seller to change the properties of a single currently active listing. Can be uploaded in bulk with Large Merchant Services.

A report that contains all of the active listings for a specific seller. The eBay servers read the token information passed in by the seller's application to determine which seller's data to retrieve. Describes or includes keywords associated with the SKU. ActiveInventoryReport Always This call allows a seller to create and publish a fixed-price listing. The main difference between AddFixedPriceItem and AddItem is that AddFixedPriceItem supports the creation of fixed-price listings only, whereas AddItem supports all listing formats. Also, only AddFixedPriceItem supports multiple-variation listings and tracking inventory by a seller-defined SKU value. AddItem does not support Variations or the InventoryTrackingMethod field.

Defines and publishes a single or multiple-variation fixed-price listing.

AddItem, AddItems, VerifyAddFixedPriceItem Listing an Item https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listing-AnItem.html Listing Items https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listing.html Introduction to Pictures in Listings https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Pictures-Intro.html Using Multi-Variation Listings https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Variations.html This container is used to specify all of the values and settings that define a new fixed-price listing. AddFixedPriceItem Yes If the new listing is created successfully, the AddFixedPriceItem response includes the unique identifier of the new listing (ItemID) and the estimated values of any fees (such as insertion fee and any other listing upgrade fees) generated as a result of the listing being created. Other response fields include the the start and end times of the listing, and any other applicable fields such as the product SKU (if defined by seller), listing recommendations (if applicable), or other details. Unique identifier for the new fixed-price listing. This field is returned as long as the listing was successfully created. AddFixedPriceItem Always The SKU value for an item is returned if the seller specified a SKU value through the Item.SKU field in the request. In the case of a multiple-variation listing, variation-level SKU values are not returned in the response. To get this data, a GetItem call would have to be made by the seller. AddFixedPriceItem Conditionally Starting date and time for the new listing. This value is based on the time the listing was received and processed, or the time the item will be listed if the seller included the Item.ScheduleTime field in the request and set a custom start time of the listing (in the future). AddFixedPriceItem Always Date and time when the new listing is scheduled to end based on the start time and the listing duration value that was set in the ListingDuration field at listing time. If the value of ListingDuration was set to <code>GTC</code> (Good 'Til Cancelled) this value will be set one month ahead of the start time, and this value will continue to be updated one month ahead each time the GTC listing needs to be renewed. Fixed-price listings get renewed automatically as long as there is still a quantity of <code>1</code> or above, or even if the quantity is <code>0</code>, but the 'out-of-stock control' feature is enabled. Note: As of July 1, 2019, the Good 'Til Cancelled renewal schedule has been modified from every 30 days to once per calendar month. For example, if a GTC listing is created July 5, the next monthly renewal date will be August 5. If a GTC listing is created on the 31st of the month, but the following month only has 30 days, the renewal will happen on the 30th in the following month. Finally, if a GTC listing is created on January 29-31, the renewal will happen on February 28th (or 29th during a 'Leap Year'). See the <a href="https://pages.ebay.com/seller-center/seller-updates/2019-spring/marketplace-updates.html#good-til-cancelled" target="_blank">Good 'Til Cancelled listings update</a> in the Spring 2019 Seller Updates for more information about this change. AddFixedPriceItem Conditionally This container is an array of fees associated with the creation of the listing. The fees in this container will not include any fees that are based on the purchase price (such as Final Value Fee) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the new listing and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the AddFixedPriceItem call to list an item on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. eBay.com Fees http://pages.ebay.com/help/sell/fees.html AddFixedPriceItem Always Fees per Site https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/IntlDiffs-Fees.html The unique identifier of the primary category in which the item was listed. This field is only returned if the Item.CategoryMappingAllowed boolean field is set to <code>true</code> in the request (or omitted) and the Category ID passed in as the primary listing category was automatically mapped to a new Category ID by eBay. If the primary category ID passed in the request is still active/valid, this field is not returned. Note: The Item.CategoryMappingAllowed field value in the request now defaults to <code>true</code> if omitted. Previously, the default value was <code>false</code>, so a user had to include this field and set it to <code>true</code> in order for eBay to map an outdated Primary or Secondary Category ID to the updated Category ID. 10 AddFixedPriceItem Conditionally Unique identifier of the secondary category in which the item was listed. This field is only returned if the Item.CategoryMappingAllowed boolean field is set to <code>true</code> in the request (or omitted) and the Category ID passed in as the secondary listing category was automatically mapped to a new Category ID by eBay. If the secondary category ID passed in the request is still active/valid, this field is not returned. Note: The Item.CategoryMappingAllowed field value in the request now defaults to <code>true</code> if omitted. Previously, the default value was <code>false</code>, so a user had to include this field and set it to <code>true</code> in order for eBay to map an outdated Primary or Secondary Category ID to the updated Category ID. 10 AddFixedPriceItem Conditionally This container is an array of one or more listing fee/upgrade discount types being offered by eBay to the seller. AddFixedPriceItem Conditionally This container holds an array of one or more products in the eBay product catalog that appear to match the product being listed, just based on the information in the listing. This container will not be returned if no similar products were found in the eBay product catalog. AddFixedPriceItem Conditionally Base request type for the AddItem call, which is used to create a fixed-price, auction, or classified ad listing. The AddItem call does not support multiple-variation listings, so the AddFixedPriceItem call must be used to create multiple-variation listings.

Creates a fixed-price, auction, or classified ad listing.

AddFixedPriceItem, AddItems, VerifyAddItem Listing an Item https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listing-AnItem.html Listing Items https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listing.html Introduction to Pictures in Item Listings https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Pictures-Intro.html This container is used to specify all of the values and settings that define a new listing. AddItem Yes If the new listing is created successfully, the AddItem response includes the unique identifier of the new listing (ItemID) and the estimated values of any fees (such as insertion fee and any other listing upgrade fees) generated as a result of the listing being created. Other response fields include the the start and end times of the listing, and any other applicable fields such as the product SKU (if defined by seller), listing recommendations (if applicable), or other details. Unique identifier for the new listing. This field is returned as long as the listing was successfully created. AddItem Always Starting date and time for the new listing. This value is based on the time the listing was received and processed, or the time the item will be listed if the seller included the Item.ScheduleTime field in the request and set a custom start time of the listing (in the future). AddItem Always Date and time when the new listing is scheduled to end based on the start time and the listing duration value that was set in the ListingDuration field at listing time. If the value of ListingDuration was set to <code>GTC</code> (Good 'Til Cancelled) this value will be set one month ahead of the start time, and this value will continue to be updated one month ahead each time the GTC listing needs to be renewed. Fixed-price listings get renewed automatically as long as there is still a quantity of <code>1</code> or above, or even if the quantity is <code>0</code>, but the 'out-of-stock control' feature is enabled. Note that <code>GTC</code> is not a supported listing duration for auction listings, but is the only supported listing duration for fixed-price listings except for a few motor vehicle categories on eBay Motors US, eBay UK, and eBay Italy. Note: As of July 1, 2019, the Good 'Til Cancelled renewal schedule has been modified from every 30 days to once per calendar month. For example, if a GTC listing is created July 5, the next monthly renewal date will be August 5. If a GTC listing is created on the 31st of the month, but the following month only has 30 days, the renewal will happen on the 30th in the following month. Finally, if a GTC listing is created on January 29-31, the renewal will happen on February 28th (or 29th during a 'Leap Year'). See the <a href="https://pages.ebay.com/seller-center/seller-updates/2019-spring/marketplace-updates.html#good-til-cancelled" target="_blank">Good 'Til Cancelled listings update</a> in the Spring 2019 Seller Updates for more information about this change. AddItem Always This container is an array of fees associated with the creation of the listing. The fees in this container will not include any fees that are based on the purchase price (such as Final Value Fee) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the new listing and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the AddItem call to list an item on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. AddItem Always eBay.com Selling Fees https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822 Fees per Site https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/IntlDiffs-Fees.html The unique identifier of the primary category in which the item was listed. This field is only returned if the Item.CategoryMappingAllowed boolean field is set to <code>true</code> in the request (or omitted) and the Category ID passed in as the primary listing category was automatically mapped to a new Category ID by eBay. If the primary category ID passed in the request is still active/valid, this field is not returned. Note: The Item.CategoryMappingAllowed field value in the request now defaults to <code>true</code> if omitted. Previously, the default value was <code>false</code>, so a user had to include this field and set it to <code>true</code> in order for eBay to map an outdated Primary or Secondary Category ID to the updated Category ID. 10 AddItem Conditionally Unique identifier of the secondary category in which the item was listed. This field is only returned if the Item.CategoryMappingAllowed boolean field is set to <code>true</code> in the request (or omitted) and the Category ID passed in as the secondary listing category was automatically mapped to a new Category ID by eBay. If the secondary category ID passed in the request is still active/valid, this field is not returned. Note: The Item.CategoryMappingAllowed field value in the request now defaults to <code>true</code> if omitted. Previously, the default value was <code>false</code>, so a user had to include this field and set it to <code>true</code> in order for eBay to map an outdated Primary or Secondary Category ID to the updated Category ID. 10 AddItem Conditionally This container is an array of one or more listing fee/upgrade discount types being offered by eBay to the seller. AddItem Conditionally This container holds an array of one or more products in the eBay product catalog that appear to match the product being listed, just based on the information in the listing. This container will not be returned if no similar products were found in the eBay product catalog. AddItem Conditionally Ends the specified fixed-price listing before the date and time at which it would normally end (per the listing duration). EndItem, EndItems Ending Items Early https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listings-EndingEarly.html Unique identifier of the listing that you want to end. In the EndFixedPriceItem request, either ItemID or SKU value is required. If both are passed in and they don't refer to the same listing, eBay ignores SKU and considers only the ItemID. EndFixedPriceItem Conditionally The seller's reason for ending the listing early is input into this required field. The seller is not allowed to use the <code>ProductDeleted</code> value, as this ending reason can only be used internally by eBay to administratively end a listing due to the associated Catalog product being removed from the eBay Catalog. ProductDeleted EndFixedPriceItem Yes The seller-defined SKU (stock keeping unit) value of the item in the listing being ended. The SKU field can only be used to end a listing if that listing was created or relisted with an AddFixedPriceItem or RelistFixedPriceItem call, and the Item.InventoryTrackingMethod was included in the call and set to <code>SKU</code>. In the EndFixedPriceItem request, either ItemID or SKU is required. If both are passed in and they don't refer to the same listing, eBay ignores SKU and considers only the lt;b>ItemID. 50 EndFixedPriceIteme> Conditionally Acknowledgement that includes SKU, as well as the date and time that the listing ended due to the call to EndFixedPriceItem. Timestamp that indicates the date and time (GMT) that the specified listing was ended. EndFixedPriceItem Always If a SKU (stock-keeping unit) exists for the item in the listing, it is returned in the response. 50 EndFixedPriceIteme> Conditionally Ends the specified item listing before the date and time at which it would normally end per the listing duration. EndFixedPriceItem, EndItems Ending Items Early https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listings-EndingEarly.html Unique item ID that identifies the listing that you want to end. EndItem Yes The seller's reason for ending the listing early is input into this required field. The seller is not allowed to use the <code>ProductDeleted</code> value, as this ending reason can only be used internally by eBay to administratively end a listing due to the associated Catalog product being removed from the eBay Catalog. EndItem Yes ProductDeleted This field was previously only used to identify and end Half.com listings, and since the Half.com site has been shut down, this element is no longer applicable. 1027 NoOp 1033 This type includes the acknowledgement of the date and time when the eBay listing was ended due to the call to EndItem. This timestamp indicates the date and time (returned in GMT) when the specified eBay listing was ended. EndItem Always Note: Large Merchant Services (LMS) functionality as a SOAP service has been decommissioned. It is fully migrated into the REST-based <a href="/api-docs/sell/feed/resources/methods" target=\"_blank\" >Sell Feed API</a> The Sell Feed API supports the same XML data files that LMS supported but through REST methods. For more information, see the <a href="/api-docs/sell/static/feed/lms-feeds.html" target="_blank" >LMS Feed Guide</a>. OrderAck is used to acknowledge that a single line item order, or an individual line item within a multiple line item order has been received. Once an order or order line item is successfully acknowledged with an OrderAck call, that order or order line item will not appear in the OrderReport response when you run either of those calls again.

This call is used to acknowledge that a single line item order, or an individual line item within a multiple line item order has been received.

A unique identifier for an eBay order. An eBay order can contain one or more order line items. This field is used to acknowledge a single line item order. If the eBay order has multiple line items, an OrderAck call will be required to acknowledge each of those order line items, and the OrderLineItemID field must be used instead. Typically, the OrderAck call will only be used on orders/line items that have already been paid for and shipped. Note: In June 2019, eBay introduced a new order ID format, but allowed developers/sellers to decide whether to immediately adopt the new format, or to continue working with the old format. Users who wanted to adopt the new format, could either use a Trading WSDL Version 1113 (or newer), or they could even use an older Trading WSDL but set the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header value to <code>1113</code> in API calls. Beginning in June 2020, only the new order ID format will be returned in response payloads for paid orders, regardless of the WSDL version number or compatibility level. Note that the unique identifier of a 'non-immediate payment' order will change as it goes from an unpaid order to a paid order. Due to this scenario, all calls that accept Order ID values as filters in the request payload, including the OrderAck call, will support the identifiers for both unpaid and paid orders. However, the OrderAck call is typically only used to acknowledge orders/line items that have already been paid for, so the new order ID format will be used for this call in most cases. The new order ID format is a non-parsable string, globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. Unlike in the past, instead of just being known and exposed to the seller, these unique order identifiers will also be known and used/referenced by the buyer and eBay customer support. Sellers can check to see if an order has been paid by looking for a value of 'Complete' in the CheckoutStatus.Status field in the response of GetOrders or GetOrderTransactions call, or in the Status.CompleteStatus field in the response of GetItemTransactions or GetSellerTransactions call. Sellers should not fulfill orders until buyer has made payment. 40 OrderAck Conditionally A unique identifier for an order line item within an eBay order. An eBay order can contain one or more order line items. If you use this field, only the specified order line item will be acknowledged, and any additional order line items within the eBay order will remain unacknowledged. If an order only has one order line item, either the OrderID or the OrderLineItemID field will acknowledge the entire order. OrderAck Conditionally The base response type of the OrderAck call. This is the unique identifier of the order line item that was successfully acknowledged. This field is returned whether an OrderID (for a single line item order) or an OrderLineItemID value was passed into the call request. OrderAck Always Note: Large Merchant Services (LMS) functionality as a SOAP service has been decommissioned. It is fully migrated into the REST-based <a href="/api-docs/sell/feed/resources/methods" target=\"_blank\" >Sell Feed API</a> The Sell Feed API supports the same XML data files that LMS supported but through REST methods. For more information, see the <a href="/api-docs/sell/static/feed/lms-feeds.html" target="_blank" >LMS Feed Guide</a>. OrderReport shows detailed information on all unacknowledged orders, and all unacknowledged line items in each order from the past 30 days. The unique identifier of each order is shown in the Order.OrderID response field, and unique identifier of each order line item is shown in a separate Transaction.OrderLineItemID response field. Only unfulfilled orders will appear in the response, and orders that have already shipped will not. Sellers use the information in OrderReport to make inventory updates and start order fulfillment. Note: Once orders and order line items have been acknowledged with the OrderAck call, those orders and order line items will no longer appear in the OrderReport response. See <a href="/api-docs/sell/static/feed/lms-feeds-managing-inventory.html#acknowledging-sales" target="_blank">Acknowledging Sales</a> for more information.

Shows detailed information on all unacknowledged orders, and all unacknowledged line items in each order from the past 30 days.

OrderReport shows detailed information on all unacknowledged orders, and all unacknowledged line items in each order from the past 30 days. The unique identifier of each order is shown in the Order.OrderID response field, and unique identifier of each order line item is shown in a separate Transaction.OrderLineItemID response field. Only unfulfilled orders will appear in the response, and orders that have already shipped will not. Sellers use the information in OrderReport to make inventory updates and start order fulfillment. Note: Once orders and order line items have been acknowledged with the OrderAck call, those orders and order line items will no longer appear in the OrderReport response. See <a href="https://developer.ebay.com/api-docs/sell/static/feed/lms-feeds-managing-inventory.html#acknowledging-sales" target="_blank">Acknowledging Sales</a> for more information. Contains information about Expiration date of the user's authentication token. Only returned within the 7-day period prior to a token's expiration OrderReport Conditionally An enumeration value that indicates the status of the current job. Values may include 'Success', 'Warning', 'Failure', or 'Partial Failure'. If any value other that 'Success' is displayed, the error(s)/issue(s) should be displayed under an Errors container. OrderReport Always This value indicates the version of the Merchant Data WSDL that eBay used to process the request. OrderReport Always An Errors container is returned for each warning or error that occurs when the call is processed. Each Errors container consists of detailed information on the warning or error, including the actual error message and information on any input parameters that actually triggered the warning or error. OrderReport Conditionally This container is an array of unacknowledged orders for the seller that occurred within the last 30 days (or less based on the Bulk Data Exchange job). OrderReport Always Enables a seller to relist a fixed-price listing that has recently ended on a specified eBay site. A seller has to up to 90 days to relist an ended listing. When an item is relisted, it will receive a new ItemID value, but this item will remain on other users' Watch Lists after it is relisted. The seller has the opportunity to make changes to the listing through the Item container, and the seller can also use one or more DeletedField tags to remove an optional field/setting from the listing. RelistItem, VerifyRelistItem Relisting Items with Trading API https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listings-RelistingItems.html Relisting items (eBay Help page) https://pages.ebay.com/help/sell/relist.html The Item container is used to configure the item that will be relisted. If the seller plans to relist the item with no changes, the only field under the Item container that is required is the ItemID field. In the ItemID field, the seller specifies the item that will be relisted. If the seller wishes to change anything else for the listing, the seller should include this field in the call request and give it a new value. If the seller wants to delete one or more optional settings in the listing, the seller should use the DeletedField tag. RelistFixedPriceItem Yes Specifies the name of the field to delete from a listing. See <a href="https://developer.ebay.com/Devzone/guides/features-guide/default.html#development/Listings-RelistingItems.html">Relisting Items</a> for rules on deleting values when relisting items. Also see the relevant field descriptions to determine when to use DeletedField (and potential consequences). The request can contain zero, one, or many instances of DeletedField (one for each field to be deleted). Some data (such as Variation nodes within Variations) can't be deleted by using a DeletedField tag. See the relevant field descriptions for how to delete such data. Case-sensitivity must be taken into account when using a DeletedField tag to delete a field. The value passed into a DeletedField tag must either match the case of the schema element names in the full field path (Item.PictureDetails.GalleryURL), or the initial letter of each schema element name in the full field path must be lowercase (item.pictureDetails.galleryURL). Do not change the case of letters in the middle of a field name. For example, item.picturedetails.galleryUrl is not allowed. To delete a listing enhancement like 'BoldTitle', specify the value you are deleting; for example, Item.ListingEnhancement[BoldTitle]. RelistFixedPriceItem Conditionally The base response type for the RelistFixedPriceItem call. The response includes the Item ID for the relisted item, the SKU value for the item (if any), listing recommendations (if applicable), the estimated fees for the relisted item (except the Final Value Fee, which isn't calculated until the item has sold), the start and end times of the listing, and other details. The unique identifier for the relisted item. Note that the ItemID value changes when a listing is relisted, so this will not be the same ItemID value that was passed in the call request. RelistFixedPriceItem Always The seller-defined SKU value for the new listing (if a SKU value exists for the item). Note that variation-level SKU values will not be returned if a multiple-variation listing was relisted. The seller would have to make a GetItem call to get variation-level SKU values. RelistFixedPriceItem Conditionally This container is an array of fees associated with the relisted item. The fees in this container will not include any fees that are based on the purchase price (such as Final Value Fee) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the relisted item and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the RelistFixedPriceItem call to relist an item on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. RelistFixedPriceItem Always eBay.com Selling Fees https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822 Fees Per Site https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/IntlDiffs-Fees.html This timestamp indicates the date and time when the relisted item became active on the eBay site. RelistFixedPriceItem Always Date and time when the relisted item is scheduled to end based on the start time and the listing duration value that was set in the ListingDuration field. If the value of ListingDuration was set to <code>GTC</code> (Good 'Til Cancelled), this value will be set 30 days ahead of the start time, although this value will be updated if the GTC listing is still alive and automatically renewed 30 days after start time. Note: Starting July 1, 2019, the Good 'Til Cancelled renewal schedule will be modified from every 30 days to once per calendar month. For example, if a GTC listing is created July 5, the next monthly renewal date will be August 5. If a GTC listing is created on the 31st of the month, but the following month only has 30 days, the renewal will happen on the 30th in the following month. Finally, if a GTC listing is created on January 29-31, the renewal will happen on February 28th (or 29th during a 'Leap Year'). See the <a href="https://pages.ebay.com/seller-center/seller-updates/2019-spring/marketplace-updates.html#good-til-cancelled" target="_blank">Good 'Til Cancelled listings update</a> in the Spring 2019 Seller Updates for more information about this change. RelistFixedPriceItem Always Unique identifier of the primary eBay category in which the item was relisted. This field is only returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.PrimaryCategory field was mapped to a new category ID by eBay. If the primary category has not changed or it has expired with no replacement, this field is not returned. 10 RelistFixedPriceItem Conditionally Unique identifier of the secondary eBay category (if one was used) in which the item was relisted. This field is only returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.SecondaryCategory field was mapped to a new category ID by eBay. If the secondary category has not changed or it has expired with no replacement, this field is not returned. 10 RelistFixedPriceItem Conditionally This field is returned if an eBay special offer or promotion is applicable to the listing. RelistFixedPriceItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. RelistFixedPriceItem Conditionally Enables a seller to relist a listing that has recently ended on a specified eBay site. A seller has to up to 90 days to relist an ended listing. When an item is relisted, it will receive a new ItemID value, but this item will remain on other users' Watch Lists after it is relisted. The seller has the opportunity to make changes to the listing through the Item container, and the seller can also use one or more DeletedField tags to remove an optional field/setting from the listing. RelistFixedPriceItem, VerifyRelistItem Relisting Items with Trading API https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listings-RelistingItems.html https://ebaydts.com/eBayKBDetails?KBid=1542 Best practices for relisting items Relisting items (eBay Help page) https://pages.ebay.com/help/sell/relist.html The Item container is used to configure the item that will be relisted. If the seller plans to relist the item with no changes, the only field under the Item container that is required is the ItemID field. In the ItemID field, the seller specifies the item that will be relisted. If the seller wishes to change anything else for the listing, the seller should include this field in the call request and give it a new value. If the seller wants to delete one or more optional settings in the listing, the seller should use the DeletedField tag. RelistItem Yes Specifies the name of the field to delete from a listing. See <a href="https://developer.ebay.com/Devzone/guides/features-guide/default.html#development/Listings-RelistingItems.html">Relisting Items</a> for rules on deleting values when relisting items. Also see the relevant field descriptions to determine when to use DeletedField (and potential consequences). The request can contain zero, one, or many instances of DeletedField (one for each field to be deleted). Case-sensitivity must be taken into account when using a DeletedField tag to delete a field. The value passed into a DeletedField tag must either match the case of the schema element names in the full field path (Item.PictureDetails.GalleryURL), or the initial letter of each schema element name in the full field path must be lowercase (item.pictureDetails.galleryURL). Do not change the case of letters in the middle of a field name. For example, item.picturedetails.galleryUrl is not allowed. To delete a listing enhancement like 'BoldTitle', specify the value you are deleting; for example, Item.ListingEnhancement[BoldTitle]. RelistItem Conditionally The base response type for the RelistItem call. The response includes the Item ID for the relisted item, the SKU value for the item (if any), listing recommendations (if applicable), the estimated fees for the relisted item (except the Final Value Fee, which isn't calculated until the item has sold), the start and end times of the listing, and other details. The unique identifier for the relisted item. Note that the ItemID value changes when a listing is relisted, so this will not be the same ItemID value that was passed in the call request. RelistItem Always This container is an array of fees associated with the relisted item. The fees in this container will not include any fees that are based on the purchase price (such as Final Value Fee) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the relisted item and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the RelistItem call to relist an item on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. RelistItem Always eBay.com Selling Fees https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822 Fees Per Site https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/IntlDiffs-Fees.html This timestamp indicates the date and time when the relisted item became active on the eBay site. RelistItem Always This timestamp indicates the date and time when the relisted item is scheduled to end on the eBay site. This date/time is calculated by using the StartTime and the the listing duration. Note: Starting July 1, 2019, the Good 'Til Cancelled renewal schedule will be modified from every 30 days to once per calendar month. For example, if a GTC listing is created July 5, the next monthly renewal date will be August 5. If a GTC listing is created on the 31st of the month, but the following month only has 30 days, the renewal will happen on the 30th in the following month. Finally, if a GTC listing is created on January 29-31, the renewal will happen on February 28th (or 29th during a 'Leap Year'). See the <a href="https://pages.ebay.com/seller-center/seller-updates/2019-spring/marketplace-updates.html#good-til-cancelled" target="_blank">Good 'Til Cancelled listings update</a> in the Spring 2019 Seller Updates for more information about this change. RelistItem Always Unique identifier of the primary eBay category in which the item was relisted. This field is only returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.PrimaryCategory field was mapped to a new category ID by eBay. If the primary category has not changed or it has expired with no replacement, this field is not returned. 10 RelistItem Conditionally Unique identifier of the secondary eBay category (if one was used) in which the item was relisted. This field is only returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.SecondaryCategory field was mapped to a new category ID by eBay. If the secondary category has not changed or it has expired with no replacement, this field is not returned. 10 RelistItem Conditionally This field is returned if an eBay special offer or promotion is applicable to the listing. RelistItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. RelistItem Conditionally Enables a seller to revise a fixed-price listing on a specified eBay site. To revise an active listing, the seller specifies the ItemID value for the listing. The seller makes one or multiple changes to the listing through the Item container, and the seller can also use one or more DeletedField tags to remove an optional field/setting from the listing. ReviseItem Revising a Listing https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listings-Revising.html The Item container is used to make changes to the active listing. The seller must pass in the ItemID value for the listing that is being revised. For anything else that the seller wishes to change, such as quantity or price, the seller should include this field in the call request and give it a new value. If the seller wants to delete one or more optional settings in the listing, the seller should use the DeletedField tag. ReviseFixedPriceItem Yes Specifies the name of a field to delete from a listing. The request can contain zero, one, or many instances of DeletedField (one for each field to be deleted). See the relevant field descriptions to determine when to use DeletedField (and potential consequences). You cannot delete required fields from a listing. Some fields are optional when you first list an item (e.g., SecondaryCategory), but once they are set they cannot be deleted when you revise an item. Some optional fields cannot be deleted if the item has bids and/or ends within 12 hours. Some optional fields cannot be deleted if other fields depend on them. Some data (such as Variation nodes within the Variations container) can't be deleted by using DeletedField. See the relevant field descriptions for how to delete such data. Use values that match the case of the schema element names (Item.PictureDetails.GalleryURL) or make the initial letter of each field name lowercase (item.pictureDetails.galleryURL). However, do not change the case of letters in the middle of a field name. For example, item.picturedetails.galleryUrl is not allowed. To delete a listing enhancement like BoldTitle, specify the value you are deleting in square brackets ("[ ]"); for example, Item.ListingEnhancement[BoldTitle]. ReviseFixedPriceItem Conditionally The base response type for the ReviseFixedPriceItem call. The response includes the Item ID for the revised item, the SKU value for the item (if any), listing recommendations (if applicable), the estimated fees for the revised item (except the Final Value Fee, which isn't calculated until the item has sold), the start and end times of the listing, and other details. The unique identifier for the revised listing. Note that the ItemID value does not change when a listing is revised, so this will be the same ItemID value that was passed in the call request. ReviseFixedPriceItem Always The seller-defined SKU value for the revised listing (if a SKU value exists for the item). Note that variation-level SKU values will not be returned if a multiple-variation listing was revised. The seller would have to make a GetItem call to get variation-level SKU values. ReviseFixedPriceItem Conditionally This timestamp indicates the date and time when the listing was created on the eBay site. This value doesn't change when a listing is revised. ReviseFixedPriceItem Always Date and time when the revised listing is scheduled to end based on the listing's start time and the listing duration value that was set for the listing. If the listing duration is 'GTC' (Good 'Til Cancelled), this value will be updated to 30 days in the future if the listing is automatically renewed after 30 days. GTC listings are automatically renewed if quantity still exists for the item. Note: Starting July 1, 2019, the Good 'Til Cancelled renewal schedule will be modified from every 30 days to once per calendar month. For example, if a GTC listing is created July 5, the next monthly renewal date will be August 5. If a GTC listing is created on the 31st of the month, but the following month only has 30 days, the renewal will happen on the 30th in the following month. Finally, if a GTC listing is created on January 29-31, the renewal will happen on February 28th (or 29th during a 'Leap Year'). See the <a href="https://pages.ebay.com/seller-center/seller-updates/2019-spring/marketplace-updates.html#good-til-cancelled" target="_blank">Good 'Til Cancelled listings update</a> in the Spring 2019 Seller Updates for more information about this change. ReviseFixedPriceItem Always This container is an array of fees associated with the revised listing. The fees in this container will not include any fees that are based on the purchase price (such as Final Value Fee) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the revised listing and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the ReviseFixedPriceItem call to relist an item on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. ReviseFixedPriceItem Always eBay.com Fees http://pages.ebay.com/help/sell/fees.html Fees per Site https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/IntlDiffs-Fees.html Unique identifier of the primary eBay category for the revised listing. This field is returned if the primary category was changed with the revision, and the primary category can only be changed if a fixed-price listing has no sales, and the listing does not end within 12 hours. This field can also be returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.PrimaryCategory field was mapped to a new category ID by eBay. If the primary category has not changed or it has expired with no replacement, this field is not returned. 10 ReviseFixedPriceItem Conditionally Unique identifier of the secondary eBay category for the revised listing. This field is returned if the secondary category was changed with the revision, and the secondary category can only be changed if a fixed-price listing has no sales, and the listing does not end within 12 hours. This field can also be returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.PrimaryCategory field was mapped to a new category ID by eBay. If the primary category has not changed or it has expired with no replacement, this field is not returned. 10 ReviseFixedPriceItem Conditionally This field is returned if an eBay special offer or promotion is applicable to the listing. ReviseFixedPriceItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. ReviseFixedPriceItem Conditionally Enables a seller to change the price and/or quantity of one to four active, fixed-price listings. The fixed-price listing to modify is identified with the ItemID of the listing and/or the SKU value of the item (if a seller-defined SKU value exists for the listing). If the seller is modifying one or more variations within a multiple-variation listing, the ItemID and SKU fields in the InventoryStatus container become required, with the ItemID value identifying the listing, and the SKU value identifying the specific product variation within that multiple-variation listing. Each variation within a multiple-variation listing requires a seller-defined SKU value. Whether updating the price and/or quantity of a single-variation listing or a specific variation within a multiple-variation listing, the limit of items or item variations that can be modified with one call is four.

Enables a seller to change the price and/or quantity of one or more fixed-price listings (single-variation or multiple-variation).

ReviseItem Revising a Listing https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listings-Revising.html One InventoryStatus container is required for each item or item variation that is being revised. Whether updating the price and/or quantity of a single-variation listing or a specific variation within a multiple-variation listing, the limit of items or item variations that can be modified with one call is four. ReviseInventoryStatus Yes 4 The base response type for the ReviseInventoryStatus call. The response includes a Fees container and an InventoryStatus container for each item and/or item variation that was revised. One InventoryStatus container is returned for each item or item variation that was revised. Whether updating the price and/or quantity of a single-variation listing or a specific variation within a multiple-variation listing, the limit of items or item variations that can be modified with one call is four. Note that the SKU field is returned as an empty tag if it is not defined for a single-variation listing. StartTime, EndTime ReviseInventoryStatus Always 4 A Fees container is returned for each fixed-price listing that was modified with the ReviseInventoryStatus call. This container consists of the estimated listing fees for the revised listing, and the listing is identified in the ItemID field. Each type of fee is returned even if it is not appplicable (has a value of <code>0.0</code>. The Final Value Fee (FVF) is not in this container, as this value cannot be determined until a sale is made. Note that these fees are at the listing level, so if multiple variations within a multiple-variation listing were modified, the fees in this container would be cumulative totals, and would not single out the fees associated with each modified item variation. Please note that since fees are returned at the listing level, it is possible that the response will include one Fees container and four InventoryStatus containers if you made revisions to four different item variations within the same multiple-variation listing. ReviseInventoryStatus 4 Always eBay.com Fees http://pages.ebay.com/help/sell/fees.html Fees per Site https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/IntlDiffs-Fees.html Final Value Fees and Credits https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Sales-Completing.html Final Value Fees http://pages.ebay.com/help/sell/fvf.html Enables a seller to revise a listing on a specified eBay site. To revise an active listing, the seller specifies the ItemID value for the listing. The seller makes one or multiple changes to the listing through the Item container, and the seller can also use one or more DeletedField tags to remove an optional field/setting from the listing. After a multiple-quantity, fixed-price listing has one or more sales, or less than 12 hours remain before the listing is scheduled to end, you can not edit the values in the Listing Title, Primary Category, Secondary Category, Listing Duration, and Listing Type fields for that listing. The same applies to an auction listing that has at least one bid. To revise a multiple-variation, fixed-price listing, the ReviseFixedPriceItem call should be used instead, as the ReviseItem call does not support variation-level edits. ReviseFixedPriceItem, ReviseInventoryStatus Revising a Listing https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listings-Revising.html The Item container is used to make changes to the active listing. The seller must pass in the ItemID value for the listing that is being revised. For anything else that the seller wishes to change, such as quantity or price, the seller should include this field in the call request and give it a new value. If the seller wants to delete one or more optional settings in the listing, the seller should use the DeletedField tag. ReviseItem Yes Specifies the name of a field to delete from a listing. The request can contain zero, one, or many instances of DeletedField (one for each field to be deleted). See the relevant field descriptions to determine when to use DeletedField (and potential consequences). You cannot delete required fields from a listing. Some fields are optional when you first list an item (e.g., SecondaryCategory), but once they are set they cannot be deleted when you revise an item. Some optional fields cannot be deleted if the item has bids and/or ends within 12 hours. Some optional fields cannot be deleted if other fields depend on them. Use values that match the case of the schema element names (Item.PictureDetails.GalleryURL) or make the initial letter of each field name lowercase (item.pictureDetails.galleryURL). However, do not change the case of letters in the middle of a field name. For example, item.picturedetails.galleryUrl is not allowed. To delete a listing enhancement like BoldTitle, specify the value you are deleting in square brackets ("[ ]"); for example, Item.ListingEnhancement[BoldTitle]. ReviseItem No When the VerifyOnly is included and set as <code>true</code>, the active listing is not actually revised, but the same response is returned and the seller gets to see the expected fees based on the changes made, and can also view any listing recommendations if the Item.IncludeRecommedations boolean field is included and set to <code>true</code>. ReviseItem No The base response type for the ReviseItem call. The response includes the Item ID for the revised item, the SKU value for the item (if any), listing recommendations (if applicable), the estimated fees for the revised item (except the Final Value Fee, which isn't calculated until the item has sold), the start and end times of the listing, and other details. The unique identifier for the revised listing. Note that the ItemID value does not change when a listing is revised, so this will be the same ItemID value that was passed in the call request. ReviseItem Always This timestamp indicates the date and time when the listing was created on the eBay site. This value doesn't change when a listing is revised. ReviseItem Always Date and time when the revised listing is scheduled to end based on the listing's start time and the listing duration value that was set for the listing. If the listing duration is 'GTC' (Good 'Til Cancelled), this value will be updated to 30 days in the future if the listing is automatically renewed after 30 days. GTC listings are automatically renewed if quantity still exists for the item. Note that GTC is not applicable to auction listings. Note: Starting July 1, 2019, the Good 'Til Cancelled renewal schedule will be modified from every 30 days to once per calendar month. For example, if a GTC listing is created July 5, the next monthly renewal date will be August 5. If a GTC listing is created on the 31st of the month, but the following month only has 30 days, the renewal will happen on the 30th in the following month. Finally, if a GTC listing is created on January 29-31, the renewal will happen on February 28th (or 29th during a 'Leap Year'). See the <a href="https://pages.ebay.com/seller-center/seller-updates/2019-spring/marketplace-updates.html#good-til-cancelled" target="_blank">Good 'Til Cancelled listings update</a> in the Spring 2019 Seller Updates for more information about this change. ReviseItem Always This container is an array of fees associated with the revised listing. The fees in this container will not include any fees that are based on the purchase price (such as Final Value Fee) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the revised listing and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the ReviseItem call to relist an item on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. ReviseItem Always eBay.com Fees http://pages.ebay.com/help/sell/fees.html Fees per Site https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/IntlDiffs-Fees.html Unique identifier of the primary eBay category for the revised listing. This field is returned if the primary category was changed with the revision, and the primary category can only be changed if a fixed-price listing has no sales/auction listing has no bids, and the listing does not end within 12 hours. This field can also be returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.PrimaryCategory field was mapped to a new category ID by eBay. If the primary category has not changed or it has expired with no replacement, this field is not returned. 10 ReviseItem Conditionally Unique identifier of the secondary eBay category for the revised listing. This field is returned if the secondary category was changed with the revision, and the secondary category can only be changed if a fixed-price listing has no sales/auction listing has no bids, and the listing does not end within 12 hours. This field can also be returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.PrimaryCategory field was mapped to a new category ID by eBay. If the primary category has not changed or it has expired with no replacement, this field is not returned. 10 ReviseItem Conditionally This field is returned if the VerifyOnly field was included in the call request and set to <code>true</code>. If the listing was revised in 'Verify Only' mode, the active listing is not actually revised, but the same response is returned and the seller gets to see the expected fees based on the changes made, and can also view any listing recommendations if the Item.IncludeRecommedations boolean input field was included and set to <code>true</code>. ReviseItem Conditionally This field is returned if an eBay special offer or promotion is applicable to the listing. ReviseItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. ReviseItem Conditionally Note: Large Merchant Services (LMS) functionality as a SOAP service has been decommissioned. It is fully migrated into the REST-based <a href="/api-docs/sell/feed/resources/methods" target=\"_blank\" >Sell Feed API</a> The Sell Feed API supports the same XML data files that LMS supported but through REST methods. For more information, see the <a href="/api-docs/sell/static/feed/lms-feeds.html" target="_blank" >LMS Feed Guide</a>. Specifies the shipment tracking information associated with one package of an order. If multiple packages are required for the order, this call must be made separately for each package.

Specifies the shipment tracking information associated with one package of an order.

A unique identifier that identifies a single line item or multiple line item order. Either the OrderID or OrderLineItemID value must be passed in the request. Note: In June 2019, eBay introduced a new order ID format, but allowed developers/sellers to decide whether to immediately adopt the new format, or to continue working with the old format. Users who wanted to adopt the new format, could either use a Trading WSDL Version 1113 (or newer), or they could even use an older Trading WSDL but set the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header value to <code>1113</code> in API calls. Beginning in June 2020, only the new order ID format will be returned in response payloads for paid orders, regardless of the WSDL version number or compatibility level. Note that the unique identifier of a 'non-immediate payment' order will change as it goes from an unpaid order to a paid order. Due to this scenario, all calls that accept Order ID values as filters in the request payload, including the SetShipmentTrackingInfo call, will support the identifiers for both unpaid and paid orders. However, the SetShipmentTrackingInfo call is typically only used to provide shipment tracking information for orders/line items that have already been paid for, so the new order ID format will be used for this call in most cases. The new order ID format is a non-parsable string, globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. Unlike in the past, instead of just being known and exposed to the seller, these unique order identifiers will also be known and used/referenced by the buyer and eBay customer support. Sellers can check to see if an order has been paid by looking for a value of 'Complete' in the CheckoutStatus.Status field in the response of GetOrders or GetOrderTransactions call, or in the Status.CompleteStatus field in the response of GetItemTransactions or GetSellerTransactions call. Sellers should not fulfill orders until buyer has made payment. 40 SetShipmentTrackingInfo Conditionally A unique identifier for an eBay order line item. This identifier is created as soon as there is a commitment to buy from the seller. Either the OrderLineItemID or the OrderID value must be passed in the request. SetShipmentTrackingInfo Conditionally This container is used to provide the name of the shipping carrier, the package tracking number, and optionally, the timestamp of the shipment. SetShipmentTrackingInfo Yes This field is included and set to <code>true</code> to indicate that an order or order line item was shipped. If this element is missing, eBay assumes that the order or order line item was shipped. SetShipmentTrackingInfo No This field is included and set to <code>true</code> to indicate that the buyer has paid for the order. SetShipmentTrackingInfo No Response to a SetShipmentTrackingInfo request that verifies whether or not the call request reached the eBay servers with or without errors. OrderLineItemID is required upon input and always returned in the response. You can use this field to track whether or not a response is returned for every request, and to match specific responses to Specific requests. SetShipmentTrackingInfo Always Enables a seller to test the definition of a new fixed-price listing by submitting the definition to eBay without creating an actual listing. AddFixedPriceItem Listing an Item https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listing-AnItem.html Root container holding all values that define a new fixed-price listing. VerifyAddFixedPriceItem Yes Returns the listing recommendations (if applicable), the estimated fees for the proposed new listing (except the Final Value Fee, which isn't calculated until the item has sold), and other details. With a successful VerifyAddFixedPriceItem call, this field is always returned, but the returned value is always <code>0</code>, since this call only validates the data passed in through the request payload and does not actually create an active listing. VerifyAddFixedPriceItem Always Item-level SKU for the new listing, if the seller specified tem.SKU in the request. Variation SKUs are not returned (see GetItem instead). VerifyAddFixedPriceItem Conditionally This container is an array of fees that would incur if the listing defined in request payload of the VerifyAddFixedPriceItem call was published. The fees in this container will not include any fees that are based on the purchase price (such as Final Value Fee) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the listing and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the VerifyAddFixedPriceItem call to verify a listing on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. VerifyAddFixedPriceItem Always eBay.com Fees http://pages.ebay.com/help/sell/fees.html Fees per Site https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/IntlDiffs-Fees.html This field is deprecated. 579 NoOp This field is deprecated. 579 NoOp ID of the primary category in which the item would be listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID you passed in PrimaryCategory was mapped to a new ID by eBay. If the primary category has not changed or it has expired with no replacement, CategoryID does not return a value. 10 VerifyAddFixedPriceItem Conditionally ID of the secondary category in which the item would be listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID you passed in SecondaryCategory was mapped to a new ID by eBay. If the secondary category has not changed or it has expired with no replacement, Category2ID does not return a value. 10 VerifyAddFixedPriceItem Conditionally The nature of the discount, if a discount would have applied had this actually been listed at this time. VerifyAddFixedPriceItem Conditionally Enables a seller to specify the definition of a new item and submit the definition to eBay without creating a listing. Sellers who engage in cross-border trade on sites that require a recoupment agreement, must agree to the recoupment terms before adding or verifying items. This agreement allows eBay to reimburse a buyer during a dispute and then recoup the cost from the seller. The US site is a recoupment site, and the agreement is located <a href="https://scgi.ebay.com/ws/eBayISAPI.dll?CBTRecoupAgreement">here</a>. The list of the sites where a user has agreed to the recoupment terms is returned by the GetUser response. AddItem, VerifyAddFixedPriceItem Listing an Item https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listing-AnItem.html Root container holding all values that define a new listing. VerifyAddItem Yes Returns the listing recommendations (if applicable), the estimated fees for the proposed new listing (except the Final Value Fee, which isn't calculated until the item has sold), and other details. With a successful VerifyAddItem call, this field is always returned, but the returned value is always <code>0</code>, since this call only validates the data passed in through the request payload and does not actually create an active listing. VerifyAddItem Always This container is an array of fees that would incur if the listing defined in request payload of the VerifyAddItem call was published. The fees in this container will not include any fees that are based on the purchase price (such as Final Value Fee) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the listing and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the VerifyAddItem call to verify a listing on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. VerifyAddItem Always eBay.com Fees http://pages.ebay.com/help/sell/fees.html Fees per Site https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/IntlDiffs-Fees.html This field is deprecated. 579 NoOp This field is deprecated. 579 NoOp ID of the primary category in which the item would be listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID you passed in PrimaryCategory was mapped to a new ID by eBay. If the primary category has not changed or it has expired with no replacement, CategoryID does not return a value. 10 VerifyAddItem Conditionally ID of the secondary category in which the item would be listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID you passed in SecondaryCategory was mapped to a new ID by eBay. If the secondary category has not changed or it has expired with no replacement, Category2ID does not return a value. 10 VerifyAddItem Conditionally The nature of the discount, if a discount would have applied had this actually been listed at this time. VerifyAddItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. VerifyAddItem Conditionally Base type definition of the request payload, which can carry any type of payload content plus optional versioning information and detail level requirements. All concrete request types (e.g., AddItemRequestType) are derived from the abstract request type. The naming convention we use for the concrete type names is the name of the service (the verb or call name) followed by "RequestType": VerbNameRequestType Detail levels are instructions that define standard subsets of data to return for particular data components (e.g., each Item, Transaction, or User) within the response payload. For example, a particular detail level might cause the response to include buyer-related data in every result (e.g., for every Item), but no seller-related data. Specifying a detail level is like using a predefined attribute list in the SELECT clause of an SQL query. Use the DetailLevel element to specify the required detail level that the client application needs pertaining to the data components that are applicable to the request. The DetailLevelCodeType defines the global list of available detail levels for all request types. Most request types support certain detail levels or none at all. If you pass a detail level that exists in the schema but that isn't valid for a particular request, eBay ignores it and processes the request without it. For each request type, see the detail level tables in the Input/Output Reference to determine which detail levels are applicable and which elements are returned for each applicable detail level. Note that DetailLevel is required input for GetMyMessages. With GetSellerList and other calls that retrieve large data sets, please avoid using ReturnAll when possible. For example, if you use GetSellerList, use GranularityLevel instead, or use GetSellerEvents. If you do use 'ReturnAll' with GetSellerList, use a small Pagination.EntriesPerPage value and a narrow EndTimeFrom/EndTimeTo date range for better performance. Yes GetMyMessages ReturnSummary, ReturnHeaders, ReturnMessages Yes GetAdFormatLeads GetBestOffers GetCategories GetCategoryMappings GetFeedback GetOrders GetSellerEvents GetTaxTable ReturnAll, none No GetCategoryFeatures GetMyeBayBuying GetMyeBaySelling GetUser GetUserDisputes ReturnAll, ReturnSummary, none No GetItemTransactions GetSellerList GetSellerTransactions GetOrderTransactions ItemReturnDescription, ReturnAll, none No GetItem ItemReturnAttributes, ItemReturnDescription, ReturnAll, none No Use ErrorLanguage to return error strings for the call in a different language from the language commonly associated with the site that the requesting user is registered with. Below are some examples from different countries. <table border="0"> <tr> <th>ID</th> <th>Country</th> </tr> <tr> <td>en_AU</td> <td>Australia</td> </tr> <tr> <td>de_AT</td> <td>Austria</td> </tr> <tr> <td>nl_BE</td> <td>Belgium (Dutch)</td> </tr> <tr> <td>fr_BE</td> <td>Belgium (French)</td> </tr> <tr> <td>en_CA</td> <td>Canada</td> </tr> <tr> <td>fr_CA</td> <td>Canada (French)</td> </tr> <tr> <td>zh_CN</td> <td>China</td> </tr> <tr> <td>fr_FR</td> <td>France</td> </tr> <tr> <td>de_DE</td> <td>Germany</td> </tr> <tr> <td>zh_HK</td> <td>Hong Kong</td> </tr> <tr> <td>en_IN</td> <td>India</td> </tr> <tr> <td>en_IE</td> <td>Ireland</td> </tr> <tr> <td>it_IT</td> <td>Italy</td> </tr> <tr> <td>nl_NL</td> <td>Netherlands</td> </tr> <tr> <td>en_SG</td> <td>Singapore</td> </tr> <tr> <td>es_ES</td> <td>Spain</td> </tr> <tr> <td>de_CH</td> <td>Switzerland</td> </tr> <tr> <td>en_GB</td> <td>United Kingdom</td> </tr> <tr> <td>en_US</td> <td> United States</td> </tr> </table> No Most Trading API calls support a MessageID element in the request and a CorrelationID element in the response. If you pass in a MessageID in a request, the same value will be returned in the CorrelationID field in the response. Pairing these values can help you track and confirm that a response is returned for every request and to match specific responses to specific requests. If you do not pass a MessageID value in the request, CorrelationID is not returned. Note: GetCategories is designed to retrieve very large sets of metadata that change once a day or less often. To improve performance, these calls return cached responses when you request all available data (with no filters). When this occurs, the MessageID and CorrelationID fields aren't applicable. However, if you specify an input filter to reduce the amount of data returned, the calls retrieve the latest data (not cached). When this occurs, MessageID and CorrelationID are applicable. No The version number of the API code that you are programming against (e.g., 1149). The version you specify for a call has these basic effects: <ul> <li>It indicates the version of the code lists and other data that eBay should use to process your request.</li> <li>It indicates the schema version you are using.</li> </ul> You need to use a version that is greater than or equal to the lowest supported version. For the SOAP API: If you are using the SOAP API, this field is required. Specify the version of the WSDL your application is using. For the XML API: If you are using the XML API, this field has no effect. Instead, specify the version in the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header. (If you specify Version in the body of an XML API request and it is different from the value in the HTTP header, eBay returns an informational warning that the value in the HTTP header was used instead.) Conditionally HTTP Headers https://developer.ebay.com/DevZone/guides/features-guide/default.html#Basics/Call-RoutingRequest.html#HTTPHeaders eBay Schema Versioning Strategy ../../HowTo/eBayWS/eBaySchemaVersioning.html Lowest Supported Version ../../HowTo/eBayWS/eBaySchemaVersioning.html#VersionSupportSchedule The public IP address of the machine from which the request is sent. Your application captures that IP address and includes it in a call request. eBay evaluates requests for safety (also see the BotBlock container in the request and response of this call). PlaceOffer Yes Authentication information for the user on whose behalf the application is making the request. Only registered eBay users are allowed to make API calls. To verify that a user is registered, your application needs to pass a user-specific value called an "authentication token" in the request. This is equivalent to signing in on the eBay Web site. As API calls do not pass session information, you need to pass the user's authentication token every time you invoke a call on their behalf. All calls require an authentication token, except the calls you use to retrieve a token in the first place. (For such calls, you use the eBay member's username and password instead.) Yes Getting Tokens https://developer.ebay.com/DevZone/guides/features-guide/Basics/Tokens.html Error tolerance level for the call. This is a preference that specifies how eBay should handle requests that contain invalid data or that could partially fail. This gives you some control over whether eBay returns warnings or blocking errors and how eBay processes the invalid data. This field is only applicable to AddItem and related calls, and only when the listing includes ProductListingDetails. AddItem AddItems AddLiveAuctionItem RelistItem ReviseItem ReviseLiveAuctionItem VerifyAddItem BestEffort No Pre-filling Item Specifics with Product Details https://developer.ebay.com/DevZone/guides/features-guide/Development/ItemSpecifics-CatalogDetails.html CompleteSale BestEffort, FailOnError FailOnError No A unique identifier for a particular call. If the same InvocationID is passed in after it has been passed in once on a call that succeeded for a particular application and user, then an error will be returned. The identifier can only contain digits from 0-9 and letters from A-F. The identifier must be 32 characters long. For example, 1FB02B2-9D27-3acb-ABA2-9D539C374228. 32 AddOrder AddToItemDescription PlaceOffer ReviseItem No You can use the OutputSelector field to restrict the data returned by a call. This field can make the call response easier to manage, especially when a large payload is returned. If you use the OutputSelector field, the output data will only include the field(s) you specified in the request, as well as all of its child fields (if a field is a container) and its parent fields (if any). Note that it is possible that a field included through an OutputSelector field may still not be returned if it is not applicable, or if it is not found based on other criteria set up in the request payload. For example, if you are using GetItem and you only want to retrieve the URL of the View Item page (emitted in ViewItemURL field) and the item's Buy It Now price (emitted in BuyItNowPrice field), you would include two separate OutputSelector fields and set the value for each one as ViewItemURL and BuyItNowPrice as in the following example: <pre> If the following output selectors are used: ... <code><OutputSelector>ViewItemURL</OutputSelector> <OutputSelector>BuyItNowPrice</OutputSelector> </code> ... ...the response might look like the following <code> <Item> <BuyItNowPrice currencyID="USD">0.0</BuyItNowPrice> <ListingDetails> <ViewItemURL>http://www.ebay.com/itm/Tag-Heuer-Mens-Watch/182879833261</ViewItemURL> </ListingDetails> </Item> </code> </pre> GetAccount GetAdFormatLeads GetAllBidders GetBestOffers GetBidderList GetCategories GetCategoryFeatures GetFeedback GetItem GetItemsAwaitingFeedback GetItemShipping GetItemTransactions GetMemberMessages GetMyeBayBuying GetMyeBaySelling GetMyMessages GetNotificationPreferences GetOrders GetOrderTransactions GetSellerEvents GetSellerList GetSellerTransactions No https://developer.ebay.com/DevZone/guides/features-guide/default.html#Basics/eBay-SelectingFields.html#WorkingwiththeOutputSelector Working with the Output Selector Controls whether or not to return warnings when the application passes unrecognized or deprecated elements in a request. An unrecognized element is one that is not defined in any supported version of the schema. Schema element names are case-sensitive, so using WarningLevel can also help you remove any potential hidden bugs within your application due to incorrect case or spelling in field names before you put your application into the Production environment. WarningLevel only validates elements; it doesn't validate XML attributes. It also doesn't control warnings related to user-entered strings or numbers, or warnings for logical errors. We recommend that you only use this during development and debugging. Do not use this in requests performed in the Production environment. No https://ebaydts.com/eBayKBDetails?KBid=499 Warning Level This container is only used by the PlaceOffer call request if the previous PlaceOffer call resulted in a BotBlock container in the response. If the caller receives this container in the response, that caller must make another PlaceOffer call, this time, passing in the encrypted token and URL that is returned in the BotBlock container in the response. This safeguard lets eBay know that a real user is making a PlaceOffer call and not a bot. PlaceOffer Conditionally Base type definition of a response payload that can carry any type of payload content with following optional elements: <ul> <li>timestamp of response message</li> <li>application-level acknowledgement</li> <li>application-level (business-level) errors and warnings</li> </ul> This value represents the date and time when eBay processed the request. The time zone of this value is GMT and the format is the ISO 8601 date and time format (YYYY-MM-DDTHH:MM:SS.SSSZ). See the Time Values section in the eBay Features Guide for information about this time format and converting to and from the GMT time zone. Note: GetCategories and other Trading API calls are designed to retrieve very large sets of metadata that change once a day or less often. To improve performance, these calls return cached responses when you request all available data (with no filters). When this occurs, this time value reflects the time the cached response was created. Thus, this value is not necessarily when the request was processed. However, if you specify an input filter to reduce the amount of data returned, the calls retrieve the latest data (not cached). When this occurs, this time value does reflect when the request was processed. OrderAck, SetShipmentTrackingInfo Always A token representing the application-level acknowledgement code that indicates the response status (e.g., success). The AckCodeType list specifies the possible values for the Ack field. CompleteSale, GetPopularKeywords PartialFailure Always CompleteSale GetPopularKeywords Always Most Trading API calls support a MessageID element in the request and a CorrelationID element in the response. If you pass in a MessageID in a request, the same value will be returned in the CorrelationID field in the response. Pairing these values can help you track and confirm that a response is returned for every request and to match specific responses to specific requests. If you do not pass a MessageID value in the request, CorrelationID is not returned. Note: GetCategories is designed to retrieve very large sets of metadata that change once a day or less often. To improve performance, these calls return cached responses when you request all available data (with no filters). When this occurs, the MessageID and CorrelationID fields aren't applicable. However, if you specify an input filter to reduce the amount of data returned, the calls retrieve the latest data (not cached). When this occurs, MessageID and CorrelationID are applicable. OrderAck, SetShipmentTrackingInfo Conditionally A list of application-level errors (if any) that occurred when eBay processed the request. Conditionally Supplemental information from eBay, if applicable. May elaborate on errors (such as how a listing violates eBay policies) or provide useful hints that may help a seller increase sales. This data can accompany the call's normal data result set or a result set that contains only errors. Applications must recognize when the Message field is returned and provide a means to display the listing hints and error message explanations to the user. The string can return HTML, including TABLE, IMG, and HREF elements. In this case, an HTML-based application should be able to include the HTML as-is in the HTML page that displays the results. A non-HTML application would need to parse the HTML and convert the table elements and image references into UI elements particular to the programming language used. As usual for string data types, the HTML markup elements are escaped with character entity references (e.g.,<table><tr>...). AddFixedPriceItem AddItem AddItems AddToItemDescription EndItem PlaceOffer RelistFixedPriceItem RelistItem RespondToWantItNowPost ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem Conditionally Standard Data for All Calls https://developer.ebay.com/DevZone/guides/features-guide/Basics/Call-StandardCallData.html The version of the response payload schema. Indicates the version of the schema that eBay used to process the request. See the Standard Data for All Calls section in the eBay Features Guide for information on using the response version when troubleshooting CustomCode values that appear in the response. OrderAck, SetShipmentTrackingInfo Always This refers to the specific software build that eBay used when processing the request and generating the response. This includes the version number plus additional information. eBay Developer Support may request the build information when helping you resolve technical issues. OrderAck, SetShipmentTrackingInfo Always Event name of the notification. Only returned by Platform Notifications. Information that explains a failure due to a duplicate InvocationID being passed in. AddFixedPriceItem AddItem AddItems AddLiveAuctionItem AddOrder AddSecondChanceItem AddToItemDescription PlaceOffer RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem Conditionally Recipient user ID of the notification. Only returned by Platform Notifications. Unique Identifier of Recipient user ID of the notification. Only returned by Platform Notifications (not for regular API call responses). A Base64-encoded MD5 hash that allows the recipient of a Platform Notification to verify this is a valid Platform Notification sent by eBay. Expiration date of the user's authentication token. Only returned within the 7-day period prior to a token's expiration. To ensure that user authentication tokens are secure and to help avoid a user's token being compromised, tokens have a limited life span. A token is only valid for a period of time (set by eBay). After this amount of time has passed, the token expires and must be replaced with a new token. FetchToken, OrderAck, SetShipmentTrackingInfo, GetSessionID Conditionally This container is conditionally returned in the PlaceOffer call response if eBay wants to challenge the user making the call to ensure that the call is being made by a real user and not a bot. This container consist of an encrypted token, the URL of the image that should be displayed to the user, or the URL of an audio clip for sight-impaired users. After receiving this data in the response, the caller must make another PlaceOffer call, this time passing in the encrypted token and one of the URLs that was received in the previous call response. PlaceOffer Conditionally An application subscribing to notifications can include an XML-compliant string, not to exceed 256 characters, which will be returned. The string can identify a particular user. Any sensitive information should be passed with due caution. To subscribe to and receive eBay Buyer Protection notifications, this field is required, and you must pass in 'eBP notification' as a string. SetNotificationPreferences Conditionally GetNotificationPreferences Conditionally This enumerated type identifies the possible values that can be returned in the Ack field in call responses. The Ack value will indicate if the call was completely successful, if the called failed, or if the call was partially successful, but with minor errors or warnings. This value indicates that the call request was processed successfully without any issues. This value indicates that the call request processing failed. This value indicates that the call request was successful, but processing was not without any issues. These issues can be checked in the Errors container, that will also be returned when one or more known issues occur with the call request. This value indicates that the call request partially failed. One or more issues that may be responsible for this partial failure can be checked in the Errors container, that will also be returned when one or more known issues occur with the call request. Reserved for internal or future use. Type used by the BotBlock container of the PlaceOffer call request. The BotBlock container is conditionally required in a PlaceOffer call request if the previous PlaceOffer call resulted in a BotBlock container being returned in the response. The BotBlock container in the response will contain an authentication token and a URL that will need to be passed into the BotBlock container of the PlaceOffer call request in the subsequent call. This string value is an encrypted token that eBay generates and returns in the BotBlock.BotBlockToken field of the PlaceOffer call response when eBay is requiring that the user supply an authentication token and URL in order for eBay to process the PlaceOffer call. As soon as a user gets a BotBlock container returned in the PlaceOffer call response, that user should grab the authentication token and the URL and then run another PlaceOffer call, but this time using the BotBlock container and passing in the authentication token and the URL values. PlaceOffer Conditionally This string value is a URL that eBay generates and returns in either the BotBlock.BotBlockUrl or BotBlock.BotBlockAudioUrl field (returned for site-impaired users) of the PlaceOffer call response when eBay is requiring that the user supply an authentication token and URL in order for eBay to process the PlaceOffer call. As soon as a user gets a BotBlock container returned in the PlaceOffer call response, that user should grab the authentication token and the URL and then run another PlaceOffer call, but this time using the BotBlock container and passing in the authentication token and the URL values. PlaceOffer Conditionally This type is used by the BotBlock container that is returned in the PlaceOffer call response if eBay is requiring that the user supply an authentication token and URL in order for eBay to process the PlaceOffer call. The authentication token and URL values that are returned in the PlaceOffer call response are then passed in the BotBlock container of a subsequent PlaceOffer call. This string value is an encrypted token that eBay generates and returns in the BotBlock.BotBlockToken field of the PlaceOffer call response when eBay is requiring that the user supply an authentication token and URL in order for eBay to process the PlaceOffer call. As soon as a user gets a BotBlock container returned in the PlaceOffer call response, that user should grab the authentication token and the URL and then run another PlaceOffer call, but this time using the BotBlock container and passing in the authentication token and the URL values. PlaceOffer Conditionally This string value is a URL to an image that eBay generates and returns in the PlaceOffer call response when eBay is requiring that the user supply an authentication token and URL in order for eBay to process the PlaceOffer call. As soon as a user gets a BotBlock container returned in the PlaceOffer call response, that user should grab the authentication token and this BotBlockUrl and then run another PlaceOffer call, but this time using the BotBlock container and passing in the authentication token and this URL value in the BotBlockUserInput field. For site-impaired users, the BotBlockAudioUrl field might be returned instead, in which case, the BotBlockAudioUrl value should be passed into theBotBlockUserInput field instead. PlaceOffer Conditionally This string value is a URL to an audio clip that eBay generates and returns in the PlaceOffer call response when eBay is requiring that the user supply an authentication token and URL in order for eBay to process the PlaceOffer call. As soon as a user gets a BotBlock container returned in the PlaceOffer call response, that user should grab the authentication token and this BotBlockAudioUrl and then run another PlaceOffer call, but this time using the BotBlock container and passing in the authentication token and this URL value in the BotBlockUserInput field. Note: This field will generally only be returned for site-impaired users. If this field is not returned, but the BotBlockUrl field is returned instead, the BotBlockUrl value should be passed into the BotBlockUserInput field of the subsequent PlaceOffer call instead. PlaceOffer Conditionally This enumerated type defines different payment methods that can be used by buyers to pay sellers for purchases. Supported payment methods vary by eBay marketplace, by eBay Category, and even by listing format. If a seller is listing, revising, or relisting an item with a Trading API call, the seller should use one of the following metadata calls to see which payment methods are supported at the site and category level: <ul> <li>GeteBayDetails: through PaymentOptionDetails containers in the response, this call will show the seller all of the payment methods that are available for the specified marketplace. To retrieve this metadata, the seller should include the DetailName field in the request, and set its value to <code>PaymentOptionDetails</code></li> <li>GetCategoryFeatures: through PaymentMethod fields that are returned under the SiteDefaults container or under one or more Category containers in the response, this call will show the seller all of the payment methods that are available for the specified marketplace, including any category exceptions. To retrieve this metadata, the seller should include the FeatureID field in the request, and set its value to <code>PaymentMethods</code>. Note that Category containers will only be returned for categories that differ from Site Defaults as far as supported payment methods are concerned. </li> </ul> Note: As eBay now controls all of the online payment methods available to buyers, sellers will only specify offline payment methods for listings that require/support offline payment. StandardPayment, QIWI, Moneybookers, ProPay, Paymate, PaisaPayEscrow, PaisaPayEscrowEMI, ELV, PaisaPayAccepted, IntegratedMerchantCreditCard, LoanCheck, CashInPerson, PayOnPickup, DirectDebit, PayPalCredit This enumeration value indicates that no payment method has been specified for the listing. This may be the case for a classified ad listing, since payment happens outside of the eBay platform. This enumeration value indicates that a money order or cashiers check is accepted for payment. This value is only applicable for offline payments. This enumeration value indicates that American Express is accepted for payment. This enumeration value indicates that buyers should check the listing description for more details on payment. This may be the case for a classified ad listing, since payment happens outside of the eBay platform. This enumeration value indicates that credit cards are accepted for payment. Note: This enumeration value is returned in the response of order management calls if the buyer used an eBay gift card to pay the full or partial balance of the order. This enumeration value indicates that a personal check is accepted for payment. This value is only applicable for offline payments. This enumeration value indicates that cash on delivery of item is accepted for payment. This value is only applicable for offline payments. This enumeration value indicates that Visa or MasterCard are accepted for payment. This payment method is deprecated. This enumeration value may be returned if the payment method is unknown. This enumeration value indicates that PayPal is accepted as a payment method. This enumeration value indicates that Discover Card is accepted for payment. This enumeration value indicates that cash on pickup is accepted for payment. This value is only applicable for offline payments. This enumeration value indicates that a direct transfer of money is accepted for payment. This enumeration value indicates that a direct transfer of money during checkout is accepted for payment. This enumeration value may be returned if the payment method is unknown. Reserved for future use. Reserved for future use. Reserved for future use. Reserved for future use. Reserved for internal or future use. This payment method is deprecated. This payment method is deprecated. 'CashOnPickup' is now the only available offline cash option. Elektronisches Lastschriftverfahren (direct debit). Only applicable to the Express Germany site, which has been shut down. 579 NoOp This payment type is no longer applicable since eBay India is no longer a functioning site. This payment type is no longer applicable since eBay India is no longer a functioning site. This payment method is deprecated. This payment method is deprecated. This payment method is deprecated. This payment method is deprecated. This payment method is deprecated. 'CashOnPickup' is now the only available offline cash option. This enumeration value indicates that the Diners Club credit card is accepted for payment. This value is no longer used. This payment method is deprecated. This enumeration value is returned in the response of order management calls if eBay collects the online payment from the buyer, and the buyer has paid for the order with any accepted payment method except for an eBay gift card. If the buyer used an eBay gift card to pay the full or partial balance of the order, the <code>CCAccepted</code> value will be returned instead. This buyer payment method is only applicable for the Germany site and is associated with the rollout of Progressive Checkout and the Pay Upon Invoice feature. 'PayUponInvoice' is not a payment method that is offered to the buyer, but instead, eBay makes the determination (based on several factors) during checkout whether the buyer is eligible for 'Pay Upon Invoice'. If the buyer is offered the 'Pay Upon Invoice' option, that buyer is not required to pay for the order until an order invoice is sent by the seller. Only select categories on the Germany site will support the 'Pay Upon Invoice' option, and orders going above the two-thousand dollar EURO mark will not be eligible for 'Pay Upon Invoice'. Since the seller can not specify 'Pay Upon Invoice' as a payment method, this enumeration value cannot be passed into a Item.PaymentMethods field in an Add/Revise/Relist call. This payment method is deprecated. This payment method is deprecated. Security header used for SOAP API calls. Authentication token representing the user who is making the request. The user's token must be retrieved from eBay. To determine a user's authentication token, see the Authentication and Authorization information in the eBay Web Services guide. For calls that list or retrieve item or transaction data, the user usually needs to be the seller of the item in question or, in some cases, the buyer. Similarly, calls that retrieve user or account data may be restricted to the user whose data is being requested. The documentation for each call includes information about such restrictions. 2000 FetchToken Yes Getting Tokens https://developer.ebay.com/DevZone/guides/features-guide/Basics/Tokens.html Expiration date of the user's authentication token. Only returned within the 7-day period prior to a token's expiration. To ensure that user authentication tokens are secure and to help avoid a user's token being compromised, tokens have a limited life span. A token is only valid for a period of time (set by eBay). After this amount of time has passed, the token expires and must be replaced with a new token. GetSessionID,FetchToken Conditionally Authentication information for the user on whose behalf the application is making the request, and authorization information for the application making the request. Only registered eBay users are allowed to make API calls. To verify that a user is registered, your application normally needs to pass a user-specific value called an "authentication token" in the request. This is equivalent to signing in on the eBay Web site. As API calls do not pass session information, you need to pass the user's authentication token every time you invoke a call on their behalf. All calls require an authentication token, except the calls you use to retrieve a token in the first place. For such calls, you use the eBay member's username and password instead. FetchToken Yes A Base64-encoded MD5 hash that allows the recipient of a Platform Notification to verify this is a valid Platform Notification sent by eBay. Specifies standard subsets of data to return for each result within the set of results in the response payload. If no detail level is specified, a base set of data is returned. The base set of data varies per call. Returns all available data. With GetSellerList and other calls that retrieve large data sets, please avoid using ReturnAll when possible. For example, if you use GetSellerList, use a GranularityLevel or use the GetSellerEvents call instead. If you use ReturnAll with GetSellerList, use a small EntriesPerPage value and a short EndTimeFrom/EndTimeTo range for better performance. Returns the description, plus the ListingDesigner node and some additional information if applicable For GetItem, returns Item Specifics and Pre-filled Item Information, if any. Also see the description of Item.ProductListingDetails for GetItem. If this value is used, the primary category and, if applicable, the secondary category is returned. Returns the summary data. For GetMyMessages, this detail level returns the same data whether or not you include MessageIDs or AlertIDs in the request. Returns up to 10 FolderID and FolderName values. Currently, this detail level is the only way to retrieve FolderID and FolderName values. See GetMyMessages for a code sample that demonstrates this. Returns message headers. For GetMyMessages, if you include MessageIDs or AlertIDs in the request, this detail level returns header information, without body text, for the specified message ID or alert ID values. If you include a FolderID, header information is returned only for the messages and alerts in the specified folder. If you do not include MessageIDs or AlertIDs, this detail level returns header information for Alerts and Messages as follows: <ul> <li>If all the Alerts have been read, they are sorted in date order, with the most recent first.</li> <li>If one of the Alerts has not been read, the Read Alerts come first, sorted most recent first, followed by the Unread Alert(s).</li> <li>All messages in ascending order by date received with the oldest messages first.</li> </ul> Note: Even when restricted by this detail level to return only header information, GetMyMessages may return a high volume of data. Returns full message information. For GetMyMessages, if you include MessageIDs or AlertIDs in the request, this detail level returns message information for the specified message ID or alert ID values. If you include a FolderID, message information is returned only for the messages and alerts in the specified folder. This type is used by the DuplicateInvocationDetails container that is returned in some calls if a duplicate InvocationID or InvocationTrackingID is used in the call request. This value represents the duplicate InvocationID or InvocationTrackingID that was used in the call request. AddItem AddItems AddOrder AddSecondChanceItem AddToItemDescription PlaceOffer RelistItem ReviseItem Conditionally This enumeration value indicates the status of the previous call that used the InvocationID or InvocationTrackingID specified in the DuplicateInvocationID. AddFixedPriceItem AddItem AddItems AddOrder AddSecondChanceItem AddToItemDescription PlaceOffer RelistItem ReviseItem Conditionally This unique identifier identifies the business item the previous API invocation created. For example, the Item ID of the item created by an AddItem call. AddItem AddItems AddOrder AddSecondChanceItem AddToItemDescription PlaceOffer RelistItem ReviseItem Conditionally An error has occurred either as a result of a problem in the sending application or because the application's end-user has attempted to submit invalid data (or missing data). In these cases, do not retry the request. The problem must be corrected before the request can be made again. If the problem is due to something in the application (such as a missing required field), the application must be changed. If the problem is a result of end-user data, the application must alert the end-user to the problem and provide the means for the end-user to correct the data. Once the problem in the application or data is resolved, resend the request to eBay with the corrected data. Indicates that an error has occurred on the eBay system side, such as a database or server down. An application can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form. (out) Reserved for internal or future use. Preferences that specify how eBay should handle certain requests that contain invalid data or that could partially fail. These preferences give you some control over whether eBay returns warnings or errors in response to invalid data and how eBay handles listing requests when such data is passed in. For example, these preferences are applicable to AddItem and related calls when Item Specifics are specified, and to CompleteSale. See <a href="https://developer.ebay.com/devzone/guides/features-guide/default.html#Basics/Call-ErrorHandling.html">Error Handling</a> for details about these preferences and their effects. Apply validation rules that were in effect prior to the time the call started supporting ErrorHandling. Drop the invalid data, continue processing the request with the valid data. If dropping the invalid data leaves the request in a state where required data is missing, reject the request. If BestEffort is specified for CompleteSale, the Ack field in the response could return PartialFailure if one change fails but another succeeds. For example, if the seller attempts to leave feedback twice for the same order line item, the feedback changes would fail but any paid or shipped status changes would succeed. If any of the item specifics data is invalid, drop all the data and proceed with listing the item. If the category has required item specifics and the data was dropped, reject the listing. If any data is invalid, reject the request. This type is used by the ErrorParameters container if one or more errors or warnings occur with the call, and if a specific request parameter has been pinpointed as the reason why the error or warning was triggered. This is the value of the request parameter noted in the ParamID attribute. So, if the ParamID value was ItemID, the value in this field would be the actual value of that ItemID. Conditionally This is name of the request parameter that has been pinpointed as the reason why the error or warning was triggered. This value might be ItemID, in which case the identifier of that item would be returned in the Value field. Conditionally These are request errors (as opposed to system errors) that occur due to problems with business-level data (e.g., an invalid combination of arguments) that the application passed in. A brief description of the condition that raised the error. Conditionally A more detailed description of the condition that raised the error. Conditionally A unique code that identifies the particular error condition that occurred. Your application can use error codes as identifiers in your customized error-handling algorithms. See the "Errors by Number" document. other Conditionally Indicates whether the error message text is intended to be displayed to an end user or intended only to be parsed by the application. If true or not present (the default), the message text is intended for the end user. If false, the message text is intended for the application, and the application should translate the error into a more appropriate message. Only applicable to Item Specifics errors and warnings returned from listing requests. AddItem AddItems AddLiveAuctionItem RelistItem ReviseItem ReviseLiveAuctionItem VerifyAddItem Conditionally Indicates whether the error is a severe error (causing the request to fail) or an informational error (a warning) that should be communicated to the user. Conditionally This optional element carries a list of context-specific error variables that indicate details about the error condition. These are useful when multiple instances of ErrorType are returned. Conditionally API errors are divided between two classes: system errors and request errors. Conditionally Basic type for specifying measures and the system of measurement. A decimal value (e.g., 10.25) is meaningful as a measure when accompanied by a definition of the unit of measure (e.g., Pounds), in which case the value specifies the quantity of that unit. A MeasureType expresses both the value (a decimal) and, optionally, the unit and the system of measurement. Details such as shipping weights are specified as measure types. Unit of measure. This attribute is shared by various fields, representing units such as lbs, oz, kg, g, in, cm. For weight, English major/minor units are pounds and ounces, and metric major/minor units are kilograms and grams. For length, the English unit is inches, and metric unit is centimeters. To get the full list of package dimension and weight measurement units (and all alternative spellings and abbreviations) supported by your site, call GeteBayDetails. AddItem AddItems No GetItemShipping GetSellerTransactions GetShippingDiscountProfiles Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GeteBayDetails GeteBayDetails.html The system of measurement (e.g., English). AddItem AddItems No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetShippingDiscountProfiles Conditionally This enumerated type defines the two measurement systems that are used globally. This enumeration value indicates that the English system of measurement is being used. Also known as the Imperial System of Measurement. Weights in this system are expressed as pounds and ounces, and package dimensions are expressed as feet or inches. This enumeration value indicates that the English system of measurement is being used. Weights in this system are expressed as kilograms and grams, and package dimensions are expressed as meters or centimeters. SeverityCodeType - Type declaration to be used by other schema. This code identifies the severity of an API error. A code indicates whether there is an API-level error or warning that needs to be communicated to the client. The request was processed successfully, but something occurred that may affect your application or the user. For example, eBay may have changed a value the user sent in. In this case, eBay returns a normal, successful response and also returns the warning. When a warning occurs, the error is returned in addition to the business data. In this case, you do not need to retry the request (as the original request was successful). However, depending on the cause or nature of the warning, you might need to contact either the end user or eBay to effect a long term solution to the problem to prevent it from reoccurring in the future. The request that triggered the error was not processed successfully. When a serious application-level error occurs, the error is returned instead of the business data. If the source of the problem is within the application (such as a missing required element), change the application before you retry the request. <ul> <li>If the problem is due to end-user input data, please alert the end-user to the problem and provide the means for them to correct the data. Once the problem in the application or data is resolved, you can attempt to re-send the request to eBay. </li> <li>If the source of the problem is on eBay's side, An application can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form. </li> </ul> See the <a href="https://developer.ebay.com/DevZone/guides/features-guide/default.html#Basics/Call-UsingLiveData.html#CompatibleApplicationCheck">Compatible Application Check</a> section of the eBay Features Guide for more information. Reserved for internal or future use. Specifies a universally unique identifier for an item. This is used to ensure that you only list a particular item once, particularly if you are listing many items at once. The identifier can contain only digits from 0-9 and letters from A-F. The identifier must be 32 characters long. For example, 9CEBD9A6825644EC8D06C436D6CF494B. Item.Site in AddItem AddItem.html#Request.Item.UUID The application ID that is unique to each application you (or your company) has registered with the eBay Developers Program. If you are executing a call in the Sandbox, this is the "AppId" value that eBay issued to you when you received your Sandbox keys. If you are executing a call in Production, this is the "AppId" value that eBay issued to you when you received your Production keys. FetchToken Yes The unique developer ID that the eBay Developers Program issued to you (or your company). If you are executing a call in the Sandbox, this is the "DevId" value that eBay issued to you when you received your Sandbox keys. Typically, you receive your Sandbox keys when you register as a new developer. If you are executing a call in Production, this is the "DevId" value that eBay issued to you when you received your Production keys. Typically, you receive your Production keys when you certify an application. FetchToken Yes Authentication certificate that authenticates the application when making API calls. If you are executing a call in the Sandbox, this is the "CertId" value that eBay issued to you when you received your Sandbox keys. If you are executing a call in Production, this is the "CertId" value that eBay issued to you when you received your Production keys. This is unrelated to auth tokens. FetchToken Yes eBay user ID (i.e., eBay.com Web site login name) for the user the application is retrieving a token for. This is typically the application's end-user (not the developer). 64 FetchToken Yes Password for the user specified in Username. This enumerated type contains the list of values that can be passed in through the WarningLevel field of a call request. The WarningLevel value is set to <code>Low</code> if the user does not wish to receive warnings when the application passes unrecognized or deprecated elements in an API call request. This is the default value if WarningLevel is not specified in the call request. The WarningLevel value is set to <code>High</code> if the user wishes to receive warnings when the application passes unrecognized or deprecated elements in an API call request. Setting the WarningLevel value to <code>High</code> is not recommended in a production environment. Instead, it should only be used during the development/debugging stage. eBay user ID (i.e., eBay.com Web site login name) for the user the application is retrieving a token for. This is typically the application's end-user (not the developer). 64 FetchToken Yes Password for the user specified in Username. Authentication token representing the user who is making the request. The user's token must be retrieved from eBay. To determine a user's authentication token, see the Authentication and Authorization information in the eBay Web Services guide. For calls that list or retrieve item or transaction data, the user usually needs to be the seller of the item in question or, in some cases, the buyer. Similarly, calls that retrieve user or account data may be restricted to the user whose data is being requested. The documentation for each call includes information about such restrictions. 2000 FetchToken Yes Getting Tokens https://developer.ebay.com/DevZone/guides/features-guide/Basics/Tokens.html This enumerated type contains the possible values that can be returned in the type attribute of the AddressAttribute field. Currently, this type only contains one enumeration value, but in the future, other address attributes may be created for this type. This value indicates that the value returned in the AddressAttribute field is the reference ID for a "Click and Collect" order. Reserved for internal or future use. This type is used to display the value of the type attribute of the AddressAttribute field. The only supported value for this attribute is <code>ReferenceNumber</code>, but in the future, other address attributes may be supported. The <code>ReferenceNumber</code> is a unique identifier for a 'Click and Collect' order. Click and Collect orders are only available on the eBay UK and eBay Australia sites. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally PayPal Enumerated type used by the ShippingAddress.AddressOwner field in order management calls to indicate the owner of the shipping address on file. This value is deprecated. This value indicates that the buyer's shipping address being referenced is on file with eBay. Reserved for internal or future use. This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. This value is not used. Contains the data for an eBay user's address. This is the base type for a number of user addresses, including seller payment address, buyer shipping address, and buyer and seller registration address. The eBay user's name associated with an address on file with eBay. 128 GetItem RegistrationAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetUserContactDetails Always GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally A concatenation of Street1 and Street2, primarily used for a registration address. GetBidderList Conditionally ShippingAddress GetItem RegistrationAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally ShippingAddress GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No The first line of the user's street address. Note: Note the different maximum lengths noted below for different countries. If a street name exceeds the maximum length for the applicable country, the full street name may be expressed through both the Street1 and Street2 fields. GB, DE - 35; US, CA - 40; AU - 80; Other countries - 50 GetBidderList Conditionally ShippingAddress GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally ShippingAddress ShipToAddress GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally GetItem RegistrationAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItem SellerContactDetails

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The second line of the user's street address (such as an apartment number or suite number). Returned if the user specified a second street value for their address. In case of Item.SellerContactDetails, Street2 can be used to provide City, Address, State, and Zip code (if applicable). Note: Note the different maximum lengths noted below for different countries. If a street name exceeds the maximum length for the applicable country, the full street name may be expressed through both the Street1 and Street2 fields. GB, DE - 35; US, CA - 40; AU - 80; Other countries - 50 GetBidderList Conditionally ShippingAddress GetItem RegistrationAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SellerContactDetails Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally ShippingAddress ShipToAddress GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No The city associated with an address on file with eBay. Most addresses include a city name, but not all. For example, Singapore is an island city-state, so <code>SG</code> would appear in the Country field, and 'Singapore' or 'Republic of Singapore' would appear in the CountryName field, but the CityName field is not applicable. GB, DE - 35; US, CA - 40; AU - 80; Other countries - 50 GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally GetBidderList Conditionally ShippingAddress GetItem RegistrationAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally ShippingAddress ShipToAddress GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetUserContactDetails Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The county associated with an address on file with eBay. This field should only be passed in or returned if applicable/defined. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SellerContactDetails Conditionally The state or province associated with an address on file with eBay. Whether it's a state or a province will depend on the region and/or country. This field should only be passed in or returned if applicable/defined. GB, DE - 35; US, CA - 40; AU - 80; Other countries - 50 GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally GetBidderList Conditionally ShippingAddress GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally ShippingAddress ShipToAddress GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetUserContactDetails Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The two-digit code representing the country of the user. If not provided as input, eBay uses the country associated with the eBay Site ID when the call is made. For a Global Shipping Program order, GetSellerList returns the country code of the buyer, not the international shipping provider. GetAllBidders GetUserContactDetails Always GetBidderList GetUserPreferences Conditionally GetItem RegistrationAddress ShippingAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

ShippingAddress ShipToAddress Conditionally GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetSellerList Conditionally HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

SetUserPreferences No The full name of the country associated with an address on file with eBay. eBay validates the content, but not the length for this field. Note: The eBay database allocates up to 128 characters for this field. GetBidderList Conditionally ShippingAddress GetItem RegistrationAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

ShippingAddress ShipToAddress Conditionally GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll, ReturnSummary, none

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally User's primary phone number. This may return a value of <code>Invalid Request</code> if you are not authorized to see the user's phone number. In the US, the area code (3 digits), the prefix (3 digits), the line number (4 digits), and phone extension (if specified by the user) are returned in this field. The extension can be one or more digits. Non-breaking spaces are used as delimiters between these phone number components. eBay validates the content (should only be integer values and delimiters), but not the length for this field. Note: The eBay database allocates up to 128 characters for this field. GetItem RegistrationAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

ShippingAddress ShipToAddress Conditionally GetBidderList ShippingAddress Conditionally GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetUserContactDetails Always GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally Standard ISO code for the country of the user's primary telephone phone number. For Classified Ad listings, this code is used to look up the country's international calling prefix. Both the ISO code and country phone prefix are stored with listings of this type. This field applies to Classified Ad listings only. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SellerContactDetails Conditionally Country Prefix of the secondary phone number. This value is derived from inputs supplied for PhoneCountryCode. This field applies to Classified Ad listings only. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SellerContactDetails Conditionally Area or City Code of a user's primary phone number. This field applies to Classified Ad listings only. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SellerContactDetails Conditionally The local number portion of the user's primary phone number. This field applies to Classified Ad listings only. Note: The full primary phone number is constructed by combining PhoneLocalNumber with PhoneAreaOrCityCode and PhoneCountryPrefix. 30 AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SellerContactDetails Conditionally User's postal code. For a Global Shipping Program order, GetSellerList and GetMyeBaySelling return the postal code of the buyer, not that of the international shipping provider. GB, DE - 35; US, CA - 40; AU - 80; Other countries - 50 GetBidderList Conditionally GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem RegistrationAddress ShippingAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions ShippingAddress ShipToAddress

DetailLevel: none, ReturnAll

Conditionally GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetAllBidders Always GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Unique ID for a user's address in the eBay database. This value can help prevent the need to store an address multiple times across multiple orders. The ID changes if a user changes their address. Note: For orders subject to Australian 'Goods and Services' tax (GST), in addition to the unique identifier for the address, the last two digits of the user's Australian Business Number (ABN) will also appear in this field. Australian 'Goods and Services' tax (GST) is automatically charged to buyers outside of Australia when they purchase items on the eBay Australia site. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This enumeration value returned here indicates the company that has the address on file. The value returned here should always be <code>eBay</code>. GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally ShipToAddress This field is no longer applicable, and should not returned. 20 GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Seller's international name that is associated with the payment address. This field is only applicable to seller payment/billing addresses. GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetBidderList Conditionally ShippingAddress International state and city that is associated with the seller's payment address. This field is only applicable to seller payment/billing addresses. GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetBidderList Conditionally ShippingAddress Seller's international street address that is associated with the payment address. This field is only applicable to seller payment/billing addresses. GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetBidderList Conditionally ShippingAddress User's company name. This field should only be passed in or returned if applicable/defined. GetUserContactDetails Always GetBidderList Conditionally ShippingAddress AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SellerContactDetails Conditionally GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

Displays the first name of the seller (in a business card format) if the seller's SellerBusinessCodeType value is <code>Commercial</code>. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetAdFormatLeads Conditionally

DetailLevel: ReturnAll

Displays the last name of the seller (in a business card format) if the seller's SellerBusinessCodeType is set to <code>Commercial</code>. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetAdFormatLeads Conditionally

DetailLevel: ReturnAll

Secondary Phone number of the lead. Not returned if information is unavailable. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally This tag tells whether current address is a default shipping address or one of the shipping addresses in address book. GetItemTransactions GetOrderTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Uniquely identifies an order shipped using the Global Shipping Program. This value is generated by eBay when the order is completed. The international shipping provider uses the ReferenceID as the primary reference when processing the shipment. Sellers must include this value on the package immediately above the street address of the international shipping provider. Example: "Reference #1234567890123456" GetItemTransactions GetOrderTransactions GetSellerTransactions GetOrders SellerShipmentToLogisticsProvider.ShipToAddress

DetailLevel: none, ReturnAll

Conditionally OrderReport SellerShipmentToLogisticsProvider.ShipToAddress Conditionally This field shows an attribute for the address, and its corresponding value. Currently, this field is only used to display the reference ID for a "Click and Collect" order, but in the future, other address attributes may be returned in this field. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This enumeration type lists the values that will be returned to the seller in a GetOrders call (and other order management calls) to indicate that the shipping address is the buyer's default shipping address, an alternative/secondary shipping address, or an invalid shipping address. This value indicates that the shipping address provided by the buyer at checkout time is the buyer's default/primary shipping address. This value indicates that the shipping address provided by the buyer at checkout time is one of the buyer's secondary shipping addresses on file with eBay. This value indicates that the address is not valid, and an alternative address will have to be provided before the order is shipped. (out) Reserved for internal or future use. An eBay-defined complex type for specifying monetary amounts. A double value (e.g., 1.00 or 1.0) is meaningful as a monetary amount when accompanied by a specification of the currency, in which case the value specifies the amount in that currency. An AmountType expresses both the value (a double) and the currency. The AmountType data type is typically used to specify details such as prices, fees, costs, and payments. In some cases, a whole number (i.e., without a period) can be passed or returned as a monetary value. This is necessary to support certain currencies that are only expressed as whole numbers. Because a double is used to represent the amount, this also means whole monetary amounts may be returned with only one 0 after the decimal. For example, a dollar value could be returned as 1.0 instead of 1.00 in calls like AddItem. Three-digit code representing the currency type being used. In Add/Revise/Relist calls, the currency can be specified in the Item.Currency field in requests instead. If you do specify this attribute in Add/Revise/Relist calls, the value must match the site currency (i.e., it must be the same as the value in Item.Currency) unless otherwise stated. In Add/Revise/Relist calls, listing fees are returned in the currency of the user's registration site. For example, a user who is registered on the eBay US site always sees their fees returned in USD, even when their listing request is sent to another site, such as eBay UK or eBay Germany. GetBidderList GetItemShipping GetMyeBaySelling Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally AddOrder Order.Total Yes GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBayBuying

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally RespondToBestOffer No InternationalShippingServiceOption ShippingServiceOptions ShippingServiceSelected Always GetBestOffers

DetailLevel: none, ReturnAll

Always GetOrders InternationalShippingServiceOption ShippingServiceOptions ShippingServiceSelected

DetailLevel: none, ReturnAll

Always OrderReport InternationalShippingServiceOption ShippingServiceOptions ShippingServiceSelected Always GetOrders InternationalShippingServiceOption ShippingServiceOptions ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally OrderReport InternationalShippingServiceOption ShippingServiceOptions ShippingServiceSelected Conditionally GetSellerTransactions InternationalShippingServiceOption ShippingServiceOptions ShippingServiceSelected

DetailLevel: none

Conditionally GetOrderTransactions InternationalShippingServiceOption ShippingServiceOptions ShippingServiceSelected

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally PlaceOffer ConvertedCurrentPrice CurrentPrice Always PlaceOffer MinimumToBid Conditionally AddItem AddItems RelistItem ReviseItem VerifyAddItem No Always AddLiveAuctionItem ReviseLiveAuctionItem No Always GetAllBidders GetStoreOptions Yes Always RelistItem No AddTransactionConfirmationItem Yes SendInvoice ShippingInsuranceCost, ShippingServiceCost, ShippingServiceAdditionalCost, SalesTaxAmount, InsuranceFee No This type is only applicable for Half.com listings, and since the Half.com site was taken down, this type is no longer applicable. AttributeArrayType and the Attribute element are only applicable for Half.com listings, and since the Half.com site was taken down, this field is no longer applicable. 1027 NoOp 1033 This type is deprecated. This field is deprecated. 773 NoOp 889 Item.ItemSpecifics This type is deprecated. 773 NoOp 889 Item.ItemSpecifics This field is deprecated. 773 NoOp 889 Item.ItemSpecifics This field is deprecated. 773 NoOp 889 Item.ItemSpecifics This field is deprecated. 773 NoOp 889 Item.ItemSpecifics This type is only applicable for Half.com listings, and since the Half.com site was taken down, this type is no longer applicable. AttributeType and all of its elements are only applicable for Half.com listings, and since the Half.com site was taken down, this field is no longer applicable. 1027 NoOp 1033 AttributeType and all of its elements are only applicable for Half.com listings, and since the Half.com site was taken down, this field is no longer applicable. 1027 NoOp 1033 AttributeType and all of its elements are only applicable for Half.com listings, and since the Half.com site was taken down, this field is no longer applicable. 1027 NoOp 1033 This type is used by the AuthenticityVerification container, which gives status on whether the order line item has passed or failed the authenticity inspection, or if the test is still pending. The following table describes the relationship between the Status and OutcomeReason fields. <table> <col /> <col /> <col /> <thead> <tr> <th> Status </th> <th> OutcomeReason </th> <th> Description </th> </tr> </thead> <tbody> <tr> <td>PENDING</td> <td>Not applicable</td> <td>Authenticity checks have not completed (the authentication status is pending). The order's authenticity is still unknown</td> </tr> <tr> <td>PASSED</td> <td>Not applicable</td> <td>The authentication has been accepted. The order is authentic. The authentication partner sends the order line item to the buyer with the message that the item is authentic</td> </tr> <tr> <td rowspan="2">PASSED_WITH_EXCEPTION There may be legal reasons or requirements such that the item cannot be labeled authentic. </td> <td>CUSTOMIZED</td> <td>The order line item has been altered or customized, and cannot be labeled as authentic but will be sent to the buyer</td> </tr> <tr> <td>MISCATEGORIZED</td> <td>The order line item was in the wrong eBay category and cannot be labeled as authentic but will be sent to the buyer</td> </tr> <tr> <td rowspan="3">FAILED</td> <td>NOT_AUTHENTIC</td> <td>The order could not be authenticated. The authentication partner returns the order line item to the seller; refunds the buyer</td> </tr> <tr> <td>NOT_AS_DESCRIBED</td> <td>The order is not as described. The authentication partner returns the order line item to the seller; refunds the buyer</td> </tr> <tr> <td>NOT_AUTHENTIC_NO_RETURN</td> <td>This enumeration value indicates that the order line item was found as counterfeit and cannot be returned to the seller because of legal constraints; refunds the buyer</td> </tr> </tbody> </table> The value in this field indicates whether the order line item has passed or failed the authenticity inspection, or if the test and/or results are still pending. The possible values returned here are <code>PENDING</code>, <code>PASSED</code>, <code>PASSED_WITH_EXCEPTION</code>, or <code>FAILED</code>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field is returned after the third-party authenticator has performed the authentication inspection on the order line item. Different values will be returned based on whether the item passed or failed the authentication inspection. This field is not returned when the status value of the order line item is <code>PENDING</code> or <code>PASSED</code>. The possible values returned here are <code>CUSTOMIZED</code>, <code>MISCATEGORIZED</code>, <code>NOT_AUTHENTIC</code>, <code>NOT_AS_DESCRIBED</code>, or <code>NOT_AUTHENTIC_NO_RETURN</code>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container shows service cost to the buyer for an item that will go through the Authenticity Guarantee process. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Type defining the BestOfferDetails container, which consists of Best Offer details associated with a listing. The BestOfferEnabled field in this container is used by Add/Revise/Relist calls to enable the Best Offer feature on a listing. The number of Best Offers made for this item, if any. In other words, if there are no Best Offers made, this field will not appear in the response. This field is not applicable to the Add/Revise/Relist calls. GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBaySelling ActiveList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally This field indicates whether or not the Best Offer feature is enabled for the listing. A seller can enable the Best Offer feature for a listing as long as the category supports the Best Offer feature. To see if an eBay category supports the Best Offer feature, run a GetCategoryFeatures call, including <code>BestOfferEnabled</code> as a FeatureID value in the call request payload. A listing enabled with the Best Offer feature allows a buyer to bargain with the seller and make a lower-priced offer than the fixed price or the starting bid price for an auction listing. The seller can then decide whether to accept the buyer's Best Offer price or propose a counter offer higher than the Best Offer price, but lower than the fixed price or starting bid price. Note: The Best Offer feature is now available for auction listings on the following sites: US, Canada, UK, Germany, Australia, France, Italy, and Spain. However, sellers must choose between offering Best Offer or Buy It Now on an auction listing, as both features cannot be enabled on the same auction listing. If an auction listing is enabled with Best Offer, this feature will no longer be applicable once the listing receives its first qualifying bid. AddFixedPriceItem AddItem AddItems RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetBidderList Conditionally This is the amount of the buyer's current Best Offer. This field will not appear in the GetMyeBayBuying response if the buyer has not made a Best Offer. This field is also not applicable to the Add/Revise/Relist calls. GetMyeBayBuying BestOfferList

DetailLevel: none, ReturnAll

Conditionally This enumeration value indicates the status of the latest Best Offer from the buyer. This field is only applicable to the GetMyeBayBuying call, and will not appear in the response if the buyer has not made a Best Offer. GetMyeBayBuying Conditionally BestOfferList

DetailLevel: none, ReturnAll

Note: this field is no longer used. The Best Offer type is only returned in the BestOfferCodeType field of the GetBestOffers call, and the applicable values for Best Offer type (<code>BuyerBestOffer</code>, <code>BuyerCounterOffer</code>, <code>SellerCounterOffer</code>, etc.) are defined in BestOfferTypeCodeType. This field is deprecated. Enumerated type that defines the possible values for the status of a Best Offer or a buyer's/seller's counter offer. This value indicates that the buyer's Best Offer on an item is awaiting the seller's response (accept, decline, counter offer). A buyer's Best Offer expires after 48 hours without a seller's response. Depending on context, this value can indicate that the buyer's Best Offer was accepted by the seller, or that the seller's or buyer's counter offer was accepted by the other party. Depending on context, this value can indicate that the buyer's Best Offer was declined by the seller, or that the seller's or buyer's counter offer was declined by the other party. Depending on context, this value can indicate that the buyer's Best Offer expired due to the passing of 48 hours with no seller response (accept, decline, counter offer), or that the seller's or buyer's counter offer expired due to the passing of 48 hours with no response from other party. Depending on context, this value can indicate that the buyer has retracted the Best Offer, or that the seller's or buyer's counter offer has been retracted. This value indicates that the Best Offer was ended by an eBay administrator. Depending on context, this value can indicate that a buyer's Best Offer or that the seller's or buyer's counter offer is in the active state. The <code>Active</code> value can also be used in the GetBestOffers request to retrieve only active Best Offers. Depending on context, this value can indicate that a buyer's Best Offer has been countered by the seller, or that the seller's or buyer's counter offer has been countered by the other party. This value is used in the GetBestOffers request to retrieve all Best Offers in all states. This value is only applicable to the GetBestOffers call. This value indicates that the buyer and seller have come to agreement on a Best Offer price, but the seller is still waiting for payment from the buyer. If the buyer does not pay within 48 hours, the Best Offer will expire. This value indicates that the seller is waiting on the buyer to commit to buying the item at the counter offer price. (out) Reserved for internal or future use. Enumerated type that defines the possible offer types for the Best Offer feature. This value indicates that the offer is an original Best Offer made by a prospective buyer to the seller. This value indicates that the offer is a prospective buyer's counter offer against the seller's counter offer. This value indicates that the offer is a seller's counter offer against the seller's original Best Offer. Reserved for internal or future use. Type defining the BiddingDetails container, which consists of information about the buyer's bidding history on a single auction item. Converted value (from seller's currency to buyer's currency) of the amount in the MaxBid field. This field is only applicable and returned if the buyer purchased an item from an eBay site in another country. For active items, it is recommended to refresh the listing's data every 24 hours to pick up the current conversion rates. GetMyeBayBuying BidList LostList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally This value is the dollar value of the highest bid that the buyer placed on the auction item. GetMyeBayBuying BidList LostList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally This value is the total number of bids that the buyer placed on the auction item throughout the duration of the listing. GetMyeBayBuying BidList LostList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally This field will only be returned if the buyer won the auction item, and if it is returned, its value will always be <code>1</code>. GetMyeBayBuying BidList LostList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally This field is returned as <code>true</code> if the prospective buyer is the current high bidder in an active listing. GetMyeBayBuying BidList

DetailLevel: none, ReturnAll

Conditionally This field is deprecated. Type used by the BiddingSummary container, which is returned in the GetAllBidders response if the IncludeBiddingSummary boolean field is included and set to <code>true</code> in the call request. The BiddingSummary container consists of bidding history information for a specific bidder (specified in the User.UserID field). This integer value indicates the length of time (in number of days) that is being used to calculate all counts in the BiddingSummary container. This value is generally <code>30</code> (days), which means that all counts in the container have been calculated from the present time and going back 30 days in the past. This field is always returned with the BiddingSummary container. GetAllBidders Conditionally This integer value indicates the total number of bids (from any and all eBay sellers) that the user has placed during the last 30 days (or the number of days specified in the SummaryDays field). This field is always returned with the BiddingSummary container. GetAllBidders Conditionally This integer value is actually a percentage value that indicates what percentage of the user's total number of bids during the last 30 days (or the number of days specified in the SummaryDays field) has been placed on auction items that the seller has listed. The percentage value is rounded up to the highest whole percentage number. This field is always returned with the BiddingSummary container. GetAllBidders Conditionally This integer value indicates the total number of bids to unique sellers that the user has placed during the last 30 days (or the number of days specified in the SummaryDays field). This field is always returned with the BiddingSummary container. GetAllBidders Conditionally This integer value indicates the total number of bids made with unique listing categories that the user has placed during the last 30 days (or the number of days specified in the SummaryDays field). This field is always returned with the BiddingSummary container. GetAllBidders Conditionally This integer value indicates the total number of bids that the user has retracted (from any and all sellers) during the last 30 days (or the number of days specified in the SummaryDays field). This field is always returned with the BiddingSummary container. GetAllBidders Conditionally This container provides information on each auction item that the user has placed a bid on during the last 30 days (or the number of days specified in the SummaryDays field). GetAllBidders Conditionally Type defining the BrandMPN container which is used to identify a product (through a unique product brand and Manufacturer Part Number combination). Note: If a brand and/or MPN value is required for a category, it is highly recommended that the brand and MPN name/value pair is also passed in through an ItemSpecifics.NameValueList container, since brand and MPN values may be dropped from the listing if eBay is not able to find a eBay catalog product match based on the provided Brand/MPN pair. The brand of the product. Both Brand and MPN should be specified if the BrandMPN container is used, or an error may occur. If Brand is a required or recommended item specific for a category, but an MPN is not applicable to the category/product, the Brand value should be specified in an Item.ItemSpecifics.NameValueList container instead. Note: The BrandMPN container is not applicable for multiple-variation listings. For multiple-variation listings that use MPNs, the Brand value should be specified through an ItemSpecifics.NameValueList container, and the Manufacturer Part Numbers (MPNs) for each product variation should be specified through a VariationSpecifics.NameValueList container. 65 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally The manufacturer part number of the product. Use the value specified by the manufacturer. Both Brand and MPN must be specified if the BrandMPN container is used or an error may occur. If the listing is being posted to a category that expects an MPN value, but one doesn't exist for the product, the seller must pass in the text that can be found in the ProductDetails.ProductIdentifierUnavailableText field of the GeteBayDetails response. To get the ProductDetails container to return in the GeteBayDetails response, <code>ProductDetails</code> should be included as a DetailName value in the call request. Note: The BrandMPN container is not applicable for multiple-variation listings. For multiple-variation listings that use MPNs, the Brand value should be specified through an ItemSpecifics.NameValueList container, and the Manufacturer Part Numbers (MPNs) for each product variation should be specified through a VariationSpecifics.NameValueList container. 65 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally Enumerated type that defines the eBay user's account type. This value indicates that the eBay user's account is a Partially Provisioned Account without buying and selling privileges on eBay. This value indicates that the eBay user's account is a fully provisioned account with buying and selling privileges on eBay. Type used by the BusinessSellerDetails container, which is returned in an Item node if the item's seller is registered on eBay as a Business Seller. This field shows the address on file for the Business Seller. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This field shows the Fax number on file for the Business Seller. This field is only returned if known and available. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This field shows the email address on file for the Business Seller. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This field shows any additional contact for the Business Seller in free-form text. This field is only returned if known and available. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This field shows the Trade Registration Number for the Business Seller. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This boolean field is returned as <code>true</code> if the Business Seller provides legal invoices to buyers. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This free-form text field provides the Business Seller's terms and conditions for doing business. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This container provides Value-Added Tax (VAT) details for the Business Seller, including the seller's VAT ID and the VAT percentage rate applicable to the item. VAT is similar to a sales and/or consumption tax, and it is only applicable to sellers selling on European sites. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Type defining the BuyerPackageEnclosure container, which is returned in GetOrders (and other order management calls) if the 'Pay Upon Invoice' option is being offered to the buyer, and the seller is including payment instructions in the shipping package. A BuyerPackageEnclosure container will be returned for each shipping package containing payment instructions. The 'Pay Upon Invoice' option is only available on the German site. This attribute indicates the type of payment instructions included in the shipping package. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally Type defining the BuyerPackageEnclosures container, which is returned in GetOrders (and other order management calls) if the 'Pay Upon Invoice' option is being offered to the buyer, and the seller is including payment instructions in the shipping package(s). A BuyerPackageEnclosure container will be returned for each shipping package containing payment instructions. The 'Pay Upon Invoice' option is only available on the German site. A BuyerPackageEnclosure container will be returned for each shipping package containing payment instructions. The 'Pay Upon Invoice' option is only available on the German site. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally This enumerated type identifies all of the payment methods supported for the 'Pay Upon Invoice' feature. The 'Pay Upon Invoice' feature is only available through the eBay Germany marketplace. This enumeration value indicates that no payment method was specified by the seller. This enumeration value indicates that a credit card was used to pay for the order. This enumeration value indicates that a bank debit card was used to pay for the order. This enumeration value indicates that PayPal was used to pay for the order. This enumeration value indicates that Elektronisches Lastschriftverfahren (direct debit) was used to pay for the order. This enumeration value indicates that an unknown credit card was used to pay for the order. This enumeration value indicates that Elektronisches Lastschriftverfahren (direct debit) was used locally to pay for the order. This enumeration value indicates that a Master Card credit card was used to pay for the order. This enumeration value indicates that an American Express credit card was used to pay for the order. This enumeration value indicates that a Visa credit card was used to pay for the order. This enumeration value indicates that a Discover credit card was used to pay for the order. This enumeration value indicates that a Diners Club credit card was used to pay for the order. This enumeration value indicates that a JCB credit card was used to pay for the order. This enumeration value indicates that a Switch debit card was used to pay for the order. This enumeration value indicates that a Solo debit card was used to pay for the order. This enumeration value indicates that Giropay was used to pay for the order. This enumeration value indicates that BML was used to pay for the order. This enumeration value indicates that the 'Pay Upon Invoice' option was offered to the buyer on the Germany site. Reserved for internal or future use. This enumeration type indicates the item's eligibility status for eBay's Money Back Guarantee program. This value indicates that the item is ineligible for buyer protection. In many cases, the item is ineligible for buyer protection due to the listing category. This value indicates that the item is eligible for buyer protection. This value indicates that customer support has marked the item as ineligible per special criteria (e.g., seller's account closed). This value indicates that customer support has marked the item as eligible per special criteria. This value indicates that the item is ineligible for coverage under any buyer protection program. Reserved for internal or future use. Type defining the ApplyBuyerProtection container, which consists of details related to whether or not the item is eligible for buyer protection and which of the buyer protection programs will cover the item. This value indicates the type of buyer protection program applicable for the item. This field is always returned with the ApplyBuyerProtection container. GetItemTransactions Conditionally GetOrderTransactions Conditionally GetSellerTransactions Conditionally GetItem Conditionally This value indicates the item's eligibility for the buyer protection program listed in the ApplyBuyerProtection.BuyerProtectionSource field. This field is always returned with the ApplyBuyerProtection container. GetItemTransactions Conditionally GetOrderTransactions Conditionally GetSellerTransactions Conditionally GetItem Conditionally PayPal This enumeration type indicates the applicable buyer protection program that the item is eligible to be covered under. This value indicates that the item is possibly eligible for buyer protection under the eBay Money Back Guarantee program. This value is deprecated. Reserved for internal or future use. Type defining the BuyerRequirementDetails container, which allows the seller to set buyer requirements at the listing level. For the corresponding listing, all buyer requirement values/settings will overwrite values/settings in Buyer Requirements preferences in My eBay. The seller includes and sets this field to <code>true</code> as a mechanism to block bidders who reside (according to their eBay primary shipping address) in countries that are on the ship-to exclusion list. Sellers add countries or regions to their ship-to exclusion list by adding those countries or regions using one or more ExcludeShipToLocation fields in an Add/Revise/Relist call. false AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This Buyer Requirements feature is only available to sellers on the China site, and is only applicable to fixed-price or auction Buy It Now items. The seller includes and sets this field to <code>true</code> as a mechanism to block prospective buyers with a feedback score of 0 from buying items with a price of 100 RMB or higher. false AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The seller uses this container as a mechanism to restrict the number of items (specifying a MaximumItemCount value) a prospective buyer can purchase from the seller during a 10-day period. The seller also has the option of setting a MinimumFeedbackScore requirement. If both fields of the MaximumItemRequirements container are set, the MaximumItemCount limit will only apply to those prospective buyers that don't equal or exceed the specified minimum Feedback Score. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The seller uses this container as a mechanism to block prospective buyers who have one or more Unpaid Item strikes on their account during a specified time period. A buyer receives an Unpaid Item strike if a seller files an Unpaid Item case against the buyer, and eBay rules in favor of the seller. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This type is used by various Get calls, including GetItem and GetOrders. Only the order management calls return the BuyerTaxIdentifier container, and each call that uses BuyerType uses the ShippingAddress container a little differently. This container shows the buyer's shipping address. Note: For an Authenticity Guarantee program order returned in GetItemTransactions or GetSellerTransactions, this is the address of the authenticator's warehouse. The authenticator is responsible for delivery to the buyer's shipping address. GetAllBidders Always GetBidderList Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions BuyerInfo

DetailLevel: none, ReturnAll

Conditionally GetSellerList Conditionally HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This container consists of taxpayer identification for the buyer. Although this container may be used for other purposes at a later date, it is currently used by sellers selling on the Italy or Spain site to retrieve the taxpayer ID of the buyer. It is now required that buyers registered on the Italy site provide their Codice Fiscale ID (similar to the Social Security Number for US citizens) before buying an item on the Italy site. On the Spain site, a Spanish seller has the option to require that Spanish buyers (registered on Spain site) provide a tax ID before checkout. This option is set by the seller at the account level. Once a Spanish buyer provides a tax ID, this tax ID is associated with his/her account, and once a tax ID is associated with the account, Spanish buyer will be asked to provide the tax ID during checkout on all eBay sites. Buyers with a registered address outside of Spain will not be asked to provide a tax ID during checkout. This container is only returned for Spanish or Italian sellers when the buyer was asked to provide tax identifier information during checkout. A BuyerTaxIdentifier will be returned for each tax ID that is associated with the buyer's account. GetOrders

DetailLevel:none,ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel:none,ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel:none,ReturnAll

Conditionally Type used by the CalculatedShippingDiscount container, which is used in the SetShippingDiscountProfiles call to create one or more discounted calculated shipping rules. The CalculatedShippingDiscount container is returned in the response of all other calls that use this type. This enumeration value indicates the type of calculated shipping discount rule that is being applied. Each rule is explained below. GetShippingDiscountProfiles IndividualItemWeight, CombinedItemWeight, WeightOff Conditionally SetShippingDiscountProfiles IndividualItemWeight, CombinedItemWeight, WeightOff Conditionally GetItem IndividualItemWeight, CombinedItemWeight, WeightOff

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Shipping Cost Discount Profiles https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-OtherFeatures.html#ShippingCostDiscountProfiles This container provides details of this particular calculated shipping discount profile. For SetShippingDiscountProfiles: If the ModifyActionCode value is set to <code>Update</code>, all details of the modified version of the profile must be provided. If the ModifyActionCode value is set to <code>Delete</code>, the DiscountProfileID is required, the MappingDiscountProfileID is optional, and all other fields of the container are no longer applicable. Restrictions on how many profiles can exist for a given discount rule are discussed in the Features Guide documentation on Shipping Cost Discount Profiles. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles IndividualItemWeight, CombinedItemWeight, WeightOff Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Shipping Cost Discount Profiles https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-OtherFeatures.html#ShippingCostDiscountProfiles Details pertinent to one or more items for which calculated shipping (or flat rate shipping using shipping rate tables with weight surcharges) has been offered by the seller, such as package dimension and weight and packaging/handling costs. Also returned with the data for an item's transaction. Note: The CalculatedShippingRate container should only be used to specify values for the InternationalPackagingHandlingCosts, OriginatingPostalCode, and/or PackagingHandlingCosts fields. The rest of the fields in the CalculatedShippingRate container should now be specified in the ShippingPackageDetails container instead. The postal code for the location from which the package will be shipped. A postal code is required for calculated shipping. This field is not necessary if a postal code is already specified through the Item.PostalCode field. If a postal code is included in both fields, the value in Item.PostalCode field is used, and the value in OriginatingPostalCode is ignored. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Note: The value for MeasurementUnit should now be specified in the ShippingPackageDetails container instead. If the MeasurementUnit field is passed in the CalculatedShippingRate container and in the ShippingPackageDetails container, the value in the ShippingPackageDetails container will take precedence. 997 Avoid 1033 ShippingPackageDetails.MeasurementUnit Fees a seller might assess for the shipping of the item (in addition to whatever the shipping service might charge). Any packaging/handling cost specified on input is added to each shipping service on output. If domestic and international calculated shipping is offered for an item and if packaging/handling cost is specified only for domestic shipping, that cost will be applied by eBay as the international packaging/handling cost. (To specify a international packaging/handling cost, you must always specify a domestic packaging/handling cost, even if it is 0.) When UPS is one of the shipping services offered by the seller, package dimensions are required on list/relist/revise. For calculated shipping only. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Note: The value for ShippingIrregular should now be specified in the ShippingPackageDetails container instead. If the ShippingIrregular field is passed in the CalculatedShippingRate container and in the ShippingPackageDetails container, the value in the ShippingPackageDetails container will take precedence. This field may be deprecated in the future. 997 Avoid 1033 ShippingPackageDetails.ShippingIrregular Fees a seller might assess for the shipping of the item (in addition to whatever the shipping service might charge). Any packaging/handling cost specified on input is added to each shipping service on output. If domestic and international calculated shipping is offered for an item and if packaging/handling cost is specified only for domestic shipping, that cost will be applied by eBay as the international packaging/handling cost. (To specify a international packaging/handling cost, you must always specify a domestic packaging/handling cost, even if it is 0.) For international calculated shipping only. AddFixedPriceItem AddItem AddItems RelistItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetItemShipping GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Type used by the CancelDetail container, which consists of details related to an eBay order that has been cancelled or is in the process of possibly being cancelled. This value indicates the reason why the order cancellation was initiated. This field is always returned with the CancelDetail container. Typical buyer-initiated cancellation reasons include <code>OrderPlacedByMistake</code>, <code>WontArriveInTime</code>, or <code>FoundCheaperPrice</code>. Sellers may initiate an order cancellation on behalf of the buyer. In this scenario, the seller should state the cancellation reason as <code>BuyerCancelOrder</code>. If the seller is cancelling an order because he/she is out of stock on an item, the seller should state the cancellation reason as <code>OutOfStock</code>. Unfortunately, in this scenario, the seller will receive a seller defect for this cancellation reason. Other order cancellation reasons are specific to eBay Scheduled Delivery orders. eBay Scheduled Delivery is similar to the eBay Now service in the US (now retired), and is only available in the UK. See <a href="types/CancelReasonCodeType.html">CancelReasonCodeType</a> for the complete list of enumeration values that can be returned in this field. Note: Currently, the CancelReason field is being returned under the Order container and under the CancelDetail container. However, there are plans to deprecate this field from OrderType in the future. CancelReasonCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The detailed reason of why the order cancellation was initiated. This field is only returned if it is available for an order that has been cancelled, or if an order is going through the cancellation process. Note: Currently, the CancelReasonDetails field is being returned under the Order container and under the CancelDetail container. However, there are plans to deprecate this field from OrderType in the future. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This value indicates which party initiated the cancellation of the eBay order. It will usually be <code>Buyer</code> or <code>Seller</code>, but it can also be <code>CS</code> (eBay Customer Support). See <a href="types/CancelInitiatorCodeType.html">CancelInitiatorCodeType</a> for the complete list of enumeration values that can be returned in this field. This field is always returned with the CancelDetail container. CancelInitiatorCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This timestamp indicates when the cancellation of the eBay order was initiated. This field is always returned with the CancelDetail container. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Timestamp indicating when the cancellation process of an eBay order has been completed, which will be indicated if the Order.CancelStatus field has a value of <code>CancelComplete</code>. This field will not be returned until the cancellation process is completed. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Enumerated type that defines the possible states of an eBay order cancellation. This value indicates that the order cancellation request is invalid. This value indicates that the order cancellation request is not applicable. This value indicates that the buyer has initiated the cancellation of the eBay order. It will be up to the seller to decide to approve or reject the cancellation request. This value indicates that the cancellation of the eBay order has been initiated by the buyer and approved by the seller, but the cancellation request has yet to be completed. This value indicates that the cancellation of the eBay order initiated by the buyer has been rejected by the seller. This value indicates that the order cancellation request has been closed, with no refund issued to the buyer. This value indicates that the order cancellation request has been closed, with a refund issued to the buyer. This value indicates that the order cancellation request has been closed, and it is unknown whether or not a refund was issued to the buyer. This value indicates that since the buyer committed to buying the item but did not pay for it, the cancellation succeeded and no refund is needed. This value indicates that the cancellation of the eBay order has been completed. This value indicates that the cancellation of the eBay order has failed. This value is reserved for internal or future use. Container for data on one listing category. Many of the CategoryType fields are only returned in the GetCategories response. Add/Revise/Relist calls only use the CategoryID field to specify which eBay category in which to list the item. If this field is returned as <code>true</code>, the corresponding category supports Best Offers. If this field is not present, the category does not support Best Offers. This field is not returned when <code>false</code>. GetCategories

DetailLevel: ReturnAll

Conditionally If this field is returned as <code>true</code>, the corresponding category supports immediate payment for listings. The immediate payment feature is applicable to fixed-price listings, to auction listings with the Buy It Now option enabled, and for a motor vehicle listing that requires an initial deposit. If the immediate payment feature is enabled for a listing, the buyer must pay immediately after clicking the 'Buy it Now' button. This field is only returned when <code>true</code>. GetCategories

DetailLevel: ReturnAll

Conditionally Requiring Immediate Payment https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Listing-PaymentMethod.html#RequiringImmediatePayment If this field is returned as <code>true</code>, the corresponding category supports business-to-business (B2B) VAT listings. If this field is not present, the category does not B2B VAT listings. This field is not returned when <code>false</code>. This feature is applicable to the eBay Germany (DE), Austria (AT), and Switzerland (CH) sites only. GetCategories

DetailLevel: ReturnAll

Conditionally Working with Business Features and VAT https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Sites-IntlDiffsVATB2B.html If this field is deprecated.. This string value is the unique identifier of an eBay category. In GetItem and related calls, see the CategoryName field for the text name of the category. The parent category of this eBay category is only shown in GetCategories. In an Add call, the PrimaryCategory.CategoryID is conditionally required unless the seller successfully uses the ProductListingDetails container to find an eBay catalog product match. When the seller successfully uses an eBay catalog product to create a listing, the listing title, listing description, item specifics, listing category, and stock photo defined in the catalog product is used to create the listing. In an Add/Revise/Relist call, the SecondaryCategory.CategoryID is conditionally required if a Secondary Category is used. Using a Secondary Category can incur a listing fee. For ReviseItem only: Previously, removing the listing from a secondary category was only possible within 12 hours of the listing's scheduled end time when an auction listing had no active bids or a multiple-quantity, fixed-price listing had no items sold, but this restriction no longer exists. Now, the secondary category can be dropped for any active listing at any time, regardless of whether an auction listing has bids or a fixed-price listing has sales. To drop a secondary category, the seller passes in a value of <code>0</code> in the SecondaryCategory.CategoryID field. 10 AddItem AddItems VerifyAddItem AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem RelistItem ReviseItem VerifyRelistItem PrimaryCategory Conditionally AddItem AddItems VerifyAddItem AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem RelistItem ReviseItem VerifyRelistItem SecondaryCategory Conditionally GetBidderList PrimaryCategory Always GetBidderList Conditionally FreeAddedCategory SecondaryCategory GetCategories

DetailLevel: ReturnAll

Always GetContextualKeywords Always GetItem Always PrimaryCategory

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItem Conditionally FreeAddedCategory SecondaryCategory

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSuggestedCategories Conditionally GetSellerList Conditionally FreeAddedCategory SecondaryCategory

DetailLevel: ItemReturnDescription, ReturnAll

GetSellerList Conditionally PrimaryCategory SecondaryCategory

DetailLevel: ItemReturnDescription, ReturnAll

This integer value indicates the level where the category fits in the eBay site's category hierarchy. For example, if this field has a value of <code>2</code>, then the category is two levels below the root category in the eBay site's category hierarchy. GetCategories

DetailLevel: ReturnAll

Always This string value is the display name of the eBay primary category, as it would appear on the eBay site. In GetItem, this will be a fully-qualified category name (e.g., Collectibles:Decorative Collectibles:Hummel, Goebel). 50 GetCategories

DetailLevel: ReturnAll

Always 50 GetContextualKeywords Always GetBidderList Always PrimaryCategory GetBidderList Conditionally FreeAddedCategory SecondaryCategory GetItem Always PrimaryCategory

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItem Conditionally FreeAddedCategory SecondaryCategory

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

50 GetSuggestedCategories Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally This string value is the Category ID of the primary category's (indicated in the CategoryID field) parent category. The number of CategoryParentID values that are returned will depend on the LevelLimit value that is set (in GetCategories) and on how far up the primary category is in the eBay category hierarchy. CategoryParentID values are returned in correct sequence, starting from the root category and ending with the category that is the direct parent of the primary category specified in CategoryID. The CategoryID and CategoryParentID values will be the same if the LevelLimit value is set to <code>1</code>. 10 GetCategories

DetailLevel: ReturnAll

Always GetSuggestedCategories Conditionally This string value is the display name of the category indicated in the corresponding CategoryParentID field. If multiple parent categories are retrieved in the GetSuggestedCategories call, the matching CategoryParentID and CategoryParentName can be found by following the sequence in which these fields are returned. The primary category's ancestors are returned in sequence beginning with the root category all the way down to the primary category's direct parent category. The CategoryParentName fields and the CategoryName field can be used to build the fully-qualified category name and/or "breadcrumbs" browse path. (e.g., Computers & Networking > Technology Books > Certification). GetSuggestedCategories Conditionally This field is deprecated. 773 Avoid FindProducts (Shopping API) 889 This field is deprecated. 773 Avoid FindProducts (Shopping API) 889 This field is deprecated. 773 Avoid FindProducts (Shopping API) 889 If this field is returned as <code>true</code>, the corresponding category is no longer a valid eBay category on the site, and items may not be listed in this category. This field is not returned when <code>false</code>. GetCategories

DetailLevel: ReturnAll

Always This field is deprecated. If this field is returned as <code>true</code>, the corresponding category is an eBay leaf category, a category in which items may be listed. This field is not returned when <code>false</code>. GetCategories

DetailLevel: ReturnAll

Always If this field is returned as <code>true</code>, the corresponding category is an eBay virtual category, a category in which items may not be listed. This field is not returned when <code>false</code>. GetCategories

DetailLevel: ReturnAll

Always This field is deprecated. This field is deprecated. 773 Avoid 889 If this field is returned as <code>true</code>, the corresponding category is an exception to the eBay site's standard Reserve Price policy on auction listings. For example, if the site's default setting is to allow setting a Reserve Price, but ORPA is returned as <code>true</code>, this particular category does not support setting a Reserve Price. Or, if the site's default setting is not to allow setting a Reserve Price, but ORPA is returned as <code>true</code>, this particular category is the exception to that rule and does support setting a Reserve Price. If ORPA is <code>true</code> for the corresponding category, you can generally assume that the category's subcategories inherit the same setting. 'ORPA' is an acronym for 'Override Reserve Price Allowed'. This field is not returned when <code>false</code>. GetCategories

DetailLevel: ReturnAll

Always If this field is returned as <code>true</code>, the corresponding category is an exception to the eBay site's standard Reduce Reserve Price (on active auction listing) policy. For example, if the site's default setting is to allow reducing a Reserve Price for the active auction listing, but ORRA is returned as <code>true</code>, this particular category does not support reducing a Reserve Price. Or, if the site's default setting is not to allow reducting a Reserve Price, but ORRA is returned as <code>true</code>, this particular category is the exception to that rule and does support reducing a Reserve Price. If ORRA is <code>true</code> for the corresponding category, you can generally assume that the category's subcategories inherit the same setting. 'ORRA' is an acronym for 'Override Reduce Reserve Allowed'. This field is not returned when <code>false</code>. GetCategories

DetailLevel: ReturnAll

Conditionally If this field is returned as <code>true</code>, the corresponding category does not support lot listings. A lot listing is a listing that features multiple related items that must be purchased by one buyer in one transaction. 'LSD' is an acronym for 'Lot Size Disabled'. 'Lot Size' refers to the LotSize field in the Add/Revise/Relisting calls that is conditionally required if the seller is creating a lot listing. The LSD field is not returned when <code>false</code>. GetCategories

DetailLevel: ReturnAll

Always This field is deprecated. This type is deprecated. 773 Avoid FindProducts (Shopping API) 889 This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This type is deprecated. 773 Avoid FindProducts (Shopping API) 889 This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. Type defining the CharityAffiliationDetail container that is returned in the GetUser response. The CharityAffiliationDetail container consists of information on a nonprofit charity organization associated with the seller's account. A separate CharityAffiliationDetail container is returned for each nonprofit charity organization associated with the seller's account. The eBay unique identifier of the nonprofit organization associated with the seller's account. Once a nonprofit organization comes aboard as an eBay for Charity organization, eBay creates and assigns this ID to the nonprofit organization. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally The enumeration value returned here indicates whether the eBay user is just selling on the behalf of the nonprofit organization, or if the eBay user is directly affiliated with/representing the nonprofit organization, or the eBay user has been added as a Direct Seller by the nonprofit organization. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This timestamp indicates when the eBay user last contributed to the nonprofit organization through the donated proceeds of an eBay sale. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This type is used to hold an array of one or more eBay for Charity organizations that are affiliated with the seller's account. A CharityAffiliationDetail container will be returned for each eBay for Charity organization that is associated with the seller's account. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This enumeration type defines the possible values that can be returned for the CharityAffiliationDetail.AffiliationType field in the GetUser response. This enumeration value indicates that the eBay user is just selling on the behalf of the nonprofit organization, and is not directly affiliated with the organization. This enumeration value indicates that the eBay user is directly affiliated with or represents the nonprofit organization, or the eBay user has been added as a Direct Seller by the same nonprofit organization. This enumeration value may be returned if the nonprofit organization has recently unregistered as an eBay for Charity organization, or it may be returned if the eBay user has recently removed the charity feature from a listing. Reserved for internal or future use. This type is deprecated. This field is deprecated. 655 NoOp User.SellerInfo.CharityAffiliationDetails.CharityAffiliationDetail.CharityID The type is used to indicate how an eBay seller is affiliated with the nonprofit organization registered with eBay for Charity. This attribute value is used to indicate how an eBay seller is affiliated with the nonprofit organization registered with eBay for Charity. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Enumerated type defining the possible states for a nonprofit charity organization registered with the PayPal Giving Fund. The specified nonprofit charity organization is a valid nonprofit charity organization according to the requirements of the PayPal Giving Fund. The specified nonprofit charity organization is no longer a valid nonprofit charity organization according to the requirements of the PayPal Giving Fund. (out) Reserved for internal or future use. This type is used to provide details about a nonprofit organization that will benefit from each sale generated from an eBay listing. The full name of the nonprofit organization. 150 GetBidderList Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItem GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally This numeric value is the unique identifier assigned to a nonprofit charity organization by the PayPal Giving Fund. Note: In an Add/Revise/Relist call, use CharityID instead, which is the unique identifier that eBay creates and assigns to the same nonprofit organization. The CharityNumber field will eventually be deprecated. If both the CharityNumber and CharityID fields are used, the CharityID takes precedence. 10 AddItem AddItems RelistItem VerifyAddItem AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem VerifyRelistItem ReviseItem ReviseFixedPriceItem Conditionally GetBidderList Conditionally GetItem GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The percentage of the purchase price that the seller chooses to donate to the selected nonprofit organization. This percentage is displayed in the eBay for Charity listing. Possible values: 10.0 to 100.0. <ul> <li>Percentages must increment by 5.0. </li> <li>Minimum donation percentages may be required for eBay for Charity listings, see <a href="http://pages.ebay.com/help/sell/selling-nonprofit.html"> Selling to benefit nonprofit organizations</a> for details. </li> </ul> The DonationPercent field is required in an Add/Revise/Relist call if the seller will be donating a percentage of the sale proceeds for each sale generated by the listing. AddItem AddItems RelistItem VerifyAddItem AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem RelistFixedPriceItem VerifyRelistItem ReviseItem ReviseFixedPriceItem Conditionally GetBidderList Conditionally GetItem GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The unique identifier that eBay creates and assigns to each nonprofit organization. Note: In an Add/Revise/Relist call, this CharityID should be used instead of the CharityNumber field, which is the PayPal Giving Fund's unique identifier for the nonprofit organization. The CharityNumber field will eventually be deprecated. The field is required in an Add/Revise/Relist call if the seller will be donating a percentage of the sale proceeds to this organization for each sale generated by the listing. If both the CharityNumber and CharityID fields are used, the CharityID takes precedence. AddItem AddItems RelistItem VerifyAddItem AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem RelistFixedPriceItem VerifyRelistItem ReviseItem ReviseFixedPriceItem Conditionally GetBidderList Conditionally GetItem GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The stated mission of the nonprofit charity organization. This mission statement is displayed in the eBay for Charity section of the View Item page. 511 GetBidderList Conditionally GetItem GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally The full URL to the nonprofit organization's logo image file. This logo image file is the image that is displayed in all eBay listings that benefit that charity. This field is returned as long as it is defined for the nonprofit organization. GetItem GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList Conditionally This enumeration value indicates whether or not the nonprofit organization is a valid eBay for Charity organization, and is able to receive proceeds from eBay sales. GetBidderList Conditionally GetItem GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally If this field is returned as <code>true</code>, a percentage of order line item's purchase price will be donated to a nonprofit organization. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Enumerated type that lists the possible checkout states of an order line item. This value indicates that the buyer has paid and checkout is complete. This value indicates that checkout is incomplete, generally because the buyer has not paid yet. This value indicates that the buyer wants to confirm the total price of the order line item before making a payment. This value indicates that the seller has just responded to the buyer concerning the total price of the order line item. Reserved for future use. Type defining the CheckoutStatus container that is returned in GetOrders and GetOrderTransactions to indicate the current checkout status of the order. Indicates the status of the buyer's payment for an order. If the payment was successfuly processed, a value of <code>NoPaymentFailure</code> will be returned. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always Indicates the last time that there was a change in value of the CheckoutStatus.Status field, such as 'Pending' to 'Complete'. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always The payment method that the buyer selected to pay for the order. Note: Sellers no longer have to specify any electronic payment methods at listing time, but this field is still returned. The value returned in this field will generally be <code>CreditCard</code>, unless an eBay gift card was used by the buyer to pay a partial or full balance of the order. If this is the case, the value returned in this field will be <code>CCAccepted</code>. Either of these two values will be returned, but neither accurately reflects the actual payment method that the buyer used. If the order was paid for off of eBay's platform using an 'offline' payment method such as 'CashOnPickup' or 'MOCC' (money order or cashier's check), and the seller marked the order as paid, either of those values may get returned here. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always Indicates the status of the order. This value is subject to change based on the status of the checkout flow. Generally speaking, the Status field reads <code>Incomplete</code> when payment has yet to be initiated, <code>Pending</code> when payment has been initiated but is in process, and <code>Complete</code> when the payment process has completed. Note: If the PaymentMethod is <code>CashOnPickup</code>, the Status value will read <code>Complete</code> right at checkout, even though the seller may not have been officially paid yet, and the eBayPaymentStatus field will read <code>NoPaymentFailure</code>. The Status value will remain as <code>Complete</code> even if the seller changes the checkout status to Pending. However, the eBayPaymentStatus value in GetOrders will change from <code>NoPaymentFailure</code> to <code>PaymentInProcess</code>. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This field is no longer applicable as eBay sellers can no longer use iMCC gateway accounts to handle buyer payments. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This container is no longer used. The enumeration value in this field indicates which payment method was used by the German buyer who was offered the 'Pay Upon Invoice' option. This field will only be returned if a German buyer was offered the 'Pay Upon Invoice' option. Otherwise, the buyer's selected payment method is returned in the PaymentMethod field. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally INVOICE This enumerated type defines the collection methods that are used to collect either 'Collect and Remit' sales tax in the US, or 'Good and Services' tax in Australia and New Zealand. Note: Although the CollectionMethod field is returned for orders subject to 'Collect and Remit' sales tax or 'Good and Services' tax, the CollectionMethod field and CollectionMethodCodeType are currently not applicable. Note: This value is for future use. This value is always returned, but because the CollectionMethod field and CollectionMethodCodeType are not currently applicable, this value does not have any purpose at this time. This enumerated type list the Feedback ratings that can be left by one eBay user for another user regarding that user's experience with the another user during the purchase/checkout flow of an order line item. This value indicates that the submitting user's experience with the other user (receiving feedback) was rated as a "Positive" experience. If an eBay user receives a Positive rating for an order line item from a Verified User, their overall Feedback score increases by a value of 1. This value indicates that the submitting user's experience with the other user (receiving feedback) was rated as a "Neutral" experience. If an eBay user receives a Neutral rating for an order line item from a Verified User, their overall Feedback score remains the same. This value indicates that the submitting user's experience with the other user (receiving feedback) was rated as a "Negative" experience. If an eBay user receives a Negative rating for an order line item from a Verified User, their overall Feedback score decreases by a value of 1. This value indicates that a submitted Feedback entry was withdrawn. If a Feedback entry is withdrawn, the effect of that entry on the overall Feedback score is nullified. However, Feedback comments from the withdrawn entry are still visible. This value indicates that a submitted Feedback entry was withdrawn based on the decision of a third-party (such as eBay). If a Feedback entry is withdrawn, the effect of that entry on the overall Feedback score is nullified. This value is only applicable to the eBay Motors site only. This value is reserved for internal or future use. Enumerated type that contains values which indicate whether an order or order line item is complete, incomplete, or pending. This value indicates that the order or order line item is in the incomplete state. Generally speaking, an order or order line item is considered incomplete when payment from the buyer has yet to be initiated. This value indicates that the order or order line item is complete. Generally speaking, an order or order line item is complete when payment from the buyer has been initiated and has been processed. Note: If the PaymentMethodUsed is <code>CashOnPickup</code>, the CheckoutStatus.Status value in GetOrders will be <code>Complete</code> at checkout time, even though the seller may not have been officially paid yet. The CheckoutStatus.Status value in GetOrders will remain as <code>Complete</code> even if the seller changes the checkout status to Pending. However, the eBayPaymentStatus value in GetOrders will change from <code>NoPaymentFailure</code> to <code>PaymentInProcess</code>. This value indicates that the order or order line item is in the pending state. Generally speaking, an order is considered pending when payment from the buyer has been initiated but has yet to be fully processed. Note: If the payment method is <code>CashOnPickup</code>, the CheckoutStatus.Status value in GetOrders will read <code>Complete</code> at checkout time, even though the seller may not have been officially paid yet. The CheckoutStatus.Status value in GetOrders will remain as <code>Complete</code> even if the seller changes the checkout status to Pending. However, the eBayPaymentStatus value in GetOrders will change from <code>NoPaymentFailure</code> to <code>PaymentInProcess</code>. Reserved for internal or future use Type defining the ContactHoursDetails container, which is used in Add/Revise/Relist calls to provide contact hours for the owner of a Classified Ad. The ContactHoursDetails container is only applicable to Classified Ad listings. Indicates the local time zone of the values provided for Hours1From/Hours1To and Hours2From/Hours2To. If you specify a contact hours time range with Hours1From and Hours1To, you must provide a local time zone. To retrieve a complete list of the TimeZoneID values supported by eBay, call GeteBayDetails with DetailName set to TimeZoneDetails. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates the range of days for which the primary contact hours specified by Hours1AnyTime or Hours1From and Hours1To apply. If a value of None is provided for this field, the values provided for Hours1AnyTime, Hours1From, Hours1To are ignored. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates whether or not a user is available to be contacted 24 hours a day during the range of days specified using the Hours1Days element. True indicates the user is available 24 hours a day, false indicates otherwise. In the case of this field being true, all values provided for Hours1From and Hours1To will be ignored. In the case of this field being false, the values provided Hours1From and Hours1To will be considered. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates the starting time of day this eBay user is available for other eBay members to contact for the range of days specified using Hours1Days. Enter times in 30 minute increments from the top of the hour. That is, enter values either on the hour (:00) or 30 minutes past the hour (:30). Other values will be will be rounded down to the next closest 30 minute increment. Times entered should be local to the value provided for TimeZoneID. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates the ending time of day this eBay user is available for other eBay members to contact them for the range of days specified using Hours1Days. Enter times in 30 minute increments from the top of the hour. That is, enter values either on the hour (:00) or 30 minutes past the hour (:30). Other values will be will be rounded down to the next closest 30 minute increment. Times entered should be local to the value provided for TimeZoneID. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates the range of days for which the secondary contact hours specified by Hours2AnyTime or Hours2From and Hours2To apply. If a value of None is provided for this field, the values provided for Hours2AnyTime, Hours2From, Hours2To are ignored. Note: You cannot set Hours2Days to EveryDay. If Hours1Days is set to EveryDay, secondary contact hours do not apply. Hours2Days cannot be set to the same value as Hours1Days. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates whether or not a user is available to be contacted 24 hours a day during the range of days specified using the Hours2Days element. True indicates the user is available 24 hours a day, false indicates otherwise. In the case of this field being true, all values provided for Hours2From and Hours2To will be ignored. In the case of this field being false, the values provided Hours2From and Hours2To will be considered. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates the starting time of day this eBay user is available for other eBay members to contact for the range of days specified using Hours2Days. Enter times in 30 minute increments from the top of the hour. That is, enter values either on the hour (:00) or 30 minutes past the hour (:30). Other values will be will be rounded down to the next closest 30 minute increment. Times entered should be local to the value provided for TimeZoneID. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This enumerated type contains a partial list of ISO 3166 standard two-letter codes that represent countries around the world. It is recommended that users use the GeteBayDetails call to see the full list of currently supported country codes, and the English names associated with each code (e.g., KY="Cayman Islands"). Call GeteBayDetails with DetailName set to Country, and then look for CountryDetails.Country fields in the response. QP Afghanistan. Albania. Algeria. American Samoa. Andorra. Angola. Anguilla. Antarctica. Antigua and Barbuda. Argentina. Armenia. Aruba. Australia. Austria. Azerbaijan. Bahamas. Bahrain. Bangladesh. Barbados. Belarus. Belgium. Belize. Benin. Bermuda. Bhutan. Bolivia. Bosnia and Herzegovina. Botswana. Bouvet Island. Brazil. British Indian Ocean Territory. Brunei Darussalam. Bulgaria. Burkina Faso. Burundi. Cambodia. Cameroon. Canada. Cape Verde. Cayman Islands. Central African Republic. Chad. Chile. China. Christmas Island. Cocos (Keeling) Islands. Colombia. Comoros. Congo. Congo, The Democratic Republic of the. Cook Islands. Costa Rica. Cote d'Ivoire. Croatia. Cuba. Cyprus. Czech Republic. Denmark. Djibouti. Dominica. Dominican Republic. No longer in use. Ecuador. Egypt. El Salvador. Equatorial Guinea. Eritrea. Estonia. Ethiopia. Falkland Islands (Malvinas). Faroe Islands. Fiji. Finland. France. French Guiana. French Polynesia. Includes Tahiti. French Southern Territories. Gabon. Gambia. Georgia. Germany. Ghana. Gibraltar. Greece. Greenland. Grenada. Guadeloupe. Guam. Guatemala. Guinea. Guinea-Bissau. Guyana. Haiti. Heard Island and McDonald Islands. Holy See (Vatican City state). Honduras. Hong Kong. Hungary. Iceland. India. Indonesia. Islamic Republic of Iran. Iraq. Ireland. Israel. Italy. Jamaica. Japan. Jordan. Kazakhstan. Kenya. Kiribati. Democratic People's Republic of Korea. Republic of Korea. Kuwait. Kyrgyzstan. Lao People's Democratic Republic. Latvia. Lebanon. Lesotho. Liberia. Libyan Arab Jamahiriya. Liechtenstein. Lithuania. Luxembourg. Macao. The Former Yugoslav Republic of Macedonia. Madagascar. Malawi. Malaysia. Maldives. Mali. Malta. Marshall Islands. Martinique. Mauritania. Mauritius. Mayotte. Mexico. Federated States of Micronesia. Republic of Moldova. Monaco. Mongolia. Montserrat. Morocco. Mozambique. Myanmar. Namibia. Nauru. Nepal. Netherlands. Netherlands Antilles. New Caledonia. New Zealand. Nicaragua. Niger. Nigeria. Niue. Norfolk Island. Northern Mariana Islands. Norway. Oman. Pakistan. Palau. Palestinian territory, Occupied. Panama. Papua New Guinea. Paraguay. Peru. Philippines. Pitcairn. Poland. Portugal. Puerto Rico. Qatar. Reunion. Romania. Russian Federation. Rwanda. Saint Helena. Saint Kitts and Nevis. Saint Lucia. Saint Pierre and Miquelon. Saint Vincent and the Grenadines. Samoa. San Marino. Sao Tome and Principe. Saudi Arabia. Senegal. Seychelles. Sierra Leone. Singapore. Slovakia. Slovenia. Solomon Islands. Somalia. South Africa. South Georgia and the South Sandwich Islands. Spain. Sri Lanka. Sudan. Suriname. Svalbard and Jan Mayen. Swaziland. Sweden. Switzerland. Syrian Arab Republic. Taiwan, Province of China. Tajikistan. Tanzania, United Republic of. Thailand. Togo. Tokelau. Tonga. Trinidad and Tobago. Tunisia. Turkey. Turkmenistan. Turks and Caicos Islands. Tuvalu. Uganda. Ukraine. United Arab Emirates. United Kingdom. United States. NOTE: United States Minor Outlying Islands was defined in the eBay list previously but is no longer a viable option. This country will remain on eBay country list for backward compatibility. Use 'US' instead. Uruguay. Uzbekistan. Vanuatu. Venezuela. Vietnam. Virgin Islands, British. Virgin Islands, U.S. Wallis and Futuna. Western Sahara. Yemen. No longer in use. See RS for Serbia and ME for Montenegro. Zambia. Zimbabwe. NOTE: APO/FPO was defined in eBay list previously but they are not defined in ISO 3166. This country will remain on eBay country code list for backward compatibility. NOTE : Guernsey was defined in eBay list previously but they are not defined in ISO 3166. This country will remain on eBay country list for backward compatibility. NOTE: Jan Mayen was defined in eBay list previously but they are not defined in ISO 3166. This country will remain on eBay country list for backward compatibility. NOTE: Jersey was defined in eBay list previously but they are not defined in ISO 3166. This country will remain on eBay country list for backward compatibility. Jersey Guernsey Unknown country Serbia Montenegro. (out) Reserved for internal or future use This type is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This enumeration type contains a list of standard 3-digit ISO 4217 currency codes for currency used in countries around the world. When adding an item through AddItem (or related API call), the Item.Currency value will default to the currency used on the listing site. Otherwise, only the following currency types may be specified through an Add/Revise/Relist call, since these are the currencies of all the countries where the Trading API is supported: <ul> <li>USD - US Dollar</li> <li>CAD - Canadian Dollar</li> <li>GBP - British Pound</li> <li>AUD - Australian Dollar</li> <li>EUR - Euro</li> <li>CHF - Swiss Franc</li> <li>CNY - Chinese Renminbi</li> <li>HKD - Hong Kong Dollar</li> <li>PHP - Philippines Peso</li> <li>PLN - Polish Zloty</li> <li>SEK - Sweden Krona</li> <li>SGD - Singapore Dollar</li> <li>TWD - Taiwanese Dollar</li> <li>MYR - Malaysian Ringgit</li> </ul> Other currency codes in this enumerated type may be returned in GetItem (and other calls) based on the buyer's and/or seller's registration country. However, only the values listed above will be returned if you call GeteBayDetails with DetailName set to CurrencyDetails. http://www.xe.com/iso4217.htm This value is a 3-digit code for an Afghan afghani, a currency used in Afghanistan. This value is a 3-digit code for an Albanian lek, a currency used in Albania. This value is a 3-digit code for an Algerian dinar, a currency used in Algeria. This value is a 3-digit code for an Andorran peseta, a currency used in Andorra. This value is a 3-digit code for an Angolan kwanza, a currency used in Angola. This value is a 3-digit code for an Argentine peso, a currency used in Argentina. This value is a 3-digit code for an Armenian dram, a currency used in Armenia. This value is a 3-digit code for an Aruban florin, a currency used in Aruba. This value is a 3-digit code for an Azerbaijani manat, a currency used in Azerbaijan. This value is a 3-digit code for a Bahamian dollar, a currency used in the Bahamas. This value is a 3-digit code for a Bahraini dinar, a currency used in the Bahrain. This value is a 3-digit code for a Bangladeshi taka, a currency used in Bangladesh. This value is a 3-digit code for a Barbados dollar, a currency used in Barbados. This value is a 3-digit code for a Belarusian ruble, a currency used in Belarus. This value is a 3-digit code for a Belize dollar, a currency used in Belize. This value is a 3-digit code for a Bermudian dollar, a currency used in Bermuda. This value is a 3-digit code for a Bhutanese ngultrum, a currency used in Bhutan. This value is a 3-digit code for an Indian rupee, a currency used in India. This value is a 3-digit code for a Bolivian Mvdol, a currency used in Bolivia. This value is a 3-digit code for a Boliviano, a currency used in Bolivia. This value is a 3-digit code for a Bosnia and Herzegovina convertible mark, a currency used in Bosnia and Herzegovina. This value is a 3-digit code for a Botswana pula, a currency used in Botswana. This value is a 3-digit code for a Brazilian real, a currency used in Brazil. This value is a 3-digit code for a Brunei dollar, a currency used in Brunei and Singapore. This value is a 3-digit code for the old Bulgarian lev, a currency previously used in Bulgaria. This currency has been replaced by the new Bulgarian lev (3-digit code: BGN). This value is a 3-digit code for a Bulgarian lev, a currency used in Bulgaria. This currency replaced the old Bulgarian lev (3-digit code: BGL). This value is a 3-digit code for a Burundian franc, a currency used in Burundi. This value is a 3-digit code for a Cambodian riel, a currency used in Cambodia. This value is a 3-digit code for a Canadian dollar, a currency used in Canada. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Canada site (Site ID 2). This value is a 3-digit code for a Cape Verde escudo, a currency used in Cape Verde. This value is a 3-digit code for a Cayman Islands dollar, a currency used in the Cayman Islands. This value is a 3-digit code for a Central African CFA franc, a currency used in Cameroon, Central African Republic, Republic of the Congo, Chad, Equatorial Guinea, and Gabon. This value is a 3-digit code for a Unidad de Fomento, a currency used in Chile. This value is a 3-digit code for a Chilean peso, a currency used in Chile. This value is a 3-digit code for a Chinese yuan (also known as the renminbi), a currency used in China. This value is a 3-digit code for a Columbian peso, a currency used in Columbia. This value is a 3-digit code for a Comoro franc, a currency used in Comoros. This value is a 3-digit code for a Congolese franc, a currency used in Democratic Republic of Congo. This value is a 3-digit code for a Costa Rican colon, a currency used in Costa Rica. This value is a 3-digit code for a Croatian kuna, a currency used in Croatia. This value is a 3-digit code for a Cuban peso, a currency used in Cuba. This value is a 3-digit code for a Cypriot pound, a currency previously used in Cyprus. This currency has been replaced by the Euro (3-digit code: EUR). This value is a 3-digit code for a Czech koruna, a currency used in the Czech Republic. This value is a 3-digit code for a Danish krone, a currency used in Denmark, the Faroe Islands, and Greenland. This value is a 3-digit code for a Djiboutian franc, a currency used in Djibouti. This value is a 3-digit code for a Dominican peso, a currency used in the Dominican Republic. This value is a 3-digit code for a Portuguese Timorese escudo, a currency previously used in Portuguese Timor. This value is an old 3-digit code for a Cape Verde escudo, a currency used in Cape Verde. The 'ECV' code has been replaced by 'CVE'. This value is a 3-digit code for an Ecuadorian sucre, a currency previously used in Ecuador. This currency has been replaced by the US Dollar (3-digit code: USD). This value is a 3-digit code for an Egyptian pound, a currency used in Egypt. This value is a 3-digit code for a Salvadoran colon, a currency previously used in El Salvador. This currency has been replaced by the US Dollar (3-digit code: USD). This value is a 3-digit code for an Eritrean nakfa, a currency used in Eritrea. This value is a 3-digit code for an Estonian kroon, a currency previously used in Estonia. This currency has been replaced by the Euro (3-digit code: EUR). This value is a 3-digit code for an Ethiopian birr, a currency used in Ethiopia. This value is a 3-digit code for a Falkland Islands pound, a currency used in the Falkland Islands. This value is a 3-digit code for a Fiji dollar, a currency used in Fiji. This value is a 3-digit code for a Gambian dalasi, a currency used in Gambia. This value is a 3-digit code for a Georgian Iari, a currency used in the country of Georgia. This value is an old 3-digit code for a Ghanaian cedi, a currency used in Ghana. The 'GHC' code has been replaced by 'GHS'. This value is a 3-digit code for a Gibraltar pound, a currency used in Gibraltar. This value is a 3-digit code for a Guatemalan quetzal, a currency used in Guatemala. This value is a 3-digit code for a Guinean franc, a currency used in Guinea. This value is a 3-digit code for a Guinea-Bissau peso, a currency previously used in Guinea-Bissau. This currency has been replaced by the West African CFA franc (3-digit code: XOF). This value is a 3-digit code for a Guyanese dollar, a currency used in Guyana. This value is a 3-digit code for a Haitian gourde, a currency used in Haiti. This value is a 3-digit code for a Honduran lempira, a currency used in Honduras. This value is a 3-digit code for a Hong Kong dollar, a currency used in Hong Kong and Macau. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Hong Kong site (Site ID 201). This value is a 3-digit code for a Hungarian forint, a currency used in Hungary. This value is a 3-digit code for an Icelandic krona, a currency used in Iceland. This value is a 3-digit code for an Indonesian rupiah, a currency used in Indonesia. This value is a 3-digit code for an Iranian rial, a currency used in Iran. This value is a 3-digit code for an Iraqi dinar, a currency used in Iraq. This value is a 3-digit code for an Israeli new shekel, a currency used in Israel and in the Palestinian territories. This value is a 3-digit code for a Jamaican dollar, a currency used in Jamaica. This value is a 3-digit code for a Japanese yen, a currency used in Japan. This value is a 3-digit code for a Jordanian dinar, a currency used in Jordan. This value is a 3-digit code for a Kazahhstani tenge, a currency used in Kazakhstan. This value is a 3-digit code for a Kenyan shilling, a currency used in Kenya. This value is a 3-digit code for an Australia dollar, a currency used in Australia. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Australia site (Site ID 15). This value is a 3-digit code for a North Korean won, a currency used in North Korea. This value is a 3-digit code for a South Korean won, a currency used in South Korea. This value is a 3-digit code for a Kuwaiti dollar, a currency used in Kuwait. This value is a 3-digit code for a Kyrgzstani som, a currency used in Kyrgystan. This value is a 3-digit code for a Lao kip, a currency used in Laos. This value is a 3-digit code for a Latvian lats, a currency used in Latvia. This value is a 3-digit code for a Lebanese pound, a currency used in Lebanon. This value is a 3-digit code for a Lesotho loti, a currency used in Lesotho. This value is a 3-digit code for a Liberian dollar, a currency used in Liberia. This value is a 3-digit code for a Libyan dinar, a currency used in Libya. Swiss Franc. For eBay, you can only specify this currency for listings you submit to the Switzerland site (site ID 193). This value is a 3-digit code for a Lithuanian litas, a currency used in Lithuania. This value is a 3-digit code for a Macanese pataca, a currency used in Macao. This value is a 3-digit code for a Macedonian denar, a currency used in Macedonia. This value is a 3-digit code for a Malagay franc, a currency previously used in Madagascar. This currency has been replaced by the Malagasy ariary (3-digit code: MGA). This value is a 3-digit code for a Malawian kwacha, a currency used in Malawi. This value is a 3-digit code for a Malaysian Ringgit, a currency used in Malaysia. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Malaysia site (Site ID 207). This value is a 3-digit code for a Maldivian rufiyaaa, a currency used in the Maldives. This value is a 3-digit code for a Maltese lira, a currency previously used in Malta. This currency has been replaced by the Euro (3-digit code: EUR). This value is a 3-digit code for a EURO, a currency used in Andorra, Austria, Belgium, Cyprus, Estonia, Finland, France, Germany, Greece, Ireland, Italy, Kosovo, Luxembourg, Malta, Monaco, Montenegro, Netherlands, Portugal, San Marino, Slovakia, Slovenia, Spain, and Vatican City. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the following sites: Austria (Site ID 16), Belgium_French (Site ID 23), France (Site ID 71), Germany (Site ID 77), Italy (Site ID 101), Belgium_Dutch (Site ID 123), Netherlands (Site ID 146), Spain (Site ID 186), and Ireland (Site ID 205). This value is a 3-digit code for a Mauritanian ouguiya, a currency used in Mauritania. This value is a 3-digit code for a Mauritian rupee, a currency used in Mauritius. This value is a 3-digit code for a Mexican peso, a currency used in Mexico. This value is a 3-digit funds code for a Mexican peso, a currency used in Mexico. This value is a 3-digit code for a Moldovan leu, a currency used in Moldova. This value is a 3-digit code for a Mongolian tugrik, a currency used in Mongolia. This value is a 3-digit code for an Easy Caribbean dollar, a currency used in Anguilla, Antigua and Barbuda, Dominica, Grenada, Montserrat, Saint Kitts and Nevis, Saint Lucia, and Saint Vincent and the Grenadines. This value is an old 3-digit code for a Mozambican metical, a currency used in Mozambique. The 'MZM' code has been replaced by 'MZN'. This value is a 3-digit code for a Myanma kyat, a currency used in Myanmar. This value is a 3-digit code for a South African rand, a currency used in South Africa. This value is a 3-digit code for a Namibian dollar, a currency used in Namibia. This value is a 3-digit code for a Nepalese rupee, a currency used in Nepal. This value is a 3-digit code for a Netherlands Antillean guilder, a currency used in Curacao and Sint Maarten. This value is a 3-digit code for a CFP franc, a currency used in French Polynesia, New Caledonia, and Wallis and Futuna. This value is a 3-digit code for a New Zealand dollar, a currency used in the Cook Islands, New Zealand, Niue, Pitcairn, and Tokelau, Ross Dependency. This value is a 3-digit code for a Nicaraguan cordoba, a currency used in Nicaragua. This value is a 3-digit code for a Nigerian naira, a currency used in Nigeria. This value is a 3-digit code for a Norwegian kron, a currency used in Norway, Svalbard, Jan Mayen, Bouvet Island, Queen Maud Land, and Peter I Island. This value is a 3-digit code for an Omani rial, a currency used in Oman. This value is a 3-digit code for a Pakistani rupee, a currency used in Pakistan. This value is a 3-digit code for a Panamanian balboa, a currency used in Panama. This value is a 3-digit code for a Papua New Guinea kina, a currency used in Papua New Guinea. This value is a 3-digit code for a Paraguayan guarani, a currency used in Paraguay. This value is a 3-digit code for a Peruvian nuevo sol, a currency used in Peru. This value is a 3-digit code for a Philippine peso, a currency used in the Philippines. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Philippines site (Site ID 211). This value is a 3-digit code for a Polish zloty, a currency used in Poland. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Poland site (Site ID 212). This value is a 3-digit code for a US dollar, a currency used in the United States, America Samoa, Barbados, Bermuda, British Indian Ocean Territory, British Virgin Islands, Caribbean Netherlands, Ecuador, El Salvador, Guam, Haiti, Marshall Islands, Federated States of Micronesia, Northern Mariana Islands, Palau, Panama, Puerto Rico, Timor-Leste, Turks and Caicos Islands, US Virgin Islands, and Zimbabwe. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay US or US eBay Motors site (Site ID 0). This value is a 3-digit code for a Qatari riyal, a currency used in Qatar. This value is a 3-digit code for the old Romanian leu, a currency previously used in Romania. This currency has been replaced by the Romanian new leu (3-digit code: RON). This value is a 3-digit code for a Russian rouble, a currency used in Russia, Abkhazia, and South Ossetia. This value replace the old 3-digit code for the Russian rouble, 'RUR'. This value is the old 3-digit code for a Russian rouble, a currency used in Russia. This value was replaced by the new 3-digit code for the Russian rouble, 'RUB'. This value is a 3-digit code for a Rwandan franc, a currency used in Rwanda. This value is a 3-digit code for a Saint Helena pound, a currency used in Saint Helena. This value is a 3-digit code for a Samoan tala, a currency used in Samoa. This value is a 3-digit code for a Sao Tome and Principe dobra, a currency used in Sao Tome and Principe. This value is a 3-digit code for a Saudi riyal, a currency used in Saudi Arabia. This value is a 3-digit code for a Seychelles rupee, a currency used in Seychelles. This value is a 3-digit code for a Sierra Leonean leone, a currency used in Sierra Leone. This value is a 3-digit code for a Singapore dollar, a currency used in Singapore and Brunei. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Singapore site (Site ID 216). This value is a 3-digit code for a Slovak koruna, a currency previously used in Slovakia. This currency has been replaced by the Euro (3-digit code: EUR). This value is a 3-digit code for a Slovenian tolar, a currency previously used in Slovenia. This currency has been replaced by the Euro (3-digit code: EUR). This value is a 3-digit code for a Solomon Islands dollar, a currency used in the Solomon Islands. This value is a 3-digit code for a Somali shilling, a currency used in Somalia. This value is a 3-digit code for a Sri Lankan rupee, a currency used in Sri Lanka. This value is the 3-digit code for a Sudanese dinar, a currency previously used in Sudan. The Sudanese dinar was replaced by the Sudanese pound, which has a 3-digit code of 'SDG'. This value is the 3-digit code for a Suriname guilder, a currency previously used in Suriname. The Surinam guilder was replaced by the Surinamese dollar, which has a 3-digit code of 'SRD'. This value is a 3-digit code for a Swazi lilangeni, a currency used in Swaziland. This value is a 3-digit code for a Swedish krona, a currency used in Swedn. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Sweden site (Site ID 218). This value is a 3-digit code for a Syrian pound, a currency used in Syria. This value is a 3-digit code for the New Taiwan dollar, a currency used in Taiwan. This value is a 3-digit code for a Tajikistani somoni, a currency used in Tajikistan. This value is a 3-digit code for a Tanzanian shilling, a currency used in Tanzania. This value is a 3-digit code for a Thai baht, a currency used in Thailand. This value is a 3-digit code for a West African CFA franc, a currency used in Benin, Burkina Faso, Cote d'Ivoire, Guinea-Bissau, Mali, Niger, Senegal, and Togo. This value is a 3-digit code for a Tongan pa'anga, a currency used in Tonga. This value is a 3-digit code for a Trinidad and Tobago dollar, a currency used in Trinidad and Tobago. This value is a 3-digit code for a Tunisian dinar, a currency used in Tunisia. This value is the old 3-digit code for a Turkish lira, a currency used in Turkey and Northern Cyprus. This value was replaced by the new 3-digit code for the Turkish lira, 'TRY'. This value is the old 3-digit code for a Turkmenistani manat, a currency used in Turkmenistan. This value was replaced by the new 3-digit code for the Turkmenistani manat, 'TMT'. This value is a 3-digit code for a Ugandan shilling, a currency used in Uganda. This value is a 3-digit code for a Ukrainian hryvnia, a currency used in the Ukraine. This value is a 3-digit code for an United Arab Emirates dirham, a currency used in the United Arab Emirates. This value is a 3-digit code for a Pound sterling, a currency used in the United Kingdom and British Crown dependencies. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay UK site (Site ID 3). This value is a 3-digit code for a same-day transaction involving US dollars. This value is a 3-digit code for a next-day transaction involving US dollars. This value is a 3-digit code for a Uruguayan peso, a currency used in Uruguay. This value is a 3-digit code for a Uzbekistan som, a currency used in the Uzbekistan. This value is a 3-digit code for a Vanuatu vatu, a currency used in Vanuatu. This value is a 3-digit code for a Venezuelan bolivar, a currency previously used in Venezuela. The Venezuela bolivar was replaced by the Venezuelan bolivar fuerte, which has a 3-digit code of 'VEF'. This value is a 3-digit code for a Vietnamese dong, a currency used in Vietnam. This value is a 3-digit code for a Moroccan dirham, a currency used in Morocco. This value is a 3-digit code for a Yemeni rial, a currency used in Yemen. This value is a 3-digit code for a Yugoslav dinar, a currency previously used in Yugoslavia. The Yugoslav dinar was replaced by the Serbian dinar, which has a 3- digit code of 'RSD'. This value is the old 3-digit code for a Zambian kwacha, a currency used in Zambia. The 'ZMK' code has been replaced by 'ZMW'. This value is the old 3-digit code for a Zimbabwean dollar, a currency previously used in Zimbabwe. The US dollar replaced the Zimbabwean dollar as the official currency in Zimbabwe. This value is a 3-digit code for an Austrian schilling, a currency previously used in Austria. This currency has been replaced by the Euro (3-digit code: EUR). Reserved for internal or future use. This type is used by the CustomPolicies container, which specifies custom policy IDs. A custom policy ID refers to the relevant policy created for product compliance and other purposes. For more information, see the Custom Policies page for your site (for example, <a href="https://www.ebay.fr/help/selling/custom-policies/custom-policies?id=5311" target="_blank">https://www.ebay.fr/help/selling/custom-policies/custom-policies?id=5311</a>). To create and manage custom policies, use the <a href="https://developer.ebay.com/api-docs/sell/account/resources/methods#h2-custom_policy" target="_blank">custom_policy</a> resource of the Account API. This field is used if the seller wants to apply a take-back policy to the listing. The seller will specify the identifier of the take-back policy in this field. The law in some countries may require sellers to take back a used product when the buyer buys a new product. Use this field to specify one take-back policy ID for the listing. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No This field is used if the seller wants to apply one or more product compliance policies to the listing. A separate ProductCompliancePolicyID field is required for each policy to be applied, and the seller specifies the identifier of each policy in this field. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No Specifies the range of days the seller can be contacted. Seller does not want to be contacted. Contact hours will not be supported for any days. If contact hours are specified, they will be ignored. Seller can be contacted any day during the specified contact hours. Seller can be contacted Monday through Friday during the specified contact hours. Seller can be contacted Saturday or Sunday during the specified contact hours. (out) Reserved for internal or future use. This type is used by the DeliveryDetails container that is returned by GetOrders and other order management calls. The DeliveryDetails container is only applicable and returned if the buyer purchased a digital gift card, and is either keeping the gift card or giving that gift card to another person. This container consists of the name and email of the person who is receiving the digital gift card. If the buyer has purchased the gift card for themselves, the buyer's name and email will appear in this container. If the buyer is giving the gift card to another individual, that individual's name and email will appear in this container. This container is always returned for a digital gift card line item. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this container will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, real data is only returned to the buyer or seller, and dummy/masked data will be returned to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container consists of the name and email of the person who purchased the digital gift card. This container is only returned if the purchaser of the digital gift card is giving the gift card to someone else, and that individual's name and email will appear in the Recipient container. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this container will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, real data is only returned to the buyer or seller, and dummy/masked data will be returned to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This type is used by the DeliveryStatus container, which will list the current status of whatever delivery method is being used (indicated in the DigitalDeliverySelected.DeliveryMethod field). Currently, the only supported delivery method is by email. This value indicates the current delivery status for the digital gift card that is being delivered by email. Currently, the only supported delivery status value is 'Notified', which indicates that the link to download the digital gift card has been sent to the recipient by email. DeliveryStatusEmailCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This enumerated type is a list of applicable values that indicate how a motor vehicle deposit should be paid. FastDeposit This value indicates that no deposit is required. This value indicates that a deposit is required from the buyer when purchasing a motor vehicle. Deposits for a motor vehicle are either due in 24, 48, or 72 hours after commitment to purchase. Or, in the case of a motor vehicle listing that is requiring immediate payment, the deposit it due immediately after commitment to purchase. This value should be used in an Add/Revise call if the seller is requiring a deposit for a motor vehicle listing. (out) No longer used. (out) Reserved for internal or future use Enumerated type containing the list of values that can be used when revising the item description of an active listing through the Revise API calls. Use this value in the Item.DescriptionReviseMode field if you want to completely replace (overwrite) the item description of the active listing. Use this value in the Item.DescriptionReviseMode field if you want to prepend text to the item description of the active listing. Use this value in the Item.DescriptionReviseMode field if you want to append text to the item description of the active listing. This value is reserved for internal or future use. This type is used by the DigitalDeliverySelected container that is returned by GetOrders and other order management calls. The DigitalDeliverySelected container is only applicable and returned if the buyer purchased a digital gift card for themselves, or is giving the digital gift card to someone else as a gift. This value indicates the method in which the digital gift card will be delivered to the buyer or to the person whom the purchaser is giving the digital gift card to. Currently, the only supported delivery method is by email. DeliveryMethodCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container consists of the current status of whatever delivery method is being used (indicated in the DigitalDeliverySelected.DeliveryMethod field). Currently, the only supported delivery method is by email. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This container is returned by GetOrders and other order management calls to provide details on the recipient of a digital gift card that was purchased. The DeliveryDetails container is only returned if the buyer is buying a digital gift card and giving that gift card to another person. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This type is used to provide the name and email of both the purchaser of a digital gift card, and the recipient of the digital gift card. This field displays the actual name (not the eBay user ID) of the sender/purchaser of the digital gift card (applicable for the Sender container) or the actual name of the recipient of the digital gift card (applicable for the Recipient container). Both the sender and recipient name is provided by the purchaser of the digital gift card at time of purchase. For GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, real data is only returned to the buyer or seller, and a string value of <code>Unavailable</code> will be returned to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This field displays the email address of the sender/purchaser of the digital gift card (applicable for the Sender container) or the email address of the recipient of the digital gift card (applicable for the Recipient container). Both the sender and recipient email address is provided by the purchaser of the digital gift card at time of purchase. For GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, real data is only returned to the buyer or seller, and a string value of <code>Unavailable</code> will be returned to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This type is used by the DigitalGoodInfo container, which is used in Add/Relist/Revise/Verify listing calls to designate the listing as a digital gift card listing. This field must be included in the request and set to <code>true</code> if the seller plans to list a digital gift card in a category that supports digital gift cards. To verify if a specific category on a specific eBay site supports digital gift card listings, use the <a href="https://developer.ebay.com/DevZone/XML/docs/Reference/eBay/GetCategoryFeatures.html">GetCategoryFeatures</a> call, passing in a CategoryID value and a DigitalGoodDeliveryEnabled value in the FeatureID field. Look for a <code>true</code> value in the DigitalGoodDeliveryEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem Conditionally This enumeration type lists the possible states of a purchased digital delivery card. This enumeration value indicates that the digital gift card has yet to be activated by the buyer or recipient of gift card. This enumeration value indicates that the digital gift card has been activated by the buyer or recipient of gift card. This enumeration value indicates that the digital gift card has been downloaded by the buyer or recipient of gift card. The next step would be to activate the gift card. This enumeration value indicates that the digital gift card has been deactivated. This value is reserved for internal or future use. This enumerated type is used by the seller to set the shipping discount type. Some of these shipping discount types apply to flat-rate shipping and others apply to calculated shipping. The cost to ship each item beyond the first item (where the item with the highest shipping cost is selected by eBay as the first item). Let's say the buyer purchases three items, each set to ship for $8, and the seller set EachAdditionalAmount to $6. The cost to ship three items would normally be $24, but since the seller specified $6, the total shipping cost would be $8 + $6 + $6, or $20. For flat shipping discount profile only. The amount by which to reduce the cost to ship each item beyond the first item (where the item with the highest shipping cost is selected by eBay as the first item). Let's say the buyer purchases three items, each set to ship for $8, and the seller set EachAdditionalAmountOff to $2. The cost to ship three items would normally be $24, but since the seller specified $2, the total shipping cost would be $24 - (two additional items x $2), or $20. For flat shipping discount profile only. The percentage by which to reduce the cost to ship each item beyond the first item (where the item with the highest shipping cost is selected by eBay as the first item). Let's say the buyer purchases three items, each set to ship for $8, and the seller set EachAdditionalPercentOff to 0.25. The cost to ship three items would normally be $24, but since the seller specified 0.25 ($2 out of 8), the total shipping cost would be $24 - (two additional items x $2), or $20. For flat rate shipping discount profile only. Shipping cost is the total of what it would cost to ship each item individually. This is simply a way to define how shipping is to be calculated--there is no discount for the buyer with this selection. For calculated shipping discount profile only. Shipping cost is based on the total weight of all individual items. This is simply a way to define how shipping is to be calculated--there is no discount for the buyer with this selection. For calculated shipping discount profile only. The amount of weight to subtract for each item beyond the first item before shipping costs are calculated. For example, there may be less packing material when the items are combined in one box than if they were shipped individually. Let's say the buyer purchases three items, each 10 oz. in weight, and the seller set WeightOff to 2 oz. The combined weight would be 30 oz., but since the seller specified 2 oz. off, the total weight for shipping cost calculation would be 30 oz. - (two additional items x 2 oz.), or 26 oz. For calculated shipping discount profile only. Shipping cost X applies if the total cost of items purchased is Y. For promotional discount only. Shipping cost X applies if the total number of items purchased is N. For promotional discount only. The shipping cost will not exceed this. For promotional discount only. Reserved for internal or future use. Using this container, a seller can supply original retail price and discount price for an item to clarify the discount treatment (also known as strike-through pricing). This only applies to fixed-price listings and auction listings with the Buy It Now option. This feature is available for large enterprise sellers via white list. A seller can provide discount treatment regardless of whether the listing includes a SKU. The actual retail price set by the manufacturer (OEM). eBay does not maintain or validate the OriginalRetailPrice supplied by the seller. OriginalRetailPrice should always be more than StartPrice. Compare the StartPrice/BuyItNowPrice to OriginalRetailPrice to determine the amount of savings to the buyer. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem ReviseItem RelistItem VerifyAddItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Minimum Advertised Price (MAP) is an agreement between suppliers (or manufacturers (OEM)) and the retailers (sellers) stipulating the lowest price an item is allowed to be advertised at. Sellers can offer prices below MAP by means of other discounts. This only applies to fixed-price listings and auction listings with the Buy It Now option. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem ReviseItem RelistItem VerifyAddItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally For MinimumAdvertisedPrice (MAP) listings only. A seller cannot show the actual discounted price on eBay's View Item page. Instead, the buyer can either click on a pop-up on eBay's View Item page, or the discount price will be shown during checkout. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem ReviseItem RelistItem VerifyAddItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Based on OriginalRetailPrice, MinimumAdvertisedPrice, and StartPrice values, eBay identifies whether the listing falls under MAP or STP (aka OriginalRetailPrice). GetItem returns this for items listed with one of these discount pricing treatments. GetSellerList returns the DiscountPriceInfo container. This field is not applicable for Add/Revise/Relist calls. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally false Used by the eBay UK and eBay Germany (DE) sites, this flag indicates that the discount price (specified as StartPrice) is the price for which the seller offered the same (or similar) item for sale on eBay within the previous 30 days. The discount price is always in reference to the seller's own price for the item. If this field is set to <code>true</code>, eBay displays 'Was' in the UK and 'Ursprunglich' in Germany, next to the discounted price of the item. In the event both SoldOffeBay and SoldOneBay fields are set to <code>true</code>, SoldOneBay takes precedence. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem ReviseItem RelistItem VerifyAddItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally false Used by the eBay UK and eBay Germany (DE) sites, this flag indicates that the discount price (specified as StartPrice) is the price for which the seller offered the same (or similar) item for sale on a Web site or offline store other than eBay in the previous 30 days. The discount price is always in reference to the seller's own price for the item. If this field is set to <code>true</code>, eBay displays 'Was*' in the UK and 'Ursprunglich*' in Germany, next to the discounted price of the item. In the event both SoldOffeBay and SoldOneBay fields are set to <code>true</code>, SoldOneBay takes precedence. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem ReviseItem RelistItem VerifyAddItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally false Applicable only if the item was specifically made for sale through dedicated eBay outlet pages (e.g., eBay Fashion Outlet). The comparison price is the price of a comparable product sold through non-outlet channels on eBay (or elsewhere), or not specifically made for the outlet. In fashion, a "comparable" product shares the same design, but is not considered an identical product. Some products are specifically made for outlets, and may have a different SKU than the "comparable" product. These made-for-outlet products may be manufactured in a different place, with different materials, or according to different specifications (i.e. different stitch pattern, seam reinforcement, button quality, etc.) AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem ReviseItem RelistItem VerifyAddItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Details of a flat or calculated shipping discount rule. Shipping Discount Rules can be set up through the SetShippingDiscountProfiles call or through My eBay. The unique eBay-created unique identifier for the shipping discount, assigned when the shipping discount rule is created. In a SetShippingDiscountProfiles call, <ul> <li>If the value of ModifyActionCode is set to <code>Add</code>, this field is not applicable and is ignored <li>If provided.</li> <li>If the value of Mod <li>IfyActionCode is set to <code>Update</code>, all fields of the modified rule must be provided, even if the values are not changing.</li> <li>If the value of ModifyActionCode is set to <code>Delete</code>, either the DiscountProfileID value or is DiscountProfileName value is required, the MappingDiscountProfileID is optional, and all other fields of the DiscountProfile container are ignored.</li> </ul> GetShippingDiscountProfiles Always SetShippingDiscountProfiles Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The seller-provided title for the shipping discount rule. In a SetShippingDiscountProfiles call, <ul> <li>If the value of ModifyActionCode is set to <code>Add</code>, this field is ignored (if provided) if this is the first shipping discount rule being created, but this field is required if there is more than one existing shipping discount rule of that type (flat rate or calculated)</li> <li>If the value of ModifyActionCode is set to <code>Update</code>, all fields of the modified rule must be provided, even if the values are not changing</li> <li>If the value of ModifyActionCode is set to <code>Delete</code>, the DiscountProfileID is required, the MappingDiscountProfileID is optional, and all other fields of the DiscountProfile container are ignored</li> <li>If the value of ModifyActionCode is set to <code>Delete</code>, either the DiscountProfileID value or is DiscountProfileName value is required, the MappingDiscountProfileID is optional, and all other fields of the DiscountProfile container are ignored</li> </ul> GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The cost to ship each item beyond the first item (where the item with the highest shipping cost is selected by eBay as the first item). Let's say the buyer purchases three items, each set to ship for $8, and the seller set the EachAdditionalAmount to $6. The cost to ship three items would normally be $24, but since the seller specified $6, the total shipping cost would be $8 + $6 + $6, or $20. This field is only applicable for flat-rate shipping. GetShippingDiscountProfiles FlatShippingDiscount Conditionally SetShippingDiscountProfiles FlatShippingDiscount Conditionally GetItem FlatShippingDiscount InternationalFlatShippingDiscount

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The amount by which to reduce the cost to ship each item beyond the first item (where the item with the highest shipping cost is selected by eBay as the first item). Let's say the buyer purchases three items, each set to ship for $8, and the seller set EachAdditionalAmountOff to $2. The cost to ship three items would normally be $24, but since the seller specified $2, the total shipping cost would be $24 - (two additional items x $2), or $20. This field is only applicable for flat-rate shipping. GetShippingDiscountProfiles FlatShippingDiscount Conditionally SetShippingDiscountProfiles FlatShippingDiscount Conditionally GetItem FlatShippingDiscount InternationalFlatShippingDiscount

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The percentage by which to reduce the cost to ship each item beyond the first item (where the item with the highest shipping cost is selected by eBay as the first item). Let's say the buyer purchases three items, each set to ship for $8, and the seller set EachAdditionalPercentOff to 0.25. The cost to ship three items would normally be $24, but since the seller specified 0.25 ($2 out of $8), the total shipping cost would be $24 - (two additional items x $2), or $20. This field is only applicable for flat-rate shipping. GetShippingDiscountProfiles FlatShippingDiscount Conditionally SetShippingDiscountProfiles FlatShippingDiscount Conditionally GetItem FlatShippingDiscount InternationalFlatShippingDiscount

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The amount of weight to subtract for each item beyond the first item before shipping costs are calculated. For example, there may be less packing material when the items are combined in one box than if they were shipped individually. Let's say the buyer purchases three items, each 10 oz. in weight, and the seller set WeightOff to 2 oz. The combined weight would be 30 oz., but since the seller specified 2 oz. off, the total weight for shipping cost calculation would be 30 oz. - (two additional items x 2 oz.), or 26 oz. This field is only applicable for calculated shipping. GetShippingDiscountProfiles CalculatedShippingDiscount Conditionally SetShippingDiscountProfiles CalculatedShippingDiscount Conditionally GetItem CalculatedShippingDiscount InternationalCalculatedShippingDiscount

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally For SetShippingDiscountProfiles, if MappedDiscountProfileID is omitted when ModifyActionCode is set to <code>Delete</code>, any listings currently using the profile identified by DiscountProfileID will have that profile removed. GetShippingDiscountProfiles CalculatedShippingDiscount Conditionally SetShippingDiscountProfiles CalculatedShippingDiscount Conditionally GetItem CalculatedShippingDiscount InternationalCalculatedShippingDiscount

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This enumerated type is used in the response of Add/Revise/Relist item calls to indicate if eBay has applied a Special offer or Promotional discount to the order line item. An offer that applies to a limited number of listings during the offering period. Example: "There is no insertion fee for up to 5 auctions when listing between 12/1 and 12/10." An offer that applies to an unlimited number of listings during the offering period. Example: "Get subtitle for $0.10 in Tech category when listing between 12/25 and 12/28. No limit to the number of items listed during this period." Reserved for future use This type is deprecated. This field is deprecated. This field is deprecated. This enumerated type contains a list of eBay subscriptions that an eBay user may be subscribed to. PictureManagerLevel1, PictureManagerLevel2, PictureManagerLevel3, PictureManagerLevel4, PictureManagerLevel5, PictureManagerLevel6, PictureManagerLevel7, SellerAssistant, SellerAssistantPro, SellerReportsBasic This eBay subscription is no longer available. This eBay subscription is no longer available. This value indicates that the user has a Basic eBay Store membership. See the <a href="http://pages.ebay.com/sellerinformation/stores/Subscriptions.html target="_blank">Welcome to eBay Stores</a> help page for more information on eBay Store subscriptions. This value indicates that the user has a Premium eBay Store membership. See the <a href="http://pages.ebay.com/sellerinformation/stores/Subscriptions.html target="_blank">Welcome to eBay Stores</a> help page for more information on eBay Store subscriptions. This value indicates that the user has a Anchor eBay Store membership. See the <a href="http://pages.ebay.com/sellerinformation/stores/Subscriptions.html target="_blank">Welcome to eBay Stores</a> help page for more information on eBay Store subscriptions. This value indicates that the user has a Selling Manager subscription. Selling Manager is free to all sellers and can be subscribed to through the Subscriptions section of My eBay. See the <a href="http://pages.ebay.com/help/sell/selling-manager-subscription.html target="_blank">Selling Manager and Selling Manager Pro</a> help page for more information on Selling Manager. This value indicates that the user has a Selling Manager Pro subscription. Selling Manager Pro is free to all sellers for the first 30 days, and a Selling Manager Pro subscription is included at no charge for eBay Store Premium and Anchor subscriptions. Selling Manager Pro can be subscribed to through the Subscriptions section of My eBay. See the <a href="http://pages.ebay.com/help/sell/selling-manager-subscription.html target="_blank">Selling Manager and Selling Manager Pro</a> help page for more information on Selling Manager Pro. This value is no longer applicable because Picture Manager has been EOLed. This value is no longer applicable because Picture Manager has been EOLed. This value is no longer applicable because Picture Manager has been EOLed. This value is no longer applicable because Picture Manager has been EOLed. This value is no longer applicable because Picture Manager has been EOLed. This value is no longer applicable because Picture Manager has been EOLed. This value is no longer applicable because Picture Manager has been EOLed. Basic Sales Reports are no longer available. Sellers should subsribe to Sales Reports Plus instead. This value indicates that the user has a Sales Reports Plus subscription. A user can subscribe to Sales Report Plus through the Subscriptions section of My eBay. See the <a href="http://pages.ebay.com/help/sell/viewing-sales-reports.html target="_blank">Sales Report Plus</a> help page for more information. This value indicates that the user has a File Exchange subscription. A user can subscribe to File Exchange through the Subscriptions section of My eBay. See the <a href="http://pages.ebay.com/sellerinformation/sellingresources/fileexchange.html target="_blank">File Exchange</a> help page for more information. This value indicates that the Motors Dealer has a Local Market Specialty subscription. This type of account is used to sell in the Motorcycles, Powersports, and Other Vehicles and Trailers categories. Not Cars and Trucks. This value indicates that the Motors Dealer has a Local Market Regular subscription. This type of account is used to sell in all eBay Motors categories. This value indicates that the Motors Dealer has a Local Market Premium subscription. This type of account is used to sell in all eBay Motors categories. This enumeration type is used to indicate whether an application/URL/device is enabled to receive notifications, or to indicate whether a specific notification event is enabled. This enumeration value indicates that an application/URL/device is enabled to receive notifications, or to indicate that a specific notification event is enabled. This enumeration value indicates that an application/URL/device is disabled, or being blocked from receiving notifications, or to indicate that a specific notification event is disabled. Reserved for future use. This type defines the reasons that a seller can end an item listing early. This value is required if the seller ends a listing early. This can be on an item that hasn't sold and has no bids or on an item that has bids and the seller wants to sell the item to the high bidder now. Use this enumeration value in an End listing call if the seller is ending a listing because the item was lost or is broken. Use this enumeration value in an End listing call if the seller is ending a listing because the item is no longer available for sale. Use this enumeration value in an End listing call if the seller is ending a listing because the start price or reserve price is incorrect. Use this enumeration value in an End listing call if the seller is ending a listing because the listing contained an error (other than start price or reserve price). Reserved for internal or future use. Use this enumeration value in an End listing call if the seller is ending a listing because they want to sell an auction item to the current high bidder. A seller can end a listing early in order to sell to the current high bidder when the listing has qualifying bids (i.e., there is a current high bid that, when applicable, meets the minimum reserve price) and there is more than 12 hours before the listing ends. Note: In the last 12 hours of an item listing, you cannot end an item early if it has bids. The vehicle was sold. Applies to local classified listings for vehicles only. For internal use only. This enumeration value cannot be used by the seller in an End listing call, but it will get returned in GetItem if a listing was administratively ended by eBay if the item in a listing becomes unpurchasable due to the eBay Catalog product associated with the listing being removed from the catalog. This type is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This type is used to provide contact hours for a seller of a Classified Ad listing, including motor vehicles. There is also a boolean field in this type that indicates whether or not potential buyer can contact the seller by email. This containers consists of fields that allows the seller of a Classified Ad listing to tell potential buyers what days and times they may be contacted to inquire about the listing. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally A value of <code>true</code> in this field indicates that potential buyers can contact the seller of the Classified Ad listing by email. AddItem AddItems ReviseItem VerifyAddItem RelistItem VerifyRelistItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This field is deprecated. This container returns the URLs of the seller's self-hosted (hosted outside of eBay) pictures and the URL for the corresponding eBay Picture Services (EPS), that was generated when the self-hosted picture was uploaded. This container returns the eBayPictureURL (images hosted by eBay Picture Services) and the ExternalPictureURL (images hosted outside of eBay) fields. GetItem Conditionally This type is used by the ExtendedProducerResponsibility container, which provides IDs for the producer or importer related to the new item, packaging, added documentation, or an eco-participation fee. In some markets, such as in France, this may be the importer of the item. For more information, see the Extended Producer Responsibility for business sellers page for your site (for example, <a href="https://www.ebay.com/help/selling/all-about-selling/selling-internationally/extended-producer-responsibility-for-business-sellers?id=5314" target="_blank">https://www.ebay.com/help/selling/all-about-selling/selling-internationally/extended-producer-responsibility-for-business-sellers?id=5314</a>). This field is supported by a limited number of sites and specific categories. Use the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getExtendedProducerResponsibilityPolicies" target="_blank">getExtendedProducerResponsibilityPolicies</a> method of the Sell Metadata API to retrieve valid categories for a site. For GetItem calls, this container is only returned to the listing owner, if the container is available. This ID is the Unique Identifier of the producer related to the item. For instance, if the seller is selling a cell phone, it is the ID related to the cell phone. 15 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This ID is the Unique Identifier of the producer of any packaging related to the product added by the seller. This does not include packaging in which the product is shipped (see ShipmentPackageID). For instance, if the seller adds bubble wrap, it is the ID related to the bubble wrap. 15 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This ID is the Unique Identifier of the producer of any packaging used by the seller to ship the item. This does not include non-shipping packaging added to the product (see ProductPackageID). This ID is required when the seller uses packaging to ship the item. For instance, if the seller uses a different box to ship the item, it is the ID related to the box. 15 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This ID is the Unique Identifier of the producer of any paper added to the parcel of the item by the seller. For example, this ID concerns any notice, leaflet, or paper that the seller adds to a cell phone parcel. 15 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This is the fee paid for new items to the eco-organization (for example, "eco-organisme" in France). It is a contribution to the financing of the elimination of the item responsibly. For multiple-variation listings, the EcoParticipationFee in the VariationExtendedProducerResponsibility container is used for each variation in the listing, and not the EcoParticipationFee in the ExtendedProducerResponsibility container. 16 0.0 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This type is deprecated. This field is deprecated. This field is deprecated. Container consisting of details related to payment of an eBay order on an external system. This container is only returned if order payment has been made on an external system. For GetSellerTransaactions and GetItemTransactions, this container is not returned for multiple line item orders. Unique identifier for a payment of an eBay order that occurred outside of eBay's system. GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetOrders

DetailLevel: ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally Timestamp for the payment transaction. GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetOrders

DetailLevel: ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally Fee amount is a positive value and credit amount is a negative value. GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetOrders

DetailLevel: ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally If this dollar value is a positive amount, this is the amount that the buyer paid the seller through for purchase of the order. If this dollar value is a negative amount, this is the amount refunded to the buyer. Note: If a refund is due to the buyer, the amount in this field will not include any 'Collect and Remit' tax (mandated US state sales tax or 'Goods and Services' tax in Australia or New Zealand) charged to the buyer for one or more order line items, since this tax is collected by eBay and not by the seller. GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetOrders

DetailLevel: ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally The current processing status of an external payment for an eBay order. GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetOrders

DetailLevel: ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally Indicates whether the seller making the request can list with certain features. A seller's eligibility is determined by their Feedback score. Indicates whether the seller is eligible to create auction listings enabled with the 'Buy It Now' option. A value of <code>true</code> means that the seller is eligible; a value of <code>false</code> indicates that they are not eligible. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Indicates whether the seller is eligible to specify the 'Buy It Now' option for multiple-quantity listings. A value of <code>true</code> means that the seller is eligible; a value of <code>false</code> indicates that they are not eligible. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Indicates whether the seller is eligible to create fixed-price listings with a one-day listing duration. A value of <code>true</code> means that the seller is eligible; a value of <code>false</code> indicates that the seller is not eligible. Note that this field only controls user eligibility. The listing type and category must support this feature for this field to be applicable. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Indicates whether or not the seller is eligible to create multiple-variation, fixed-price listings. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Always Indicates whether the seller is eligible to create an auction listing with a one-day duration. Limitation: the Adult-Only and Motor Vehicle categories do not support one-day auctions, so the seller cannot create one-day auction listings in these categories, even if the seller has the eligibility. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Identifies the name and cost of a listing feature that a member pays to eBay. These listing feature names, fees, and possible discounts are intended only as an aid to help estimate the fees for a listing. This is the name of the listing feature, such as <code>ListingFee</code>, <code>SubtitleFee</code>, or <code>BoldFee</code>. Fees Resulting from Listing an Item https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listing-Fees.html AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseInventoryStatus ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Always Amount of the fee that eBay will charge the member for the associated listing feature. eBay.com Fees http://pages.ebay.com/help/sell/fees.html a current list of listing features and their associated fees. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseInventoryStatus ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Always This field exists in the response when the user has selected a feature that participates in a promotional discount. Note: Verify calls might not return the PromotionalDiscount fee in the response. Standard selling fees http://pages.ebay.com/help/sell/fees.html A current schedule of listing features and their associated fees. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem ReviseInventoryStatus RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Always Type defining the Feedback details for an order line item, including the eBay User ID of the user the feedback is intended for, the Feedback rating, and the Feedback comment. Textual comment that explains, clarifies, or justifies the Feedback rating specified in CommentType. This field is required in CompleteSale if the FeedbackInfo container is used. This comment will still be displayed even if submitted Feedback is withdrawn. 500 CompleteSale Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This value indicates the Feedback rating for the user specified in the TargetUser field. This field is required in CompleteSale if the FeedbackInfo container is used. A Positive rating increases the user's Feedback score, a Negative rating decreases the user's Feedback score, and a Neutral rating does not affect the user's Feedback score. eBay users also have the right to withdraw feedback for whatever reason. Sellers cannot leave Neutral or Negative ratings for buyers. CompleteSale Positive Conditionally GetItemsAwaitingFeedback Conditionally FeedbackReceived GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally This eBay User ID identifies the recipient user for whom the feedback is being left. This field is required in CompleteSale if the FeedbackInfo container is used. CompleteSale No GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The color of a feedback score star visually denotes the range in which the member's summary feedback score falls. The score is the net positive feedback minus the net negative feedback left for the member. No graphic displayed, feedback score 0-9. Yellow Star, feedback score 10-49. Blue Star, feedback score 50-99. Turquoise Star, feedback score 100-499. Purple Star, feedback score 500-999. Red Star, feedback score 1,000-4,999 Green Star, feedback score 5,000-9,999. Yellow Shooting Star, feedback score 10,000-24,999. Turquoise Shooting Star, feedback score 25,000-49,999. Purple Shooting Star, feedback score 50,000-99,999. Red Shooting Star, feedback score 100,000-499,999. Green Shooting Star, feedback score 500,000-999,999. Silver Shooting Star, feedback score 1,000,000 and above. Reserved for internal or future use. Type used to express all fees associated with listing an item. These are the fees that the seller will pay to eBay. A Fee container is returned for each listing fee associated with listing an item. Each Fee container consists of the fee type, the amount of the fee, and any applicable eBay promotional discount on that listing fee. A Fee container is returned for each listing feature, even if the associated cost is 0. AddFixedPriceItem AddItem AddItems AddLiveAuctionItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem ReviseLiveAuctionItem VerifyAddFixedPriceItem VerifyAddItem ReviseInventoryStatus VerifyRelistItem Always Details of an individual discount profile defined by the user for flat-rate shipping. The type of discount or rule that is being used by the profile. The value corresponding to the selected rule is set in the same-named field of FlatShippingDiscount.DiscountProfile. GetShippingDiscountProfiles EachAdditionalAmount, EachAdditionalAmountOff, EachAdditionalPercentOff Conditionally SetShippingDiscountProfiles EachAdditionalAmount, EachAdditionalAmountOff, EachAdditionalPercentOff Conditionally GetItem EachAdditionalAmount, EachAdditionalAmountOff, EachAdditionalPercentOff

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Shipping Cost Discount Profiles https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-OtherFeatures.html#ShippingCostDiscountProfiles Details of this particular flat-rate shipping discount profile. If the value of ModifyActionCode is <code>Modify</code>, all details of the new version of the profile must be provided. If ModifyActionCode is <code>Delete</code>, DiscountProfileID is required, MappingDiscountProfileID is optional, and all other fields of DiscountProfile are ignored. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles EachAdditionalAmount, EachAdditionalAmountOff, EachAdditionalPercentOff Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Shipping Cost Discount Profiles https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-OtherFeatures.html#ShippingCostDiscountProfiles This type is used to provide details about an order line item being fulfilled by eBay or an eBay fulfillment partner. The value returned in this field indicates the party that is handling fulfillment of the order line item. For eBay Vault scenarios, for the GetOrders, GetOrderTransactions, and GetItemTransactions calls, this value is returned as <code>EBAY</code> for either of the following fulfillment options:<ul><li>Vault to Vault</li><li>Vault to Buyer</li></ul> GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The value in this field identifies the warehouse where the order line item is located. For eBay Vault scenarios: GetOrders, GetOrderTransactions, and GetItemTransactions calls, if FulfillmentBy is returned as <code>EBAY</code>, FulfillmentRefId is not returned. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Enumeration type that returns the status of the gallery image generation. That status returns either a value of 'Success' or a value that indicates why the gallery image has not been generated. The Gallery image was successfully generated. The Gallery image has not yet been generated. The URL for the image file is not valid. The URL does not start with <code>http:// </code> or <code>https:// </code>. There is a problem with the image file. The server containing the image file was unavailable. The image file could not be found. The image file failed to transfer. The image file is not in JPG, BMP, GIF, TIF, or PNG format. We were not able to process the image file. Reserved for internal only. Indicates which Gallery image enhancements to apply to the listing. Featured Gallery is supported free on all sites. So this field is useful only for removing an existing feature setting when using RelistItem. Highlights the listing by randomly placing it at the top of the search results. When the Featured First listing upgrade is selected for an item listing, the listing also automatically gets the Gallery and Plus functionality at no extra cost. A user can see if a site supports the Featured First listing upgrade by using the GeteBayDetails call and passing in <code>ListingFeatureDetails</code> in the DetailName field. In the response, the value of the ListingFeatureDetails.FeaturedFirst field will show a value other than <code>Disabled</code> if the eBay site supports the Featured First listing upgrade. Note: The Featured First listing upgrade can no longer be used for new listings or revising existing listings in any eBay marketplace. If this value is used in an Add/Revise/Relist call, sellers will get a warning message about this value/feature being deprecated. This feature, which is free on all sites, adds a Gallery image in the search results. A Gallery image is an image that was uploaded and copied to EPS (eBay Picture Service). This copy is stored for 30 days or until the image is associated with a listing. Once the image is associated with a listing, the period is extended to 90 days after the item's sale_end date and is extended again if the item is relisted or used in subsequent listings. As part of storing a copy, EPS also makes additional sizes available (thumbnail, main image, supersize, popup, etc.), which are used by the various Gallery enhancements. All images must comply to the <a href="https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Pictures-Intro.html">Picture Requirements.</a> Adds a Gallery Plus icon to the listing. When Plus is selected in a request that specifies at least two images (using ItemType.PictureDetailsType.PictureURL), the Gallery Plus feature automatically includes a Gallery Showcase of all the listing's images. The Gallery Showcase displays when hovering over or clicking on the listing's Gallery Plus icon in the search results. The Showcase window displays a large (400px x 400px) preview image which is first image specified PictureURL, as well as up to 11 (64 px x 64 px) selectable thumbnails for the remaining EPS images. Clicking on the preview image displays the item's listing page. If Plus is selected and the request includes only one EPS image or any self-hosted images, the listing includes a Gallery Plus icon that, when hovered over or clicked, displays a large (400px x 400px) preview image of the item. Clicking the image displays the View Item page for that listing. When using RelistItem or ReviseItem (item has no bids and more than 12 hours before the listing's end), Plus can be unselected in the request. However, the Plus fee will still apply if a previous request selected Plus. There is at most one Plus fee per listing. When "Plus" is included in an item listing, the listing also automatically gets the Gallery functionality at no extra cost. "Gallery" does not need to be specified separately in the listing. Listing images that are originally smaller than 400px x 400px are centered in the preview frame. Images that are originally larger than 400px x 400px are scaled down to 400px on their longest side (maintaining their original aspect ratio). Reserved for internal use only. This type is used by the GiftSummary container that is returned in GetOrders and other order management calls if a buyer has purchased a digital gift card but has sent it to another individual as a gift. The GiftSummary container consists of the message that the buyer wrote for the recipient of the digital gift card. This free-form text contains the message that the purchaser of the digital gift card left for the recipient of the gift card. For GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, real data is only returned to the buyer or seller, and a string value of <code>Unavailable</code> will be returned to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Enumerated type that defines the possible states of a buyer's Item Not Received (INR) inquiry. This value indicates that the INR inquiry is invalid. This value indicates that the INR inquiry is not applicable. This value indicates that the INR inquiry is pending a response from the buyer. This value indicates that the INR inquiry is pending a response from the seller. This value indicates that the INR inquiry was closed with a refund issued to the buyer. This value indicates that the INR inquiry was closed with no refund issued to the buyer. This value indicates that the INR inquiry was escalated to an eBay Money Back Guarantee case, and it is pending a response from the buyer. This value indicates that the INR inquiry was escalated to an eBay Money Back Guarantee case, and it is pending a response from the seller. This value indicates that the INR inquiry was escalated to an eBay Money Back Guarantee case, and it is pending a response from eBay Customer Support. This value indicates that the INR inquiry was escalated to an eBay Money Back Guarantee case, but it was closed with a refund issued to the buyer. This value indicates that the INR inquiry was escalated to an eBay Money Back Guarantee case, but it was closed with no refund issued to the buyer. Reserved for internal or future use. This type is no longer applicable as eBay sellers can no longer use iMCC gateway accounts to handle buyer payments, and the SellerInfo.IntegratedMerchantCreditCardInfo container is no longer returned in GetUser response. The SellerInfo.IntegratedMerchantCreditCardInfo container (and this field) are no longer returned in GetUser response, as eBay sellers can no longer use iMCC gateway accounts to handle buyer payments. GetUser Conditionally Container consisting of shipping costs and other details related to an international shipping service. If one or more international shipping services are provided, the seller must specify at least one domestic shipping service as well. An international shipping service being offered by the seller to ship an item to a buyer. For a list of valid values, call GeteBayDetails with DetailName set to ShippingServiceDetails. To view the full list of International shipping service options in the response, look for the ShippingService fields in the ShippingServiceDetails containers that contain a InternationalService = <code>true</code> field, as this indicates that the ShippingService value is an International shipping service option. The ShippingServiceDetails.ValidForSellingFlow flag must also be present. Otherwise, that particular shipping service option is no longer valid and cannot be offered to buyers through a listing. For flat and calculated shipping. ShippingServiceCodeType SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GeteBayDetails https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GeteBayDetails.html The base cost of shipping the item using the shipping service specified in the ShippingService field. In the case of a multiple-quantity, fixed-price listing, the ShippingServiceAdditionalCost field shows the cost to ship each additional item if the buyer purchases multiple quantity of the same line item. When returned by GetItemShipping, it includes the packaging and handling cost. For flat and calculated shipping. If a shipping service has been specified (even LocalPickup), GetItem returns the shipping service cost, even if the cost is zero. Otherwise, cost is not returned. If this is for calculated shipping for a listing that has not yet ended, note that the cost cannot be determined until the listing has ended and the buyer has specified a postal code. For GetItemShipping, promotional shipping savings is reflected in the cost, if applicable. If the promotional shipping option is lower than other shipping services being offered, the savings is reflected in the returned shipping cost. The shipping service named Promotional Shipping Service (or whatever is the localized name for it) is included among the shipping services. If the promotional shipping cost is lower than the cost of other shipping services being offered, it is presented first in the list. (The LOWEST shipping service cost is always presented first, regardless of whether there is promotional shipping.) SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally Specifying Shipping Types and Costs https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-TypesCosts.html The cost of shipping each additional item if the same buyer purchases multiple quantity of the same line item. This field is required when creating a multiple-quantity, fixed-price listing. Generally, the seller will give the buyer a shipping discount if that buyer purchases multiple quantity of the item, so this value should usually be less than the value set for ShippingServiceCost. The value of this field can even be set to <code>0</code> if the seller wants to encourage buyers to buy multiple quantity of the item, or it could be that the seller can fit multiple quantities of the line item in a single shipping package, so the seller is just passing this shipping savings onto the buyer. This field is not applicable for single-quantity listings. SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally This integer value controls the order (relative to other shipping services) in which the corresponding ShippingService will appear in the View Item and Checkout page. Sellers can specify up to five international shipping services (with five InternationalShippingServiceOption containers), so valid values are 1, 2, 3, 4, and 5. A shipping service with a ShippingServicePriority value of <code>1</code> appears at the top. Conversely, a shipping service with a ShippingServicePriority value of 5 appears at the bottom of a list of five shipping service options. If the Global Shipping Program is enabled on the listing for international shipping, only four additional shipping services may be specified. If this field is omitted from international shipping service options, the order of the shipping service options in View Item and Checkout pages will be determined by the order that these shipping service options are presented in the request payload of an Add/Revise/Relist call. SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally An international location or region to where the item seller will ship the item. Use GeteBayDetails with DetailName set to ShippingLocationDetails to determine which locations are valid per site. In the GeteBayDetails response, look for the ShippingLocationDetails.ShippingLocation fields. For the AddItem family of calls, this field is required if any international shipping service is specified. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, ShipToLocation fields will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, ShipToLocation fields are only returned to the buyer or seller, and a string value of <code>Unavailable</code> will be returned to all third parties. ShippingRegionCodeType, CountryCodeType SendInvoice No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-Locations.html#ShipToLocation Ship-To Locations This field is no longer applicable as it is not longer possible for a seller to offer a buyer shipping insurance. 1081 NoOp 1081 The total cost of customs and taxes for the international leg of an order shipped using the Global Shipping Program. This amount is calculated and supplied for each item by the international shipping provider when a buyer views the item properties. 0 GetItemShipping Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally The last time of day that an order using the specified shipping service will be accepted by the seller. The cut off time applies and is returned only when the ShippingService field contains the name of a qualifying time-sensitive shipping service, such as <code>eBayNowImmediateDelivery</code>. The cut off time is set by eBay and determined in part by the policies and locations of the seller and the shipping carrier. GetItemShipping Conditionally This is used in the ReviseInventoryStatus response to provide the set of fees associated with each unique ItemID. The unique identifier of the listing being changed. The ReviseInventoryStatus response includes a separate set of fees for each item that was successfully revised. Use the ItemID to correlate the Fees data with the Inventory Status data in the response. ReviseInventoryStatus Always Contains the data for one fee (such as name and amount). ReviseInventoryStatus Always This type is used by the ReviseInventoryStatus call to update the price and/or quantity of an item or an item variation within a single-variation or multiple-variation, fixed-price listing. This value is the seller-defined SKU value of the item being revised. For a single-variation listing, either the ItemID of the listing or the SKU value of the item (if it exists) is required, and which one to use will depend on the value of the InventoryTrackingMethod setting. If the value of InventoryTrackingMethod is <code>ItemID</code>, the ItemID field should be used. If the value of InventoryTrackingMethod is <code>SKU</code>, the SKU field should be used. <code>ItemID</code> is the default value of InventoryTrackingMethod, and its value can only be set/changed to <code>SKU</code> through either an AddFixedPriceItem or RelistFixedPriceItem call. For a multiple-variation listing, the SKU value of the item variation is required in order to identify a specific item variation. An ItemID field is also required if the InventoryTrackingMethod value is set to <code>ItemID</code>. However, if the InventoryTrackingMethod value is set to <code>SKU</code>, only the SKU value of the item variation is needed to identify a specific item variation. Note that a seller-defined SKU value is required when a seller creates a multiple-variation listing, regardless of whether they decide to track inventory by Item ID or SKU. The SKU field is always returned in the response, and if a SKU value doesn't exist for a single-variation listing, it is returned as an empty tag. ReviseInventoryStatus Conditionally ReviseInventoryStatus Always The unique identifier of the listing being revised. For a single-variation listing, either the ItemID of the listing or the SKU value of the item (if it exists) is required, and which one to use will depend on the value of the InventoryTrackingMethod setting. If the value of InventoryTrackingMethod is <code>ItemID</code>, the ItemID field should be used. If the value of InventoryTrackingMethod is <code>SKU</code>, the SKU field should be used. <code>ItemID</code> is the default value of InventoryTrackingMethod, and its value can only be set/changed to <code>SKU</code> through either an AddFixedPriceItem or RelistFixedPriceItem call. For a multiple-variation listing, the SKU value of the item variation is required in order to identify a specific item variation. An ItemID field is also required if the InventoryTrackingMethod value is set to <code>ItemID</code>. However, if the InventoryTrackingMethod value is set to <code>SKU</code>, only the SKU value of the item variation is needed to identify a specific item variation. Note that a seller-defined SKU value is required when a seller creates a multiple-variation listing, regardless of whether they decide to track inventory by Item ID or SKU. Please note that the same ItemID value can be used multiple times in the same call if you revise several item variations from the same multiple-variation listing. The ItemID field is always returned in the response, even if an ItemID value was not included in the request. ReviseInventoryStatus Conditionally ReviseInventoryStatus Always This field is used to update the price of a fixed-price item, or to update the price of an item variation within a multiple-variation listing. To update the price of an item variation, both the ItemID and SKU fields are required to identify the listing and the specific variation within that listing, respectively. In each InventoryStatus container, either StartPrice or Quantity (or both) are required. Note: The StartPrice field should no longer appear in the response payload. If it does appear, it can be ignored. Sellers can leverage the <a href="https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetItem.html">GetItem</a> call to verify that the requested price updates were successful. Insertion Fees http://pages.ebay.com/help/sell/insertion-fee.html eBay.com Listing Fees http://pages.ebay.com/help/sell/fees.html ReviseInventoryStatus Conditionally This field is used to update the quantity of a fixed-price listing, or to update the quantity of a variation within a multiple-variation listing. To update a variation, both the ItemID and SKU fields are required to identify the listing and the specific variation within that listing, respectively. In each InventoryStatus container, either StartPrice or Quantity (or both) are required. Note: The Quantity field should no longer appear in the response payload. If it does appear, it can be ignored. Sellers can leverage the <a href="https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetItem.html">GetItem</a> call to verify that the requested quantity updates were successful. ReviseInventoryStatus Conditionally Defines options to track a listing by the eBay item ID or the seller's SKU. In some calls, elements of this type are only returned in the response when the value is set to SKU on the item. Indicates the seller prefers to track the listing by its eBay item ID. This is the default for all listings. Indicates the seller prefers to track the listing by their own SKU. When you track by SKU, it means you can pass in your SKU instead of the eBay item ID in other calls that support SKU as an input field. If you choose SKU as your tracking preference for a listing, the value in Item.SKU must be unique across your active listings. You cannot create new listings with the same Item.SKU value while the listing is active (that is, until the existing listing with that SKU has ended). However, you can use ReviseInventoryStatus to update the quantity and/or price for the existing SKU as needed. When revising a listing where the InventoryTrackingMethod was set to SKU, you must pass in both the InventoryTrackingMethod tag (with the value set to SKU) and the SKU tag with the SKU value from your original listing. Reserved for internal or future use. This type is used by the ItemBidDetails container that is returned in GetAllBidders. The ItemBidDetails container shows a few details about a user's bid on an auction listing. An ItemBidDetails container is returned for each bid that a user makes during the life of an auction listing. An ItemBidDetails container will only be returned to the seller of the auction listing or to an actual bidder for the listing. The unique identifier of an item listed on the eBay site. Since a bidder's user information is anonymous, this tag will contain the real ID value only for that bidder, and the seller of an item that the user is bidding on. For all other users, the real ID value will be replaced with the anonymous value, according to these rules: When bidding on items listed on the US site: UserID is replaced with the value "a****b" where a and b are random characters from the UserID. For example, if the UserID = IBidALot, it might be displayed as, "I****A". Note that in this format, the anonymous bidder ID stays the same for every auction. (GetMyeBayBuying only) when bidding on items listed on the US site: UserID is replaced with the value "a****b" where a and b are random characters from the UserID. When bidding on items listed on the UK and AU sites: UserID is replaced with the value "Bidder X" where X is a number indicating the order of that user's first bid. For example, if the user was the third bidder, UserID = Bidder 3. Note that in this format, the anonymous bidder ID stays the same for a given auction, but is different for different auctions. For example, a bidder who is the third and then the seventh bidder in an auction will be listed for both bids as "Bidder 3". However, if that same bidder is the first bidder on a different auction, the bidder will be listed for that auction as "Bidder 1", not "Bidder 3". (GetMyeBayBuying only) when bidding on items listed on the UK and AU sites: UserID is replaced with the string "High Bidder". (GetBestOffers only) - all sites: The last part of the user ID is replaced with asterisks for users that submit best offers on an item. The seller of the item will be able to see the full User ID. https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-UserInformation.html#WorkingwithAnonymousUserInformation Working with Anonymous User Information GetAllBidders Conditionally Unique identifier of the eBay category that the auction item is listed under. GetAllBidders Conditionally The total number of bids that the user has placed on the auction item. GetAllBidders Conditionally The eBay ID of the seller who listed the item. This will be returned with the anonymous value "Seller X", where X indicates where the seller falls in the sequence of sellers that the user has purchased items from. For example, if the seller is the third seller that the user has purchased items from, the value "Seller 3" is returned. https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-UserInformation.html#WorkingwithAnonymousUserInformation Working with Anonymous User Information GetAllBidders Conditionally This timestamp indicates the date/time at which the user placed the last bid on the auction item. GetAllBidders Conditionally A list of compatible applications specified as name and value pairs. Describes an assembly with which a part is compatible (i.e., parts compatibility by application). For example, to specify a part's compatibility with a vehicle, the name would map to standard vehicle characteristics (e.g., Year, Make, Model, Trim, and Engine). The values would desribe the specific vehicle, such as a 2006 Honda Accord. Details for an individual compatible application, consisting of the name-value pair and related parts compatibility notes. When revising or relisting, the Delete field can be used to delete individual parts compatibility nodes. Note: For the GetItem call, Compatibility includes only parts compatibility details that were specified manually; that is, they do not correspond to an eBay catalog product. To retrieve parts compatibility details that do correspond to eBay catalog products, use the eBay Product API's getProductCompatibilities call. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally Product API ProductCompatibilities call reference https://developer.ebay.com/Devzone/product/CallRef/getProductCompatibilities.html information about retrieving parts compatibility details that correspond to eBay catalog products. Set this value to true to delete or replace all existing parts compatibility information when you revise or relist an item. If set to true, all existing item parts compatibility nodes are removed from the listing. If new item compatibilities are specified in the request, they replace the removed compatibilities. Note: To ensure that buyer expectations are upheld, you cannot delete or replace an item parts compatibility list if the listing has bids or if the auction ends within 12 hours. false RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem Conditionally All information corresponding to an individual parts compatibility by application. Removes individual parts compatibility nodes from the compatibility list. Set to <code>true</code> within the compatibility to delete. Note: This field can only be used with Revise calls or when revising a template. If the listing has bids or ends within 12 hours, you cannot delete item parts compatibilities. false ReviseFixedPriceItem ReviseItem Conditionally A name-value pair describing a single compatible application. The allowed names and values are specific to the primary category in which the item is listed. For example, when listing in a Parts & Accessories category, where the applications are vehicles, the allowed names might include Year, Make, and Model, and the values would correspond to specific vehicles in eBay's catalog. For details and examples, see the <a href="https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/CompatibleParts-Listing.html#SpecifyingPartsCompatibilityManually" target="_blank">Features Guide</a>. The eBay Germany, UK, France, Italy, Spain, and Australia sites support the use of K type vehicle numbers to specify vehicle parts compatibility. To use a K type number, set the Name field to "<code>KType</code>" and set the corresponding Value field to the appropriate K type number. The DE and UK eBay sites also support the use of an eBay Product ID (or ePID) number/value pair to specify motorcycle and scooter parts compatibility (currently, only DE supports scooter parts compatibily). To use an ePID number to specify part compatibilities, set the Name field to "<code>ePID</code>" and the corresponding Value field to the ePID number that matches the motorcycle for the part(s) you are listing. Motorcycle ePID numbers are provided by the Master Motorcycle List (MML) file, which contains the ePID numbers and their associated vehicle mappings). For motorcycles, an ePID number contains the vehicle make, model, CCM, year, and submodel data. Please use the following links to obtain the DE and UK MML data files: - DE seller help page: http://verkaeuferportal.ebay.de/fahrzeugteile-und-zubehoer-optimal-einstellen - UK seller help page: http://pages.ebay.co.uk/help/sell/contextual/master-motorcycle-list-manually.html AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally Product Metadata API Call Reference https://developer.ebay.com/DevZone/product-metadata/CallRef/index.html information on retrieving parts compatibility search names and corresponding values needed to specify compatibility by application manually GetItem Conditionally The seller may optionally enter any notes pertaining to the parts compatibility being specified. Use this field to specify the placement of the part on a vehicle or the type of vehicle a part fits. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally Type that represents the unique identifier for an eBay listing. Specifies the details of policy violations if the item was administratively canceled. The details are the policy ID and the policy text. Policy ID of the violated policy which resulted in item being administratively canceled. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Brief information of the violated policy which resulted in item being administratively canceled. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This enumerated type is used by GetItem, and indicates the source for an Item Specific. Attribute This enumeration value indicates that the corresponding Item Specific was specified by the seller in Add/Revise/Relist call or flow. In an Add/Revise/Relist API call, Item Specifics for a listing are specified through the ItemSpecifics.NameValueList or VariationSpecifics.NameValueList (for a variation in a multiple-variation listing) containers. This value is no longer applicable and should not be returned. This enumeration value indicates that the corresponding Item Specific was derived from a product in the eBay Catalog, and was automatically picked up by the listing when the seller created, revised, or relisted an item referencing and matching an eBay catalog product through the use of an ePID or GTIN value in the ProductListingDetails container. Reserved for future use. This type is used by the ItemTransactionID container in the GetOrderTransactions call. This container is used to specify a specific order line item to retrieve. Unique identifier for an eBay listing. A multiple-quantity listing can have multiple order line items, but only one ItemID. Unless an OrderLineItemID or SKU value is specified in the same node, this field is required for each ItemTransactionID node included in the request. GetOrderTransactions Conditionally Unique identifier for an eBay order line item. The TransactionID should match the ItemID specified in each ItemTransactionID node included in the request. Optionally, an OrderLineItemID or SKU value can substitute for the ItemID/TransactionID pair. The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. GetOrderTransactions Conditionally A SKU (stock keeping unit) is a unique identifier defined and used by the seller to identify a product or variation of an item. Unless an OrderLineItemID value or ItemID/TransactionID pair is specified in the same node, this field is required for each ItemTransactionID node included in the request. To retrieve order line items associated with a SKU, the InventoryTrackingMethod field must be set to SKU. The InventoryTrackingMethod field is set through AddFixedPriceItem or RelistFixedPriceItem. 50 GetOrderTransactions Conditionally OrderLineItemID is a unique identifier for an eBay order line item. If an OrderLineItemID is included in an ItemTransactionID node in the request, the ItemID, TransactionID, and SKU fields are not required and are ignored if they are included in the request. GetOrderTransactions Conditionally Contains the data defining one item. A seller populates an object of this type at listing time with the definition of a new item. A seller also uses an object of this type to relist or revise an item. Calls that retrieve item data (such as the GetSellerList call) return an object of this type, filled with the item's data. AttributeConversionEnabled, BasicUpgradePack, ClassifiedAdContactByEmailAvailable, ClassifiedAdMaximumBestOffersAllowed, ClassifiedAdPayPerLeadEnabled, CombinedFixedPriceTreatment, DepositSupported, DigitalDeliveryEnabled, DutchBINEnabled, EANIdentifierEnabled, ExpressConditionRequired Return custom, application-specific data associated with the item. The data you specify is stored by eBay with the item for your own reference, but it is not used by eBay in any way. Use ApplicationData to store special information for yourself, such as a part number. For a SKU in an eBay.com listing, use the SKU element instead. To remove this value when revising or relisting an item, use DeletedField. 32 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field has been deprecated, and should no longer be used. This field has been deprecated, and should no longer be used. 1027 NoOp 1033 This field is deprecated, and should no longer be used. This field is included and set to if <code>true</code> in an Add/Revise/Relist call if the seller wants to require immediate payment from the buyer. If this field is set to <code>false</code> or not included, the seller is not requestinng immediate payment. Note that this field may be set to <code>true</code>, but that does not necessarily mean that the buyer will be required to pay right away. For example, immediate payment is not currently applicable to auctions items won in a competitive bidding process or to items where the buyer and seller negotiated the price through the Best Offer feature. Immediate payment is also not applicable to listings where the payment happens offline between the buyer and seller. false AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Detailed information about a bid. For GetMyeBayBuying, returned as a self-closed element if no bids meet the request criteria. GetMyeBayBuying BidList LostList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling BidList

DetailLevel: none, ReturnAll

Conditionally The enumeration value returned in this field indicates whether an item is eligible for the buyer protection. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field is only applicable for auction listings. By specifying a 'Buy It Now' price, a seller is allowing prospective buyers the opportunity to purchase the item in the auction listing at this price immediately. When a buyer uses the 'Buy It Now' option to purchase the item, the auction listing will end immediately. By including this field and specifying a 'Buy It Now' price, the seller is enabling the 'Buy It Now' feature on the auction listing. If the seller includes this field for any other listing type other than an auction, this field and its price will just be ignored. The price in this field must be at least 30 percent higher than the starting bid price (which is specified in an Add call through the Item.StartPrice field). Once a bid is made on an auction listing, and the bid meets or exceeds the Item.ReservePrice value (if set), the 'Buy It Now' option becomes unavailable, and this field will no longer be applicable. If there is no Reserve Price, the first bid will nullify the 'Buy It Now' option. Keep in mind that GetItem (and other 'Get' calls that retrieve the Item details) may still return the BuyItNowPrice field for an auction item even if the 'Buy It Now' option is no longer available. Instead, a user should look for the ListingDetails.BuyItNowAvailable boolean field in the GetItem response to determine if the 'Buy It Now' option is still available for the auction item. Note: For the US site, new eBay sellers are subject to <a href="https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listing-Policies.html#SellerLimits">Seller Limits</a>, which limit the quantity of items that may be listed and/or the total cumulative value of these listings. While subject to these selling limits, an eBay seller can use the GetMyeBaySelling call to retrieve both the remaining number of listings they can create and the remaining cumulative value of these listings. These values are shown in the Summary.QuantityLimitRemaining and Summary.AmountLimitRemaining fields in the GetMyeBaySelling response. If a call to add an item or revise an item would result in the exceeding of these limits, the add item or revise item call will fail. These fields will only be returned if the seller is subject to seller limits. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetBestOffers

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Medium, Fine

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WatchList BestOfferList BidList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList

DetailLevel: none, ReturnAll

Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerEvents

DetailLevel: ReturnAll

Conditionally Note: This field's value now defaults to <code>true</code> if this field is omitted. Previously, the default value was <code>false</code>, so a user had to include this field and set it to <code>true</code> in order for eBay to map an outdated Primary or Secondary Category ID to the updated Category ID. This boolean field controls whether or not eBay automatically maps outdated Category ID(s) specified in a PrimaryCategory and/or SecondaryCategory container(s) to the updatd Category ID(s) no longer exists in the current category structure: If you pass a value of <code>true</code> in CategoryMappingAllowed or just omit the field, eBay will look up the current Category ID(s) that have replaced the specified Category ID(s). If you pass a value of <code>false</code>, eBay will not do any mapping, and the call may fail if specified Category ID(s) are no longer valid IDs for a eBay leaf category. The new Category ID(s) will be returned in the CategoryID and Category2ID fields (if secondary category is used) of the Add/Revise/Relist call response. true AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No Maintaining Category Data https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Categories-DataMaintenance.html This container identifies the nonprofit organization that will benefit with a percentage of the proceeds from each sale of an item through an auction or fixed-price listing. Charity names and IDs can be found by going to <a href="https://charity.ebay.com/charity-auctions/my-causes" target="_blank">eBay for Charity</a> page and doing a search, or by doing a search with the GetCharities call. The donation percentage can be set in 5 percent increments from 10 percent to 100 percent. When it comes to revising an auction or fixed-price listing, you can add a benefitting charity (as long as there is at least 12 hours left before end of listing/close of auction), but you cannot remove or change a nonprofit company once one is already established in the original listing. For Revise calls: The non-profit organization and donation percentage can now be modified in a Revise call as long as there are no active bids on an auction listing, or no pending Best Offers/Counter Offers on a listing. This container will only be returned in Get calls for charitable listings. Charitable listings are only supported in the US and UK marketplaces. Buying and selling on eBay to benefit nonprofit organizations https://www.ebay.com/help/account/donating-ebay-charity/buying-selling-ebay-benefit-nonprofit-organizations?id=4668 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Identifying Listings that Benefit Nonprofits https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Feature-NonprofitSupport.html This two-digit enumeration value indicates the country of the seller's registration address. CountryCodeType defines the supported values. The <a href="https://developer.ebay.com/DevZone/XML/docs/Reference/eBay/GeteBayDetails.html">GeteBayDetails</a> call can also be used (include the DetailName field and set its value to CountryDetails) to see the full list of supported country codes. In an Add/Revise/Relist/Verify call, this field is required. AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Yes GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse

Conditionally RelistItem ReviseItem RelistFixedPriceItem ReviseFixedPriceItem VerifyRelistItem No GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field is deprecated, and should not longer be used. In an Add/Revise/Relist/Verify call, this required three-digit enumeration value defines the currency associated with the listing site. The item price and all costs passed in the call request will be using this currency. Similarly, the listing fees and other cost-related data will be using this currency. Since the Trading API can only be used for a select number of eBay sites, only a subset of values are supporting when adding/revising/relisting an item. These supported values are discussed in the top section of CurrencyCodeType. In 'Get' calls, it is possible that any of the values in CurrencyCodeType may appear, as some cost-related fields will show the buyer's currency type. AddFixedPriceItem AddItem AddItems AddFixedPriceItem VerifyAddFixedPriceItem VerifyAddItem Yes GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBestOffers

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally The seller's description of the item. In listing requests, you can submit your description using CDATA if you want to use HTML or XML-reserved characters in the description. However, a seller can not use any active content in their listing description. Active content includes animation or video via JavaScript, Flash, plug-ins, or form actions. All active content will be blocked/removed from a listing. Removing/blocking active content will lead to faster load times of listings, make listings more mobile-friendly, improve SEO performance, and lead to a more secure eBay Marketplace. Note: To ensure that their listing description is optimized when viewed on mobile devices, sellers should strongly consider using eBay's <a href="https://pages.ebay.com/sell/itemdescription/customizeyoursummary.html" target="_blank">View Item description summary feature</a> when listing their item. Using HTML div and span tag attributes, this feature allows sellers to customize and fully control the listing description that is displayed for prospective buyers when viewing the item on a mobile device. The listing description on mobile devices is limited to 800 characters, and whenever the listing description exceeds this limit, eBay uses a special algorithm to derive the best possible description within the 800-character limit. However, due to some description content being removed, it is definitely not ideal for the seller, and could possibly lead to a bad buyer experience and a Significantly not as described (SNAD) case, since the buyer may not get complete details on the item. See the eBay help page for more details on using the HTML div and span tags, and for more tips on creating listings that are mobile-friendly, see this <a href="https://pages.ebay.com/sell/itemdescription/mobilefriendlyguidelines.html" target="_blank">Best practices</a> document. In the listing description, sellers are only allowed to provide links to product videos, freight shipping services, or other legally required information, and when providing these links in the listing description, the secure 'https' protocol must be used instead of 'http'. In addition, any valid links to sites outside of eBay should use the target="_blank" attribute in the a href tag so a new browser window will be loaded when the link is clicked instead of buyers being redirected off of eBay. For more information on using links in the listing description, see eBay's <a href="http://pages.ebay.com/help/policies/listing-links.html" target="_blank">Links policy</a>. For more information about the stronger security standards that eBay is using, see the <a href="https://pages.ebay.com/seller-center/seller-updates/2018-fall/marketplace-update.html#use-secure-https" target="_blank">Use secure HTTPS for enhanced browser security</a> topic in the 2018 Fall Seller Update. The <a href="https://developer.ebay.com/api-docs/sell/compliance/resources/listing_violation/methods/getListingViolations" target="_blank">getListingViolations</a> method of the Compliance API can be used to see if any of the seller's active listings are not 'HTTPS' compliant. If you embed pictures in the description (by using IMG tags) instead of using PictureURL, but you want a camera icon to appear in search and listing pages, specify the following null-image URL in the PictureURL field: https://pics.ebay.com/aw/pics/dot_clear.gif. See <a href="https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Pictures-InListing.html">Working with Pictures in an Item Listing</a> in the eBay Features Guide. This field is conditionally required for all listings. The exception is when the seller specifies a product identifier, such as a GTIN or ePID, through the ProductListingDetails container and a product match is found in the eBay product catalog. If a matching product is found in the eBay product catalog, the item description will be created automatically (as long as the ProductListingDetails.IncludeeBayProductDetails value is <code>true</code>). 500000 (some sites may allow more, but the exact number may vary) AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally IncludeeBayProductDetails #Request.Item.ProductListingDetails.IncludeeBayProductDetails GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: ItemReturnDescription, ReturnAll

Always IncludeeBayProductDetails #Response.Item.ProductListingDetails.IncludeeBayProductDetails This field is conditionally required if the listing is being revised through a Revise call, and the Item.Description field is one of the fields being changed. The enumeration value passed in this field specifies whether the text provided in the Item.Description field will prepend, append, or replace the existing text in the current Item.Description field. ReviseItem ReviseFixedPriceItem Conditionally This field is deprecated, and should no longer be used. The unique identifier of the eBay listing. This identifier is generated by eBay and returned in the response of an Add call if an item is successfully listed. Once an item is successfully created, the ItemID cannot be modified. Note: Although we represent item IDs as strings in the schema, we recommend you store them as 64-bit signed integers. If you choose to store item IDs as strings, allocate at least 19 characters (assuming decimal digits are used) to hold them. Your code should be prepared to handle IDs of up to 19 digits. AddOrder GetBestOffers RelistItem ReviseItem VerifyRelistItem Yes RelistFixedPriceItem ReviseFixedPriceItem Conditionally GetBidderList GetDispute Always GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetBestOffers

DetailLevel: none, ReturnAll

Conditionally GetItemsAwaitingFeedback GetMemberMessages Conditionally GetUserDisputes

DetailLevel: ReturnSummary, ReturnAll, none

Conditionally GetMyeBayBuying BestOfferList BidList LostList SecondChanceOffer WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Various details about a listing, some of which are calculated or derived after the item is listed. These include the start and end time, converted (localized) prices, and certain flags that indicate whether the seller specified fields whose values are not visible to the requesting user. For GetMyeBayBuying, returned as a self-closed element if no listings meet the request criteria. In an Add/Revise/Relist call, this container is used to set the Best Offer Auto-Accept and Best Offer Auto-Decline threshold values. GetBestOffers

DetailLevel: none, ReturnAll

Always GetBidderList GetDispute Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetCategoryListings GetItemsAwaitingFeedback GetMemberMessages Conditionally GetMyeBayBuying BestOfferList BidList LostList SecondChanceOffer WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No Describes the number of days the seller wants the listing to be active (available for bidding/buying). The duration specifies the seller's initial intent at listing time. The end time for a listing is calculated by adding the duration to the item's start time. If the listing ends early, the value of the listing duration does not change. When a listing's duration is changed, any related fees (e.g., 10-day fee) may be debited or credited (as applicable). The valid choice of values depends on the listing format (see Item.ListingType). For a list of valid values, call GetCategoryFeatures with DetailLevel set to ReturnAll and look for ListingDurations information. When you revise a listing, the duration cannot be reduced if it will result in ending the listing within 24 hours of the current date-time. You are only allowed to increase the duration of the listing if fewer than 2 hours have passed since you initially listed the item and the listing has no bids. You can decrease the value of this field only if the listing has no bids (or no items have sold) and the listing does not end within 12 hours. Note: As of April 1, 2019, 'GTC' is the only supported listing duration for all eBay marketplaces with the following exceptions: <ul> <li>The following eBay Motors US categories are exempt from this change: Cars & Trucks (6001), Motorcycles (6024), Other Vehicles & Trailers (6038), Boats (26429), Powersports (66466).</li> <li>All child categories under Cars, Motorcycles & Vehicles (9800) categories on the eBay UK and eBay Italy sites are also exempt from this change. </li> </ul> If any other listing duration value besides <code>GTC</code> is specified in this field, it will be ignored, and <code>GTC</code> will be used instead. ListingDurationCodeType AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Yes RelistItem ReviseItem RelistFixedPriceItem ReviseFixedPriceItem VerifyRelistItem No GetBidderList Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBaySelling ScheduledList UnsoldList ActiveList

DetailLevel: none, ReturnAll

Conditionally Describes listing upgrades that sellers can select for a fee, such as the BoldTitle upgrade. Also includes feature packs for saving on listing upgrades. See <a href="https://pages.ebay.com/help/sell/ia/promoting_your_item.html" target="_blank">Listing Upgrades</a> in the eBay site help. You cannot remove listing upgrades when you revise a listing. When you relist an item, use DeletedField to remove a listing upgrades. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetCategoryListings Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The selling format of the eBay listing, such as auction (indicated with <code>Chinese</code> value), fixed-price (indicated with <code>FixedPriceItem</code> value), or classified ad (indicated with <code>AdType</code> value). If this field is not included in an AddItem, AddItems, or VerifyAddItem call, the listing type defaults to auction For AddFixedPriceItem, RelistFixedPriceItem, or VerifyAddFixedPriceItem call, this field must be included and set to <code>FixedPriceItem</code>, since these calls only work with fixed-price listings. This field is not applicable to Revise calls because the selling format of active listings cannot be changed. Unknown, Auction, PersonalOffer, Shopping, Half AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Unknown, Auction, Half, PersonalOffer Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Unknown, Auction, Half Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Unknown, Auction, Half, PersonalOffer, Shopping Conditionally GetItemTransactions GetSellerTransactions Unknown, Auction, Half, Shopping

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetOrderTransactions Unknown, Auction, Half, Shopping

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetCategoryListings Unknown, Auction, Half, PersonalOffer Conditionally GetMyeBayBuying BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Unknown, Auction, Half Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList

DetailLevel: none, ReturnAll

Unknown, Auction, Half Conditionally GetSellerEvents

DetailLevel: ReturnAll

Unknown, Auction, Half, Shopping Conditionally Overview of Listing Types https://developer.ebay.com/DevZone/guides/features-guide/default.html#basics/eBay-BuildingBlocks.html#ListingTypes Indicates the geographical location of the item (along with the value in the Country field). When you revise a listing, you can add or change this value only if the listing has no bids (or no items have sold) and it does not end within 12 hours. If you do not specify Location, you must specify Item.PostalCode. If you specify a postal code, but do not specify a location, then the location is given a default value derived from the postal code. For the Classified Ad format for motors vehicle listings, the value provided in the Location field is used as item location only if the SellerContactDetails.Street and the SellerContactDetails.Street2 are empty. Else, the SellerContactDetails.Street and the SellerContactDetails.Street2 will be used for item location. 45 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetCategoryListings Conditionally A lot is a set of two or more similar items included in a single listing that must be purchased together in a single order line item. The Item.LotSize value is the number of items in the lot. This field is required if two or more items are including in one listing. Lots can be used for auction and fixed-price listings. Lot items can be listed only in lot-enabled categories. Call GetCategories to determine if a category supports lots. If the returned CategoryArray.Category.LSD (LotSize Disabled) value is <code>true</code>, the category does not support lots. 450,000 AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally This field is deprecated. This field is deprecated. This container is used in an Add/Revise/Relist/Verify call if the seller is selling a motor vehicle. It is used by the seller to specify the amount of the initial deposit, and the due dates for the deposit and the full payment for a motor vehicle listing. Note: If you are using business policies with your listing, the details set up in this container will instead be set up via the payment business policy. Payment business policies are associated with the listing via the SellerProfiles.SellerPaymentProfile container. This container will only be returned in 'Get' calls for motor vehicle listings where an initial deposit is required for that vehicle. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Listing US and CA eBay Motors Items https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Sites-eBayMotors.html#PaymentMethodsforMotors For Add/Revise/Relist calls: A PaymentMethods field is required for each offline payment method supported by the seller for the listing. Note: Sellers no longer have to specify any electronic payment methods for listings, so one or more PaymentMethods fields will only be needed for listings that require/support payments off of eBay's platform. If an electronic payment is supplied in a PaymentMethods field, a warning will be triggered and the payment method will be dropped. Note: If you are already referencing a payments business policy in an Add/Revise/Relist call with the SellerProfiles.SellerPaymentProfile container, no lt;b>PaymentMethods fields will be needed, as these settings will already be set in the payments business policy. Payment methods are not applicable to any classified ad listings, as any agreement and payment is handled off of the eBay platform. For Get calls that return PaymentMethods fields : One or more PaymentMethods fields will only be returned if the seller set one or more offline payment methods for the listing. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList GetItems IntegratedMerchantCreditCard Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

IntegratedMerchantCreditCard Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

IntegratedMerchantCreditCard Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

IntegratedMerchantCreditCard Conditionally This field is no longer applicable, and should not be used. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This container is used in an Add/Revise/Relist call to set the primary listing category. This field is conditionally required in an Add call unless the seller successfully uses the ProductListingDetails container to find an eBay catalog product match. When the seller successfully uses an eBay catalog product to create a listing, the listing title, listing description, Item Specifics, listing category, and stock photo defined in the catalog product is used to create the listing. If you do not know the appropriate eBay category for your product, you can use the GetSuggestedCategories call. Once you know your category, and want to know which listing features it supports, you can use the GetCategoryFeatures call. To discover required, recommended, and optional Item Specifics for a category, use the <a href="/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API. If you do use an eBay catalog product, it is advised that you do not include this field, as any primary category ID you specify in this field may get dropped if this category is different than the primary category defined in the eBay catalog product. For ReviseItem only: When revising a listing, you can change the primary category only if an auction listing has no bids or a multiple-quantity, fixed-price listing has no sales, and the listing does not end within 12 hours. If you change the listing category, any Item Specifics that were previously specified may be dropped from the listing if they aren't valid for the new category. When you list an event ticket on the US site, you must specify one of the leaf categories under the Tickets & Experiences meta category. AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally RelistItem ReviseItem RelistFixedPriceItem ReviseFixedPriceItem VerifyRelistItem No GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Applying Categories https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Categories.html Maintaining Category Data https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Categories-DataMaintenance.html A <code>true</code> value in this field indicates that the listing is private. Sellers may want to use this option when they believe that a listing's potential bidders/buyers would not want their obfuscated user IDs (and feedback scores) exposed to other users. For ReviseItem/ReviseFixedPriceItem: The seller will not be able change this setting if the listing has any pending bids, any pending best offers, previous sales (for multiple-quantity, fixed-price listing), or if the listing will end within 12 hours. false AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally This container is used to provide one or more product identifiers for a product, and if desired by the seller, eBay will use the identifier(s) of the product to try to match it to a defined product in the eBay catalog. If a seller's product is matched to an eBay catalog product, the product details associated with that catalog product will be prefilled for the listing. Product details defined for a catalog product include the product title, product description, product aspects, and stock image(s) of the product (if available). In some eBay categories, one or more product identifier types (e.g. UPC or ISBN) may be required, but the category may not have any eBay catalog products defined, or the category does not allow listings to be created using a catalog product. Note that the GetCategoryFeatures call can be used to retrieve supported/required product identifier types. Note: If a product identifier type is required, the corresponding field must be used, even if the seller is not interested in finding an eBay catalog product match. A large percentage of eBay US categories require one or more product identifier types when listing an item. See the <a href="http://pages.ebay.com/sell/item_specifics/product_identifiers.html" target="_blank">Structured Data - Product Identifiers</a> help page for more information on which eBay US categories require which product identifier types. If known, an ePID (specified through the ProductReferenceID field) is always the best bet to find an eBay catalog product match, although an EAN, ISBN, UPC, or Brand/MPN pair can also be used in an attempt to find a catalog product match. If a Brand/MPN pair is required for the product, these values must be input through the BrandMPN container. When you use ProductListingDetails, in an Add/Revise/Relist call, you must specify at least one GTIN, a ProductReferenceID (also known as an ePID), a Brand/MPN pair, or TicketListingDetails. If you specify more than one GTIN value, eBay uses the first one that matches a product in eBay's catalog. For ReviseItem and RelistItem only: When you revise a listing, if it has bids or it ends within 12 hours, you cannot change the product identifier and you cannot remove existing product listing details data. However, you can change or add preferences such as IncludeStockPhotoURL, UseStockPhotoURLAsGallery, and IncludePrefilledItemInformation. To delete all catalog data when you revise or relist an item, specify Item.ProductListingDetails in DeletedField and don't pass ProductListingDetails in the request. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally For AddItem family of calls: The Quantity value for auction listings must always be <code>1</code>. For a fixed-price listing, the Quantity value indicates the number of identical items the seller has available for sale in the listing. If this field is not included when creating a new fixed-price listing, quantity defaults to '1'. If variations are specified in AddFixedPriceItem or VerifyAddFixedPriceItem, the Item.Quantity is not required since the quantity of variations is specified in Variation.Quantity instead. See the <a href="https://pages.ebay.com/help/sell/listing-variations.html" target="_blank">Creating a listing with variations</a> eBay Help page for more information on variations. For ReviseItem and ReviseFixedPriceItem: This value can only be changed for a fixed-price listing with no variations. The quantity of variations is controlled in the Variation.Quantity field and the Item.Quantity value for an auction listing should always be <code>1</code>. For RelistItem and RelistFixedPriceItem: Like most fields, when you use RelistItem or RelistFixedPriceItem, Quantity retains its original value unless you specifically change it. This means that the item is relisted with the value that was already in Quantity, not with the remaining quantity available. For example, if the original Quantity value was <code>10</code>, and three items have been sold, eBay sets the relisted item's Quantity to <code>10</code> by default, and not <code>7</code>. So, we strongly recommend that you always set Quantity to the correct value (your actual quantity available) in your relist requests. When eBay auto-renews a GTC listing (ListingDuration = GTC) on your behalf, eBay relists with correct quantity available. For GetSellerEvents: Quantity is only returned for listings where item quantity is greater than 1. For GetItem and related calls: This is the total of the number of items available for sale plus the quantity already sold. To determine the number of items available, subtract SellingStatus.QuantitySold from this value. For order line item calls with variations: In GetItemTransactions, Item.Quantity is the same as GetItem (the total quantity across all variations). In GetSellerTransactions, Transaction.Item.Quantity is the total quantity of the applicable variation (quantity available plus quantity sold). Note: For the US site, new eBay sellers are subject to <a href="/DevZone/guides/features-guide/default.html#development/Listing-Policies.html#SellerLimits">Seller Limits</a>, which limit the quantity of items that may be listed and/or the total cumulative value of these listings. While subject to these selling limits, an eBay seller can use the GetMyeBaySelling call to retrieve both the remaining number of listings they can create and the remaining cumulative value of these listings. These values are shown in the Summary.QuantityLimitRemaining and Summary.AmountLimitRemaining fields in the GetMyeBaySelling response. If a call to add an item or revise an item would result in the exceeding of these limits, the add item or revise item call will fail. These fields will only be returned if the seller is subject to seller limits. 1 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally ReviseItem No GetBidderList GetDispute Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally A note that a user makes on an item from their My eBay account. GetMyeBayBuying and GetMyeBaySelling return this field, and only if you pass in the IncludeNotes field in the request, and set its value to true. This field will only be returned if set for an item, and only returned to the user who created the note. Not supported as input in ReviseItem. Use SetUserNotes instead. For GetMyeBayBuying In WatchList, notes for variations are only returned at the Item level, not the variation level. They are only set if you specified ItemID (if no purchases) or ItemID and VariationSpecifics (if there are purchases) in SetUserNotes (or selected the equivalent in the My eBay UI on the site). In WonList, notes for variations are only returned at the Item level, not the variation level. They are only set if you specified ItemID and TransactionID in SetUserNotes (or selected the equivalent in the My eBay UI on the site). AddFixedPriceItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetMyeBayBuying GetMyeBaySelling Conditionally This field is deprecated. Applicable only to relisting an item. If true, creates a link in the item's old listing for the item that points to the new relist page, which accommodates users who might still look for the item under its old item ID. RelistItem No RelistFixedPriceItem No This field is used to set the lowest price at which the seller is willing to sell an auction item. The StartPrice value must be lower than the ReservePrice value. Note that setting a reserve price will incur a listing fee of $5 or 7.5% of the reserve price, whichever is greater, and this fee is charged regardless of whether or not the auction item has a qualifying, winning bidder. As long as no bidder has matched your reserve price, and the scheduled end time of the auction is 12 or more hours away, you can lower or remove the reserve price. However, even if you remove the reserve price from an active listing, you will still be charged the fee and not eligible for a credit. In 'get' calls that retrieve item data, the ReservePrice field will only be returned to the seller of that particular auction item, and only if a reserve price has been set up. The reserve price is never exposed to anyone other than the seller of the item. 16 AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList

DetailLevel: none, ReturnAll

Conditionally Revising US eBay Motors Listings (lowering or removing reserve price) https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listings-Revising.html#RevisingUSeBayMotorsListings Setting a reserve price (eBay help topic) https://www.ebay.com/help/selling/listings/selling-auctions/reserve-prices?id=4143 Fees for optional listing upgrades (eBay help topic) https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822#section5 This container is returned if a listing has been revised in any way since it first became active. One or more boolean fields will be returned under this container based on the type of revision(s) that occured, including a general revision, a price change, or a feature added or removed. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always Allows the user to specify a time in the future that the listing becomes active on eBay. To schedule the listing start time, specify a time in the future in GMT format. In GetItem and related calls, the scheduled time is returned in StartTime. For ReviseItem, you can modify this value if the currently scheduled start time is in the future (listing has yet to go live). When you schedule a start time, the start time is randomized within 15-minute intervals. Randomized start times applies to the following sites: <code>AT, BEFR, BENL, CH, DE, ES, FR, IE, IT, NL, PL, UK</code> Also see the following article in the Knowledge Base: <a href= "https://ebaydts.com/eBayKBDetails?KBid=1473" target="_blank" >Why scheduled time is sometimes getting reset</a>. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No The unique identifer for a secondary category. This field is only applicable if the seller decides to list the item under two categories. You cannot list US eBay Motors vehicles in two categories. However, you can list Parts & Accessories in two categories. The Final Value Fee is based on the primary category in which the item is listed. Furthermore, you can list the same item in an eBay Motors Parts & Accessories category and in an eligible eBay category, as long as the primary category is associated with the site on which you are listing. That is, the two categories can be a mix of Motors Parts & Accessories and eBay site categories. (Real Estate, Mature Audience (adult), and Business & Industrial categories are not eligible for listing in two categories in this manner.) For example, if you list on Motors, the primary category could be 6750 (eBay Motors > Parts & Accessories > Apparel & Merchandise > Motorcycle > Jackets & Leathers), and the secondary category could be 57988 (eBay > Clothing, Shoes > Accessories > Men's Clothing > Outerwear). If you list on the main eBay site, the primary category could be 57988 and the secondary category could be 6750. If eBay has designated a listing category as a value category (see ValueCategory in GetCategoryFeatures), and that listing category will be the seller's primary category, the seller will not be able to list their item in a secondary category. If a seller's request payload includes a primary or a secondary category that is designated as a value category, then eBay drops the SecondaryCategory ID and only lists the item in the category specified with the PrimaryCategory ID. Also, if the listing request includes Item Specifics (in ItemSpecifics) that are associated with the SecondaryCategory, eBay drops those values as well when the SecondaryCategory is dropped. The same logic is used if you revise an existing listing to add a secondary category, or to change one of the categories: If either the primary or secondary category is a value category, eBay drops the secondary category from your request.) To remove this value when relisting an item, use DeletedField. For ReviseItem only: When revising a listing within 12 hours of the listing's scheduled end time, you can only add or change the secondary category when an auction listing has no active bids or a multiple-quantity, fixed-price listing has no items sold. If you change the secondary category, any corresponding Item Specifics that were previously specified may be dropped from the listing if they aren't valid for the category. For ReviseItem only: Previously, removing the listing from a secondary category was only possible within 12 hours of the listing's scheduled end time when an auction listing had no active bids or a multiple-quantity, fixed-price listing had no items sold, but this restriction no longer exists. Now, the secondary category can be dropped for any active listing at any time, regardless of whether an auction listing has bids or a fixed-price listing has sales. To drop a secondary category, the seller passes in a value of <code>0</code> in the SecondaryCategory.CategoryID field. 10 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally The unique identifier for a secondary category that eBay has added as a free promotion. You cannot add this yourself. This container is only returned if the item was listed in a single category and eBay added a free secondary category. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Container for information about this listing's seller. Returned by GetItemsAwaitingFeedback if Buyer is making the request. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GetItemsAwaitingFeedback

DetailLevel: none, ReturnAll

Conditionally GetCategoryListings Conditionally GetMyeBayBuying BestOfferList BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling BidList

DetailLevel: none, ReturnAll

Conditionally GetBidderList Always AddItem AddItems ReviseItem VerifyAddItem Conditionally Various details about the current status of the listing, such as the current number of bids, the current high bidder, quantity sold, current price, and listing status. GetBidderList GetDispute Always GetSellerEvents

DetailLevel: none, ReturnAll

Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetCategoryListings GetMemberMessages Conditionally GetMyeBayBuying BestOfferList BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally The shipping-related details for an order, including flat and calculated shipping costs. Note: For sellers who are using a shipping (aka Fulfillment) business policy to create/revise/relist an item, none of the fields under the ShippingDetails container are necessary. A fulfillment business policy can be set up and/or modified in My eBay, or via the <a href="https://developer.ebay.com/api-docs/sell/account/resources/fulfillment_policy/methods/createFulfillmentPolicy">Account API</a>. A fulfillment business policy is associated to a listing through the Item.SellerProfiles.SellerShippingProfile container. If you do not use a fulfillment business policy, many of the fields under this ShippingDetails container become required in your request. New users who list their first items in selected categories on the US site must specify at least one domestic shipping service. This applies to a category if GetCategoryFeatures returns <code>true</code> for Category.ShippingTermsRequired. For multi-quantity, fixed-price listings, a seller can revise all shipping details of the listing (except for sales tax and for shipping type of Freight) for all unsold items. This applies to both domestic and international shipping. Checkout is not affected for those who bought items prior to the seller's shipping changes—the shipping details that were in effect at the time of purchase are used for that buyer at the time of checkout. Shipping details are not applicable to any classified ad listings, as shipping/delivery/pickup is handled by the buyer and seller off of the eBay platform. Note: To create a listing that is 'Local Pickup only' (buyer picks up, with no shipping/delivery available), the user does the following two things: <ul> <li>Either omit the entire ShippingDetails container, or pass in an empty ShippingDetails container - <ShippingDetails/> </li> <li>Pass in one ShipToLocations field, with its value set to <code>None</code> - <ShipToLocations>None</ShipToLocations></li> </ul> For GetMyeBayBuying, GetMyeBaySelling: ShippingDetails is not returned. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBayBuying BestOfferList BidList DeletedFromLostList DeletedFromWonList WatchList WonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally Determining Shipping Costs for a Listing https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Shipping-DeterminingCosts.html Revising Items https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listings-Revising.html restrictions on changing item properties with ReviseItem An international location or region to which the seller is willing to ship, regardless of shipping service. The country of the listing site is added by eBay. Note: For sellers who are using a shipping (aka Fulfillment) business policy to create/revise/relist an item, the ShipToLocations field should not be used in the request. A fulfillment business policy can be set up and/or modified in My eBay, or via the <a href="https://developer.ebay.com/api-docs/sell/account/resources/fulfillment_policy/methods/createFulfillmentPolicy">Account API</a>. A fulfillment business policy is associated to a listing through the Item.SellerProfiles.SellerShippingProfile container. Use GeteBayDetails with a DetailName of ShippingLocationDetails to determine which international locations are valid for the site. Omit ShipToLocations if you want to ship only within the country of the listing site. To state that you do not wish to ship at all, set ShipToLocations to <code>None</code>. ReviseItem can add a ShipToLocations. On output, ShipToLocations is the collection of all input item-level ShipToLocations plus international shipping service-level ShipToLocation values. If you have specified a region to which you will ship (such as Asia), you can use ExcludeShipToLocation to exclude certain countries within that region to where you will not ship (such as Afghanistan). Note: To create a listing that is 'Local Pickup only' (buyer picks up, with no shipping/delivery available), the user does the following two things: <ul> <li>Either omit the entire ShippingDetails container, or pass in an empty ShippingDetails container - <ShippingDetails/> </li> <li>Pass in one ShipToLocations field, with its value set to <code>None</code> - <ShipToLocations>None</ShipToLocations></li> </ul> ShippingRegionCodeType, CountryCodeType AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Specifying Locations to Where You Ship https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Shipping-Locations.html#ShipToLocation GeteBayDetails The name of the eBay listing site. The listing site affects the business logic and validation rules that are applied to the request, which in turn affect the values that are returned in the response, as well as values that appear on the eBay site. For example, the listing site can affect the validation of Category in listing requests, international business seller requirements, the values of converted (localized) prices in responses, the item-related time stamps that are displayed on the eBay site, the visibility of the item in some types of searches (e.g., GetCategoryListings), and other information. In some cases, the rules are determined by a combination of the site, the user's registration address, and other information. You cannot change the site when you revise a listing. When you specify Item.Site in AddItem or AddFixedPriceItem, it must be consistent with the numeric site ID that you specify in the request URL (for the SOAP API) or the X-EBAY-API-SITEID header (for the XML API). AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetDispute Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetCategoryListings Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetMyeBayBuying BestOfferList BidList LostList SecondChanceOffer WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling BidList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally The original price of the item at listing or re-listing time. If this value changes when the item is revised, the new value becomes the original price. For auction listings: Competitive bidding starts at this value. Once at least one bid has been placed, StartPrice remains the same but CurrentPrice is incremented to the amount of each succeeding bid. If ReservePrice is also specified, the value of StartPrice must be lower than the value of ReservePrice. For input on fixed-price listings (FixedPriceItem): This is the constant price at which a buyer may purchase the item. GetMyeBaySelling does not return Item.StartPrice for fixed price items—it returns Item.SellingStatus.CurrentPrice. For AddFixedPriceItem and VerifyAddFixedPriceItem: Required when no variations are specified. If variations are specified, use Variation.StartPrice for each variation instead. For Revise calls: If the StartPrice value for a fixed-price item is changed with a Revise call, the MinimumBestOfferPrice and BestOfferAutoAcceptPrice fields in the ListingDetails container will be dropped (if set), basically turning off the Best Offer Auto Accept and/or Auto Decline features. If the seller wanted to reintroduce either of these Best Offer threshold values in the listing again, an additional Revise call would have to be made, passing in the desired threshold values. Note: For the US site, new eBay sellers are subject to <a href="/DevZone/guides/features-guide/default.html#development/Listing-Policies.html#SellerLimits">Seller Limits</a>, which limit the quantity of items that may be listed and/or the total cumulative value of these listings. While subject to these selling limits, an eBay seller can use the GetMyeBaySelling call to retrieve both the remaining number of listings they can create and the remaining cumulative value of these listings. These values are shown in the Summary.QuantityLimitRemaining and Summary.AmountLimitRemaining fields in the GetMyeBaySelling response. If a call to add an item or revise an item would result in the exceeding of these limits, the add item or revise item call will fail. These fields will only be returned if the seller is subject to seller limits. Listing Policies https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listing-Policies.html#SellerLimits AddFixedPriceItem AddItem AddItems RelistFixedPriceItem ReviseFixedPriceItem VerifyAddFixedPriceItem VerifyAddItem Yes ReviseItem RelistItem VerifyRelistItem No GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetMyeBayBuying BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally This container provides details about the seller's eBay store. In an Add/Revise/Relist call, the seller can include this container to set/change which customized eBay store category that the item will be placed in. For 'Get' calls, this container is returned if the seller of the item has an eBay store. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Subtitle to use in addition to the title. Provides more keywords when buyers search in titles and descriptions. You cannot use HTML in the Subtitle. (HTML characters will be interpreted literally as plain text.) If you pass any value, this feature is applied (with applicable fees). When you revise a item, you can add, change, or remove the subtitle. 55 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetCategoryListings Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBayBuying BestOfferList BidList LostList SecondChanceOffer WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally Removing/Changing a Field When Relisting an Item https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listings-RelistingItems.html#RemovingaFieldWhenRelistinganItem (RelistItem) DeletedField RelistItem.html#Request.DeletedField Specifying a Subtitle for a Motors Vehicle Listing https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Sites-eBayMotors.html#SpecifyingaSubtitleforaMotorsVehicleList Time left before the listing ends. The duration is represented in the ISO 8601 duration format (PnYnMnDTnHnMnS). See Data Types in the Trading API Guide for information about this format. For ended listings, the time left is PT0S (zero seconds). GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetMyeBayBuying BestOfferList BidList SecondChanceOffer WatchList Conditionally

DetailLevel: none, ReturnAll

GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally This field is used to specify the title of the listing. This field is conditionally required in an Add call unless the seller successfully uses the ProductListingDetails container to find an eBay catalog product match. When the seller successfully uses an eBay catalog product to create a listing, the listing title, listing description, Item Specifics, and stock photo defined in the catalog product are used to create the listing. You cannot use HTML or JavaScript in the Title. (HTML characters will be interpreted literally as plain text.) The listing title can only be changed if the active listing has yet to have any bids or sales, and the listing does not end within 12 hours. 80 AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally RelistItem ReviseItem RelistFixedPriceItem ReviseFixedPriceItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetCategoryListings GetItemsAwaitingFeedback GetMemberMessages Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetMyeBayBuying BestOfferList BidList LostList SecondChanceOffer WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList BidList

DetailLevel: none, ReturnAll

Conditionally GetBidderList GetDispute Always GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally Use an UUID value to ensure that you only list (or relist) a particular item once. This field can be particularly useful if you are listing many items on a daily basis and/or many items at once with an AddItems call. If your call request does not generate a response, or if you get one or more (blocking) errors, be sure to use the same UUID value when you attempt to list or relist the same item with another call request. If you pass in a UUID value that has already been used to successfully create or relist an item, you will receive an error message that includes the Item ID for that listing and a boolean value indicating whether the duplicate UUID was sent by the same application. We recommend that you use the Item.UUID field for add and relist calls (for example, AddItem and RelistItem), but use the Item.InvocationID field instead when using a revise call. The UUID can only contain digits from 0-9 and letters from A-F and must be 32 characters long. The UUID value must be unique across all of the seller's eBay across all eBay marketplaces. 32 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This container is used in an Add/Revise/Relist call to set the VAT (Value-added Tax) percentage rate that will be charged to buyers when an item is purchased from the listing, and to enable Business Seller-related features. This container is returned in 'Get' calls only if VAT is applicable to the listing, and unless the person making the 'Get' call owns the listing, only the VATPercent field is returned (if applicable). However, Business Seller-related information will be returned to all users in 'Get' calls under the SellerInfo and BusinessSellerDetails containers. Note: VAT is not applicable to all countries, including the US. Allowed VAT percentage rates can vary by region/country, so sellers should be aware of the rates they are legally required/allowed to charge. Sellers must be registered as Business Sellers on the site they are selling on in order to use the Business Seller-related fields. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Working with Business Features and VAT https://developer.ebay.com/devzone/guides/features-guide/default.html#development/Sites-IntlDiffsVATB2B.html Business Feature Field Differences https://developer.ebay.com/devzone/guides/features-guide/default.html#development/IntlDiffs-B2BFields.html This field is returned if the seller of the item is currently on vacation and that seller has turned on the Store vacation setting, and has included a message to display to shoppers who visit the eBay store. If the seller turns on the Store vacation setting, the listing will be hidden from search result pages. Store vacation settings, including this note, are set through the Messages tab in My eBay, or this message can also be set through the SetStorePreferences call. The Store vacation setting is only applicable for sellers with eBay stores. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents

DetailLevel: ReturnAll

Conditionally The number of watches placed on this item from buyers' My eBay accounts. Specify IncludeWatchCount as <code>true</code> in the request. Returned by GetMyeBaySelling only if greater than 0. GetSellerEvents

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBaySelling Conditionally This value indicates the number of page views that a listing has received in the last 30 days. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally If <code>true</code>, all buyer requirements (from Item.BuyerRequirementDetails or Buyer requirements preferences in My eBay) are ignored. If <code>false</code> (or omitted): Item.BuyerRequirementDetails or Buyer requirements preferences are used, with Item.BuyerRequirementDetails having the higher precedence. false AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally For Add/Revise/Relist/Verify calls: This container is used to enable the Best Offer feature on a listing. Note that the Best Offer feature can be set for auction listings on the US, Canada, UK, Germany, Australia, France, Italy, and Spain marketplaces, but a seller can only use Best Offer or Buy It Now, but not both. Once an auction listing receives a qualifying bid, the Best Offer feature will be turned off and any pending Best Offers or Counteroffers will no longer be valid. For GetItem and other calls that retrieve item data, this container will include the status (GetMyeBayBuying only) and dollar amount of the latest Best Offer on a fixed-price listing, and the number of Best Offers received for the fixed-price listing. AddFixedPriceItem AddItem AddItems RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying BestOfferList Conditionally

DetailLevel: none, ReturnAll

GetMyeBaySelling ActiveList Conditionally

DetailLevel: none, ReturnAll

If <code>true</code>, eBay provided a central location as a result of the user not specifying a location. This typically occurs when the seller specifies PostalCode without Location. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Indicates whether the seller's tax table is to be used when applying and calculating sales tax for an order line item. A sales tax table can be created programmatically using the SetTaxTable call of Trading API or the <a href="https://developer.ebay.com/api-docs/sell/account/resources/sales_tax/methods/createOrReplaceSalesTax">createOrReplaceSalesTax</a> method of Account API. If UseTaxTable is set to <code>true</code>, the values contained in the seller's sales tax table will supersede the values contained in the Item.ShippingDetails.SalesTax container (if included in the request). Note: As of November 2021, buyers in all US states except for Missouri (and several US territories), will automatically be charged sales tax for purchases, and the seller does not set this rate. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. For more US state-level information on sales tax, see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/taxes-import-charges?id=4121#section4" target="_blank">eBay sales tax collection</a> help topic. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No Enabling Multi-jurisdiction Sales Tax https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Feature-SalesTax.html This field is deprecated. Applicable for listings in vehicle categories on the US eBay Motors site and eBay Canada site. (No business effect if specified for other categories or sites, as the Web site will not display the information to buyers.) <ul> <li>If <code>true</code>, the buyer is responsible for vehicle pickup or shipping. </li> <li>If <code>false</code>, specify vehicle shipping arrangements in the item description. (The description can also include vehicle shipping arrangements when this value is <code>true</code>.) </li> </ul> If the item has bids or ends within 12 hours, you cannot modify this flag. Do not specify ShippingDetails.ShippingServiceOptions for vehicle listings. If <code>true</code> and the listing is on the US eBay Motors site, and you want the listing to be visible on the eBay Canada site, set Item.ShipToLocations to CA. If <code>true</code> and the listing is on the eBay Canada site, and you want your listing to be visible on the US eBay Motors site, set Item.ShipToLocations to US. true AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This field is deprecated. 675 NoOp 759 Returns a note from eBay displayed below items in the user's My eBay account. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList UnsoldList Conditionally

DetailLevel: none, ReturnAll

Specifies the number of questions buyers have posted about the item. Returned only if greater than 0. GetMyeBaySelling Conditionally This boolean field is returned as <code>true</code> if the item in this listing was relisted. When an item is relisted, a brand new Item ID value is automatically created by eBay. This field is only returned for an original listing whose item has been relisted, so a <code>false</code> value should never get returned. Note: A new listing will not return this field. GetMyeBaySelling Conditionally UnsoldList This integer value indicates the quantity of an item that is still available for purchase in a multiple-quantity, fixed-price listing. This field is not applicable to auction listings. GetMyeBayBuying WatchList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList

DetailLevel: none, ReturnAll

Conditionally A SKU (Stock Keeping Unit) value is a seller-defined identifier for a product. Each product within a seller's inventory should be unique. Most large-volume sellers use SKUs, but eBay only requires a SKU value if the InventoryTrackingMethod field is included in an AddFixedPriceItem call and its value is set to <code>SKU</code>. Setting the InventoryTrackingMethod field to <code>SKU</code> allows the seller to use a SKU value instead of an ItemID value as a unique identifier in calls such as GetItem and ReviseInventoryStatus A seller can specify a SKU when listing an item with AddItem and related calls. eBay preserves the SKU on the item, enabling you to obtain it before and after an order line item is created. (SKU is recommended as an alternative to ApplicationData.) If both ItemID and SKU are specified in calls that support the use of SKU as a unique identifier, the ItemID value takes precedence. If a seller wants to use SKUs for multiple-variation listings, the SKU value for each product variation is actually specified at the variation level (Item.Variations.Variation.SKU) field, and the Item.SKU) field should not be included in the call request. Note: The eBay site cannot identify listings by SKU. For example, My eBay pages and Search pages all identify listings by item ID. When a buyer contacts you via eBay's messaging functionality, eBay uses the item ID as the identifier. Buyer-focused APIs (like the Shopping API) also do not support SKU as an identifier. For revising and relisting only: To remove a SKU when you revise or relist an item, use DeletedField. (You cannot remove a SKU when Item.InventoryTrackingMethod is set to SKU.) For GetItem, GetMyeBaySelling, and other 'Get' call, the SKU value will only be returned if defined for the listing. 50 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBaySelling Conditionally eBay Merchant Data API AddFixedPriceItem and ReviseFixedPriceItem https://developer.ebay.com/DevZone/merchant-data/CallRef/index.html This field is deprecated. Postal code of the place where the item is located. This value is used for proximity searches. To remove this value when revising or relisting an item, use DeletedField. If you do not specify PostalCode, you must specify Item.Location. If you specify PostalCode, but do not specify Item.Location, then Item.Location is given a default value derived from the postal code. Note: As of late January 2020, the displayed postal code returned in GetItem is now masked to all users except for the seller of the item. Different countries will mask postal/zip codes in slightly different ways, but an example would be <code>951**</code>. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always This container consists of the data associated with photos within the listing. With most eBay sites and categories, a seller can add up to 12 photos to their listings free of charge. These photos can be hosted by eBay Picture Services (EPS), or the seller can host pictures on a non-eBay server. If pictures are externally-hosted, they must be hosted on a site that is using the 'https' protocol. It is required that all listings have at least one picture. eBay Motors listings can have up to 24 pictures. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList GetCategoryListings Conditionally GetMyeBayBuying BestOfferList BidList SecondChanceOffer WatchList LostList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none,ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList BidList

DetailLevel: none, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Introduction to Pictures in Item Listings https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Pictures-Intro.html Adding photos to your listing https://pages.ebay.com/help/sell/pictures.html This container is used if the seller wants to add a video to their listing. At this time, only one video can be added per listing. The video can be uploaded to eBay using the <a href="https://developer.ebay.com/api-docs/commerce/media/overview.html" target="_blank">Media API</a>. See the <a href="https://developer.ebay.com/api-docs/commerce/media/overview.html" target="_blank">Media API</a> reference documentation for all of the necessary details to upload videos to eBay. This container will only be returned in GetItem if the listing contains a video, and the seller of the item is the one making the GetItem call. Note: Videos can only be attached to listings on supported eBay marketplaces and can only be viewed through supported platforms. See <a href="https://developer.ebay.com/api-docs/sell/static/inventory/managing-video-media.html#AddingVideos" target="_blank">Managing videos</a> in the Selling Integration Guide for a full list of supported marketplaces and platforms. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem Conditionally This container provides IDs for the producer or importer related to the new item, packaging, added documentation, or an eco participation fee. In some markets, such as in France, this may be the importer of the item. For more information, see the Extended Producer Responsibility for business sellers page for your site (for example, <a href="https://www.ebay.com/help/selling/all-about-selling/selling-internationally/extended-producer-responsibility-for-business-sellers?id=5314" target="_blank">https://www.ebay.com/help/selling/all-about-selling/selling-internationally/extended-producer-responsibility-for-business-sellers?id=5314</a>). This field is supported by a limited number of sites and specific categories. Use the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getExtendedProducerResponsibilityPolicies" target="_blank">getExtendedProducerResponsibilityPolicies</a> method of the Sell Metadata API to retrieve valid categories for a site. For GetItem calls, this container is only returned to the listing owner, if the container is available. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This container is used to apply one or more custom policies to the listing by specifying custom policy IDs. Custom policies include Product Compliance and Take-Back Policies. For more information, see the Custom Policies page for your site (for example, <a href="https://www.ebay.fr/help/selling/custom-policies/custom-policies?id=5311" target="_blank">https://www.ebay.fr/help/selling/custom-policies/custom-policies?id=5311</a>). This container is supported by a limited number of sites and specific categories. Use the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getExtendedProducerResponsibilityPolicies" target="_blank">getExtendedProducerResponsibilityPolicies</a> method of the Sell Metadata API to retrieve valid categories for a site. To create and manage custom policies, use the <a href="https://developer.ebay.com/api-docs/sell/account/resources/methods#h2-custom_policy" target="_blank">custom_policy</a> resource of the Account API. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No Specifies the maximum number of business days the seller commits to for preparing an item to be shipped after receiving a cleared payment. This time does not include the shipping time (the carrier's transit time). Note: If the seller opts into the eBay Guaranteed Delivery feature and wants to make a listing eligible for eBay Guaranteed Delivery, the DispatchTimeMax value must be set to <code>0</code> or <code>1</code> (days) and the cumulative value of DispatchTimeMax plus the transit time of the shipping service (returned in ShippingServiceDetails.ShippingTimeMax field of GeteBayDetails) must be 4 business days or less to be eligible for this feature. See the <a href="https://pages.ebay.com/seller-center/shipping/ebay-guaranteed-delivery.html" target="_blank">eBay Guaranteed Delivery</a> page in Seller Center for more information on this program. The eBay Guaranteed Delivery feature is only available on the US and Australia marketplaces. For Add/Revise/Relist calls: Required for listings in certain categories when certain shipping services (with delivery) are offered. See HandlingTimeEnabled in GetCategoryFeatures. The seller sets this to a positive integer value corresponding to the number of 'handling' days. For a list of allowed values on each eBay site, use DispatchTimeMaxDetails in GeteBayDetails. Supported handling times for most sites in most categories range from 0 (same-day handling) to 3 business days, but this can vary by site. Some categories on some sites support longer handling times, and this generally comes into play with extremely large items where freight shipping may be required. This field is required whenever flat-rate or calculated shipping is used, but does not apply when there is no shipping involved, which is the case for digital gift card listings, or any orders where local pickup is available and this option is selected by the buyer. For ReviseItem only: If the listing has bids or sales and it ends within 12 hours, you can't change this value. If the listing is a GTC listing that has sales or ends within 12 hours (one or the other, but not both), you can add or change this value. If the listing has no bids or sales and more than 12 hours remain before the listing ends, you can add or change the dispatch (handling) time. For GetItem: GetItem returns DispatchTimeMax only when shipping service options are specified for the item and the seller specified a dispatch time. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Handling Time and Estimated Delivery Time https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Shipping-Services.html#HandlingTimeandEstimatedDeliveryTime (GetCategoryFeatures) Category.HandlingTimeEnabled categories that support handling times GetCategoryFeatures.html#Response.Category.HandlingTimeEnabled This field is deprecated. This information is returned in BestOfferDetails. This field is deprecated. This container is used by sellers of Classified Ad listings to provide contact information. Classified Ad Listings https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Specialty-ClassifiedAds.html AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally The number of questions asked about this item. Applies to eBay Motors Pro applications only. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Some listings on the eBay platform originate from eBay affiliates. Depending on the relationship the affiliate has with eBay, there are times when the affiliate retains ownership of the listing. When this occurs the representation of the listing on eBay is considered a proxy item. Proxy items can only be edited using API requests from the applications that originally listed them. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Extended contact information for sellers using the Classified Ad format. Specifies the days and hours when the seller can be contacted. To remove seller contact information when revising or relisting an item, use DeletedField. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Specifies the number of leads (emails) buyers have posted about the item. You must be the seller of the item to retrieve the lead count. GetMyeBaySelling ActiveList UnsoldList

DetailLevel: none, ReturnAll

Conditionally Specifies the number of new leads (unanswered emails) buyers have posted about the item. GetMyeBaySelling ActiveList

DetailLevel: none, ReturnAll

Conditionally This container is a list of Item Specific Name/Value pairs used by the seller to provide desciptive details of an item in a structured manner. If creating, revising, or relisting an item with an Add, Revise, or Relist call, it is recommended that you use the <a href="/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API to retrieve mandatory and recommended Item Specifics for a category. For ReviseItem only: When you revise a listing, if an auction listing has one or more bids and ends within 12 hours, you cannot change or add Item Ppecifics. If the auction listing has bids but ends in more than 12 hours, you cannot change existing Item Specifics, but you can add Item Specifics that were not previously included. If your listing is in a eBay product catalog-enabled category, certain Name/Value pairs will be accepted as product identifying information. The Name can be <code>Brand</code>, <code>MPN</code>, or a Global Trade Item Number (GTIN). GTINs are a set of globally recognized identifiers, including <code>EAN</code>, <code>ISBN</code>, and <code>UPC</code>. However, the Values provided for these Names must comply with eBay's constraints or they will not be recognized as product identifiers. The Value for Brand must be an actual brand name (except that if the item is not branded, Value can be <code>Unbranded</code>.) The Value for Brand or MPN cannot contain only special characters (e.g. <code>%$*#@</code>). All GTINs must comply with international formatting standards. For more details, see <a href="https://developer.ebay.com/devzone/guides/features-guide/default.html#development/ItemSpecifics-Listing.html" target="_blank">Listing with Item Specifics</a>. If the ProductListingDetails container in an Add/Revise/Relist call is successfully used to find and use an eBay catalog product to create/revise listing, the seller should not remove or change the value of any Item Specific name or value that is defined as part of the eBay catalog product definition. Note: If a listing is associated with an eBay catalog product, the seller does not need to pass in any Item Specifics that are already defined in the eBay catalog product. Sellers can make a call to the <a href="/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API to see if the category supports any 'instance aspects', which can be thought of as Item Specifics that are unique to the specific item that is being listed. Instance aspects are indicated if the corresponding <a href="/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory#response.aspects.aspectConstraint.aspectApplicableTo" target="_blank">aspectApplicableTo</a> field of the getItemAspectsForCategory response shows a value of <code>ITEM</code> (and not <code>PRODUCT</code>). Many categories support the following instance aspects: Custom Bundle, Bundle Description, Modified Item, Modification Description, and California Prop 65 Warning. These instance aspects allow the seller to provide more information about product bundles or modified products in a structured way. Depending on the category, there are other instance aspects as well. Note: To specify an item's condition, use the ConditionID field instead of a condition Item Specific. Use GetCategoryFeatures to see which categories support ConditionID and to get a list of valid condition IDs. (If you specify ConditionID and you also specify Condition as a Item Specific, eBay drops the condition Item Specific.) For GetItem: This list is returned only when you specify IncludeItemSpecifics in the request (and the seller included Item Specifics in their listing). To delete all Item Specifics when you revise or relist, specify Item.ItemSpecifics in DeletedField, and don't pass ItemSpecifics in the request. Working with Item Specifics https://developer.ebay.com/Devzone/guides/features-guide/default.html#development/ItemSpecifics.html AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This field is deprecated. The email and phone lead fee for a pay-per-lead item. GetMyeBaySelling Conditionally

DetailLevel: ReturnAll

This field is deprecated. Different Buyer protection schemes and the various status associated with each one of them. GetItem Conditionally Indicates a specific type of lead generation format listing, such as classified ad or local market best offer listing. Only applicable when ListingType = LeadGeneration. Note: ListingSubtype2 replaces the deprecated ListingSubtype field. If both are specified in a request, ListingSubtype2 takes precedence. About Local Market Listings https://pages.ebay.com/help/sell/motors-selling-locally.html Advertising with Classified Ads https://pages.ebay.com/help/sell/f-ad.html AddItem AddItems RelistItem ReviseItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Indicates whether the seller allows the bidder to request mechanical inspection services from RAC. For the Car category listings on the UK site. false GetItem Conditionally Specifies whether the following Business Seller fields have been updated for the item specified in the request: First Name, Last Name, Fax, Email Address, Additional Contact Information, Trade Registration Number, VAT Identification Number. ReviseItem No Specifies whether the Return Policy Details have been updated for the item specified in the request. ReviseItem No Specifies the details of policy violations if the item was administratively canceled. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem Conditionally This field is used by sellers who want their listing to be returned in the search results for other eBay sites. This feature is currently only supported by the US, UK, eBay Canada, and eBay Ireland sites. See <a href=" https://pages.ebay.com/help/sell/globalexposure.html">Getting exposure on international sites</a> for full requirements on using this feature. There is a small listing fee for each country specified as a Cross Border Trade country. US listings that offer shipping to Canada, North America, or worldwide are automatically returned on eBay.ca at no extra charge, so US listings that offer shipping to these locations do not need to specify Canada as a Cross Border Trade country. Making Listings Available by Default on Another Site https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Feature-MultipleSiteListing.html AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always Returns the seller's information (in a business card format) if the seller's SellerBusinessCodeType is set to <code>Commercial</code>. This is only applicable for sites where Business Seller options are supported. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

The eBay Best Price Guarantee price. The <a href=" https://pages.ebay.com.au/buy/Best_Price_Guarantee/">Best Price Guarantee</a> program is only available on the eBay Australia marketplace. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally When this container is present in an AddItem or AddFixedPriceItem call, all buyer requirements for the resulting listing are set by this container. Furthermore, individual buyer requirements cannot be modified or added when including this container in a ReviseItem call. The ReviseItem call needs to provide the entire set of buyer requirements to modify or add any of the requirements. Unless otherwise specified, most buyer requirements are only returned if the caller is the seller. Any and all My eBay account-level Buyer Requirements are overridden by the contents of this container. This means that buyer requirements set in My eBay cannot be combined with buyer requirements included in this container. AddFixedPriceItem AddItem AddItems RelistItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Setting Buyer Requirements (eBay help) https://pages.ebay.com/help/sell/buyer-requirements.html Describes the seller's return policy. Most categories on most eBay sites require the seller to clearly specify whether or not returns are accepted (see ReturnsAcceptedOption). Note: If you are using a return business policy set up through My eBay or via the <a href="https://developer.ebay.com/api-docs/sell/account/resources/return_policy/methods/createReturnPolicy">Account API</a>, then you should not populate the fields in this ReturnPolicy container. Instead, indicate your return policy using the SellerProfiles.SellerReturnProfile container. However, if you do not configure a return policy, all the fields in this ReturnPolicy container that are marked conditional must be populated in your request. For the AddItem family of calls: Required for most categories on most sites. Use ReturnPolicyEnabled in GetCategoryFeatures to determine which categories require this field. Also use ReturnPolicyDetails in GeteBayDetails to determine which ReturnPolicy fields can be used on each site. Australia (AU) and US eBay Motors Parts and Accessories categories typically support but do not require a return policy. (However, we strongly recommend that you specify a clear return policy whenever possible.) For ReviseItem only: If the listing has bids or sales and it ends within 12 hours, you can't change the return policy details. If the listing is a GTC listing that has sales or ends within 12 hours (one or the other, but not both), you can add a return policy to the GTC listing (but you can't change return policy details if already present). If the listing has no bids or sales and more than 12 hours remain before the listing ends, you can add or change the return policy. When you revise your return policy, you only need to specify the fields you want to add or change. You don't need to specify all the other ReturnPolicy fields again. The other fields will retain their existing settings. For the GetItem family of calls: Only returned if the site you sent the request to supports the seller's return policy. Typically, the return policy details are only returned when the request is sent to the listing site. Note: The GeteBayDetails call can be used to retrieve site-wide return policy metadata, but it is recommended that sellers use the GetCategoryFeatures call instead, as this call was recently updated to retrieve category-level metadata for both domestic and international return policies. Note: In May 2018, eBay added the ability to create a separate international return policy for items that are shipped to international customers. If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead for international returns. For more information on setting separate domestic and international return policies, see the <a href="https://pages.ebay.com/seller-center/seller-updates/2018-summer/simplified-returns.html#international-returns-policy" target="_blank">International returns policy</a> help topic. For the international equivalent of this field, see the InternationalRefundMethodValues field. AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Offering a Clear Return Policy https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Feature-ReturnPolicy.html Enables you to view the sites on which an item can be purchased, based on the payment methods offered for the item. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always Indicates whether you prefer to track your eBay listings by eBay Item ID or by your own SKU. If a seller will be converting an existing eBay listing into the new Inventory model using the bulkMigrateListings call of the Inventory API, the InventoryTrackingMethod value must be set to <code>ItemID</code> (default value), but the item must also have a SKU value (Item.SKU or Variation.SKU) associated with it. For GetItem and related calls: Only returned when the value is <code>SKU</code>; not returned when the value is <code>ItemID</code>. AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem No ItemID GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally eBay Merchant Data API AddFixedPriceItem and ReviseFixedPriceItem https://developer.ebay.com/DevZone/merchant-data/CallRef/index.html This field is no longer applicable as eBay sellers can no longer use iMCC gateway accounts to handle buyer payments. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItems Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Variations are multiple similar (but not identical) items in a single fixed-price listing. For example, a T-shirt listing could contain multiple items of the same brand that vary by color and size (like "Blue, Large" and "Black, Medium"). Each variation specifies a combination of one of these colors and sizes. Each variation can have a different quantity and price. You can buy multiple items from one variation at the same time. (That is, one order line item can contain multiple items from a single variation.) If you list in two categories, both categories must support listing with variations. See VariationsEnabled in GetCategoryFeatures to determine applicable categories. For ReviseFixedPriceItem and RelistFixedPriceItem: Once a listing has been submitted with variations, you can't delete all the variations when you revise or relist the listing (because it would be considered a different listing). You also can't add or change variation specifics (because they are unique identifiers). However, you can delete or replace individual variations as needed to match your current inventory. If a variation has no purchases, use the Variation.Delete field to delete the variation. If it has inventory, set the Quantity to 0. As a best practice, if you want to revise multiple variations in the same listing at the same time (i.e., within a very short period), use a single ReviseFixedPriceItem request and include all the variation revisions in the same request. If your application design requires you to revise each variation individually, then avoid using multiple parallel threads. Instead, use a serial, synchronous process. That is, wait until each revision has been processed by eBay before submitting the next revision request for another variation in the same listing. For GetItem and related calls Only returned when a listing has variations. For GetSellerList: Only returned when a listing has variations, IncludeVariations was set to <code>true</code> in the request, the DetailLevel was set to ReturnAll, and an applicable pagination value and time range were specified. For GetItemTransactions Only returned in Item when a listing has variations and IncludeVariations was set to <code>true</code> in the request. (Also see Variation returned in Transaction for information about which variation was actually purchased.) For GetSellerEvents, GetMyeBayBuying, and GetMyeBaySelling: Only returned when a listing has variations and HideVariations was set to <code>false</code> or not specified in the request. Multi-Variation Listings https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Variations.html AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem No Qualifications for Listing with Variations https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Variations.html#QualificationsforListingwithVariations GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList DeletedFromSoldList DeletedFromUnsoldList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally A list of parts compatibility information specified as name and value pairs. Describes an assembly with which a part is compatible (i.e., compatibility by application). For example, to specify a part's compatibility with a vehicle, the name (search name) would map to standard vehicle characteristics (e.g., Year, Make, Model, Trim, and Engine). The values would describe the specific vehicle, such as a 2006 Honda Accord. Use the Product Metadata API to retrieve valid search names and corresponding values. For the AddItem family of calls: Use this for specifying parts compatibility by application manually. This can only be used in categories that support parts compatibility by application. Use GetCategoryFeatures with the CompatibilityEnabled feature ID to determine which categories support parts compatibility by application. For ReviseFixedPriceItem and ReviseItem: When you revise a listing, if the listing has bids and/or ends within 12 hours, item compatibilities cannot be deleted. You may add item compatibilities at any time. For GetItem: ItemCompatibilityList is only returned if the seller included item compatibility in the listing and IncludeItemCompatibilityList is set to <code>true</code> in the GetItem request. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No Product Metadata API Call Reference https://developer.ebay.com/DevZone/product-metadata/CallRef/index.html information on retrieving compatibility search names and corresponding values needed to specify compatibility by application manually Listing Items with Parts Compatibility https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/CompatibleParts.html GetItem Conditionally Indicates the number of compatible applications specified for the given item. Applies to items listed with fitment by application only (either manually or with a catalog product that supports compatibility). Not returned if the item has no specified compatible applications. Not returned if IncludeItemCompatibilityList is specified in the request. To retrieve the list of compatibility information, set IncludeItemCompatibilityList to <code>true</code> in the request. Parts Compatibility is supported in limited Parts & Accessories categories for the eBay Motors (US) site (site ID 100) only. GetItem Conditionally This is a numeric identifier for an item's condition. All numeric Condition ID values map to an item condition string value. For example, numeric identifer <code>1000</code> maps to <code>New</code> condition. Most eBay listing categories require an item condition, but a few eBay categories do not (such as Digital Gift Cards or Antiques categories). To verify if the listing category requires an item condition, and if so, what are the supported item condition and ConditionID values, you can call GetCategoryFeatures. In this GetCategoryFeatures call, you'd pass in the listing CategoryID value and two FeatureID fields - one of these fields set to <code>ConditionEnabled</code>, and the other field set to <code>ConditionValues</code>. In the GetCategoryFeatures response, look at the Category.ConditionEnabled to see if item condition is required for the category. Then look at the Category.ConditionValues container in the response for the full list of Condition IDs that you can pass in through the ConditionID field of an Add/Revise/Relist/Verify call. Note that the Condition.DisplayName value in the response is the actual condition value that will appear in the actual eBay listing. If you pass in a ConditionID value that is not valid for the category, or if you don't pass in a ConditionID value at all for a category that requires it, the listing request fails. If you are listing in two categories (using a secondary category), it is the primary listing category that determines which ConditionID values are supported. For Revise/Relist calls: In most cases, you can change the ConditionID value (if applicable/warranted), with the exception being an auction listing that has one or more bids, or any listing that is scheduled to end in 12 hours or less. For GetItem: The ConditionID value is always returned if set for the listing. GetItem also returns the item condition string value in the ConditionDisplayName field. Note: As of February 2022, in the US, Canada, UK, Germany, France, Italy, and Australia marketplaces, condition ID 2500 ('Seller Refurbished') can no longer be used In the following categories: Cell Phones & Smartphones (category ID 9355); Smart Watches (category ID 178893); and Tablets & eBook Readers (category ID 171485). In these three categories, the 'Seller Refurbished' item condition has been replaced by one of three new refurbished values, which include condition ID 2010 ('Excellent - Refurbished'), condition ID 2020 ('Very Good - Refurbished'), and condition ID 2030 ('Good - Refurbished'). To use any of these new refurbished item conditions in category 9355, in category 178893, or in category 171485, sellers must go through an application and qualification process. Any seller who is not eligible to use these new refurbished item conditions in these three categories will be blocked if they try to create a new listing or revise an existing listing with any of these three new item conditions. Any active listings in these three categories that had condition ID 2500 ('Seller Refurbished') as the item condition should have been administratively ended by eBay. Sellers will have to relist these items, and until they are eligible to list with the new refurbished item conditions, they will need to use another item condition supported in these categories, such as condition ID 3000 ('Used'). Any seller that is interested in eligibility requirements to list with any refurbished item condition, including condition ID 2000 ('Certified - Refurbished'), should see the <a href="https://pages.ebay.com/seller-center/listing-and-marketing/ebay-refurbished-program.html" target="_blank">eBay Refurbished Program</a> page in Seller Center. Specifying an Item's Condition https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Desc-ItemCondition.html ConditionValues in GetCategoryFeatures GetCategoryFeatures.html#Response.Category.ConditionValues Item Condition Look-up Table (and Automatic Mapping) https://pages.ebay.com/sellerinformation/news/itemconditionlookup.html AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

ItemSpecifics #Response.Item.ItemSpecifics This string field is used by the seller to more clearly describe the condition of items that are not brand new. The ConditionDescription field is available for all categories, including categories where the condition type is not applicable (e.g., Antiques). This field is applicable for all item conditions except 'New', 'Brand New', 'New with tags', and 'New in box'. If ConditionDescription is used with these conditions (Condition IDs 1000-1499), eBay will simply ignore this field if included, and eBay will return a warning message to the user. The ConditionDescription field is returned by GetItem (and other related calls that return the Item object) if a condition description is specified in the listing. 1000 AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyRelistItem Conditionally GetSellerList Conditionally

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Fine, Medium

The human-readable label for the item condition. Display names are localized for the site on which they're listed (not necessarily the site on which they're viewed). Most categories use the same display name for the same condition ID. Some categories may override the display name based on buyer expectations for items in the category. For example, condition ID 1000 could be called "New" in one category and "New with tags" in another. Behind the scenes, eBay's search engine uses the ID (not the display name) to determine whether items are new, used, or refurbished. Only returned when the seller specified ConditionID in their listing. 50 GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Tax exception category code. This is to be used only by sellers who have opted into sales tax being calculated by a sales tax calculation vendor. If you are interested in becoming a tax calculation vendor partner with eBay, contact developer-relations@ebay.com. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem Conditionally GetItem

DetailLevel: ReturnAll

Conditionally Indicates the type of message that will be returned describing the quantity available for the item. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally The quantity threshold above which the seller prefers not to show the actual quantity available. Returned when the quantity available is greater than the value of quantity threshold. Currently, 10 is the only available value for this threshold. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally This container provides information for an item that has a Strikethrough Price (STP) or a Minimum Advertised Price (MAP) discount pricing treatment. STP and MAP apply only to fixed-price listings. STP is available on the US, eBay Motors, UK, Germany, Canada (English and French), France, Italy, Spain, and Ireland sites, while MAP is available only on the US site. Discount pricing is available to qualified sellers (and their associated developers) who participate in the Discount Pricing Program. Once qualified, sellers receive a 'special account flag' (SAF) that allows them to apply Discount Pricing to both single-variation and multi-variation items. STP is intended for eBay partners and their sellers only. As a seller listing Discount Price items, you are required to maintain records of your discount pricing in the event you are called upon to substantiate your item pricing. For AddFixedPriceItem, RelistFixedPriceItem, ReviseFixedPriceItem, and VerifyAddFixedPriceItem: If you are listing variations (MSKU items), use Variation.DiscountPriceInfo for each variation. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem No AddItem ReviseItem RelistItem VerifyAddItem VerifyRelistItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally A descriptive free-text title for a US or CA eBay Motors vehicle listing. This title appears below eBay's pre-filled listing title on the View Item page (not at the top of the View Item page). It's also appended to the listing title in search results (like a subtitle) on the US eBay Motors site. Keywords in this title help buyers find or distinguish your listing. Applicable to listings in US eBay Motors Cars and Trucks, Motorcycle, and some of the Powersport, Boats and RV campers categories; or to Cars and Trucks listings on CA eBay Motors. This replaces the older US and Canada eBay Motors Subtitle attribute (attribute ID 4148). 80 AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No This field displays the Vehicle Identification Number, which is a unique serial number for a motor vehicle. This field is applicable to listings in US eBay Motors Cars and Trucks (6001), Motorcycles (6024), Commercial Trucks (63732), RVs and Campers (50054), ATVs (6723), Snowmobiles (42595), and UTVs (173665); and to Cars and Trucks listings in CA, CAFR and AU eBay Motors. For vehicle categories that do not use VIN, make a call to the <a href="/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API to determine applicable Item Specifics (such as 'Hull ID Number' for Boats). For the US, CA, and CA-FR eBay Motors categories, required for cars and trucks from model year 1981 and later. (The US developed national standards for VIN values in 1981.) For the eBay Australia site, required for vehicles from model year 1989 or later. For the eBay Australia site, only appears on the View Item page if you also specify the date of first registration in the listing's Item Specifics. Appears in the VIN field in the Item Specifics section of eBay's View Item page. 17 AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No This field is deprecated. Vehicle Registration Mark, which is a unique identifier for a motor vehicle in the UK. Applicable to listings in UK eBay Motors Cars and Trucks, Motorcycle, and some Powersport categories. Appears as a VRM field in the Item Specifics section of eBay's View Item page. On the View Item page, the VRM value is masked (i.e., only a portion of the value is shown to users). In the GetItem response, the VRM is only returned if the call is made by the seller (i.e., the AuthToken is associated with the vehicle's seller). AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No This field is deprecated. This container is used to set the minimum number of event tickets that should remain available after a buyer makes a purchase. This functionality allows the seller to avoid the possibility of being left with just one event ticket after a sale. This container can be used when adding, revising, or relisting event tickets, and it will only be returned in GetItem if set for the listing. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem No AddItem ReviseItem RelistItem VerifyAddItem VerifyRelistItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This container is used if the seller would like to use/reference business policies to create, revise, relist, or verify their listing. The seller's account must be opted in to business policies to use this container. If this container is used, exactly one Payment Business Policy, one Shipping Business Policy, and one Return Business Policy must be specified and applied to the listing. If the seller's account is not opted in to business policies, that seller may not use this container. Sellers must opt-in to business policies through My eBay or by using the optInToProgram call of the eBay Account API. If business policies are applied to a listing, all payment, shipping, and return policy settings in these policies will override any other payment, shipping, or return policy legacy fields that are included in the call request. This container is only returned in 'Get' calls if business policies are set for the listing, and the person making the API call is the seller of the listing. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally This container is used when the seller wants to override the flat shipping costs for all domestic and/or all international shipping services defined in the shipping business policy referenced in the SellerProfiles.SellerShippingProfile.ShippingProfileID field. Shipping costs include the cost to ship one item, the cost to ship each additional identical item, and any shipping surcharges applicable to domestic shipping services. A ShippingServiceCostOverrideList.ShippingServiceCostOverride container is required for each domestic and/or international shipping service that is defined in the domesticShippingPolicyInfoService and intlShippingPolicyInfoService containers of the shipping business policy. Shipping service cost overrides are a listing-level concept, and the shipping costs specified through each ShippingServiceCostOverrideList.ShippingServiceCostOverride container will not change the shipping costs defined for the same shipping services in the shipping business policy. For Revise and Relist calls: To delete all shipping service cost overrides when you revise or relist, specify Item.ShippingServiceCostOverrideList in DeletedField, and don't pass ShippingServiceCostOverrideList in the request. AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No GetItem GetItems GetSellerList Conditionally Container consisting of dimension and size details related to a shipping package in which an item will be sent. The information in this container is applicable if the seller is using calculated shipping or flat rate shipping using shipping rate tables with weight surcharges. This container is only returned in the Get calls if specified for the item. AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem Conditionally RelistFixedPriceItem RelistItem VerifyRelistItem ReviseFixedPriceItem ReviseItem No GetItem Conditionally This boolean field is returned as <code>true</code> if the listing was created by a Top-Rated Seller and the listing has all of the requirements that qualifies it as a Top-Rated Plus listing. The Top-Rated Seller program is only available on the US, UK, and Germany sites. See the <a href="https://pages.ebay.com/help/sell/top-rated.html#what">Top-Rated Seller requirements</a> help topic for more information on qualifying as a Top-Rated Seller and the <a href="https://pages.ebay.com/help/sell/top-rated.html#plus">Top-Rated Plus listing requirements</a> help topic for more information on what a listing must offer to qualify as a Top-Rated Plus listing and get the Top-Rated Plus badge. Information on the overall program can be found on the <a href="https://pages.ebay.com/sellerinformation/build-your-business-online/status-standards/top-rated-seller.html">Top-Rated Seller home page</a> in the Seller Center. GetItem Conditionally This container is used by the seller to restrict the quantity of items that may be purchased by one buyer during the duration of a fixed-price listing (single or multi-variation). This is an optional container that can be used with an Add, Revise, or Relist call. This container is not applicable to auction listings. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No This value sets the minimum price threshold for a seller's product price in a fixed-price listing. Regardless of the product price on eBay Value Box or Amazon listings, the seller's product price will not be reduced lower than this dollar value. This value is only applicable to sellers enabled to use the Dynamic Pricing API, and if a dynamic pricing rule is assigned to the listing's product. ReviseItem ReviseFixedPriceItem No This value sets the maximum price threshold for a seller's product price in a fixed-price listing. Regardless of the product price on Amazon or eBay Value Box, the seller's product price will not be raised higher than this dollar value. This value is only applicable to sellers enabled to use the Dynamic Pricing API, and if a dynamic pricing rule is assigned to the listing's product. If this field is not specified through the Dynamic Pricing API, an eBay system-level threshold is used to avoid any undesirable results. ReviseItem ReviseFixedPriceItem No This boolean field is returned as <code>true</code> if the item is eligible is to be shipped internationally via eBay's Global Shipping Program. With the Global Shipping Program, the buyer pays a single shipping fee for the order, which includes the domestic shipping leg, the international shipping leg, and handling charges, and import charges. eBay uses a shipping partner that allows the seller to ship the package to a domestic location and then the shipping partner takes care of the rest, including the international shipping leg. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally This container provides information about the weight, volume or other quantity measurement of a listed item. The European Union requires listings for certain types of products to include the price per unit so buyers can accurately compare prices. eBay uses the UnitType and UnitQuantity values and the item's listed price to calculate and display the per-unit price on eBay EU sites. This container will only be returned if price per unit information exists for the listing, and the IncludeItemSpecifics field was included in the call request and set to <code>true</code>. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The identifier of the original listing that contained the item before the item was relisted. This field is only returned for an item that was relisted. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally This string value provides more details about the item's condition. GetItem GetItems

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally This boolean field is returned as <code>true</code> if the listing has been hidden from all searches occurring on eBay. If a listing is hidden from eBay searches, the reason can be found in the ReasonHideFromSearch field. GetItem GetSellerList GetMyeBaySelling Conditionally This field is returned only when the listing is currently being hidden from any searches occurring on eBay. Listings may be hidden from search if an active listing is currently out of stock or if the listing has been determined by eBay to be a duplicate listing. GetItem GetSellerList GetMyeBaySelling Conditionally This container is used in Add/Revise/Relist/Verify listing calls by the seller to enable a listing with the 'In-Store Pickup' feature. The 'In-Store Pickup' feature is only available to a limited number of large retail merchants in the US, Canada, UK, Germany, and Australia marketplaces. This container is returned in the 'Get' calls if the listing is enabled with the In-Store Pickup feature. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem GetSellerList No GetItem GetSellerList GetItemShipping Conditionally This boolean field is returned as <code>true</code> if the actual quantity of a multiple-quantity, fixed-price listing (indicated in the Item.Quantity field) can not be accurately determined by eBay. GetItem Conditionally This field is only returned if <code>true</code>, and indicates that the 'Click and Collect' feature is available for this item. With Click and Collect, buyers are able to purchase from thousands of sellers on the eBay UK, Australia, and Germany sites, and then pick up their order from the nearest 'eBay Collection Point'. Note that an item may be eligible for Click and Collect, but this logistics option will only surface if the prospective buyer is within the vicinity of an 'eBay Collection Point'. The Click and Collect feature is only available on the eBay UK, Australia, and Germany sites. For more information about Click and Collect, see the <a href="https://ebay.co.uk/clickandcollect/">Click and Collect</a> home page on the eBay UK site, the <a href="https://sellercentre.ebay.com.au/click-and-collect">Click and Collect</a> home page on the eBay Australia site, or the <a href="https://pages.ebay.de/einkaufen/click-and-collect.html">Click and Collect</a> home page on the eBay Germany site. Not all categories on the UK, Australia, and Germany sites support Click and Collect listings. To verify if a specific category on these eBay sites support Click and Collect listings, use the <a href="https://developer.ebay.com/DevZone/XML/docs/Reference/eBay/GetCategoryFeatures.html">GetCategoryFeatures</a> call, passing in one or more CategoryID values and a PickupDropOffEnabled value in the FeatureID field. Look for a <code>true</code> value in the PickupDropOffEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Note: For Click and Collect eligible sellers, the Click and Collect feature can only be enabled at the account level, and then each of the seller's listings will be automatically evaluated for Click and Collect eligibility. GetItem Conditionally For 'Click and Collect' eligible sellers, this field was once used to set 'Click and Collect' eligibility at the listing level. However, now the seller can only opt in to 'Click and Collect' at the account level, and then each of their listings will be automatically evaluated for 'Click and Collect' eligibility. Note: Until this field is fully deprecated in the Trading WSDL (and in Add/Revise/Relist/Verify calls), it can still be used, but it will have no functional affect. However, if set in an Add/Revise/Relist/Verify call, it will get returned in GetItem, but it won't be a true indicator if the item is available for the 'Click and Collect' logistics type. Instead, the Item.AvailableForPickupDropOff field should be referenced to see if the item is available for 'Click and Collect'. GetItem Conditionally Note: This field is no longer applicable as eBay Live Auctions are no longer being held as of September 1, 2018. If this field is used in an Add/Revise/Relist call, it will be ignored and dropped. This container is used in Add/Revise/Relist/Verify listing calls to designate the listing as a digital gift card listing. It is also returned in GetItem to indicate that the listing contains a digital gift card. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem Conditionally eBay Plus is a premium account option for buyers, which provides benefits such as fast and free domestic shipping, and free returns on selected items. To offer this feature to buyers, sellers must opt in to eBay Plus, and their selling status must be 'Above Standard' or above. Note: Currently, eBay Plus is only available to buyers on the Germany and Australia marketplaces, and this field should only be used by sellers selling eligible items in Germany. In Australia, the seller has no control/responsibility over setting the eBay Plus feature for a listing. Instead, eBay will evaluate/determine whether a listing is eligible for eBay Plus. Due to this fact, an Australian seller will also get the <code>21919431: This listing isn't eligible for eBay Plus.</code> warning message in an add/revise/relist call, even though eBay may ultimately set the eBay Plus feature on the listing if the item is eligible. In an add/revise/relist call, a seller on the Germany site must include this field and set its value to <code>true</code>. If the seller is not eligible for/opted in to eBay Plus and/or the listing category or item does not qualify for eBay Plus, a warning message will be returned to the seller in the response indicating this. In addition to the seller, listing category, and item being eligible for eBay Plus, the seller must also set/commit to the following for the listing: <ul> <li>Listing format must be fixed-price.</li> <li>Same-day or one-day handling (DispatchTimeMax set to <code>0</code> or <code>1</code>). </li> <li>A free, next-day shipping option offered.</li> <li>A return policy that offers a 30-day (or longer) return period.</li> </ul> If this field is returned as <code>true</code> in a 'Get' call, it indicates that the item is eligible for eBay Plus treatment, but eBay Plus will only come into play if the buyer is subscribed to eBay Plus. more details Offering eBay Plus https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Feature-eBayPlus.html Selling with eBay Plus (Australia help page) https://www.ebay.com.au/help/selling/listings/creating-managing-listings/selling-ebay-plus?id=4756 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem GetSellerList GetSellerEvents Conditionally If this field is returned as <code>true</code>, this item is eligible to be listed under the eBay Plus program. eBay Plus is a premium account option for buyers, which provides benefits such as fast and free domestic shipping and free returns on selected items. eBay sellers must opt in to eBay Plus to be able offer the program on qualifying listings. Among other requirements, sellers must commit to next-day delivery of those items. Note: Currently, eBay Plus is available only to buyers in Germany and Australia marketplaces. more details Offering eBay Plus https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Feature-eBayPlus.html GetItem GetSellerList GetSellerEvents Conditionally The boolean value that is returned in this field will indicate whether or not a digital gift card can be delivered by email to the buyer or recipient of the gift card. This field is only applicable to digital gift card listings. GetItem Conditionally This boolean field indicates whether or not the listing description is HTTPS secure/compliant. To be HTTPS secure/compliant, the Item.Description field may not contain any links to site pages that use the HTTP (and not HTTPS) protocol. This field will be returned with each listing that is found unless one or more OutputSelector fields are used and <code>Item.IsSecureDescription</code> is not one of the values passed in to one of these fields. If this field is returned as <code>true</code>, the listing is HTTPs secure/compliant, and the whole listing description will appear on the View Item page for the listing. If this field is returned as <code>false</code>, the listing is not HTTPs secure/compliant, and only a partial/brief listing description will appear on the View Item page for the listing, with a link to the full listing description that will load in another tab. If the listing description is not HTTPS compliant, the fix is to call ReviseItem or ReviseFixedPriceItem and update the Item.Description field, removing all links to HTTP pages. For more information about why eBay made this change, please see the <a href="http://pages.ebay.com/seller-center/seller-updates/2017-fall/policy-updates.html" target="_blank">Policy Updates</a> page of the Fall 2017 Seller Updates page. GetItem GetSellerList GetSellerEvents Conditionally This type is deprecated. 773 Avoid FindProducts (Shopping API) 889 This field is deprecated. This field is deprecated. This type provides information about one order line item in a Global Shipping package. The package can contain multiple units of a given order line item. The number of units of the order line item in this package; this is required for customs. The seller must ensure that this matches the quantity of the order line item enclosed in the package. This value must be a positive integer, and it can't be greater than the quantity of this item specified in the original transaction. CompleteSale SetShipmentTrackingInfo No The Country of Manufacture for the order line item; this is required for customs. This should identify the country in which more than 50% of the value of the item was created. This value must conform to the ISO 3166 two-letter country code standard. To see the list of currently supported codes, and the English names associated with each code (e.g., KY="Cayman Islands"), call GeteBayDetails with DetailName set to CountryDetails. CompleteSale SetShipmentTrackingInfo No The item description of the order line item, based on its ItemID. CompleteSale SetShipmentTrackingInfo No Unique identifier for the eBay listing associated with the order line item. A multiple-quantity listing can have multiple order line items, but only one ItemID value. Unless an OrderLineItemID or SKU value is specified in the same node, this field is required for each ItemTransactionID node included in the request. CompleteSale SetShipmentTrackingInfo No Unique identifier for an eBay order line item (transaction). The TransactionID should match the ItemID specified in each ItemTransactionID node included in the request. Optionally, an OrderLineItemID value can substitute for the ItemID/TransactionID pair. The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. CompleteSale SetShipmentTrackingInfo No This type has been deprecated, as Pro Stores and other third-party checkouts have been deprecated. This field is deprecated. This field is deprecated. Various details about a listing. Some of the details are calculated or derived after an item is listed. The details in this type include the start and end time and the converted (localized) prices. The details in this type also include input values applicable to the Best Offer feature. Additional details in this type include flags indicating if a seller specified fields whose values are not visible to the requesting user. If <code>true</code>, the item is listed in a Mature category. Users must accept the Mature Category agreement on the eBay site to retrieve items listed in Mature categories. (Users do not need to sign this agreement to be able to list items in Mature Categories.) GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Medium, Fine

Conditionally Applicable for Real Estate auctions only. If <code>true</code>, buyers and sellers are expected to follow through on the sale. If false, bids for the Real Estate auction are only expressions of interest. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Medium, Fine

Conditionally Indicates whether or not the seller's Checkout Enabled preference is turned on. Note: A 'Checkout Enabled' setting is no longer available to sellers, and this field is always returned as <code>true</code>. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Medium, Fine

Conditionally Converted value of the BuyItNowPrice in the currency of the site that returned this response. For active items, refresh this value every 24 hours to pick up the current conversion rates. GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Medium, Fine

Conditionally GetMyeBayBuying SecondChanceOffer BestOfferList BidList WatchList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList ActiveList

DetailLevel: none, ReturnAll

Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always Converted value of the StartPrice in the currency of the site that returned this response. For active items, refresh this value every 24 hours to pick up the current conversion rates. In multi-variation listings, this value matches the lowest-priced variation that is still available for sale. GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetMyeBayBuying BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList

DetailLevel: none, ReturnAll

Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always Converted value of the ReservePrice in the currency of the site that returned this response. Only returned for listings with a reserve price when the requesting user is the listing's seller. For active items, refresh this value every 24 hours to pick up the current conversion rates. Not applicable to Fixed Price listings. GetBidderList Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally If <code>true</code>, the seller specified a value in ReservePrice. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Medium, Fine

Conditionally Indicates the new item ID for a re-listed item. When an item is re-listed, the item ID for the new item is added to the old listing, so buyers can navigate to the new listing. This value only appears when the old listing is retrieved. The RelistedItemID of the original item will reflect the last relist. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally The item ID for the original listing from which a second chance offer is made. This value is only returned when the data for the second chance offer listing is retrieved. Output only. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The StartTime value returned by non-search calls such as GetItem is the time stamp (in GMT) for when the item was listed. GetBidderList GetDispute Always GetItem Always GetMemberMessages Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying BestOfferList BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally Time stamp (in GMT) when the listing is scheduled to end (calculated based on the values of StartTime and ListingDuration ) or the actual end time if the item has ended. GetBidderList GetDispute Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetBestOffers

DetailLevel: none, ReturnAll

Conditionally GetItemsAwaitingFeedback GetMemberMessages Conditionally GetMyeBayBuying BidList LostList SecondChanceOffer WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling BidList DeletedFromSoldList DeletedFromUnsoldList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally The URL of the Web page where a user can view the listing. On the US site, this is called the View Item page. If you enabled affiliate tracking in a search-related call (for example, if you used the AffiliateTrackingDetails container in an applicable call), ViewItemURL contains a string that includes affiliate tracking information (see the <a href= "https://www.ebaypartnernetwork.com" target="_blank">eBay Partner Network</a>). GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetMyeBayBuying WatchList

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Indicates whether the item has any unanswered questions. Use GetMemberMessages to retrieve unanswered questions for the item if this flag indicates that there are any. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Indicates whether the item has any publicly displayed messages. Use GetMemberMessages to retrieve public messages for the item if this flag indicates that there are any. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Indicates whether the Buy It Now feature is available for an auction listing. As a general rule, once an auction listing has bids (and the high bid exceeds the reserve price, if any), the Buy It Now feature becomes disabled for the listing. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Type of seller account. This value is not returned for most sites. This value is not returned for the German site (site ID 77) or US eBay Motors site (site ID 0). Specifies the minimum acceptable Best Offer price. If a buyer submits a Best Offer that is below this value, the offer is automatically declined. This applies only to items listed in categories that support the Best Offer auto-decline feature. In order for this setting to have an effect, Best Offer must be enabled for the listing, and this value will only be exposed to the seller who listed the item. For Revise and Relist calls: If a seller wanted to disable the Best Offer auto-accept and/or Best Offer auto-reject feature when revising or relisting an item, the full path to one or both of these two corresponding fields would be provided in a DeletedField tag, like the following: <pre><code> <DeletedField>Item.ListingDetails.MinimumBestOfferPrice</DeletedField> </code></pre> Note: The Best Offer feature is now available for auction listings on the following sites: US, Canada, UK, Germany, Australia, France, Italy, and Spain. However, sellers must choose between offering Best Offer or Buy It Now on an auction listing, as both features cannot be enabled on the same auction listing. As of January 2019, the value set in this field for an auction listing can be more than the auction start price. AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistItem RelistFixedPriceItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally This field is deprecated. 547 629 NoOp This field is needed if the seller is selling a motor vehicle through a Motors Local Listing. The string value supplied in this field actually sets the radius of the area (in miles) in which the vehicle will be available and exposed to interested local buyers. The seller's supplied PostalCode or Location field value will be used as the center point for this radius. There is a closed set of radius values that can be set in this field, and it depends on the seller's subscription level. The user can call GetCategoryFeatures, including <code>LocalListingDistances</code> as a FeatureID value to retrieve the local listing distances supported by a given site, category, and Local Market subscription level. AddItem AddItems AddFixedPriceItem Conditionally Indicates the item ID of the original item listing from which a Transaction Confirmation Request (TCR) was created. This value is only returned when the data for a TCR is retrieved. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetBidderList Conditionally This URL takes you to the same View Item page as ViewItemURL, but this URL is optimized to support natural search. That is, this URL is designed to make items on eBay easier to find via popular Internet search engines. The URL includes the item title along with other optimizations. To note, "?" (question mark) optimizes to "_W0QQ", "&" (ampersand) optimizes to "QQ", and "=" (equals sign) optimizes to "Z". If you are an eBay affiliate, use this URL to promote your affiliate information. Note: This URL may include additional query parameters that don't appear in ViewItemURL and vice versa. You should not modify the query syntax. For example, eBay won't recognize the URL if you change QQ to ?. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally This field is deprecated. The price at which Best Offers are automatically accepted. Similar in use to MinimumBestOfferPrice. If a buyer submits a Best Offer that is at or above this value, the offer is automatically accepted by the seller. This applies only to items listed in categories that support the BestOfferAutoAcceptPrice feature. For this setting to have an effect, the Best Offer feature must be enabled for the listing, and only the seller who listed the item will see BestOfferAutoAcceptPrice in a call response. For Revise and Relist calls: If a seller wanted to disable the Best Offer Auto-Accept and/or Best Offer Auto-Reject feature when revising or relisting an item, the full path to one or both of these two corresponding fields would be provided in a DeletedField tag, like the following: <pre><code> <DeletedField>Item.ListingDetails.BestOfferAutoAcceptPrice</DeletedField> </code></pre> AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistItem RelistFixedPriceItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally This field is only returned if the item was ended early (before listing duration expired) by the seller (through an API call or on the Web site) or ended administratively by eBay. The value in this field indicates the seller's reason for ending the listing early. GetItem Conditionally Type defining all listing upgrades that may be available to the seller when listing an item. The listing upgrades that are available vary by site and by the seller's account status. To discover which listing upgrades are available, call GeteBayDetails, pass in the appropriate SiteID value and set the DetailName input filter to <code>ListingFeatureDetails</code>, and then look for the ListingFeatureDetails container in the response. Listing upgrades will either be listed as <code>Enabled</code> or <code>Disabled</code>. BasicUpgradePackBundle, Border, Featured, Highlight, ProPackBundle, ProPackPlusBundle, HomePageFeatured Note: The Picture Border feature is no longer available on any eBay Marketplace sites, so this value should not be used in Add/Revise/Relist calls, and will not be returned in 'Get' calls. If specified, the seller wants to add a border around the listing's pictures. Applicable listing fees apply. This value is used if the seller wants the listing title to be in boldface type. This feature will incur a listing fee. Note that this enhancement will not put the listing subtitle in boldface type (if a subtitle is used). Currently, Bold Titles are only supported on eBay US, both Canada sites, eBay Netherlands, and eBay Poland. Note: The Featured listing feature is no longer available on any eBay Marketplace sites, so this value should not be used in Add/Revise/Relist calls, and will not be returned in 'Get' calls. Listing is a "Featured Plus" item. The item will display prominently in the Featured Items section of its category list, and it will stand out on search results pages. It will also display in the regular, non- featured item list. Only available to users with a Feedback rating of 10 or greater. Note: The Highlighted listing feature is no longer available on any eBay Marketplace sites, so this value should not be used in Add/Revise/Relist calls, and will not be returned in 'Get' calls. Listing is highlighted in a different color in lists. Note: The Featured Gallery listing feature is no longer available on any eBay sites, so this value should not be used in Add/Revise/Relist calls, and will not be returned in 'Get' calls. Listing will have a chance to rotate into a special display on eBay's Home page. Your item is very likely to show up on the Home page, although eBay does not guarantee that your item will be highlighted in this way. This is the highest level of visibility on eBay. Note: The Pro Pack Bundle is no longer available on any eBay Marketplace sites, so this value should not be used in Add/Revise/Relist calls, and will not be returned in 'Get' calls. Listing is using ProPackBundle (a feature pack). Applies only to vehicle listings on eBay Motors (US and Canada), and to the Parts and Accessories category in the eBay Motors US site. Contains the BoldTitle, Border, Featured and Highlight features. Note: The Basic Upgrade Pack Bundle is no longer available on any eBay Marketplace sites, so this value should not be used in Add/Revise/Relist calls, and will not be returned in 'Get' calls. If this value is specified in an Add/Revise/Relist call, a Value Pack bundle is applied to the listing. The Value Pack bundle includes the Gallery Plus feature, a listing subtitle, and use of a Listing Designer template for a discounted price. Support for this feature varies by site and category. Note: As of May 31, 2020, sellers are no longer able to use Listing Designer templates when they create or revise listings, so use of a Listing Designer template will no longer be a part of this bundle. Note: The Pro Pack Plus Bundle is no longer available on any eBay Marketplace sites, so this value should not be used in Add/Revise/Relist calls, and will not be returned in 'Get' calls. Support for this feature varies by site and category. A ProPackPlusBundle listing is using ProPackPlus bundle (a feature pack), which combines the features of BoldTitle, Border, Highlight, Featured (which is equivalent to a GalleryType value of Featured), and Gallery, for a discounted price. Note that if, for example, in AddItem, if you use ProPackPlusBundle and a GalleryType value of Gallery, then the resulting item will have a GalleryType value of Featured. Reserved for internal or future use. Specifies an active or ended listing's status in eBay's processing workflow. If a listing ends with a sale (or sales), eBay needs to update the sale details (e.g., total price and buyer/high bidder) and the final value fee. This processing can take several minutes. If you retrieve a sold item and no details about the buyer/high bidder are returned or no final value fee is available, use this listing status information to determine whether eBay has finished processing the listing. The listing is still active or the listing has ended with a sale but eBay has not completed processing the sale details (e.g., total price and high bidder). A multi-item listing is considered active until all items have winning bids or purchases or the listing ends with at least one winning bid or purchase. If the listing has ended with a sale but this Active status is returned, please allow several minutes for eBay to finish processing the listing. The listing has ended. If the listing ended with a sale, eBay has completed processing of the sale. All sale information returned from eBay (e.g., total price and high bidder) should be considered accurate and complete. However, the final value fee is not yet available. The listing has closed and eBay has completed processing the sale. All sale information returned from eBay (e.g., total price and high bidder) should be considered accurate and complete. Although the Final Value Fee (FVF) for FixedPriceItem and StoresFixedPrice items is returned by GetSellerTransactions and GetItemTransactions, all other listing types (excluding Buy It Now purchases) require the listing status to be Completed before the Final Value Fee is returned. Reserved for internal or future use. Reserved for internal or future use. This enumerated type defines the two subtypes that can be used if the main listing type (in ListingType field) is <code>LeadGeneration</code>. A ListingSubtype2 value must be specified if the ListingType value is set to <code>LeadGeneration</code>. This value indicates that the lead generation listing is a classifed ad. Note that only some eBay categories support classified ad listings. Use the GetCategoryFeatures call (with FeatureID value set to <code>AdFormatEnabled</code>) to see which categories support classified ad listings. This value indicates that the lead generation listing is a US Motors Local Market listing. Note that only some eBay Motors categories support Motors Local Market listings. Use the GetCategoryFeatures call (with the SITEID header set to <code>100</code> and the FeatureID value set to <code>LocalMarketAdFormatEnabled</code>) to see which eBay Motors categories support Motors Local Market listings. Reserved for internal or future use This enumerated type contains the valid selling formats for eBay listings. StoresFixedPrice, Dutch, Live, Express, Half, Shopping Unknown or undefined auction type. Applicable to user preferences and other informational use cases. This value indicates an auction listing. In an auction listing, prospective buyers engage in a competitive bidding process, although Buy It Now may be offered as long as no bids have been placed. Auctions occur on the eBay marketplace site, and the auction listings will also appear in the seller's eBay Store (if the seller has an eBay Store). Although listing durations may vary by eBay marketplace and category, typical listing durations for auctions are 3, 5, 7, and 10 days. It is recommended that the seller uses the GetCategoryFeatures call to retrieve the actual listing durations that are supported for auctions on a particular marketplace and category. This enumeration value is only applicable to the GetMyeBaySelling call. This value is used in the ActiveList.ListingType field if the seller only wants to retrieve active listings that are in the auction format. This enumeration value represents a classified ad in a Real Estate category. This listing type is only used to solicit inquiries from interested parties. To express interest, a buyer fills in a contact form that eBay forwards to the seller as a lead. This format does not enable buyers and sellers to transact online through eBay, and eBay Feedback is not available for ad format listings. Although listing durations may vary by eBay marketplace and category, typical listing durations for real estate ads are 30 and 90 days. It is recommended that the seller uses the GetCategoryFeatures call to retrieve the actual listing durations that are supported for real estate ads on a particular marketplace and category. Second chance offer made to a non-winning bidder on an ended listing. A seller can make an offer to a non-winning bidder when either the winning bidder has failed to pay for an item or the seller has a duplicate of the item. A seller can create a Second Chance Offer immediately after a listing ends and up to 60 days after the end of the listing. eBay does not charge an Insertion Fee, but if the bidder accepts the offer, the regular Final Value Fee is charged. In the case of an Unpaid Item, the seller should ensure that everything has been done to resolve the issue with the winning bidder before sending a Second Chance Offer to another bidder. See the Unpaid Items Process for details. Make sure you're aware of other rules and restrictions surrounding Second Chance Offers. Use AddSecondChanceItem to submit Second Chance Offers. Listed on eBay, but does not appear when browsing or searching listings. With this listing format, the selling is offering the item at a fixed price, although it is still possible for the seller to negotiate the price with prospective buyers using the Best Offer feature. A fixed-price listing can offer a single item, or if the seller has multiple quantity of the same item, multiple quantity of that same item can be made available for sale through the same listing. Additionally, the seller can set up a multiple-variation, fixed-price listing, where similar items can be sold through the same listing. An example of a multiple-variation, fixed-price listing might be a t-shirt (or another article of clothing) that is available in multiple color and size combinations. Traditionally, listing durations for fixed-prices listings have varied by eBay marketplace and category. Typical listing durations for fixed-price listings ranged from three to 30 days, or GTC (Good 'Til Cancelled). As of April 1, 2019, 'GTC' is the only supported listing duration for all eBay marketplaces with the following exceptions: <ul> <li>The following eBay Motors US categories are exempt from this change: Cars & Trucks (6001), Motorcycles (6024), Other Vehicles & Trailers (6038), Boats (26429), Powersports (66466).</li> <li>All child categories under Cars, Motorcycles & Vehicles (9800) categories on the eBay UK and eBay Italy sites are also exempt from this change. </li> </ul> With the 'GTC' listing duration, the listing will remain active as long as the listing shows that inventory is available for purchase (available quantity is '1' or more). For sellers listing motor vehicles on the eBay US Motors, eBay UK, or eBay Italy sites, it is recommended that the seller uses the GetCategoryFeatures call to retrieve the supported listing durations for their particular marketplace and category. Note: As of July 1, 2019, the Good 'Til Cancelled renewal schedule has been modified from every 30 days to once per calendar month. For example, if a GTC listing is created July 5, the next monthly renewal date will be August 5. If a GTC listing is created on the 31st of the month, but the following month only has 30 days, the renewal will happen on the 30th in the following month. Finally, if a GTC listing is created on January 29-31, the renewal will happen on February 28th (or 29th during a 'Leap Year'). See the <a href="https://pages.ebay.com/seller-center/seller-updates/2019-spring/marketplace-updates.html#good-til-cancelled" target="_blank">Good 'Til Cancelled listings update</a> in the Spring 2019 Seller Updates for more information about this change. Note: This listing type is no longer applicable as the Half.com site has been shut down. This enumeration value represents a (non-Real Estate) classified ad listing. The <code>AdType</code> enumeration value represents Real Estate classified ads. This listing type is only used to solicit inquiries from interested parties. To express interest, a buyer fills in a contact form that eBay forwards to the seller as a lead. This format does not enable buyers and sellers to transact online through eBay, and eBay Feedback is not available for ad format listings. Non-Real Estate classified ads are only available in a limited number of eBay categories, including Business and Industrial categories, Travel, ans Specialty Services. Although listing durations may vary by eBay marketplace and category, typical listing durations for (non-Real Estate) classified ads are 30, 60, and 90 days. It is recommended that the seller uses the GetCategoryFeatures call to retrieve the actual listing durations that are supported for real estate ads on a particular marketplace and category. This value is no longer applicable, as Shopping.com is no longer a property of eBay, Inc. Reserved for internal or future use. This type is deprecated. 773 NoOp 889 Item.ConditionID This field is deprecated. This type is deprecated. 773 NoOp 889 Item.ConditionID This field is deprecated. This field is deprecated. Type used by the MaximumItemRequirements container to specify the maximum quantity of an order line item that a prospective buyer may purchase during any given 10-day period. This field is conditionally required if the MaximumItemRequirements container is used. The value of this field specifies the maximum quantity of an order line item that a prospective buyer may purchase from the seller during any given 10-day period. The prospective buyer will be blocked from bidding/buying once this value is reached. Valid values for the US site: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 25, 50, 75, and 100. To see the valid values for your site, call GeteBayDetails with DetailName set to BuyerRequirementDetails, and then look for the BuyerRequirementDetails.MaximumItemRequirements.MaximumItemCount fields. If the MaximumItemRequirements.MinimumFeedbackScore field is also specified, the MaximumItemCount limit will only apply to those prospective buyers who don't meet the specified Minimum Feedback Score threshold. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This is an optional field that is ignored if a MaximumItemCount value has not been provided. If this field is used, a prospective buyer is blocked from bidding/buying if they have reached or exceeded the MaximumItemCount and their feedback score is less than the value of this field. Valid values for the US site: 0, 1, 2, 3, 4, and 5. To see the valid values for your site, call GeteBayDetails with DetailName set to BuyerRequirementDetails, and then look for the BuyerRequirementDetails.MaximumItemRequirements.MinimumFeedbackScore fields. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem No GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Type defining the MaximumUnpaidItemStrikesInfo container, which is used by the seller as a mechanism to block prospective buyers who have unpaid item strikes on their account exceeding the value set in the Count field during a specified time period (set in the Period field). This integer value sets the maximum number of unpaid item strikes that a prospective buyer is allowed to have during a specified time period (MaximumUnpaidItemStrikesInfo.Period) before being blocked from buying/bidding on the item. To retrieve a list of allowed values for this field, the seller should call GeteBayDetails, including BuyerRequirementDetails in the DetailName field of the request, and then look for the BuyerRequirementDetails.MaximumUnpaidItemStrikesInfo.MaximumUnpaidItemStrikesCount.Count fields in the response. 2 AddItem AddFixedPriceItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem 2, 3, 4, 5 Conditionally GetBidderList GetSellerList 2, 3, 4, 5 Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

2, 3, 4, 5 Conditionally This enumerated value defines the length of time over which a prospective buyer's unpaid item strikes will be counted. If the prospective buyer's number of unpaid item strikes during this defined period exceeds the value set in the Count field, that prospective buyer is blocked from buying/bidding on the item. If the Count value is 2, and the specified Period is 'Days_30' (counting back 30 days from the present day), any prospective buyer that has had three or more unpaid item strikes is blocked from buying/bidding on the item. Days_30 AddItem AddFixedPriceItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem Days_30, Days_180, Days_360 Conditionally GetBidderList GetSellerList Days_30, Days_180, Days_360 Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Days_30, Days_180, Days_360 Conditionally Type used by the Program container that is returned in the response of the GetUser call if the seller is enrolled in one or more eBay membership programs, such as eBay Plus. The Program container provides the eBay site, program (such as '<code>EBAYPLUS</code>'), and the membership expiration date. Note: Currently, eBay Plus is available only to buyers on Germany and Australia marketplaces. In Australia, the seller has no control/responsibility over setting the eBay Plus feature for a listing. Instead, eBay will evaluate/determine whether a listing is eligible for eBay Plus. This value indicates the name of the membership program, such as <code>EBAYPLUS</code>. This field will always be returned with each Program container. GetUser

DetailLevel: none,ReturnAll

Conditionally This enumeration value indicates the eBay site for which the seller is enrolled in a membership program. This field will always be returned with each Program container. GetUser

DetailLevel: none,ReturnAll

Conditionally This dateTime value is the expiration date of the seller's membership within the program specified in the ProgramName field. This field will always be returned with each Program container. GetUser

DetailLevel: none,ReturnAll

Conditionally Type used by the Membership container that is returned in the response of the GetUser call if the seller is enrolled in one or more eBay membership programs such as eBay Plus. Note: Currently, eBay Plus is available only to buyers on Germany and Australia marketplaces. A Program container will be returned for each eBay membership program for which the seller is enrolled. This container provides the the eBay site, the membership program (such as '<code>EBAYPLUS</code>'), and the membership expiration date. GetUser

DetailLevel: none,ReturnAll

Conditionally This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. This type defines the details about one specific variation. Stock Keeping Unit that serves as the seller's unique identifier for items within the same variation. You can use the variation's SKU instead of the variation specifics to revise a variation and to keep track of your eBay inventory. Many merchants assign a SKU to an item of a specific type, size, and color. This way, they can keep track of how many products of each type, size, and color are selling, and they can re-stock their shelves or update the variation quantity on eBay according to customer demand. Only returned if the seller specified a SKU for the variation. ActiveInventoryReport Conditionally The fixed price of all items identified by this variation. For example, a "Blue, Large" variation price could be USD 10.00, and a "Black, Medium" variation price could be USD 5.00. ActiveInventoryReport Conditionally For ActiveInventoryReport: The number of items available for sale that are associated with this variation. ActiveInventoryReport Always A list of name/value pairs that uniquely identify the variation within the listing. All variations specify the same set of names, and each variation provides a unique combination of values for those names. For example, if the items vary by color and size, then every variation specifies Color and Size as names, and no two variations specify the same combination of color and size values. If a variation has no SKU, use the variation specifics as a unique ID to revise the variation and to keep track of your eBay inventory. ActiveInventoryReport Conditionally Variations are multiple similar (but not identical) items in a single fixed-price (or Store Inventory Format) listing. For example, a single listing could contain multiple items of the same brand and model that vary by color and size (like "Blue, Large" and "Black, Medium"). Each variation can have its own quantity and price. For example, a listing could include 10 "Blue, Large" variations and 20 "Black, Medium" variations. Contains data that distinguishes one variation from another. For example, if the items vary by color and size, each Variation node specifies a combination of one of those colors and sizes. Always returned when variations are present. ActiveInventoryReport Conditionally This enumerated type defines the special price treatments that can be set up for listings enabled with the Minimum Advertised Price feature. The Minimum Advertised Price (MAP) feature is only supported on the eBay US site. This enumeration value indicates that the buyer must add the item to his/her cart before the discounted price can be displayed. To enable this pricing treatment when adding/revising/relisting an item, include the DiscountPriceInfo.MinimumAdvertisedPriceExposure field in an Add/Revise/Relist calls and set its value to <code>PreCheckout</code>. This enumeration value indicates that the discounted price will only be shown to the buyer once the buyer reaches the eBay Checkout page. To enable this pricing treatment when adding/revising/relisting an item, include the DiscountPriceInfo.MinimumAdvertisedPriceExposure field in an Add/Revise/Relist calls and set its value to <code>DuringCheckout</code>. The value None is no longer valid. If provided in the request, it will be mapped to <code>PreCheckout</code>. Reserved for future use. This enumerated type is deprecated. This value is not used. This value is not used. (out) Reserved for internal or future use This type is used by the ModifyNameList container in a ReviseFixedPriceItem or RelistFixedPriceItem call to rename one or more Variation Specific names for a multiple-variation listing. A ModifyName container is needed for each Variation Specific name that the seller wishes to change in a multiple-variation listing. You cannot change the name of an Item Specific that is required for the listing category. Use the <a href="/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API to determine which Item Specifics names are required for a category. To get a current list of Variation Specifics defined for a multiple-variation listing, the seller can use GetItem, and then view all Variation Specific names in the VariationSpecificsSet container in the response. RelistFixedPriceItem ReviseFixedPriceItem No 5 Type used by the ModifyName container in a ReviseFixedPriceItem or RelistFixedPriceItem call to rename a Variation Specific name for a multiple-variation listing. A ModifyName container is needed for each Variation Specific name that the seller wishes to change the name of in a multiple-variation listing. In this field, the seller identifies the current name (e.g., Material) of a Variation Specific in the active listing that the seller wishes to change. If this field is used, the NewName field must also be specified. 40 ReviseFixedPriceItem RelistFixedPriceItem Conditionally In this field, the seller states the new name of the Variation Specific (e.g., Fabric). In addition to changing a Variation Specific name through the ModifyName container, the seller must also include the new Variation Specific name (and its available values) in the VariationSpecificsSet container, and omit the original name. Note that variations that were sold while they used the old name will also be changed to use the new name in eBay's system. If you are making other changes to a variation (such as adding new values or pictures), use consistent names to avoid unexpected results. For example, specify the same new name to identify the Variation Specific in the Pictures container and in the VariationSpecifics containers for each variation within the listing. 40 RelistFixedPriceItem ReviseFixedPriceItem Conditionally This type provides information about the shipping service, cost, address, and delivery estimates for the domestic leg of a Global Shipping Program shipment. This type is only applicable for international shipments using the GSP program. Contains information about the shipping service and cost of the domestic leg of a Global Shipping Program shipment. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Contains shipping address information for the domestic leg of a Global Shipping Program shipment. This container includes the ReferenceID field, which can be printed on the package to give the international shipping provider a unique identifier for the order. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The integer value returned here indicates the minimum number of business days that the corresponding shipping service (indicated in ShippingServiceDetails.ShippingService field) will take to be delivered to eBay's domestic shipping partner. This minimum shipping time does not include the seller's handling time, and the clock starts on the shipping time only after the seller has delivered the item to the shipping carrier for shipment to eBay's domestic shipping partner. 'Business days' can vary by shipping carrier and by country, but 'business days' are generally Monday through Friday, excluding holidays. This field is returned if defined for that particular shipping service option. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The integer value returned here indicates the maximum number of business days that the corresponding shipping service (indicated in ShippingServiceDetails.ShippingService field) will take to be delivered to eBay's domestic shipping partner. This maximum shipping time does not include the seller's handling time, and the clock starts on the shipping time only after the seller has delivered the item to the shipping carrier for shipment to eBay's domestic shipping partner. 'Business days' can vary by shipping carrier and by country, but 'business days' are generally Monday through Friday, excluding holidays. This field is returned if defined for that particular shipping service option. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This type provides information about the domestic leg of a Global Shipping Program shipment. Note: The LogisticsProviderShipmentToBuyer field is reserved for the exclusive use of the international shipping provider. Contains information about the domestic leg of a Global Shipping Programn shipment, including the seller-selected shipping service, the domestic shipping cost, the domestic address of the international shipping provider, and the estimated shipping time range. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Reserved for use by the international shipping provider. This type specifies the shipping service and cost of the domestic leg of a Global Shipping Program shipment. The shipping service specified for the domestic leg of a Global Shipping Program shipment. For the domestic leg, the value of this field can be any available shipping service that ships to the domestic address of the international shipping provider. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The total shipping cost of the domestic leg of a Global Shipping Program shipment. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally A list of one or more valid names and corresponding values. Currently used to identify Item Specifics and individual variations within a multiple-variation listing. For the AddItem family of calls: Contains the name and value(s) for an Item Specific. Only required when the ItemSpecifics container is specified. Note: The maximum number of item specifics that may be defined for a listing has increased from 30 to 45. For the AddFixedPriceItem family of calls: The same NameValueList schema is used for the ItemSpecifics node, the VariationSpecifics node, and the VariationSpecifcsSet node. If the listing has variations, any name that you use in the VariationSpecifics and VariationSpecificsSet nodes can't be used in the ItemSpecifics node. When you list with Item Variations: <ul> <li>Specify shared Item Specifics (e.g., Brand) in the ItemSpecifics node. </li> <li>Specify up to five VariationSpecifics in each Variation node. </li> <li>Specify all applicable names with all their supported values in the VariationSpecificSet node. </li> </ul> See the Variation sample in the AddFixedPriceItem call reference for examples. For PlaceOffer: Required if the item being purchased includes Item Variations. For AddToWatchList and RemoveFromWatchList: The ItemID value of the multiple-variation listing and the name-value pair to identify each variation in the listing are required. Note: As of August 30, 2018, California will require sellers to display a Proposition 65 warning on online retail sites if products contain chemicals and/or substances that may impact the health of California buyers. This requirement is applicable to most eBay US categories, including eBay Motors, Motors Parts & Accessories, and catalog-enabled categories. The warning message can be customized by the seller, but should contain the following basic information: <ul> <li>The name of at least one listed chemical that prompted the warning</li> <li>Text stating that the product 'can expose you to' the chemical(s) in the product </li> <li>The URL for OEHHA's new Proposition 65 warnings website, which is <a href="www.P65Warnings.ca.gov" target="_blank">www.P65Warnings.ca.gov</a></li> </ul> Unlike standard item specifics that allow a maximum of 65 characters in the Value field, the matching value for the 'California Prop 65 Warning' item specific allows up to 800 characters of text. When a seller passes in this item specific, eBay will automatically insert a warning symbol icon for the listing. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem ItemSpecifics 45 Conditionally AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Variations Conditionally 2 5 AddToWatchList RemoveFromWatchList Conditionally GetItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Variation Conditionally GetItemTransactions GetSellerTransactions GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList DeletedFromSoldList DeletedFromUnsoldList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally OrderReport Conditionally PlaceOffer Conditionally SetUserNotes No GetItemTransactions Conditionally ActiveInventoryReport Conditionally This type is used to set or identify either an Item Specific name/value pair for a category/item/variation, or to identify a Parts Compatibility name/value pair. Depending on the call and context, this value is either a name of an Item/Variation Specific, or a Parts Compatibility name. For the AddItem and AddFixedPriceItem families of calls: In the Item.ItemSpecifics context, the value in this field will either be the name of a required/recommended/optional item specific name for the category, or it may be a seller's customized item specific name. For the AddFixedPriceItem family of calls: In the Compatibility.NameValueList context, this value is a motor vehicle aspect such as Year, Make, and Model. A Compatibility.NameValueList container is applicable for motor vehicle parts and accessories listings. For PlaceOffer: Required if the line item being purchased is an item variation within a multiple-variation listing. Note: For required and recommended item specifics that are returned in the <a href="/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API, the seller should pass in the name of these item specifics just as they are shown in the getItemAspectsForCategory response. Similarly, for catalog-enabled categories, the seller should pass in the name of instance aspects just as they are shown in the getItemAspectsForCategory response. Instance aspects are additional details unique to a specific item or listing that a seller can include along with the product aspects that are already defined in the eBay catalog product associated with the listing. Instance aspects common to many catalog-enabled categories include 'Bundle Description' and 'Modification Description'. eBay US sellers who ship to California are required to pass in a 'California Prop 65 Warning' item specific if the item in the listing contains one or more chemicals known to be harmful to human health. This item specific is passed at the listing level for both single-variation and multiple-variation listings. The 'California Prop 65 Warning' is considered an instance specific because it will be retained on the listing even when the seller lists using an eBay catalog product. The 'California Prop 65 Warning' may be applicable in most eBay US categories, including eBay Motors, Motors Parts & Accessories, and catalog-enabled categories. Note: If Brand and MPN (Manufacturer Part Number) are being used to identify product variations in a multiple-variation listing, the Brand must be specified at the item level (ItemSpecifics container) and the MPN for each product variation must be specified at the variation level (VariationSpecifics container). The Brand name must be the same for all variations within a single listing. 65 AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddToWatchList RemoveFromWatchList Conditionally GetItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList DeletedFromSoldList DeletedFromUnsoldList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally OrderReport Conditionally PlaceOffer Conditionally SetUserNotes No ActiveInventoryReport Conditionally Depending on the call and context, this value is either the value of an Item/Variation Specific, a Parts Compatibility value, or a product identifier. For the AddItem family of calls: Multiple values can only be specified for an Item Specific if the <a href="/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory#response.aspects.aspectConstraint.itemToAspectCardinality" target="_blank">itemToAspectCardinality</a> field of the getItemAspectsForCategory method shows a value of <code>MULTI</code>. If an item specific only supports a single value, only the first item specific value specified in the request will be used. For the Compatibility.NameValueList context, this is the corresponding value of a motor vehicle aspect such as Year, Make, and Model. A Compatibility.NameValueList container is applicable for motor vehicle parts and accessories listings. For PlaceOffer: Required if the line item being purchased is an item variation within a multiple-variation listing. Note: The standard maximum length for the value of an item specific is 65, but the maximum allowed length increases for instance aspects such as 'Bundle Description' and 'Modification Description'. For item specifics with max lengths greater than 65, the actual max length will be returned in a corresponding <a href="/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory#response.aspects.aspectConstraint.aspectMaxLength" target="_blank">aspectMaxLength</a> field. The maximum allowed length for the new 'California Prop 65 Warning' item specific is 800 characters. For more information about the 'California Prop 65 Warning' item specific, see the ItemSpecifics.NameValueList field description. 65 (but longer for some instance aspects, including 800 for 'California Prop 65 Warning') AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddToWatchList RemoveFromWatchList Conditionally 50 GetItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList DeletedFromSoldList DeletedFromUnsoldList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally OrderReport Conditionally PlaceOffer Conditionally SetUserNotes No ActiveInventoryReport Conditionally This enumerated value indicates whether the Item Specific was manually input or selected during listing/revision/re-listing time, or if the Item Specific name-value pair came from an eBay catalog product that the listing is associated with. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Conditionally Type used by the OrderArray container that is returned in order management calls. The OrderArray container consists of one or more eBay orders that match the input criteria. Details of an eBay order. One eBay order can have one or more order line items (Transaction objects). GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listing-AnItem.html#CombinedInvoice Combined Invoice This container will be returned if there are one or more errors or warnings with the corresponding order. This container consists of detailed information on the warning or error, including the actual error message and information on any input parameters that actually triggered the warning or error. OrderReport Conditionally Type that represents the unique identifier for an eBay order. Note: As of June 2019, eBay has changed the format of order identifier values. The new format is a non-parsable string, globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. Unlike in the past, instead of just being known and exposed to the seller, these unique order identifiers will also be known and used/referenced by the buyer and eBay customer support. For developers and sellers who are already integrated with the Trading API's order management calls, this change shouldn't impact your integration unless you parse the existing order identifiers (e.g., OrderID or OrderLineItemID), or otherwise infer meaning from the format (e.g., differentiating between a single line item order versus a multiple line item order). Because we realize that some integrations may have logic that is dependent upon the old identifier format, eBay is rolling out this Trading API change with version control to support a transition period of approximately 9 months before applications must switch to the new format completely. During the transition period, for developers/sellers using a Trading WSDL older than Version 1113, they can use the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header in API calls to control whether the new or old OrderID format is returned in call response payloads. To get the new OrderID format, the value of the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header must be set to <code>1113</code>. During the transition period and even after, the new and old OrderID formats will still be supported/accepted in all Trading API call request payloads. After the transition period (which will be announced), only the new OrderID format will be returned in all Trading API call response payloads, regardless of the Trading WSDL version used or specified compatibility level. Note: For sellers integrated with the new order ID format, please note that the identifier for an order will change as it goes from unpaid to paid status. Sellers can check to see if an order has been paid by looking for a value of 'Complete' in the CheckoutStatus.Status field in the response of GetOrders or GetOrderTransactions call, or in the Status.CompleteStatus field in the response of GetItemTransactions or GetSellerTransactions call. When using a GetOrders or GetOrderTransactions call to retrieve specific order(s), either of these order IDs (paid or unpaid status) can be used to retrieve an order. Enumerated type that defines the possible values for order states. Some of these values can be used as OrderStatus filters in the GetOrders request payload, and some of these values may be returned in any of the order management calls under the OrderStatus field. See the individual value descriptions for more information on how they are used and/or when they are returned. Authenticated, Default, Invalid, Shipped This value indicates that the order is not yet complete. An order in the <code>Active</code> state means that the buyer has not initiated payment for the order. While an order is in this state, it can be combined into a <a href="https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listing-AnItem.html#CombinedInvoice">Combined Invoice</a>, a buyer can request a cancellation, and/or a seller can update payment details (including a change in order price) or shipping details (including shipping cost and shipping service). This value can be used a filter value in the OrderStatus field of the GetOrders request payload, and it can also be returned in any of the order management calls. This value can be used a filter value in the OrderStatus field, and if used, all inactive orders will be returned. This value indicates that the order is paid for and complete. An order in the <code>Completed</code> state means that no other changes to the order can be made. This value can be used a filter value in the OrderStatus field of the GetOrders request payload, and it can also be returned in any of the order management calls. This value indicates that the order has been cancelled. Depending on whether payment was made or not, the seller may also need to refund the buyer after an order is cancelled. This value can be used a filter value in the OrderStatus field of the GetOrders request payload, and it can also be returned in any of the order management calls. This enumeration value was only used for the deprecated Half.com site, so is no longer applicable and should not be used as an OrderStatus value in the GetOrders request payload. This value is not used. This enumeration value is no longer applicable and should not be used as an OrderStatus value in the GetOrders request payload. This enumeration value indicates that the order is currently in the state of being processed, but is not yet complete. This value is not supported by the OrderStatus field of the GetOrders request payload, but it can be returned in any of the order management calls. This enumeration value is no longer applicable and should not be used as an OrderStatus value in the GetOrders request payload. Reserved for internal or future use. This enumeration value is passed into the OrderStatus of GetOrders to retrieve orders in all states. This is the default value. This value is not applicable to the response payloads of the order management calls. This value indicates that a buyer has initiated a cancellation request on the order. If a seller sees an order in this state, that seller must either approve or reject the cancellation request through My eBay Web flows or through the Post-Order API cancellation calls. This enumeration value cannot be used as an OrderStatus value in the GetOrders request payload. This type is used to express the details of an order. An order may contain one or more line items (purchases) from the same buyer. Regardless of how many line items an order has, only one payment is made for the order. The GetOrders and GetOrderTransactions calls return many of the fields of this type. The GetItemTransactions and GetSellerTransactions calls will only return order-level details if the IncludeContainingOrder boolean field is included in the call request and set to <code>true</code>. The AddOrder call is used to combine two or more unpaid order line items (between the same seller and buyer) into a 'Combined Invoice' order. While combining these order line items into one 'Combined Invoice' order, the seller can make adjustments to accepted payment methods, shipping details (including costs), and the total cost of the order. Sometimes, sellers will reduce the cost of shipping if one or more order line items can be shipped together in the same package. The GetMyeBaySelling call returns order details if the seller wishes to view listings that have sold, and the GetMyeBayBuying call returns order details if the buyer wishes to view items they have won or purchased. A unique identifier for a single or multiple line item eBay order. In the ContainingOrder container of a GetItemTransactions or GetSellerTransactions response, this identifier identifies the parent order of the order line item. A single buyer payment is made for each order. For order management calls only: This field is returned with the correct order ID only to the buyer and the seller. For third parties: <ul> <li>If using Trading WSDL version 1019 or newer (or Compatibility Level is set to '1019' or newer), the Order ID will be returned to third parties as an empty field (<code><OrderID/></code>).</li> <li>If using a Trading WSDL older than version 1019, the Order ID will be returned to third parties as dummy data in the form of <code>1000000000000</code> or <code>1000000000000-1000000000000</code>.</li> </ul> Note: The unique identifier of a 'non-immediate payment' order will change as it goes from an unpaid order to a paid order. Due to this scenario, all calls that accept Order ID values as filters in the request payload, including the GetOrders and GetOrderTransactions calls, will support the identifiers for both unpaid and paid orders. The revised order ID format (introduced in June 2019) is a non-parsable string, globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. Unlike in the past, instead of just being known and exposed to the seller, these unique order identifiers will also be known and used/referenced by the buyer and eBay customer support. Sellers can check to see if an order has been paid by looking for a value of 'Complete' in the CheckoutStatus.Status field in the response of GetOrders or GetOrderTransactions call, or in the Status.CompleteStatus field in the response of GetItemTransactions or GetSellerTransactions call. Sellers should not fulfill orders until buyer has made payment. 40 GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetItemTransactions GetSellerTransactions ContainingOrder

DetailLevel: none, ReturnAll

Conditionally This enumeration value indicates the current status of the order. GetOrders All, Authenticated, Default, Inactive, Invalid, Shipped

DetailLevel: none, ReturnAll

Always OrderReport All, Authenticated, Default, Inactive, Invalid, Shipped Always GetOrderTransactions All, Authenticated, Default, Inactive, Invalid, Shipped

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetItemTransactions GetSellerTransactions All, Authenticated, Default, Inactive, Invalid, Shipped

DetailLevel: none, ReturnAll

Conditionally This value indicates the dollar amount by which the buyer has adjusted the order total. Adjustments to order costs may include shipping and handling, buyer discounts, or added services. A positive amount indicates the amount is an extra charge being paid to the seller by the buyer. A negative value indicates this amount is a credit given to the buyer by the seller. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This value indicates the total amount paid by the buyer for the order. This amount includes the sale price of each line item, shipping and handling charges, additional services, and any sales tax that the seller has applied towards the order. This value is only returned after the buyer has paid for the order. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This value indicates the amount that the buyer saved on the order due to any discounts (item, shipping, promotional) applied to the purchase, or if the seller 'manually' reduced the order total. This field is always returned even when it is '0.0'. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This container indicates the current status of the order, including a timestamp that indicates the last time that the status of the order changed. For orders that have been paid for, the Status value will show as <code>Complete</code>. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always Container consisting of order-level shipping details. More shipping-related details can be found at the line item level for each line item in the order. In an AddOrder call, the seller can use the ShippingDetails container to make adjustments to shipping details, including the available shipping service options and shipping cost. Sometimes, sellers will reduce the cost of shipping if one or more order line items can be shipped together in the same package. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always AddOrder No GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally ShippingServiceOptions, ShippingType This value indicates whether a 'Combined Invoice' order was initiated/created by the buyer or by the seller. This field is only returned for Combined Invoice orders. An AddOrder call can be used by a seller or buyer to combine two or more unpaid order line items into a 'Combined Invoice' order. Once two or more line items are successfully combined into one order, the buyer only needs to make one payment (instead of multiple payments - one for each order line item). The CreatingUserRole field is required in the AddOrder call request. Note: Except for listings that required immediate payment, buyers also may have the opportunity to combine multiple line items (from the same seller) into a 'Combined Invoice' order through the buy/checkout flow. This may include accepted Best Offers or auctions that the buyer wins. https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listing-AnItem.html#CombinedInvoice Combined Invoice GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally AddOrder Yes Timestamp that indicates the date and time that the order was created. Note: For single line item orders, this timestamp value is often the same as the CreatedDate field in the corresponding Transaction container. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always In GetOrders, GetOrderTransactions, and OrderReport, a PaymentMethods field will appear for each payment method available to the buyer for the order's purchase. However, once the buyer pays for the order, any and all of these PaymentMethods fields will stop being returned, and instead, the actual payment method used will be returned in the PaymentMethod field of the CheckoutStatus container. In an AddOrder call, the seller can use one or more PaymentMethods fields to override whatever available payment methods were already defined for each individual line item. Note: For AddOrder, the seller can only specify offline payment methods (if offline payment is supported for the listing), as eBay now controls all electronic payment methods avaialable to buyers, and sellers have no control over these payment methods. AddOrder Conditionally CreditCard, DirectDebit GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always The email address of the seller involved in the order. The email address of the seller is only returned if it is the same seller making the call. Note: For the GetOrders and GetOrderTransactions calls, this field is only returned to the seller of the order; this field is not returned to the buyer or to a third party. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally AddOrder No This container shows the shipping address for the order. Note: For an Authenticity Guarantee program shipment, this is the address of the authenticator's warehouse. The authenticator is responsible for delivery to the buyer's shipping address. Note: For GetOrderTransactions, the buyer's shipping address may also be returned at the order line item level in the Transaction.Buyer.BuyerInfo.ShippingAddress container. Note: For eBay Vault scenarios: GetOrders, GetOrderTransactions, and GetItemTransactions calls, mock addresses are returned for: - Vault to vault orders: Buyer and Seller View - Ship to vault orders: Mock addresses are returned for the Buyer View (only); address returned for the Seller View will be the authenticator's address GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always Container consisting of details about the domestic or international shipping service selected by the buyer for delivery of the order. Note that more shipping service information may be returned at the order line item level in the Transaction.ShippingServiceSelected container. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always The cumulative item cost for all line items in the order. This value does not take into account any shipping/handling costs, sales tax costs, or any discounts. For a single line item order, the amount in this field should be the same as the amount in the Transaction.TransactionPrice field. For a multiple line item order, the amount in this field should equal the cumulative amount of each Transaction.TransactionPrice fields for each order line item. GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always The Total amount shows the total cost for the order, including total item cost (shown in Subtotal field), shipping charges (shown in ShippingServiceSelected.ShippingServiceCost field), and seller-applied sales tax (shown in SalesTax.SalesTaxAmount field). In an AddOrder call, the seller can pass in the Total amount for the 'Combined Invoice' order, and this is what the buyer will be expected to pay for the order. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always AddOrder Yes Container consisting of payment details for an eBay order, including an identifier for the monetary transaction and a field to express any fees or credits applied to the monetary transaction. This field is only returned after payment for the order has occurred. Note: The MonetaryDetails container also shows payment information for the order. In the future, it is possible that the ExternalTransaction container will be deprecated, so you are encouraged to start using MonetaryDetails as soon as possible. GetOrderTransactions GetOrders

DetailLevel: ReturnAll

Conditionally OrderReport Conditionally Container consisting of one or more line items that comprise an order. The data for each order line item in the order is stored in a separate Transaction container. Under the TransactionArray container in an AddOrder call, a seller or buyer specifies two or more (up to 40) order line items into a 'Combined Invoice' order. https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Listing-AnItem.html#CombinedInvoice Combined Invoice GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally AddOrder Yes The eBay user ID of the order's buyer. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always Timestamp indicating the date and time of order payment. This field is not returned until payment has been made by the buyer. This time is specified in GMT (not Pacific time). See <a href="https://developer.ebay.com/DevZone/guides/features-guide/default.html#basics/DataTypes.html#ConvertingBetweenUTCGMTandLocalTime"> eBay Features Guide</a> for information about converting between GMT and other time zones. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Timestamp indicating the date and time of order shipment. This field is not returned until shipment tracking is provided for all line items in the order, or if the order has been marked as 'shipped' by the seller. This time is specified in GMT (not Pacific time). See <a href="https://developer.ebay.com/DevZone/guides/features-guide/default.html#basics/DataTypes.html"> eBay Features Guide</a> for information about converting between GMT and other time zones. GetOrders

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field is no longer applicable as eBay sellers can no longer use iMCC gateway accounts to handle buyer payments. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Reserved for future use. This field is returned if the buyer left a message for the seller during checkout. GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Unique identifier for the user that does not change when the eBay user name is changed. Use when an application needs to associate a new eBay user name with the corresponding eBay user. Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field indicates the type and/or status of a payment hold on the item. It is always returned for GetOrders and GetOrderTransactions, even if there are no payment holds (in which case, an enumeration value of <code>None</code> is shown). Note: For the GetItemTransactions, GetOrders, and GetOrderTransactions calls, this field is only returned to the seller of the order; this field is not returned for the buyer or third party. GetOrders

DetailLevel: none

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This container consists of information related to the payment hold on the order, including the reason why the buyer's payment for the order is being held, the expected release date of the funds into the seller's account, and possible action(s) the seller can take to expedite the payout of funds into their account. This container is only returned if a payment hold has placed on the order. See PaymentHoldReasonCodeType for some details on why/when a seller's funds may be held, or visit the <a href="https://www.ebay.com/help/selling/getting-paid/getting-paid-items-youve-sold/pending-payments?id=4816">Pending payments</a> help topic for more information on eBay's payment hold policies. GetOrders

DetailLevel: none

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The amount of the refund due to, or already issued to the buyer for the order. This field is only returned in GetMyeBaySelling if a buyer refund is due, or was issued for the order. GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally This string value indicates the result of a seller's refund to the buyer. Its value are 'Success', 'Failure' or 'Pending'. This field is only returned in GetMyeBaySelling if the buyer has received a refund from the seller, or is due to receive a refund. GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally Note: This container was only used for Half.com orders, and since the Half.com site was taken down, this container is no longer applicable. 1027 NoOp 1033 If IsMultilegShipping is <code>true</code>, at least one order line item in the order will not be shipped directly to the buyer. Instead, the item(s) may be shipped to eBay's Global Shipping Program (GSP) partner who will handle the international leg of shipment, or the item may be shipped to eBay's Authenticity Guarantee service partner if the item is subject to the Authenticity Guarantee service program. In both cases, the partner's shipping address can be found in the MultiLegShippingDetails.SellerShipmentToLogisticsProvider.ShipToAddress container. If an order line item is subject to the Authenticity Guarantee service, the Transaction.Program container will be returned. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This container consists of details about the domestic leg of a Global Shipping Program (GSP) shipment or shipment to eBay's Authenticity Guarantee service partner. With GSP, the shipment has a domestic leg and an international leg. In the domestic leg, the seller ships the item to eBay's shipping partner. In the Authenticity Guarantee service, the seller ships the item to the authentication partner, and if the item passes an authentication inspection, the authentication partner ships it directly to the buyer. This container is only returned if the order has one or more order line items that require shipping through GSP or shipment to an Authenticity Guarantee service partner. It is not returned if IsMultilegShipping is <code>false</code>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Contains information about each monetary transaction that occurs for the order, including order payment, any refund, a credit, etc. Both the payer and payee are shown in this container. GetOrders

DetailLevel:ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel:ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel:ReturnAll

Conditionally Container consisting of an array of PickupOptions containers. Each PickupOptions container consists of the pickup method and its priority. The priority of each pickup method controls the order (relative to other pickup methods) in which the corresponding pickup method will appear in the View Item and Checkout page. For GetOrders and GetOrderTransactions, this container is always returned prior to order payment if the seller created/revised/relisted the item with the EligibleForPickupInStore and/or EligibleForPickupDropOff flag in the call request set to 'true'. If and when the In-Store pickup method (US only) or 'Click and Collect' pickup method (UK and Australia only) is selected by the buyer and payment for the order is made, this container will no longer be returned in the response, and will essentially be replaced by the PickupMethodSelected container. Note: A seller must be eligible for the In-Store Pickup feature or Click and Collect feature to list an item that is eligible for In-Store Pickup or Click and Collect. At this time, the In-Store Pickup and Click and Collect features are generally only available to large retail merchants, and can only be applied to multiple-quantity, fixed-price listings. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally Container consisting of details related to the selected pickup method, including the pickup method type, the merchant's store ID, the status of the pickup, and the pickup reference code (if provided by merchant). This container is only returned when the buyer has selected the In-Store Pickup or Click and Collect option and has paid for the order. All fields in the PickupMethodSelected container are static, except for the PickupStatus field, which can change states based on the notifications that a merchant sends to eBay through the Inbound Notifications API. Note: A seller must be eligible for the In-Store Pickup or Click and Collect feature to list an item that is eligible for these features. At this time, the In-Store Pickup and Click and Collect features are generally only available to large retail merchants, and can only be applied to multiple-quantity, fixed-price listings. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally This is the eBay user ID of the order's seller. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This is a unique identifier for the seller that does not change when the eBay user name is changed. This is useful when an application needs to associate a new eBay user name with the corresponding eBay user. Note: For the GetOrders call, this field is only returned to the seller of the order; this field is not returned for the buyer or third party. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value indicates the reason why the order cancellation was initiated. This field is only returned if an order cancellation has been initiated by the buyer or seller. Typical buyer-initiated cancellation reasons include 'OrderPlacedByMistake', 'WontArriveInTime', or 'FoundCheaperPrice'. Sellers may initiate an order cancellation on behalf of the buyer. In this scenario, the seller should state the cancellation reason as 'BuyerCancelOrder'. If the seller is cancelling an order because he/she is out of stock on an item, the seller should state the cancellation reason as 'OutOfStock'. Unfortunately, in this scenario, the seller will receive a seller defect for this cancellation reason. See <a href="types/CancelReasonCodeType.html">CancelReasonCodeType</a> for the complete list of enumeration values that can be returned in this field. Note: Only the CancelReason and CancelStatus fields are returned. The CancelDetail container and the CancelReasonDetails field are no longer returned. A seller can use the <a href="https://developer.ebay.com/Devzone/post-order/post-order_v2_cancellation_search__get.html">Search Cancellations</a> method of the Post-Order API to retrieve more details on a cancelled order. If the seller does use this method, they can use the Order ID or Item ID as a filter in the request to retrieve the correct cancellation request. CancelReasonCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The current status for the order cancellation request (if it exists for the order). This field is only returned if a cancellation request has been made on the order, or if the order is currently going through the cancellation process, or if the order has already been cancelled. Note: Only the CancelReason and CancelStatus fields are returned. The CancelDetail container and the CancelReasonDetails field are no longer returned. A seller can use the <a href="https://developer.ebay.com/Devzone/post-order/post-order_v2_cancellation_search__get.html">Search Cancellations</a> method of the Post-Order API to retrieve more details on a cancelled order. If the seller does use this method, they can use the Order ID or Item ID as a filter in the request to retrieve the correct cancellation request. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The detailed reason for the cancellation of an eBay order. This field is only returned if it is available when a cancellation request has been made on the order, or if the order is currently going through the cancellation process, or if the order has already been cancelled. Note: Only the CancelReason and CancelStatus fields are returned. The CancelDetail container and the CancelReasonDetails field are no longer returned. A seller can use the <a href="https://developer.ebay.com/Devzone/post-order/post-order_v2_cancellation_search__get.html">Search Cancellations</a> method of the Post-Order API to retrieve more details on a cancelled order. If the seller does use this method, they can use the Order ID or Item ID as a filter in the request to retrieve the correct cancellation request. Note: This field is no longer applicable/used. It was previously used for eBay Now and 'eBay On Demand Delivery' orders - two features that have been deprecated. 1095 1095 NoOp This container consists of details related to an eBay order that has been cancelled or is in the process of possibly being cancelled. Order cancellation requests can be viewed and managed with the cancellation API calls that are available in the <a href="https://developer.ebay.com/Devzone/post-order/index.html#CallIndex">Post Order API</a>. Note: Only the CancelReason and CancelStatus fields are returned. The CancelDetail container and the CancelReasonDetails field are no longer returned. A seller can use the <a href="https://developer.ebay.com/Devzone/post-order/post-order_v2_cancellation_search__get.html">Search Cancellations</a> method of the Post-Order API to retrieve more details on a cancelled order. If the seller does use this method, they can use the Order ID or Item ID as a filter in the request to retrieve the correct cancellation request. This field will be returned at the order level only if the buyer purchased a digital gift card, which is delivered by email, or if the buyer purchased an item that is enabled with the 'Click and Collect' feature. Currently, LogisticsPlanType has two applicable values: <code>PickUpDropOff</code>, which indicates that the buyer selected the 'Click and Collect' option. With Click and Collect, buyers are able to purchase from thousands of sellers on the eBay UK and Australia sites, and then pick up their order from the nearest 'eBay Collection Point', including over 750 Argos stores in the UK. The Click and Collect feature is only available on the eBay UK and Australia sites; or, <code>DigitalDelivery</code>, which indicates that the order is a digital gift card that will be delivered to the buyer or recipient of the gift card by email. LogisticsPlanCodeType GetOrders

DetailLevel:none,ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel:none,ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel:none,ReturnAll

Conditionally This container will either consist of VAT or Codice Fiscale taxpayer identification information for the buyer. It is now required that buyers registered on the Italy site provide their Codice Fiscale ID (similar to the Social Security Number for US citizens) before buying an item on the Italy site. On the Spain site, a Spanish seller has the option to require that Spanish buyers (registered on Spain site) provide a tax ID before checkout. This option is set by the seller at the account level. Once a Spanish buyer provides a tax ID, this tax ID is associated with his/her account, and once a tax ID is associated with the account, Spanish buyer will be asked to provide the tax ID during checkout on all eBay sites. Buyers with a registered address outside of Spain will not be asked to provide a tax ID during checkout. This container is only returned for Spanish or Italian sellers when the buyer was asked to provide tax identifier information during checkout. A BuyerTaxIdentifier container will be returned for each tax ID that is associated with the buyer's account. GetOrders

DetailLevel:none,ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel:none,ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel:none,ReturnAll

Conditionally This container is returned in GetOrders (and other order management calls) if the 'Pay Upon Invoice' option is being offered to the buyer, and the seller is including payment instructions in the shipping package(s) for the order. The 'Pay Upon Invoice' option is only available on the Germany site. GetOrders

DetailLevel:none,ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel:none,ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel:none,ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally A unique identifier for an eBay order in the eBay REST API model. ExtendedOrderID values will be used to identify orders in REST-based APIs, including the Post-Order API and the Fulfillment API. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the correct Order ID is returned to the buyer or seller, but a dummy Order ID value of <code>1000000000000</code> will be returned to all third parties. Note: As of June 2019, eBay has changed the format of order identifier values, and this new format is relevant to both legacy and REST API-based order ID fields. The new format is a non-parsable string, globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. Unlike in the past, instead of just being known and exposed to the seller, these unique order identifiers will also be known and used/referenced by the buyer and eBay customer support. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally If <code>true</code>, the order contains a transaction for an item that was purchased under the eBay Plus program. eBay Plus is a premium account option for buyers, which provides benefits such as fast free domestic shipping and free returns on selected items. Top-Rated eBay sellers must opt in to eBay Plus to be able offer the program on qualifying listings. Sellers must commit to next-day delivery of those items. Note: Currently, eBay Plus is available only to buyers in Germany and Australia. more details Offering eBay Plus ../../../../guides/features-guide/default.html#development/Feature-eBayPlus.html GetOrders GetOrderTransactions Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This boolean field is returned as <code>true</code> if one or more line items in the order are subject to a tax (US sales tax or Australian Goods and Services tax) that eBay will collect and remit to the proper taxing authority on the buyer's behalf. This field is also returned if <code>false</code> (not subject to eBay Collect and Remit). A Transaction.eBayCollectAndRemitTaxes container is returned for any order line items subject to such a tax, and the type and amount of this tax is displayed in the Transaction.eBayCollectAndRemitTaxes.TaxDetails container. Australian 'Goods and Services' tax (GST) is automatically charged to buyers outside of Australia when they purchase items on the eBay Australia site. Sellers on the Australia site do not have to take any extra steps to enable the collection of GST, as this tax is collected by eBay and remitted to the Australian government. For more information about Australian GST, see the <a href="https://www.ebay.com.au/help/selling/fees-credits-invoices/taxes-import-charges?id=4121">Taxes and import charges</a> help topic. As of November 2021, buyers in all US states except for Missouri (and several US territories), will automatically be charged sales tax for purchases, and the seller does not set this rate. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. For more US state-level information on sales tax, see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/taxes-import-charges?id=4121#section4">eBay sales tax collection</a> help topic. GetOrders Always OrderReport Always GetOrderTransactions Always GetItemTransactions Always GetSellerTransactions Always This field indicates the total number of line items in the order. This field is returned under the ContainingOrder container of a GetItemTransactions or GetSellerTransactions call. In order for the ContainingOrder container to be returned, a user must include the IncludeContainingOrder field in the call request and set its value to true. Note: This field is automatically returned if the user is using Version 1113 of the Trading WSDL (or newer), or if the user includes the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header and sets its value to <code>1113</code> (or newer). If a user is using a Trading WSDL older than 1113 (or is not setting the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header value to 1113 or newer), this field will not be returned. GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Enumerated type that lists the possible states of buyer payment for an order. PaymentPendingWithEscrow, PaidWithEscrow, EscrowPaymentCancelled, PaymentPendingWithPaisaPay, PaidWithPaisaPay, PaymentPendingWithPaisaPayEscrow, PaidWithPaisaPayEscrow, PaisaPayNotPaid, PaymentPendingWithPayPal, PaidWithPayPal This enumeration value is returned if the buyer has completed checkout, but eBay cannot confirm whether or not the buyer has paid for the order. It is possible that the buyer has paid with an 'offline' payment method, but the order has not been marked as paid. This enumeration value is returned if the buyer has not completed the checkout process and so has not made payment. This value is deprecated and should no longer be returned. This value is deprecated and should no longer be returned. This enumeration value is returned if the order was marked as paid by eBay or the seller. This enumeration value is returned if the buyer's payment is in process, but not yet complete. This enumeration value is returned if the buyer's payment was refunded. The selected payment method is COD and the buyer will make the payment upon delivery. The buyer has paid for the order with the COD payment method. Reserved for future use. This enumeration value is returned if the buyer has paid for the order. This enumeration value is returned if the buyer was offered the 'Pay Upon Invoice' option. The 'Pay Upon Invoice' option is only available to eligible German buyers as part of Progressive Checkout on the German site. If a German buyer is offered the 'Pay Upon Invoice' option, that buyer is not required to pay for the order until after receiving an order invoice from the seller. This enumeration type is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. Reserved for internal or future use This enumeration type is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. Reserved for internal or future use This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration type is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. Reserved for internal or future use. Type defining the PaymentDetails container, which is used by the seller to specify the amount of the initial deposit, and the due dates for the deposit and the full payment for a motor vehicle listing. Note: The seller may not use the PaymentDetails container if selling a motor vehicle through a Classified Ad listing. If it is used in a Trading call, it will be dropped and the seller will get a warning that it was dropped. For a Classified Ad listing, the buyer and seller directly discuss amongst themselves any details on a deposit, or due dates for a deposit and full balance. eBay will not be involved in this process for a Classified Ad listing. This field is used to set the due date (in hours) for the motor vehicle deposit. The deposit amount is specified in the DepositAmount field. The "clock starts" on the deposit due date as soon as the buyer commits to buying the vehicle by clicking the Buy It Now button, by winning the auction, or by the seller accepting that buyer's Best Offer/counteroffer. The three supported values here are <code>24</code>, <code>48</code> (default), and <code>72</code> hours. Note: If the immediate payment requirement is set for the listing (see Item.AutoPay description), and the listing qualifies for immediate payment (e.g. the Buy It Now button is used), the HoursToDeposit field will not be applicable, since the buyer will be required to pay any deposit amount immediately (and not within 1, 2 or 3 days). 24 (hours) 72 (hours) 48 (hours) AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This field is used to set the due date (in days) for the buyer to pay off the full balance of the motor vehicle. The "clock starts" on the full payment due date as soon as the buyer commits to buying the vehicle by clicking the Buy It Now button, by winning the auction, or by the seller accepting that buyer's Best Offer/counteroffer. The three supported values here are <code>3</code>, <code>7</code> (default), <code>10</code>, and <code>14</code> days. The seller must specify one or more of the following offline payment methods in the listing. The buyer will be expected to use one of these payment method options to pay the full balance of the motor vehicle. <ul> <li>CashOnPickup</li> <li>MOCC (money order or cashier's check)</li> <li>PersonalCheck</li> </ul> 3 14 7 AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This dollar value indicates the amount of the initial deposit on the vehicle required from the buyer. If the immediate payment requirement is set for the listing (see Item.AutoPay description), and the listing qualifies for immediate payment (e.g. the Buy It Now button is used), the deposit will be required immediately, and the HoursToDeposit field (if set) will not be applicable. If immediate payment is required for a motor vehicle deposit, the value input into this field cannot exceed '500.0', or an error will occur. If there is no immediate payment requirement set for the listing the deposit will be required in 24, 48, or 72 hours after commitment to purchase (see the HoursToDeposit field). If immediate payment is not required for a motor vehicle deposit, the value input into this field cannot exceed '2000.0', or an error will occur. If this field is not included in an Add/Revise call, its value defaults to '0.0', which would technically mean that a deposit is not required, even if the DepositType and HoursToDeposit fields were included. Motor vehicle deposit details will be shown to prospective buyers in the listing. The available payment methods for the deposit will be shown on the checkout page once the buyer clicks the the Buy It Now button. For ReviseItem and related calls: If the listing has no bids, the seller can add or lower a deposit; and they can increase the deposit if the listing doesn't require immediate payment. The seller can also remove the immediate payment option (if any). If the listing has bids, the seller can only lower an existing deposit; but not add or increase a deposit. The seller can't remove immediate payment when a listing with a deposit has bids. 500.0 (if immediate payment required); 2000.0 (if immediate payment not required) AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally In order for a seller to require a motor vehicle deposit from a buyer, this field must be included and set to <code>OtherMethod</code>. Otherwise, the field will default to <code>None</code> and a deposit will not be required. None AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This type defines the PaymentHoldDetails container, which consists of information related to eBay holding the payment proceeds for an order, including the reason why eBay is holding the money, the expected release date of the funds to the seller, and possible action(s) the seller can take to expedite the release of funds. Timestamp that indicates the expected date in which eBay will distribute the funds to the seller's account. This is not a firm date and is subject to change. This field is only returned after checkout is complete and if the PaymentHoldStatus indicates a hold has been placed on payment. GetOrders

DetailLevel: none

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBaySelling

DetailLevel: none,ReturnAll

Conditionally Container consisting of one or more RequiredSellerAction fields. RequiredSellerAction fields provide possible actions that a seller can take to expedite the release of funds into their account. GetOrders

DetailLevel: none

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBaySelling

DetailLevel: none,ReturnAll

Conditionally Integer value that indicates the number of possible actions that a seller can take to possibly expedite the release of funds into their account. This value should equal the number of RequiredSellerAction fields contained in the RequiredSellerActionArray container. GetOrders

DetailLevel: none

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Enumerated value that indicates why the buyer's payment for the order is being held by eBay instead of being distributed to the seller's account. GetOrders

DetailLevel: none

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBaySelling

DetailLevel: none,ReturnAll

Conditionally Enumerated type that contains all possible reasons why the buyer's payment for the order is being held by eBay instead of being distributed to the seller's account. A seller's funds for an order can be held by eBay for as little as three days after the buyer receives the order, but the hold can be up to 21 days based on the scenario, and in some cases, the seller's lack of action in helping to expedite the release of funds. SellerIsOnBlackList, None, NewPaypalAccountAdded This value indicates that the buyer's payment for the order is being held by eBay because the seller is new to selling on eBay. This value indicates that the buyer's payment for the order is being held by eBay because the seller has been classified as a Below Standard seller. This value indicates that the buyer's payment for the order is being held by eBay because an eBay Money Back Guarantee case has been filed against the order. If this value is returned, the seller can expedite the release of funds into their account by resolving the eBay Money Back Guarantee case, as indicated by a value of 'ResolveeBPCase' returned in a PaymentHoldDetails.RequiredSellerActionArray.RequiredSellerAction field. This value indicates that the buyer's payment for the order is being held by eBay because the seller has recently been reinstated as an active eBay seller after their account went through a suspension/restricted period. This value indicates that the buyer's payment for the order is being held by eBay because the seller is classified as a casual (or infrequent) seller on eBay. This value is deprecated. This value indicates that the reason for the buyer's payment for the order being held by eBay is not known. This value is reserved for internal or future use. This value is returned if the reason for the buyer's payment for the order being held by eBay cannot be classified by any of the other enumeration values. This value is reserved for internal or future use. This value is reserved for internal or future use. Enumerated type that contains the list of possible values that can be returned in the PaymentHoldStatus container. ReleaseFailed This value indicates a possible issue with the buyer that needs to be reviewed by eBay. This value indicates a possible issue with the seller that needs to be reviewed by eBay. This value indicates that a payment hold on the order has been released. This value indicates that there is no payment hold on the order. This value indicates that there is a "new seller hold" on the order. eBay may hold payments to a new seller for up to 21 days. This value indicates that there is a payment hold on the order. This value indicates that the process for the release of funds for the order has been initiated. This value indicates that the funds are available in the seller's account. This value is no longer used. This value is reserved for internal or future use. This type contains information about one or more payments made by the buyer to pay for an order. This container consists of detailed information about each payment made by the buyer to pay for an order. In many cases, there may be only one payment - the payment made from the buyer to the seller, but in the case of an order going through the Global Shipping Program, one payment goes to the seller for the price of the order, and then an import charge and a portion of the shipping charges may go to eBay Global Shipping Program partner. In the case of an order that is subject to Australia import tax, one payment goes to the seller for the total price of the order, and the import tax goes to eBay for remittance to the Australian government. Note: Australia import tax is only applicable to the Australia site. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This enumerated type indicates the type of payment instructions included in the shipping package. This enumeration value indicates that payment instructions were included in the shipping package for the 'Pay Upon Invoice' order. Reserved for internal or future use. Type defining the values that can be returned in the eBayPaymentStatus field of order management calls. These values indicate the current status of the buyer's payment for an order. BuyerECheckBounced, BuyerCreditCardFailed, PayPalPaymentInProcess This value indicates that the buyer's payment for the order has cleared. A CheckoutStatus.eBayPaymentStatus value of 'NoPaymentFailure' and a CheckoutStatus.Status value of 'Complete' indicates that checkout is complete. This value should no longer be returned as electronic checks are no longer a valid buyer payment method on any eBay marketplace. This value should no longer be returned as the buyer's form of electronic payment is no longer exposed to the seller since eBay now receives payment from the buyer. This value indicates that the seller reported the buyer's offline payment as failed. This enumeration value would only be applicable for a sales transaction that occurred off of eBay's platform. This value should no longer be returned as the buyer's form of electronic payment is no longer exposed to the seller since eBay now receives payment from the buyer. This value indicates that the buyer's payment is in process, but has not yet cleared. Note: This value may also get returned for a sales transaction that occurred off of eBay's platform, and the payment status may stay in this state unless the seller marks the order as paid. Reserved for internal or future use. Type defining the possible states of a payment transaction. This type is used by several containers in order management-related calls. This value indicates that the payment transaction failed. This value indicates that the payment transaction succeeded. If the payment transaction is a buyer's payment for an order, once this <code>Succeeded</code> value is returned in an order management call, it is safe for the seller to ship the order to the buyer. Note: Previously, the <code>Succeeded</code> value would automatically get returned for order payment transactions that were occurring off of eBay's platform. As of March 2020, the <code>Pending</code> value will get returned instead for order payment transactions occurring off of eBay's platform, and the seller can use the CompleteSale call to mark the order as paid. Once the seller does this, the payment status will change from <code>Pending</code> to <code>Succeeded</code>. This value indicates that the payment transaction is pending. Note: Previously, the <code>Succeeded</code> value would automatically get returned for order payment transactions that were occurring off of eBay's platform. As of March 2020, the <code>Pending</code> value will get returned instead for order payment transactions occurring off of eBay's platform, and the seller can use the CompleteSale call to mark the order as paid. Once the seller does this, the payment status will change from <code>Pending</code> to <code>Succeeded</code>. Reserved for internal or future use. This type contains details about the allocation of funds to one payee from a buyer payment for a specified order. The current status of a buyer payment that is allocated to a specified payee. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This field indicates the eBay user or eBay partner who submitted the payment. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the correct payer is returned to the buyer or seller, but the identity of the payer will be masked to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The person or organization who is to receive the payment allocation. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The date and time when the payment is received by the payee. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The amount of the payment that is allocated to the payee. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally A unique transaction ID for the payment. This field is not returned if the Payee field's type attribute is <code>eBayPartner</code>. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the correct payment identifier is returned to the buyer or seller, but the payment identifier will be masked to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Fee Amount is a positive value and Credit Amount is a negative value. This field is not returned if the Payee field's type attribute is <code>eBayPartner</code>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The payment transaction ID. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the correct payment identifier is returned to the buyer or seller, but the payment identifier will be masked to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This type defines the MonetaryDetails container, which consists of detailed information about one or more exchanges of funds that occur between the buyer, seller, eBay, and eBay partners during the lifecycle of an order, as well as detailed information about a merchant's refund (or store credit) to a buyer who has returned an In-Store Pickup item. Note: At this time, the In-Store Pickup feature is generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings. Contains information about how different portions of the funds exchanged for a specified order are allocated among payees. Each allocated portion is represented by a Payment container. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This container consists of an array of one or more Refund containers, and each Refund container consists of detailed information about a merchant's refund (or store credit) to a buyer who has returned an In-Store Pickup item. This container is only returned if the buyer has returned an In-Store Pickup item to the merchant at a physical store, and the merchant has notified eBay through the ORDER.RETURNED notification of the Inbound Notifications API. Note: At this time, the In-Store Pickup feature is generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. Type defining the time periods used when evaluating the number of unpaid item strikes that a buyer has against their account. A seller can set up listing-level Buyer Requirements in an Add/Revise/Relist call that will block a buyer if that buyer has a specified number of unpaid item strikes against their account during a specified time period. Days_1, Days_540 This value is no longer applicable. This value indicates that the evaluation period is set back 30 days from the present date. This value indicates that the evaluation period is set back 180 days (approximately 6 months) from the present date. This value indicates that the evaluation period is set back 360 days (approximately 12 months) from the present date. This value is no longer applicable. This value is reserved for future or internal use. Specifies the type of image display used in a listing. Some options are only available if images are hosted through eBay Picture Services (EPS). SiteHostedPictureShow, SlideShow, VendorHostedPictureShow No special image display options. Valid for US Motors listings. This value is no longer applicable. Increase the size of each image and allow buyers to enlarge images further. Only available for site-hosted (EPS) images. Not valid for US Motors listings. For all sites that do not automatically upgrade SuperSize to PicturePack (see note below), specifying no SuperSize-qualified images is now accepted in the request. Note: SuperSize is automatically upgraded to PicturePack for the same SuperSize fee on the US Motors Parts & Accessories Category and US (site ID 0) and CA (site ID 2) and CAFR (site ID 210). This upgrade applies only to EPS images. Increase the number of images displayed. This is only available for images hosted with eBay. See GetCategoryFeatures and the online Help (on the eBay site) for additional information. Picture Pack applies to all sites (including US Motors), except for NL (site ID 146). You can specify a minimum of one EPS picture, or no SuperSize-qualified EPS pictures in the request. For the NL site, PicturePack is replaced with SuperSize. This value is no longer applicable. This value is no longer applicable. This is valid for US Motors listing only. For other listings, use SuperSize. Reserved for internal use only. This type defines the PickupDetails container, which contains an array of PickupOptions containers. Each PickupOptions container consists of the pickup method and its priority. Note: At this time, the In-Store Pickup and Click and Collect features are generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings. In-Store Pickup is only applicable to the US site, and Click and Collect is only applicable to the UK, Germany, and Australia sites. Container consisting of a pickup method and the priority of the pickup method. The priority of each pickup method controls the order (relative to other pickup methods) in which the corresponding pickup method will appear in the View Item and Checkout page. This container is always returned prior to order payment if the seller created/revised/relisted the item with the EligibleForPickupInStore and/or EligibleForPickupDropOff flag in the call request set to 'true'. If and when the In-Store pickup method (US only) or 'Click and Collect' pickup method (UK and Australia only) is selected by the buyer and payment for the order is made, this container will no longer be returned in the response, and will essentially be replaced by the PickupMethodSelected container. Note: At this time, the In-Store Pickup and Click and Collect features are generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings. In-Store Pickup is only applicable to the US site, and Click and Collect is only applicable to the UK, Germany, and Australia sites. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally Complex type defining the PickupInStoreDetails container, that is used in Add/Revise/Relist calls to enable the listing for In-Store Pickup or Click and Collect. Note: At this time, In-Store Pickup as a fulfillment method is only available to a limited number of large retail merchants in the US, Canada, UK, Germany, and Australia marketplaces, and can only be applied to multiple-quantity, fixed-price listings. The Click and Collect feature is only available to large merchants on the UK, Australia, and Germany marketplaces. For Add/Revise/Relist/Verify calls: this field is included to enable the listing for In-Store Pickup. To enable the listing for In-Store Pickup, the seller includes this boolean field and sets its value to <code>true</code>. In-Store Pickup as a fulfillment method is only available to a limited number of large retail merchants in the US, Canada, UK, Germany, and Australia marketplaces. The In-Store Pickup feature can only be applied to multiple-quantity, fixed-price listings. In addition to setting the EligibleForPickupInStore boolean field to <code>true</code>, the merchant must also perform the following actions in an Add/Revise/Relist/Verify call to enable the In-Store Pickup option on a multiple-quantity, fixed-price listing: <ul> <li>Have inventory for the product at one or more physical stores tied to the seller's account. By using the REST-based Inventory API, sellers can associate physical stores to their account by using the Create Inventory Location call, and then, using the Create Inventory Item call, they can add inventory to specific stores;</li> <li>Include the seller-defined SKU value of the product(s) in the call request. For a single-variation listing, the SKU value would be specified in the Item.SKU field, and for a multiple-variation listing, the SKU value(s) would be specified in the Item.Variations.Variation.SKU field(s);</li> <li>Set an immediate payment requirement on the item. </li> </ul> When a seller is successful at listing an item with the In-Store Pickup feature enabled, prospective buyers within a reasonable distance (25 miles or so) from one of the seller's stores (that has stock available) will see the "Available for In-Store Pickup" option on the listing, along with information on the closest store that has the item. This field is returned in the 'Get' calls if the listing is enabled with the In-Store Pickup feature. false AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetSellerList GetItemShipping GetItem Conditionally For sellers opted in to Click and Collect, this field was once used to set Click and Collect eligibility at the listing level. However, now the seller can only opt in to Click and Collect at the account level, and then each of their listings will be automatically evaluated by eBay for Click and Collect eligibility. Note: Until this field is fully deprecated in the Trading WSDL (and in Add/Revise/Relist/Verify calls), it can still be used, but it will have no functional affect. However, if set in an Add/Revise/Relist/Verify call, it will get returned in GetItem, but it won't be a true indicator if the item is actually available for the Click and Collect fulfillment method. Instead, the Item.AvailableForPickupDropOff field should be referenced to see if the listing actually has inventory that is available for pickup via the Click and Collect fulfillment method. GetSellerList GetItemShipping GetItem Conditionally Type defining the PickupMethodSelected container, which consists of details related to the selected local pickup method (In-Store Pickup or "Click and Collect"), including the pickup method, the merchant's store ID, the status of the pickup, and the pickup reference code (if provided by merchant). Note: At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. The "Click and Collect" feature is only available to large merchants on the eBay UK (site ID - 3), eBay Australia (Site ID - 15), and eBay Germany (Site ID - 77) sites. This value indicates the local pickup method that was selected by the buyer at checkout. This field is always returned with the PickupMethodSelected container. Note: Merchants must be eligible for the In-Store Pickup or "Click and Collect" feature to list items that are eligible for these local pickup methods. PickupMethodCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally The unique identifier of the merchant's store where the item will be picked up. The PickupStoreID is picked up by eBay based on the LocationID value that is set by the merchant in the Inventory Management API. This field is always returned with the PickupMethodSelected container. Note: A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally This field indicates the current status of the local pickup order. The value of the PickupStatus field can change during the lifecycle of the order based on the notifications that a merchant sends to eBay through the Inbound Notifications API. This field is always returned with the PickupMethodSelected container. Note: A seller must be eligible for the In-Store Pickup or Click and Collect features to list an item that is eligible for these features. At this time, these features are generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally The unique reference number defined by the merchant to track In-Store Pickup orders. The MerchantPickupCode is picked up by eBay if it is set by the merchant through the payload of a notification sent to eBay through the Inbound Notifications API. This field is only returned with the PickupMethodSelected container if it set by the merchant. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the real reference number is only returned to the buyer or seller, and a string value of <code>Unavailable</code> will be returned to all third parties. Note: A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally Timestamp indicating the date/time when the order is expected to be fulfilled by the merchant and available for pick up by the buyer. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The unique identifier of the merchant's store where the "Click and Collect" item will be picked up. This field will only be returned if supplied by the merchant. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally Type defining the PickupOptions container, which consists of a pickup method and the priority of the pickup method. Note: At this time, the In-Store Pickup and Click and Collect features are generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. This value indicates an available pickup method. This field is always returned with the PickupOptions container. Note: At this time, 'InStorePickup' and 'PickUpDropOff' are the only available pickup methods; however, additional pickup methods may be added to the list in future releases. Note: A seller must be eligible for the In-Store Pickup or Click and Collect feature to list an item that is eligible for In-Store Pickup or Click and Collect. At this time, In-Store Pickup is generally only available to large retail merchants in US, and the 'Click and Collect' feature is only available to large merchants on the eBay UK (site ID - 3), eBay Australia (Site ID - 15), and eBay Germany (Site ID - 77) sites. PickupMethodCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally This integer value indicates the priority of the pickup method. The priority of each pickup method controls the order (relative to other pickup methods) in which the corresponding pickup method will appear in the View Item and Checkout page. This field is always returned with the PickupOptions container. Note: A seller must be eligible for the In-Store Pickup or Click and Collect features to list an item that is eligible for In-Store Pickup or Click and Collect. At this time, In-Store Pickup is generally only available to large retail merchants in US, and the 'Click and Collect' feature is only available to large merchants on the eBay UK (site ID - 3), eBay Australia (Site ID - 15), and eBay Germany (Site ID - 77) sites. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally Simple type defining all possible states for an In-Store Pickup order. The value of the PickupStatus field (returned under the PickupMethodSelected container) can change during the lifecycle of the order based on the notifications that a merchant sends to eBay through the Inbound Notifications API. Note: At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. This value indicates that the current status value of the In-Store Pickup order is invalid. This value indicates that the current status value of the In-Store Pickup order is not applicable. This status indicates that the In-Store Pickup order has yet to be acknowledged by the merchant. This is typically the state before the merchant sends the ORDER.READY_FOR_PICKUP notification to eBay through the Inbound Notifications API. This status indicates that the In-Store Pickup order is ready to be picked up by the buyer. This state occurs after the merchant sends the ORDER.READY_FOR_PICKUP notification to eBay through the Inbound Notifications API. This status indicates that the In-Store Pickup order has been picked up by the buyer. This state occurs after the merchant sends the ORDER.PICKEDUP notification to eBay through the Inbound Notifications API. This status indicates that the In-Store Pickup order has been cancelled by the merchant, because the product was out of stock. This state occurs after the merchant sends the ORDER.PICKUP_CANCELED notification (with the CANCEL_TYPE parameter in the notification payload set to "OUT_OF_STOCK") to eBay through the Inbound Notifications API. This status indicates that the In-Store Pickup order has been cancelled by the merchant, because the buyer rejected the item. This state occurs after the merchant sends the ORDER.PICKUP_CANCELED notification (with the CANCEL_TYPE parameter in the notification payload set to "BUYER_REJECTED") to eBay through the Inbound Notifications API. This status indicates that the In-Store Pickup order has been cancelled by the merchant, because the buyer never showed up to pick up the item. This state occurs after the merchant sends the ORDER.PICKUP_CANCELED notification (with the CANCEL_TYPE parameter in the notification payload set to "BUYER_NO_SHOW") to eBay through the Inbound Notifications API. This status indicates that the In-Store Pickup order has been cancelled, and the exact reason is not available. This value is reserved for internal or future use. Contains the data for the pictures associated with an item. <a name="galleryTypeField"></a> This field is used to specify the type of picture gallery to use for the listing. If this field is omitted, a standard picture gallery is used for the listing. There is no listing fee for a standard picture gallery. To use the Gallery Plus feature, you must include this field and set its value to <code>Plus</code>. The Gallery image will be the first URL passed into the first PictureURL field, so if you want a specific picture to be the Gallery image, you should make sure you pass the URL for this picture in the first PictureURL field. When revising a listing, if you disable the Gallery Plus or Featured Gallery feature by including the GalleryType and setting its value to <code>Gallery</code>, the original feature fee for either of these features will not be credited to the seller. Gallery AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Gallery AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem VerifyAddFixedPriceItem No Specifies the type of image display used in a listing. Some options are only available if images are hosted through eBay Picture Services (EPS). eBay determines this by parsing the associated PictureURL. Some PhotoDisplay options can result in listing fees, even when the item is relisted. If you are relisting an item that was originally listed with a PhotoDisplay option, and you do not want that PhotoDisplay enhancement in your relisted item, you need to specifically remove PhotoDisplay in your RelistItem call (or RelistFixedPriceItem, as applicable) by setting PhotoDisplay to <code>None</code>. Use VerifyRelistItem to review your listing fees before you relist an item. PicturePack AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList SlideShow Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SlideShow Always AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem VerifyAddFixedPriceItem No Contains the URL for a picture of the item. The URL can be from the eBay Picture Services (images previously uploaded) or from a server outside of eBay (self-hosted). You can pass in up to 12 picture URLs (for most categories and marketplaces) for each listing, but you cannot mix self-hosted and EPS-hosted URLs in the same listing. The UploadSiteHostedPictures call can be used to upload pictures to EPS. Note that if pictures are externally-hosted, they must be hosted on a site that is using the 'https' protocol. URLs using the 'http' protocol will not be allowed. Note: If a URL contains spaces, those spaces can be replaced with <code>%20</code>. For example, <code>https://example.com/my image.jpg</code> must be submitted as <code>https://example.com/my%20image.jpg</code> to replace the space in the image file name. However, a semicolon character (;) cannot be replaced with <code>%20</code>, so a semicolon cannot be a part of the URL, as an error will occur. On the US and Canada eBay Motors sites (for all vehicle listings) a listing can contain up to 24 pictures. The Gallery image will be the first PictureURL in the array of PictureURL fields. Note: All images, whether they are hosted by EPS or self-hosted, must comply with eBay picture requirements, including the requirement that all images must be at least 500 pixels on its longest side. If the image does not satisfy the 500 pixels requirement, the listing may be blocked. For more information about other requirements and tips for adding pictures to listings, see the <a href="https://www.ebay.com/help/selling/listings/adding-pictures-listings?id=4148">Adding pictures to your listings</a> help page. To specify multiple pictures, send each URL in a separate, PictureDetails.PictureURL element. The first URL passed in defaults to be the 'gallery image', and will be the first picture that is shown when a user lands on the View Item page. If a listing uses a single, self-hosted picture (except in the case of a multiple-variation listing), the picture will be copied to eBay Picture Services (EPS) and the PictureDetails.PictureURL value returned by GetItem will be an EPS URL. For VerifyAddItem only: You must include a picture even when using VerifyAddItem. If you don't have a image file, you can use the following fake eBay Picture Services URL (https://i2.ebayimg.com/abc/M28/dummy.jpg) with this call. For ReviseItem and RelistItem only: To remove a picture when revising or relisting an item, specify PictureDetails with all the pictures that you want the listing to include. That is, you need to completely replace the original set of URLs with the revised set. You cannot remove all the PictureURL fields from a listing because each listing requires at least one picture. Remember: The 'gallery image' will be the first PictureURL in the array of PictureURL fields. So, if the first image passed in when relisting/revising is different from when the listing was created, the 'gallery image' will be changed. Note: For some large merchants, there are no limitations on when pictures can be added or removed from a fixed-price listing, even when the listing has had transactions or is set to end within 12 hours. 500 AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ReturnAll

24 AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem VerifyAddFixedPriceItem Conditionally Introduction to Pictures in Listings https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Pictures-Intro.html Working with Pictures in an Item Listing https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Pictures-InListing.html The service hosting the pictures in PictureURL, if any. This information is primarily useful for Picture Manager subscribers, who pay a flat subscription fee instead of individual picture fees per listing. Only returned when PictureURL is returned. GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally EPS AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem VerifyAddFixedPriceItem No Indicates if the gallery image upload failed and gives a reason for the failure, such as 'InvalidUrl' or 'ServerDown'. It is not returned if the gallery image is uploaded successfully. GetItem Conditionally Indicates the reason the gallery generation failed, such as, URL for the image is not valid. This field is returned when GalleryStatus field is returned and does not appear when the gallery generation is successful. 1024 GetItem Conditionally When returned this contains the original URL of a self-hosted pictures, associated with the item when the item was listed. 500 1 GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ReturnAll

Using a Self-Hosted Picture https://developer.ebay.com/devzone/guides/features-guide/default.html#Development/Pictures-InListing.html#UsingaSelfHostedPicture This container returns the URLs of the seller's self-hosted (hosted outside of eBay) pictures and the URL for the corresponding eBay Picture Services (EPS), that was generated when the self-hosted picture was uploaded. GetItem Conditionally PictureManager Enumerated type used to specify where a listing's image(s) are hosted. This value indicates that the image(s) specified in the PictureURL field(s) are hosted by eBay Picture Services. This value is deprecated. This value indicates that the image(s) specified in the PictureURL field(s) are hosted by a third-party vendor. Note that if pictures are externally-hosted, they must be hosted on a site that is using the 'https' protocol. (out) Reserved for internal or future use. This container returns the URLs of the seller's self-hosted (hosted outside of eBay) pictures and the URL for the corresponding eBay Picture Services (EPS), that was generated when the picture was uploaded. The URL of an eBay Picture Services (EPS) image. This image is created when a seller uploads a self-hosted image using the UploadSiteHostedPictures, AddItem or AddFixedPriceItem call. 150 24 GetItem Conditionally

DetailLevel: none,ItemReturnDescription,ReturnAll

The URL of a seller's self-hosted image(s). 150 GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ReturnAll

Defines variation-specific pictures associated with one VariationSpecificName (e.g., Color) whose values differ across variations. One aspect of the variations that will be illustrated in the pictures for all variations. For example, if each variation is visually distinguished by color and the pictures show the different colors available, then specify "Color" as the name. The name must match one of the names specified in the VariationSpecifics container. This field is required in each Item.Variations.Pictures container that is used. 40 AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

A container consisting of one or more picture URLs associated with a variation specific value (e.g., color=blue). For example, suppose a listing contains blue and black color variations, and VariationSpecificName=Color. In this case, one picture set could contain pictures of the blue shirts (e.g., front view, back view, and close-up of a trim detail), and another picture set could contain pictures of the black shirts. A variation specific picture set can consist of up to 12 images hosted by eBay Picture Services (EPS) or self-hosted (hosted outside of eBay) pictures. The eBay Picture Services and self-hosted images can never be combined into the same variation specific picture set. At least one picture set is required if the Pictures node is present in the request. You are not required to provide pictures for all values that correspond to the variation specific name. For example, a listing could have pictures depicting the blue and black color variations, but not the pink variations. Note: All images must comply with the <a href="https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Pictures-Intro.html">Picture Requirements</a>. AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This enumerated type defines the available discount price treatments that can be set up by eligible sellers. This enumeration value indicates that Strikethrough Pricing is enabled for the order line item. If this value is returned, the price in the OriginalRetailPrice field will be crossed out in the View Item page. This enumeration value indicates that Minimum Advertised Pricing is enabled for the order line item. If this value is returned, the minimum advertised price is found in the MinimumAdvertisedPrice field. This enumeration value indicates that neither Strikethrough Pricing or Minimum Advertised Pricing is enabled for the order line item. This enumeration value indicates that Made For Outlet Comparison Pricing is enabled for the order line item. If this value is returned, the Made For Outlet Comparison price is found in the MadeForOutletComparisonPrice field. Reserved for future use. This type is deprecated. This field is deprecated. This field is deprecated. This type is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. Type used by the ProductListingDetails container, which is used by a seller in an add/revise/relist call to identify a product through a Global Trade Item Number (EAN, ISBN, or UPC) or an eBay Product ID (e.g. 'ePID'). If a specified product identifier is matched to a product in the eBay catalog, some of the details for the product listing, such as listing category, product title, product description, product aspects, and stock photo are prefilled for the listing. Note: If a Brand/MPN pair is required for the product, these values must still be input through the BrandMPN container. If this value is <code>true</code>, the listing will use the eBay catalog product's stock photo. In an Add/Revise/Relist call, this field is set to <code>true</code> by default. If you will be using an eBay catalog product to list your item, it is always advised to include the stock photo. Sellers can also add their own pictures using one or more Item.PictureDetails.PictureURL fields. Seller photos are particularly recommended for used and modified products to give prospective buyers a clear sense of exactly what they are purchasing. In GetItem and other 'Get' calls, the URL of the stock photo will be returned in the StockPhotoURL field. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No true GetBidderList Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally Using a Stock Photo in an Item Listing https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Pictures-InListing.html#UsingaStockPhotoinanItemListing If this value is <code>true</code>, the listing will use the eBay catalog product's stock photo as the Gallery thumbnail photo. In an Add/Revise/Relist call, this field is set to <code>true</code> by default. If this field is set to <code>true</code>, the IncludeStockPhotoURL field must also be set to <code>true</code> or this field will have no effect. Sellers can also add their own pictures using one or more Item.PictureDetails.PictureURL fields, but none of these photos will be the Gallery thumbnail photo. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No true GetBidderList Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Pictures-InResults.html#UsinganeBayStockPhotoasaGalleryPicture Using an eBay Stock Photo as a Gallery Picture The full URL for the eBay catalog product's stock photo. This field is only returned if the seller used an eBay catalog product to list the item, and the IncludeStockPhotoURL field was set to <code>true</code>. GetBidderList Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally Copyright statement indicating the source of the product information. This information will be included in the listing if the seller used an eBay catalog product to list the item. GetBidderList Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally In an Add/Revise/Relist call, this field is used to pass in the eBay Product ID (e.g. ePID), which is the unique identifier of an eBay catalog product. Although an eBay catalog product match can be found using one or more GTIN values, passing in an ePID value is the best way to try and discover the appropriate eBay catalog product. This field is also returned in GetItem if the listing is associated with a eBay catalog product. 38 (42 with "EPID") AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This field is no longer applicable and should not be used. This field is no longer applicable and should not be used. If the seller attempts to use ProductListingDetails in an Add/Revise/Relist call to find an eBay catalog product match, and multiple matches are found, the call will actually fail. This field can be included and set to <code>true</code> if the seller wants to see the eBay catalog products that were found through error messages in the call response. This flag will not have an effect if only one catalog product matchi is found, or if the UseFirstProduct field is used and set to <code>true</code> and a catalog product is found to create/revise the listing. If this field is omitted or set to <code>false</code>, and multiple catalog products are found, the call will fail and no information about the matching catalog products will be returned. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No false This field is used if the seller wants to, or is required to identify a product using an ISBN (International Standard Book Number) value. An ISBN is a unique identifer for books. Both 10 and 13-character ISBNs are supported. When specifying a 13-character ISBN, the value must begin with either '978' or '979'. The seller can use the GetCategoryFeatures call to see if an ISBN is supported/required for a category. If the IncludeeBayProductDetails field is omitted or included and set to <code>true</code>, eBay will use the ISBN value passed into this field to try and find a matching eBay catalog product. If a match is found, the listing will pick up the product details of the catalog product, including the product title, product description, item specifics, and stock photo. If the seller is passing in an ePID through the ProductReferenceID field, this field is not needed, as all product identifiers will get picked up automatically by the listing if a matching catalog product is found. This field is only applicable for single-variation listings. For multiple-variation listings, if the category/product requires an ISBN value, this value should be passed into the Variation.VariationProductListingDetails.ISBN field instead. Note: If the listing is being posted to a category that expects an ISBN value, but one doesn't exist for the product, the seller must pass in the text that can be found in the ProductDetails.ProductIdentifierUnavailableText field of the GeteBayDetails response. To get the ProductDetails container to return in the GeteBayDetails response, <code>ProductDetails</code> should be included as a DetailName value in the call request. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally This field is used if the seller wants to, or is required to identify a product using a UPC (Universal Product Code) value. A UPC is a commonly used identifer for many different products. The seller can use the GetCategoryFeatures call to see if a UPC is supported/required for a category. Note: The UPC (and UPC values) are typically only applicable to US products listed on US eBay marketplace. If a European seller is selling a European-based product (with an EAN value) on the US site, instead of using the EAN field, the seller will use the UPC field to pass in the EAN value. If the IncludeeBayProductDetails field is omitted or included and set to <code>true</code>, eBay will use the UPC value passed into this field to try and find a matching eBay catalog product. If a match is found, the listing will pick up the product details of the catalog product, including the product title, product description, item specifics, and stock photo. If the seller is passing in an ePID through the ProductReferenceID field, this field is not needed, as all product identifiers will get picked up automatically by the listing if a matching catalog product is found. This field is only applicable for single-variation listings. For multiple-variation listings, if the category/product requires a UPC value, this value should be passed into the Variation.VariationProductListingDetails.UPC field instead. Note: If the listing is being posted to a category that expects a UPC value, but one doesn't exist for the product, the seller must pass in the text that can be found in the ProductDetails.ProductIdentifierUnavailableText field of the GeteBayDetails response. To get the ProductDetails container to return in the GeteBayDetails response, <code>ProductDetails</code> should be included as a DetailName value in the call request. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally This field is used if the seller wants to, or is required to identify a product using an EAN (European Article Number) value. An EAN is a unique 8 or 13-digit identifier that many industries (such as book publishers) use to identify products. The seller can use the GetCategoryFeatures call to see if an EAN is supported/required for a category. Note: The EAN (and EAN values) are typically only applicable to European products listed on European eBay marketplaces. If a US seller is selling a US-based product (with a UPC value) on a European site (such as eBay UK), instead of using the UPC field, the seller will use the EAN field to pass in the UPC value. If the IncludeeBayProductDetails field is omitted or included and set to <code>true</code>, eBay will use the EAN value passed into this field to try and find a matching eBay catalog product. If a match is found, the listing will pick up the product details of the catalog product, including the product title, product description, item specifics, and stock photo. If the seller is passing in an ePID through the ProductReferenceID field, this field is not needed, as all product identifiers will get picked up automatically by the listing if a matching catalog product is found. This field is only applicable for single-variation listings. For multiple-variation listings, if the category/product requires an EAN value, this value should be passed into the Variation.VariationProductListingDetails.EAN field instead. Note: If the listing is being posted to a category that expects an EAN value, but one doesn't exist for the product, the seller must pass in the text that can be found in the ProductDetails.ProductIdentifierUnavailableText field of the GeteBayDetails response. To get the ProductDetails container to return in the GeteBayDetails response, <code>ProductDetails</code> should be included as a DetailName value in the call request. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally This container is used if the seller wants to, or is required to identify a product using an Brand/Manufacturer Part Number (MPN) pair. The seller can use the GetCategoryFeatures call to see if a Brand/MPN pair is supported/required for a category. Both the Brand and MPN fields are required if the category/product requires an MPN value. If the IncludeeBayProductDetails field is omitted or included and set to <code>true</code>, eBay will use the Brand/MPN pair to try and find a matching eBay catalog product. If a match is found, the listing will pick up the product details of the catalog product, including the product title, product description, item specifics, and stock photo. If the seller is passing in an ePID through the ProductReferenceID field, this field is not needed, as all product identifiers associated with the catalog product will get picked up automatically by the listing if a matching catalog product is found. This container is only applicable for single-variation listings. For multiple-variation listings, if the category requires Brand/MPN pairs, the product brand (shared by all variations in this listing) is passed in through the item-level item specifics (Item.ItemSpecifics.NameValueList), and the MPN value for each variation in the listing is passed in through the variation-level item specifics (Variation.VariationSpecifics.NameValueList). Note: If the listing is being posted to a category that requires or recommends a Brand and MPN value, the Brand and MPN values for the product should always be passed in through separate ItemSpecifics.NameValueList containers since the Brand and MPN values passed in through the ProductListingDetails.BrandMPN will not get picked up by the generated/revised listing unless the the Brand/MPN pair is successfully matched to an eBay catalog product. If an MPN doesn't exist for a product, or the seller does not have it available, the seller must pass in the text that can be found in the ProductDetails.ProductIdentifierUnavailableText field of the GeteBayDetails response. To get the ProductDetails container to return in the GeteBayDetails response, <code>ProductDetails</code> should be included as a DetailName value in the call request. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally This container is only applicable when a seller is creating/revising an event tickets listing. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally This field can be included and set to <code>true</code> if the seller wants to use the first eBay catalog product that is found to create/revise the listing. eBay will search for an eBay catalog product match if the seller provides an ePID or one or more GTIN values. If this field is omitted, or included and set to <code>false</code>, the call will fail if more than one eBay catalog product is found. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No false This boolean field controls whether or not an eBay catalog product is used to create or revise a listing. If an ePID or GTIN value is provided through the ProductListingDetails container when adding, revising, or relisting an item, the default behavior is for eBay to try and find a match for the product in the eBay catalog, and then automatically create/revise the listing using the product title, product description, item specifics, and stock photo defined for the catalog product. If the seller wants to use an eBay catalog product to create/revise a listing, the seller can include this field and set its value to <code>true</code>, or just omit this field, as its default value is <code>true</code>. If a seller doesn't want use an eBay catalog product to create/revise their listing, this field should be included and set to <code>false</code>. If the seller declines to use an eBay catalog product, they will be required to pass in their own listing title, listing description, item specifics, a listing category, and at least one picture. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No true GetBidderList Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally This container is for future use. If it used, it will be ignored. Identifies an individual product suggestion. The product details include the EPID, Title, Stock photo url and if it is an exact match. The title of the product from the eBay catalog. 80 AddFixedPriceItem AddItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally The product reference Id of the product The eBay Product ID, a global reference ID for an eBay catalog product. The ePID is a fixed reference to a product (regardless of version). AddFixedPriceItem AddItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally Fully qualified URL for a stock image (if any) that is associated with the eBay catalog product. The URL is for the image eBay usually displays in product search results (usually 70px tall). It may be helpful to calculate the dimensions of the photo programmatically before displaying it. AddFixedPriceItem AddItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally If true, indicates that the product is an exact match, suitable for listing the item. AddFixedPriceItem AddItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally Provides a list of products recommended by eBay, which match the item information provided by the seller. Contains details for one or more individual product suggestions. The product details include the EPID, Title, Stock photo url and whether or not the product is an exact match for the submitted item. This product information can be used to list subsequent items. AddFixedPriceItem AddItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally This type is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This type is deprecated. 521 603 NoOp This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. This value is not used. This value is not used. This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. This type is deprecated. This value is not used. This value is not used. This value is not used. This value is not used. This value is not used. This value is not used. This value is not used. This value is not used. This value is not used. This value is not used. If a seller has reduced the price of a listed item with the Promotional Price Display feature, this type contains the original price of the discounted item and other information. Original price of an item whose price a seller has reduced with the Promotional Price Display feature. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WatchList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList

DetailLevel: none, ReturnAll

Conditionally Start time of a discount for an item whose price a seller has reduced with the Promotional Price Display feature. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WatchList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList

DetailLevel: none, ReturnAll

Conditionally End time of a discount for an item whose price a seller has reduced with the Promotional Price Display feature. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WatchList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList

DetailLevel: none, ReturnAll

Conditionally Details of a promotional shipping discount. The type of promotional shipping discount that is detailed in the profile. If the discount type is <code>MaximumShippingCostPerOrder</code>, see ShippingCost. If the discount type is <code>ShippingCostXForAmountY</code>, see ShippingCost and OrderAmount. If the discount type is <code>ShippingCostXForItemCountN</code>, see ShippingCost and ItemCount. GetShippingDiscountProfiles MaximumShippingCostPerOrder, ShippingCostXForAmountY, ShippingCostXForItemCountN Conditionally SetShippingDiscountProfiles MaximumShippingCostPerOrder, ShippingCostXForAmountY, ShippingCostXForItemCountN Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

MaximumShippingCostPerOrder, ShippingCostXForAmountY, ShippingCostXForItemCountN Conditionally This is shipping cost X when DiscountName is either <code>ShippingCostXForAmountY</code> or <code>ShippingCostXForItemCountN</code>, and is the maximum cost when DiscountName is <code>MaximumShippingCostPerOrder</code>. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This is the cost Y of the order (not including shipping cost) when DiscountName is set to <code>ShippingCostXForAmountY</code>. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This is the number of items when DiscountName is set to <code>ShippingCostXForItemsY</code>. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Indicates the text message type of the item's quantity availability. (out) The message "Limited quantity available" is shown in the web flow (e.g., for a flash sale or a Daily Deal). (out) The message "More than 10 available" is shown in the web flow. 10 is the value of QuantityThreshold tag based on the seller's preference. Reserved for internal or future use. Type defining the QuantityInfo container, which consists of the MinimumRemnantSet field, which sets the minimum amount of event tickets that can remain in the fixed-price listing's inventory after a buyer purchases one or more tickets (but not all) from the listing. Enables a seller to avoid being left with quanity of <code>1</code> in an event listing. A typical use case is event tickets in reserved, adjacent seats, or items that typically only sell if more than one can be purchased at once. Specify the minimum number of items that should remain if a buyer doesn't purchase all the items. Based on the value of MinimumRemnantSet and the listing's available quantity (Quantity-QuantitySold), eBay calculates the quantity that a buyer can purchase in one transaction. For example, suppose you list 5 tickets, and you want at least 2 tickets remaining for the final buyer to purchase. In this case, you would set MinimumRemnantSet value to <code>2</code>. This means a buyer can purchase 1, 2, 3, or 5 tickets, but not 4 (because 4 would leave the seller with 1 ticket). To remove this restriction when you revise or relist, set MinimumRemnantSet to 1. Applicable to multiple-quantity, fixed-price listings. Currently supported for US and CA event ticket listings. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem ReviseItem RelistItem VerifyAddItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

1 This type defines the QuantityRestrictionPerBuyer container, which is used by the seller to restrict the quantity of items that may be purchased by one buyer during the duration of a fixed-price listing (single or multi-variation). This integer value indicates the maximum quantity of items that a single buyer may purchase during the duration of a fixed-price listing (single or multi-variation). The buyer is blocked from the purchase if that buyer is attempting to purchase a quantity of items that will exceed this value. Previous purchases made by the buyer are taken into account. For example, if MaximumQuantity is set to '5' for an item listing, and Buyer1 purchases a quantity of three, Buyer1 is only allowed to purchase an additional quantity of two in subsequent orders on the same item listing. This field is required if the QuantityRestrictionPerBuyer container is used. 1 AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem Conditionally RelistFixedPriceItem RelistItem VerifyRelistItem ReviseFixedPriceItem ReviseItem Conditionally This type is used to reference a seller's specific domestic and/or international shipping rate tables. Shipping rate tables allow sellers to configure specific shipping costs based on the shipping destinations and level of service (e.g. economy, standard, expedite, and one-day). Generally speaking, sellers want to use these shipping rate tables so they can charge a higher shipping cost to the buyer whenever shipping costs are higher for them as well. For example, shipping to Alaska or Hawaii is generally more expensive than shipping to any other of the 48 US states, or in regards to international shipping, shipping to some regions and countries are more expensive than others. Sellers configure domestic, international, and regional shipping rate tables in My eBay Shipping Preferences. To apply shipping rate tables, the shipping cost type must be flat-rate. For domestic shipping rate tables, the three supported domestic regions are Alaska & Hawaii, US Protectorates (e.g. Puerto Rico and Guam), and APO/FPO destinations, which are US military bases/locations outside of the continental US. In addition to setting one flat rate based on the destination and service level, the seller also has the option of adding an extra charge based on the weight of the shipping package, or they can add a surcharge instead. For international shipping rate tables, specific rates may be set up for any and all geographical regions and individual countries within those regions. Similar to domestic shipping rate tables, the seller has the option of adding an extra charge based on the weight of the shipping package. Sellers cannot add a surcharge for international shipping. Note: The capability to create and use multiple domestic and international shipping rate tables (up to 40 per seller account) has rolled out to the US, Australia, Canada (English and French), Italy, UK, and Germany sites. For other sites, only one domestic and one international shipping rate table may be set up per seller. Until the seller's account is updated with the new shipping rate tables in My eBay, the seller will continue to use the DomesticRateTable and InternationalRateTable tags and pass in <code>Default</code> as the value. Once the seller's account is updated with the new shipping rate tables in My eBay, the seller will be required to use the new DomesticRateTableId and InternationalRateTableId tags, and the DomesticRateTable and InternationalRateTable tags will not work. Note that shipping rate tables can also be applied to Shipping business policies that are applied against a listing. The new shipping rate tables have all of the functionality of the old shipping rate tables, plus the seller has access to all domestic regions and not just the special regions (such as Alaska & Hawaii, US Protectorates, and APO/FPO locations in US). This field is used in an Add/Revise/Relist/Verify call to apply the domestic shipping rate table to the listing. In all cases, sellers pass in a string value of <code>Default</code> to apply the domestic shipping rate table. The shipping rates and/or surcharges set up in the domestic shipping rate table will only be applicable based on the location of the buyer, and if that shipping service level is covered in one of the specified shipping service options in the listing. Basically, domestic shipping costs and surcharges are set in one or more ShippingServiceOptions containers in the listing, and based on the settings and costs in the domestic shipping rate table, these shipping costs and/or surcharges may be overridden based on the buyer's location. For example, if the buyer lives in Alaska, and the domestic shipping rate table has one or more shipping rates set up for the Alaska & Hawaii domestic region, the buyer will see these rates in the View Item page and not the rates/costs that are defined in the ShippingServiceOptions containers. If a seller is revising or relisting an item, the domestic shipping rate table can be unassociated from the listing by using the empty tag: <code><DomesticRateTable /></code> This field is returned in the 'Get' calls if a domestic rate table is being applied to the listing, and it is only returned for the seller who listed the item. Note: The capability to create and use multiple domestic and international shipping rate tables (up to 40 per seller account) has rolled out to the US, Australia, Canada (English and French), Italy, UK, and Germany sites. Currently, for sites other than the ones stated, only one domestic and one international shipping rate table may be set up per seller. Until the seller's account is updated with the new shipping rate tables in My eBay, the seller will continue to use the DomesticRateTable and InternationalRateTable tags and pass in <code>Default</code> as the value. Once the seller's account is updated with the new shipping rate tables in My eBay, the seller will be required to use the new DomesticRateTableId and InternationalRateTableId tags, and the DomesticRateTable and InternationalRateTable tags will not work. Note that shipping rate tables can also be applied to Shipping business policies that are applied against a listing. The new shipping rate tables have all of the functionality of the old shipping rate tables, plus the seller has access to all domestic regions and not just the special regions (such as Alaska & Hawaii, US Protectorates, and APO/FPO locations in US). 50 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Using Shipping Rate Tables https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Shipping-TypesCosts.html#UsingShippingRateTables more information on using shipping rate tables. This field is used in an Add/Revise/Relist/Verify call to apply the international shipping rate table to the listing. International shipping rate tables can be used only for items listed on the eBay US, UK, and DE sites. In all cases, sellers pass in a string value of <code>Default</code> to apply the international shipping rate table. The shipping rates set up in the international shipping rate table will only be applicable based on the location of the buyer, and if that shipping service level is covered in one of the specified international shipping service options in the listing. Basically, international shipping costs are set in one or more InternationalShippingServiceOption containers in the listing, and based on the settings and costs in the international shipping rate table, these shipping costs may be overridden based on the buyer's location. For example, if the buyer lives in Argentina, and the international shipping rate table has one or more shipping rates set up for the country of Argentina, the buyer will see these rates in the View Item page and not the rates/costs that are defined in the InternationalShippingServiceOption containers. If a seller is revising or relisting an item, the international shipping rate table can be unassociated from the listing by using the empty tag: <code><InternationalRateTable /></code> This field is returned in the 'Get' calls if an international rate table is being applied to the listing, and it is only returned for the seller who listed the item. Note: The capability to create and use multiple domestic and international shipping rate tables (up to 40 per seller account) has rolled out to the US, Australia, Canada (English and French), Italy, UK, and Germany sites. Currently, for sites other than the ones stated, only one domestic and one international shipping rate table may be set up per seller. Until the seller's account is updated with the new shipping rate tables in My eBay, the seller will continue to use the DomesticRateTable and InternationalRateTable tags and pass in <code>Default</code> as the value. Once the seller's account is updated with the new shipping rate tables in My eBay, the seller will be required to use the new DomesticRateTableId and InternationalRateTableId tags, and the DomesticRateTable and InternationalRateTable tags will not work. Note that shipping rate tables can also be applied to Shipping business policies that are applied against a listing. The new shipping rate tables have all of the functionality of the old shipping rate tables, plus the seller has access to all domestic regions and not just the special regions (such as Alaska & Hawaii, US Protectorates, and APO/FPO locations in US). 50 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Using Shipping Rate Tables https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Shipping-TypesCosts.html#UsingShippingRateTables more information on using shipping rate tables. Note: This field is only available for sellers on the US, Australia, Canada (English and French), Italy, UK, and Germany sites. The unique shipping rate identifiers that will be passed into this field can be retrieved using the getRateTables call of the Account API, or these identifiers can be viewed in the displayed URL when the seller selects a specific shipping rate table in the Shipping rate tables UI in My eBay. This field is included in an Add/Revise/Relist/Verify call if the seller wants to apply a customized domestic shipping rate table to the listing. The string value that is supplied in this field is the unique identifier of the shipping rate table. If the DomesticRateTableId field is used, the seller must make sure that the DomesticRateTable and InternationalRateTable fields are not used, as the old and new rate tables cannot be used together or an error will occur. In domestic shipping rate tables, sellers customize the flat-rate cost of shipping based on shipping destination (region/state/province) and shipping service level (one-day, expedited, standard, economy in US). In addition to setting one flat rate based on the destination and service level, the seller also has the option of adding an extra charge based on the weight of the shipping package, or they can add a surcharge instead. If the seller is using the Revise or Relist call, they must include the DomesticRateTableId field or the domestic shipping rate table currently being applied to the listing will be unassociated from the listing. If they want to continue using the same domestic shipping rate table, the seller will pass in this identifier. The seller can also change the domestic shipping rate table by passing in the identifier for a different domestic shipping rate table. If a seller is revising or relisting an item, the domestic shipping rate table can be unassociated from the listing by using the empty tag: <code><DomesticRateTableId /></code> This field is returned in the 'Get' calls if a customized domestic rate table is being applied to the listing, and it is only returned for the seller who listed the item. Note: The capability to create and use multiple domestic and international shipping rate tables (up to 40 per seller account) has rolled out to the US, Australia, Canada (English and French), Italy, UK, and Germany sites. For other sites, only one domestic and one international shipping rate table may be set up per seller. Until the seller's account is updated with the new shipping rate tables in My eBay, the seller will continue to use the DomesticRateTable and InternationalRateTable tags and pass in <code>Default</code> as the value. Once the seller's account is updated with the new shipping rate tables in My eBay, the seller will be required to use the new DomesticRateTableId and InternationalRateTableId tags, and the DomesticRateTable and InternationalRateTable tags will not work. Note that shipping rate tables can also be applied to Shipping business policies that are applied against a listing. The new shipping rate tables have all of the functionality of the old shipping rate tables, plus the seller has access to all domestic regions and not just the special regions (such as Alaska & Hawaii, US Protectorates, and APO/FPO locations in US). 50 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Note: This field is only available to sellers on the US, Australia, Canada (English and French), Italy, UK, and Germany sites. The unique shipping rate identifiers that will be passed into this field can be retrieved using the getRateTables call of the Account API, or these identifiers can be viewed in the displayed URL when the seller selects a specific shipping rate table in the Shipping rate tables UI in My eBay. This field is included in an Add/Revise/Relist/Verify call if the seller wants to apply a customized international shipping rate table to the listing. The string value that is supplied in this field is the unique identifier of the shipping rate table. If the InternationalRateTableId field is used, the seller must make sure that the DomesticRateTable and InternationalRateTable fields are not used, as the old and new rate tables cannot be used together or an error will occur. In international shipping rate tables, sellers customize the flat-rate cost of shipping based on shipping destination (continent/region/country) and shipping service level (expedited, standard, economy in US). In addition to setting one flat rate based on the destination and service level, the seller also has the option of adding an extra charge based on the weight of the shipping package. Unlike domestic shipping, sellers cannot add a surcharge for international shipping. If the seller is using the Revise or Relist call, they must include the InternationalRateTableId field or the international shipping rate table currently being applied to the listing will be unassociated from the listing. If they want to continue using the same international shipping rate table, the seller will pass in this identifier. The seller can also change the international shipping rate table by passing in the identifier for a different international shipping rate table. If a seller is revising or relisting an item, the domestic shipping rate table can be unassociated from the listing by using the empty tag: <code><InternationalRateTableId /></code> This field is returned in the 'Get' calls if a customized international rate table is being applied to the listing, and it is only returned for the seller who listed the item. Note: The capability to create and use multiple domestic and international shipping rate tables (up to 40 per seller account) has rolled out to the US, Australia, Canada (English and French), Italy, UK, and Germany sites. For other sites, only one domestic and one international shipping rate table may be set up per seller. Until the seller's account is updated with the new shipping rate tables in My eBay, the seller will continue to use the DomesticRateTable and InternationalRateTable tags and pass in <code>Default</code> as the value. Once the seller's account is updated with the new shipping rate tables in My eBay, the seller will be required to use the new DomesticRateTableId and InternationalRateTableId tags, and the DomesticRateTable and InternationalRateTable tags will not work. Note that shipping rate tables can also be applied to Shipping business policies that are applied against a listing. The new shipping rate tables have all of the functionality of the old shipping rate tables, plus the seller has access to all domestic regions and not just the special regions (such as Alaska & Hawaii, US Protectorates, and APO/FPO locations in US). 50 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Enumerated type that defines the possible reasons why a listing is being hidden from search on the eBay site. This value indicates that the listing is being hidden from search on the eBay site because the listing has been determined by eBay to be a duplicate listing. This enumeration value is associated with eBay Duplicate Listings Policy, which is applicable on the US, CA, CA-FR, and eBay Motors (Parts and Accessories only) sites. Event Tickets, Real Estate, and Motor Vehicle categories are excluded from this policy. For more information, read <a href="http://pages.ebay.com/help/policies/listing-multi.html">eBay's Duplicate Listings Policy</a> help page. This value indicates that the listing is currently hidden from search because the quantity in the listing is zero. However, the listing is still alive and will reappear in the search results when the quantity is set to something greater than zero. The 'Out-of-stock' option is set by the seller at the account level. This option can be enabled in My eBay Site Preferences, or the seller can use the <a href="https://developer.ebay.com/DevZone/XML/docs/Reference/ebay/SetUserPreferences.html#Request.OutOfStockControlPreference">OutOfStockControlPreference</a> field in the SetUserPreferences call. Type used by the RecoupmentPolicyConsent container that is returned in the GetItem call response to indicate which sites the user (specified in UserID field of call request) has signed a cross-border trade Recoupment Policy Agreement. A unique identifier for an eBay site. Each site where the user (specified in UserID field of call request) has signed a cross-border trade Recoupment Policy Agreement is returned. The enumeration values that represent these eBay sites can be found in SiteCodeType. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Note: This type was only used for Half.com order refunds, and since the Half.com site has been shut down, this type is no longer applicable. Type used by the RefundArray container, which consists of an array of Half.com refunds. Note: RefundArrayType and the Refund field are no longer applicable since the Half.com site has been shut down. This container consists of information about a Half.com refund. It is only returned if a Half.com order is going through (or has completed) the refund process. 1027 NoOp 1033 This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. This type is deprecated. This field is deprecated. This type is deprecated. This field is deprecated. This type is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. Type defining the Refunds container, which contains an array of Refund containers. A Refund container consists of detailed information on an In-Store Pickup item refund. Note: At this time, the In-Store Pickup feature is generally only available to large retail merchants on the US site, and can only be applied to multi-quantity, fixed-price listings. This container consists of detailed information on an In-Store Pickup item refund. This container is only returned if the merchant is refunding (or providing a store credit) the buyer for an In-Store Pickup item. A separate Refund container will be returned for each ORDER.RETURNED notification that the merchant sends to eBay through the Inbound Notifications API. Note: A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants on the US site, and can only be applied to multi-quantity, fixed-price listings. Eligible Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This type is deprecated. This field is deprecated. This type is deprecated. This field is deprecated. This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. This value is not used. This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. This value is not used. This type is deprecated. This field is deprecated. Type defining the Refund container, which consists of detailed information on an In-Store Pickup item refund. Note: At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. This value indicates the success or failure of the attempt by the merchant to refund or provide store credit to the buyer for a returned In-Store Pickup item. This field is always returned with the Refund container. Note: A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API. Pending GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This value indicates whether the merchant refunded or provided a store credit to the buyer for the returned In-Store Pickup item. Applicable values are 'REFUND' and 'STORE_CREDIT'. This value is picked up by eBay when the merchant passes in the REFUND_TYPE parameter through the payload of an ORDER.RETURNED notification sent to eBay. Note: A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This field is the eBay user ID of the buyer who is receiving the refund or store credit from the merchant. This field is always returned with the Refund container. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the correct refund recipient is returned to the buyer or seller, but the refund recipient will be masked to all third parties. Note: A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This date/time value is the timestamp for the refund transaction. This field is not returned if the refund was not successful (RefundStatus=FAILED). Note: A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This dollar value is the amount of the refund to the buyer for this specific refund transaction. This field is not returned if the merchant issued the buyer a store credit instead of a refund (RefundType=STORE_CREDIT). Note: A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This value is a merchant-defined identifier used to track In-Store Pickup refunds. This value is picked up by eBay when the merchant passes in the REFUND_ID parameter through the payload of an ORDER.RETURNED notification sent to eBay. This field is not returned if the merchant does not set this value through ORDER.RETURNED notification. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the correct payment identifier is returned to the buyer or seller, but the payment identifier will be masked to all third parties. Note: A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This dollar value is the total amount of the refund to the buyer for the In-Store Pickup order. Typically, this dollar value will be the same as the RefundAmount value, unless the merchant is issuing multiple refund transactions to the buyer, in which case, the FeeOrCreditAmount value will be the cumulative amount for multiple refund transactions. This field is not returned if the merchant issued the buyer a store credit instead of a refund (RefundType=STORE_CREDIT). Note: A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This type is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. Note: This type is only used for Half.com order refunds, and since the Half.com site has been shut down, this type will also be deprecated. Contains information about a single Half.com refund. Note: RefundType and all of its fields are no longer applicable since the Half.com site has been shut down. Total amount refunded by the seller for this order line item. 1027 NoOp 1033 Note: RefundType and all of its fields are no longer applicable since the Half.com site has been shut down. Total amount refunded to the buyer for this order line item. 1027 NoOp 1033 Note: RefundType and all of its fields are no longer applicable since the Half.com site has been shut down. The date and time at which the refund was issued. 1027 NoOp 1033 Note: RefundType and all of its fields are no longer applicable since the Half.com site has been shut down. The unique identifier of the refund. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the real refund identifier is only returned to the buyer or seller, and a string value of <code>Unavailable</code> will be returned to all third parties. 1027 NoOp 1033 Note: RefundType and all of its fields are no longer applicable since the Half.com site has been shut down. Note: RefundType and all of its fields are no longer applicable since the Half.com site has been shut down. The total amount of the refund requested. 1027 NoOp 1033 Note: RefundType and all of its fields are no longer applicable since the Half.com site has been shut down. Note: RefundType and all of its fields are no longer applicable since the Half.com site has been shut down. Note: RefundType and all of its fields are no longer applicable since the Half.com site has been shut down. Note: RefundType and all of its fields are no longer applicable since the Half.com site has been shut down. Note: RefundType and all of its fields are no longer applicable since the Half.com site has been shut down. Note: RefundType and all of its fields are no longer applicable since the Half.com site has been shut down. Note: RefundType and all of its fields are no longer applicable since the Half.com site has been shut down. Note: RefundType and all of its fields are no longer applicable since the Half.com site has been shut down. Enumerated type defining the refund types that a merchant can offer a buyer who is returning an In-Store Pickup item to the store. This value indicates that the merchant issued a store credit to the buyer for the amount of the returned item(s). This value indicates that the merchant issued a cash refund (or debit card/credit card reversal) to the buyer for the amount of the returned item(s). This value is reserved for internal or future use. This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. (out) Reserved for internal or future use. This type defines the RequiredSellerActionArray container, which may contain one or more RequiredSellerAction fields. This field contains a possible action that a seller can take to expedite the release of a payment hold. There can be one or more RequiredSellerAction fields in the RequiredSellerActionArray container. GetOrders

DetailLevel: none

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBaySelling

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Enumerated type that defines the list of possible actions that a seller can take to expedite the release of funds for an order into their account. SetupPayoutMethod, UpdatePayoutMethod, None, ResolvePPPIcase This value indicates that there is an open eBay Money Back Guarantee case involving the seller and the order. The seller must address and get the case resolved before the funds can be scheduled for release to the seller's account. This value indicates that the seller must mark the order line item as shipped to expedite the release of funds into their account. The seller can use the CompleteSale call or My eBay to mark an item as shipped. This value indicates that the seller should contact eBay Customer Support to discover the next required action to expedite the release of funds into their account. This value is deprecated. This value is no longer used. This value is no longer used. This value is no longer used. This value indicates that the seller must provide shipment tracking information for the order line item to expedite the release of funds into their account. The seller can use the CompleteSale call to provide tracking information for an order line item. This value indicates that the buyer has not received the order, and the buyer has contacted the seller through the eBay system in an effort to resolve the issue with the seller. The seller must make it right with the buyer in order to expedite the release of funds into their account. This value indicates that the buyer has received the order, but the item is not as described in the listing; hence, the buyer has contacted the seller through the eBay system in an effort to resolve the issue with the seller. The seller must make it right with the buyer in order to expedite the release of funds into their account. This value is reserved for internal or future use. This value indicates that the buyer is returning the item through eBay's return process. Upon receiving the returned item from the buyer, the seller must issue a refund to the buyer within five business days, and shortly after this happens, eBay will credit the seller's account with the Final Value Fee that was originally assessed on the sale of the item. Type used to express the details of the return policy for an item. Historically, the GeteBayDetails call has been used to retrieve site-level return policy metadata. However, the GetCategoryFeatures call is now recommended instead because this call now returns category-level metadata for both domestic and international return policies. Note: If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. For more information on setting separate domestic and international return policies, see the <a href="https://pages.ebay.com/seller-center/seller-updates/2018-summer/simplified-returns.html#international-returns-policy" target="_blank">International returns policy</a> help topic. This field indicates how the seller compensates buyers for returns</a>. <code>MoneyBack</code> is the only supported value for all marketplaces except for the US. On the US marketplace, you can set this value to either <code>MoneyBack</code> or <code>MoneyBackOrReplacement</code>. <code>MoneyBackOrReplacement</code> can be used by sellers that have the depth of inventory to support an exchange for an identical item. However, ultimately, it is up to the buyer on whether they want money back or a replacement item. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller ships internationally, and wants to define and use a separate international returns policy, the international equivalent of this field is the InternationalRefundOption field. RefundOptionsCodeType AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Domestic Refund Methods (in GetCategoryFeatures) supported domestic refund value for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.DomesticRefundMethodValues Display string that buyer applications can use to present RefundOption in a more user-friendly format to buyers. For example, in GetItem and related calls, this value is usually localized and can contain spaces. If necessary, you can predict the choice of values based on the Refund.Description options returned by GeteBayDetails. This field is applicable to only the US marketplace and is not applicable as input to the Add/Revise/Relist family of calls. (Use RefundOption instead.) GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Specifies the amount of time the buyer has to return an item. The return period begins when the item is marked "delivered" at the buyer's specified ship-to location. Most marketplaces and categories support 30-day and 60-day return periods. eBay sites often set 30-days as the default value for this field and sellers are obligated to honor the values that are set for a listing. This value is required if ReturnsAcceptedOption=ReturnsAccepted. Applicable values: Retrieve the values supported by a marketplace and category by calling GetCategoryFeatures with FeatureID set to <code>DomesticReturnsDurationValues</code>, then see the values returned under the Category.DomesticReturnsDurationValues container in the response. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller ships internationally, and wants to define and use a separate international returns policy, the international equivalent of this field is the InternationalReturnsWithinOption field. ReturnsWithinOptionsCodeType AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Domestic Return Durations (in GetCategoryFeatures) supported domestic return durations for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.DomesticReturnsDurationValues Display string that buyer applications can use to present ReturnsWithinOption in a more user-friendly format to buyers. For example, in GetItem and related calls, this value is usually localized and can contain spaces. If necessary, you can predict the choice of values based on the ReturnsWithin.Description options returned by GeteBayDetails. Not applicable as input to the AddItem family of calls. (Use ReturnsWithinOption instead.) GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally This required field indicates whether or not the seller accepts returns. Applicable values are <code>ReturnsAccepted</code> or <code>ReturnsNotAccepted</code>. When set to <code>ReturnsAccepted</code>, this option indicates the seller allows items to be returned. Specify ReturnsNotAccepted for a listing if returns are not accepted. On the eBay DE, IE, and UK marketplaces, registered business sellers must accept returns for fixed-price items (including auction items with Buy It Now and any other fixed price formats) when the category requires a return policy. On some European sites, such as eBay Germany (DE), registered business sellers are required to accept returns. Use the Trading call GetUser to determine the status of an eBay business seller in DE, IE, and UK. Review the User.SellerInfo.SellerBusinessType field in the response. Note: In order for Top-Rated sellers to receive a Top-Rated Plus seal for their listings, returns must be accepted for their items (ReturnsAcceptedOption = <code>ReturnsAccepted</code>) and handling time should be set to zero-day (same-day shipping) or one-day shipping. Set the handling time (in days) using the Item.DispatchTimeMax field. Top-Rated listings qualify for the greatest average boost in Best Match and for the 20 percent Final Value Fee discount. For more information on eBay's Top-Rated seller program, see the <a href="https://pages.ebay.com/help/sell/top-rated.html">Seller levels and performance standards</a> page. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller ships internationally, and wants to define and use a separate international returns policy, the international equivalent of this field is the InternationalReturnsAcceptedOption field. ReturnsAcceptedOptionsCodeType AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Domestic Returns Accepted Values (in GetCategoryFeatures) supported domestic returns accepted values for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.DomesticReturnsAcceptedValues Display string that buyer applications can use to present ReturnsAcceptedOption in a more user-friendly format to buyers. For example, in GetItem and related calls, this value is usually localized and can contain spaces. If necessary, you can predict the choice of values based on the ReturnsAccepted.Description options returned by GeteBayDetails. Not applicable as input to the AddItem family of calls. (Use ReturnsAcceptedOption instead.) GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally For AddItem, VerifyAddItem, and RelistItem: If the seller accepts returns (ReturnsAcceptedOption = <code>ReturnsAccepted</code>) but does not specify this field when listing the item, GetItem returns this as an empty node. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. 8000 (for DE, AT); 5000 (for FR, IT, ES) AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally This field is deprecated as of release 1061 and any values supplied in this field are ignored. eBay no longer supports warranty policies for returns. WarrantyOfferedCodeType 1061 NoOp 1139 This field is deprecated as of release 1061 and any values supplied in this field are ignored. eBay no longer supports warranty policies for returns. 1061 NoOp 1139 This field is deprecated as of release 1061 and any values supplied in this field are ignored. eBay no longer supports warranty policies for returns. WarrantyTypeOptionsCodeType 1061 NoOp 1139 This field is deprecated as of release 1061 and any values supplied in this field are ignored. eBay no longer supports warranty policies for returns. 1061 NoOp 1139 This field is deprecated as of release 1061 and any values supplied in this field are ignored. eBay no longer supports warranty policies for returns. WarrantyDurationOptionsCodeType 1061 NoOp 1139 This field is deprecated as of release 1061 and any values supplied in this field are ignored. eBay no longer supports warranty policies for returns. 1061 NoOp 1139 This option specifies whether the buyer or the seller pays for return shipping charges. Accepted values are <code>Buyer</code> or <code>Seller</code>. eBay sites often set <code>Seller</code> as the default value for this field, and sellers are obligated to honor the values that are set for a listing. This value is required if ReturnsAcceptedOption=ReturnsAccepted. Depending on the seller's return policy and the specifics of a return, either the buyer or the seller can be responsible for the return shipping costs. Note that the seller is always responsible for return shipping costs for SNAD-related issues or for late shipments. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller ships internationally, and wants to define and use a separate international returns policy, the international equivalent of this field is the InternationalShippingCostPaidByOption field. ShippingCostPaidByOptionsCodeType AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Return Shipping Cost Payee Values (in GetCategoryFeatures) supported domestic return shipping cost payee values for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.DomesticReturnsShipmentPayeeValues This is a display string that buyer applications can use to present ShippingCostPaidByOption in a more user-friendly format to buyers. For example, in GetItem and related calls, this value is usually localized and can contain spaces. If necessary, you can predict the choice of values based on the ShippingCostPaidBy.Description options returned by GeteBayDetails. Not applicable as input to the AddItem family of calls. (Use ShippingCostPaidByOption instead.) GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally This field is deprecated as of release 1061 and any values supplied in this field are ignored. eBay no longer allows sellers to charge a restocking fee when returning items. 1061 NoOp 1139 This field is deprecated as of release 1061 and any values supplied in this field are ignored. eBay no longer allows sellers to charge a restocking fee when returning items. RestockingFeeCodeType 1061 NoOp 1139 This field is deprecated as of release 1061 and any values supplied in this field are ignored. eBay no longer supports extended holiday returns. 1061 NoOp 1139 This field indicates how the seller compensates international buyers for returns</a>. <code>MoneyBack</code> is the only supported value for all marketplaces except for the US. On the US marketplace, you can set this value to either <code>MoneyBack</code> or <code>MoneyBackOrReplacement</code>. <code>MoneyBackOrReplacement</code> can be used by sellers that have the depth of inventory to support an exchange for an identical item. However, ultimately, it is up to the buyer on whether they want money back or a replacement item. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. So if this field is not used in an add/revise/relist call, the refund option(s) for international returns will default to the value specified in the RefundOption field. RefundOptionsCodeType AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally International Refund Methods (in GetCategoryFeatures) supported international refund value for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.InternationalRefundMethodValues This field is conditionally required if a seller wants to use a separate return policy for international returns. The value in this field indicates whether or not the seller accepts returns from international buyers. Applicable values are <code>ReturnsAccepted</code> or <code>ReturnsNotAccepted</code>. When set to <code>ReturnsAccepted</code>, this option indicates the seller allows international buyers to return items. Specify ReturnsNotAccepted for a listing if returns are not accepted from international buyers. On the eBay DE, IE, and UK, registered business sellers must accept returns for fixed-price items (including auction items with Buy It Now and any other fixed price formats) when the category requires a return policy. On some European sites, such as eBay Germany (DE), registered business sellers are required to accept returns. Use the Trading call GetUser to determine the status of an eBay business seller in DE, IE, and UK. Review the User.SellerInfo.SellerBusinessType field in the response. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. So if this field is not used in an add/revise/relist call, the return accepted value for international returns will default to the value specified in the ReturnsAcceptedOption field. ReturnsAcceptedOptionsCodeType AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally International Returns Accepted Values (in GetCategoryFeatures) supported international returns accepted values for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.InternationalReturnsAcceptedValues This field is conditionally required if a seller is using a separate return policy for international returns, and is accepting international returns. The value in this field indicates the number of days that an international buyer has to return an item. The time period begins on the day that the buyer receives the item. Most marketplaces and categories support 30-day and 60-day return periods. eBay sites often set 30-days as the default value for this field and sellers are obligated to honor the values that are set for a listing. Applicable values: Retrieve the values supported by a marketplace and category by calling GetCategoryFeatures with FeatureID set to <code>InternationalReturnsDurationValues</code>, then see the values returned under the Category.InternationalReturnsDurationValues container in the response. For AddItem, VerifyAddItem, and RelistItem: If the seller accepts international returns (InternationalReturnsAcceptedOption is set to ReturnsAccepted) but does not specify this field for a listing, eBay sets a default value (often Days_30) and the seller is obligated to honor this setting. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. So if this field is not used in an add/revise/relist call, the return period for international returns will default to the value specified in the ReturnsWithinOption field. ReturnsWithinOptionsCodeType AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally International Return Durations (in GetCategoryFeatures) supported international return durations for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.InternationalReturnsDurationValues This field is conditionally required if a seller is using a separate return policy for international returns, and is accepting international returns. The value in this field specifies whether the buyer or the seller pays for international return shipping charges. Accepted values are <code>Buyer</code> or <code>Seller</code>. eBay sites often set <code>Seller</code> as the default value for this field, and sellers are obligated to honor the values that are set for a listing. Depending on the seller's return policy and the specifics of a return, either the buyer or the seller can be responsible for the return shipping costs. Note that the seller is always responsible for return shipping costs for SNAD-related issues or for late shipments. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. So if this field is not used in an add/revise/relist call, return shipping cost payee for international returns will default to the value specified in the ShippingCostPaidByOption field. ShippingCostPaidByOptionsCodeType AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Return Shipping Cost Payee Values (in GetCategoryFeatures) supported international return shipping cost payee values for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.InternationalReturnsShipmentPayeeValues Enumerated type that defines the possible states of an eBay return request. This value indicates that the return request is invalid. This value indicates that the return request is not applicable. This value indicates that the return request has been initiated by the buyer and is pending approval by the seller. This value indicates that the buyer's return request was rejected by the seller. This value indicates that a return request was successfully opened by the buyer. This value indicates that the buyer has return shipped the item(s) in the return request back to the seller. This value indicates that the seller has received the item(s) that the buyer return shipped. This value indicates that a return request was closed with a refund issued to the buyer. This value indicates that a return request was closed after being escalated to an eBay return case. This value indicates that a return request was closed with no refund issued to the buyer. This value indicates that a return request was escalated to an eBay return case, and the case is awaiting a response from the buyer. This value indicates that a return request was escalated to an eBay return case, and the case is awaiting a response from the seller. This value indicates that a return request was escalated to an eBay return case, and the case is awaiting a response from eBay Customer Support. This value indicates that a return request was escalated to an eBay return case, but the case was closed with a refund issued to the buyer. This value indicates that a return request was escalated to an eBay return case, but the case was closed with no refund issued to the buyer. This value indicates that a return request was escalated to an eBay return case. This value indicates that the return request is currently in the pending state. This value indicates that the return request was closed with a refund to the buyer. This value indicates that the return request was closed with no refund to the buyer. Reserved for internal or future use. Contains data indicating whether an item has been revised since the listing became active and, if so, which among a subset of properties have been changed by the revision. This field is returned as <code>true</code> if the original listing has been revised. This field is always returned with the ReviseStatus container. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally This field is returned as <code>true</code> if a Buy It Now price has been added to the auction listing. This field is only returned if the original auction listing did not have a Buy It Now price, but a revision to that original listing included adding a Buy It Now price. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This field is returned as <code>true</code> if the Buy It Now price on the original auction listing was lowered as part of a revision to the original auction listing. This field is only returned if the Buy It Now price on the original auction listing was lowered as part of a revision to the original auction listing. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This field is returned as <code>true</code> if the Reserve price on the original auction listing was lowered as part of a revision to the original auction listing. This field is only returned if the Reserve price on the original auction listing was lowered as part of a revision to the original auction listing. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This field is returned as <code>true</code> if the Reserve price on the original auction listing was removed as part of a revision to the original auction listing. This field is only returned if the Reserve price on the original auction listing was removed as part of a revision to the original auction listing. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Describes or includes information associated with the SKU. Stock Keeping Unit that serves as a unique identifier for an item. Many merchants assign a SKU number to an item of a specific type, size, and color. This way, they can keep track of how many products of each type, size, and color are selling, and they can re-stock their shelves according to customer demand. You can include a SKU when you list any item, and then use the SKU instead of (or in addition to) using the ItemID to track your inventory on eBay. For fixed-price items, if you set Item.InventoryTrackingmethod to SKU, you can use the SKU instead of ItemID as a unique ID when you revise the listing. Only returned when the listing included a SKU. 70 ActiveInventoryReport Conditionally The price that the seller assigns to the item. If this value changes when the item is revised, the new value becomes the price. For a multi-variation listing, price is only returned at the variation level. You can revise this value using ReviseFixedPriceItem or ReviseInventoryStatus in the Trading API. ActiveInventoryReport Conditionally The total number of items available for sale in the listing. For a multi-variation listing, the item quantity for each variation is returned at the variation level. You can revise this value using ReviseFixedPriceItem or ReviseInventoryStatus in the Trading API. ActiveInventoryReport Always The ID that uniquely identifies the item listing. The ID is generated by eBay after an item is listed. You cannot choose or revise this value. ActiveInventoryReport Always Number of bids placed so far for the item. Returned only for auction-style listings if auctionItemDetails.includeBidCount has a value of true in the activeInventoryReportFilter of a Bulk Data Exchange Service startDownloadJob request. See <a href="https://developer.ebay.com/DevZone/bulk-data-exchange/CallRef/startDownloadJob.html#Request.downloadRequestFilter.activeInventoryReportFilter" target="_blank">activeInventoryReportFilter</a> ActiveInventoryReport Conditionally Indicates whether the Reserve Price has been met for the listing. Returned only for auction-style listings if auctionItemDetails.includeReservePrice has a value of true in the activeInventoryReportFilter of a Bulk Data Exchange Service startDownloadJob request. See <a href="https://developer.ebay.com/DevZone/bulk-data-exchange/CallRef/startDownloadJob.html#Request.downloadRequestFilter.activeInventoryReportFilter" target="_blank">activeInventoryReportFilter</a> ActiveInventoryReport Conditionally Variations are multiple similar (but not identical) items in one fixed-price listing. For example, a clothing listing can contain items of the same brand that vary by color and size. Each variation specifies a combination of one of these colors and sizes. Each variation can have a different quantity and price. ActiveInventoryReport Conditionally Primitive type that represents a stock-keeping unit (SKU). The usage of this string may vary in different contexts. For usage information and rules, see the fields that reference this type. This type is used to show sales tax-related details for a tax jurisdiction. The concept of 'sales tax' is only applicable to eBay US and Canada (English and French) sites. This float value is the sales tax percentage rate applicable to the corresponding tax jurisdiction (US state or Canadian province). Sellers are responsible for providing accurate sales tax rates for each jurisdiction. This sales tax rate comes into play when a buyer from that tax jurisdiction makes a purchase from the seller. The value passed in is stored with a precision of 3 digits after the decimal point (##.###). This field is only returned in order management calls if sales tax applies to the order line item, and is only in GetItem (and other 'Get' calls) if sales tax is applicable to the listing or order line item, and the seller is the person making the call. Although this field will be returned at the order level in order management calls for a single line item order, sales tax is applied at the line item level and not order level. For multiple line item orders, this field will not be returned at all at the order level. Note: As of September 1, 2020, buyers in over 40 US states will automatically be charged sales tax for eBay purchases. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. So, if a sales tax rate is applied to the listing by the seller for a state that is subject to eBay 'Collect and Remit', the sales tax rate in this field is ignored by eBay during the checkout process. For a list of the US states that are currently subject to 'eBay Collect and Remit', see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/taxes-import-charges?id=4121#section4">eBay sales tax collection</a> help topic. AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem SendInvoice VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetItemShipping GetTaxTable Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This is the unique, two-digit identifier of the tax jurisdiction (such as 'CA' for California). To retrieve all two-digit identifiers for all states/territories/provinces for a site, a seller can either use a GetTaxTable call with DetailLevel set to <code>ReturnAll</code>, or they can use the GeteBayDetails call with DetailLevel name set to <code>TaxJurisdiction</code>. Please note that both GetTaxTable and GeteBayDetails calls use a JurisdictionID field to express these tax jurisdiction identifiers instead of SalesTaxState, but the values used in these fields are the same. The SalesTaxState field is conditionallly required in an Add/Revise/Relist/Verify call if the seller is applying sales tax to a listing for a particular jurisdiction, and is returned with each SalesTax container to identify the tax jurisdiction. AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem SendInvoice VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally This field is included in an Add/Revise/Relist/Verify call and set to <code>true</code> if the seller wants sales tax for the jurisdiction to apply to the cumulative amount of item cost and shipping charges. This value defaults to <code>false</code> if not specified. This field is always returned with the SalesTax container (whether <code>true</code> or <code>false</code>). Note: As of September 1, 2020, buyers in over 40 US states will automatically be charged sales tax for eBay purchases. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. With 'eBay Collect and Remit' sales tax, the sales tax is applied against the full cost of the order, including any shipping and handling charges. So, if this field is included for a state that is subject to 'eBay Collect and Remit', this setting is ignored by eBay during checkout process. For a list of the US states that are currently subject to 'eBay Collect and Remit', see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/taxes-import-charges?id=4121#section4">eBay sales tax collection</a> help topic. AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem SendInvoice VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No False GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetBidderList GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The amount of sales tax calculated for an order line item based on the sale price and the sales tax rate for the buyer's tax jurisdiction. For a multiple line item order, the SalesTaxAmount returned at the order level will be the cumulative amount for all line items in the order. GetItemTransactions can return incorrect sales tax if the name of a state is not abbreviated (e.g. if the value is "Illinois" rather than "IL") in TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress.StateOrProvince. If the name of a state is not abbreviated, sales tax should be obtained by using the OrderLineItemID to call GetOrderTransactions. SendInvoice No GetItemShipping Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Contains information for scheduling limits for the user. Maximum number of minutes that a listing may be scheduled in advance of its going live. GetUser

DetailLevel: none, ReturnAll

Conditionally Minimum number of minutes that a listing may be scheduled in advance of its going live. GetUser

DetailLevel: none, ReturnAll

Conditionally Maximum number of Items that a user may schedule. GetUser

DetailLevel: none, ReturnAll

Conditionally This type is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. Type of seller account. This value is returned if the user is a business seller with a site ID of 77 (Germany), 3 (UK), 205 (Ireland) or 0 (US Motors). Type of seller account not defined. Private seller account. Commercial seller account. Reserved for internal or future use. Type defining the SellerDiscounts container, which consists of one or more SellerDiscount nodes, as well as the original purchase price and shipping cost of the order line item. The original purchase price of the order line item (before any seller discounts are applied). GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The original shipping cost for the order line item (before any seller discounts are applied). GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The original shipping service offered by the seller to ship an item to a buyer. ShippingServiceCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally A container consisting of name and ID of the seller's discount campaign, as well as the discount amount that is being applied to the order line item. GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Type that defines the SellerDiscount container, which contains the ID, name, and amount of the seller discount. Unique identifier for a seller discount campaign. This ID is automatically created when the seller creates the discount campaign. This field is always returned with the SellerDiscount container. GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The name of the seller discount campaign. This field will only be returned with the SellerDiscount container if defined for the seller discount campaign. GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The dollar amount of the order line item discount. The original purchase price (denoted in OriginalItemPrice) will be reduced by this value. The amount of the item discount will depend on the rules defined in the the seller discount campaign. Note: Prior to Version 895, this field worked a little differently. Instead of this field showing the amount of the discount, it was actually showing the final item price after the discount was applied. So, if an item price is 10.0 dollars and the discount is 2.0 dollars, someone using Version 895 (and going forward) will see a value of '2.0' (amount of the discount) in this field, but anyone using Version 893 or lower will see a value of '8.0' (item price after discount) in this field. GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The dollar amount of the shipping discount applied to the order line item. GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This type was deprecated along with the Seller Guarantee feature. (out) Not eligible for Seller Level Guarantee (out) Regular eligibility level (out) Premium eligibility level (out) Ultra eligibility level (out) Reserved for internal or future use. Indicates the user's eBay PowerSeller tier. PowerSellers are distinguished in 5 tiers based on average monthly sales. Benefits and services vary for each tier. eBay calculates eligibility for each tier monthly. Bronze (lowest tier) Silver (between Bronze and Gold) Gold (between Silver and Platinum) Platinum (between Gold and Titanium) Titanium (highest tier) Not a PowerSeller (eBay has not yet evaluated your PowerSeller status, or you have not chosen to be a member of the PowerSeller program, or you lost your PowerSeller status due to a policy violation.) Reserved for internal or future use This enumerated type defines the payment methods that an eBay user can use to pay fees on monthly eBay invoice. This enumeration value indicates that eBay does not currently have a payment method on file for the eBay user. This enumeration value indicates that eBay will use the credit card on file to process the eBay user's monthly invoice. This enumeration value is deprecated. This enumeration value indicates that eBay will debit the bank account on file to process the eBay user's monthly invoice. This enumeration value indicates that eBay will debit the bank account on file to process the eBay user's monthly invoice. A signature will be needed from the eBay user before a payment can be processed. This enumeration value indicates that the eBay user will use eBay Direct Pay to pay the monthly invoice. (out) Reserved for internal or future use This enumeration value indicates that eBay will debit the bank account on file to process the eBay user's monthly invoice. However, the bank account information must be verified before a payment can be processed. Type defining the SellerPaymentProfile container, which is used in an Add/Revise/Relist/Verify Trading API call to reference and use a payment business policy. The unique identifier of a payment business policy. A PaymentProfileID and/or a PaymentProfileName value is used in the Add/Revise/Relist/Verify call to reference and use the payment settings/values of a payment business policy. If both fields are provided and their values don't match, the PaymentProfileID takes precedence. Payment profile IDs can be retrieved with the getPaymentPolicies call of the Account API or with the getSellerProfiles call of the Business Policies Management API. Business policy IDs can also be retrieved through the Business policies section of My eBay. In the 'Get' calls, the PaymentProfileID value will always be returned if business policies are set for the listing, and the person making the API call is the seller of the listing. The PaymentProfileName value will be returned if a name is assigned to the payment business policy. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally The name of a payment business policy. A PaymentProfileID and/or a PaymentProfileName value is used in the Add/Revise/Relist/Verify call to reference and use the payment settings/values of a payment business policy. If both fields are provided and their values don't match, the PaymentProfileID takes precedence. In the 'Get' calls, the PaymentProfileID value will always be returned if business policies are set for the listing, and the person making the API call is the seller of the listing. The PaymentProfileName value will be returned if a name is assigned to the payment business policy. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally Type defining the SellerProfiles container, which consists of references to a seller's payment, shipping, and return policy profiles. The SellerShippingProfile container is used in an Add/Revise/Relist/Verify Trading API call to reference and use the settings/values of a specific shipping business policy. Shipping business policies contain detailed information on domestic and international shipping, including shipping service options and costs, handling time, shipping discount inormation, and excluded ship-to locations. Multiple shipping business policies can be created and saved at the account level by sellers. This container is only returned in 'Get' calls if Business Policies are set for the listing, and the person making the API call is the seller of the listing. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally The SellerReturnProfile container is used in an Add/Revise/Relist/Verify Trading API call to reference and use the settings/values of a return business policy. Return business policies contain detailed information on the seller's return policy for domestic and international buyers (if the seller ships internationally), including whether or not the seller accepts returns from domestic and international buyers, how many days the buyer has to return the item for a refund, and who pays the return shipping costs. Multiple return policy business policies can be created and saved at the account level by sellers. This container is only returned in 'Get' calls if Business Policies are set for the listing and the person making the API call is the seller of the listing. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally The SellerPaymentProfile container is used in an Add/Revise/Relist/Verify API call to reference and use the settings/values of a payment business policy. Payment business policies contain a setting to control whether immediate payment is required, settings to specify due dates for the deposit and full payment of a motor vehicle listing (Motors policy only), and settings to specify which offline payment methods are avaiable to buyers for sales transactions that happen off of eBay's platform. Multiple payment business policies can be created and saved at the account level by sellers. This container is only returned in 'Get' calls if Business Policies are set for the listing, and the person making the API call is the seller of the listing. Note: Sellers will never have to specify electronic payment methods, but offline payment methods are required for listings where offline payment is required or supported. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally Type defining the SellerReturnProfile container, which is used in an Add/Revise/Relist/Verify Trading API call to reference a return policy business policy. Return policy business policies contain detailed information on the seller's return policy for domestic and international buyers (if the seller ships internationally), including whether or not the seller accepts returns from domestic and international buyers, how many days the buyer has to return the item for a refund, and who pays the return shipping costs. The unique identifier of a return policy business policy. A ReturnProfileID and/or a ReturnProfileName value is used in the Add/Revise/Relist/Verify call to reference and use the return policy settings/values of a return policy business policy. If both fields are provided and their values don't match, the ReturnProfileID takes precedence. Return policy profile IDs can be retrieved with the getReturnPolicies call of the Account API or with the getSellerProfiles call of the Business Policies Management API. Business policy IDs can also be retrieved through the Business policies section of My eBay. In the 'Get' calls, the ReturnProfileID value will always be returned if business policies are set for the listing, and the person making the API call is the seller of the listing. The ReturnProfileName value will be returned if a name is assigned to the return policy business policy. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally The name of a return policy business policy. A ReturnProfileID and/or a ReturnProfileName value is used in the Add/Revise/Relist/Verify call to reference and use the return policy settings/values of a return policy business policy. If both fields are provided and their values don't match, the ReturnProfileID takes precedence. In the 'Get' calls, the ReturnProfileID value will always be returned if business policies are set for the listing, and the person making the API call is the seller of the listing. The ReturnProfileName value will be returned if a name is assigned to the return policy business policy. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally Type defining the SellerShippingProfile container, which is used in an Add/Revise/Relist Trading API call to reference a shipping business policy. Shipping business policies contain detailed information on domestic and international shipping, including shipping service options and costs, handling time, shipping discount inormation, and excluded ship-to locations. The unique identifier of a shipping business policy. A ShippingProfileID and/or a ShipppingProfileName value is used in the Add/Revise/Relist/Verify call to reference and use the shippping-related settings/values of a shipping business policy. If both fields are provided and their values don't match, the ShipppingProfileID takes precedence. Shipping profile IDs can be retrieved with the getFulfillmentPolicies call of the Account API or with the getSellerProfiles call of the Business Policies Management API. Business policy IDs can also be retrieved through the Business policies section of My eBay. In the 'Get' calls, the ShipppingProfileID value will always be returned if business policies are set for the listing, and the person making the API call is the seller of the listing. The ShipppingProfileName value will be returned if a name is assigned to the shipping business policy. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally The name of a shipping business policy. A ShippingProfileID and/or a ShippingProfileName value is used in the Add/Revise/Relist/Verify call to reference and use the shipping-related settings/values of a shipping business policy. If both fields are provided and their values don't match, the ShippingProfileID takes precedence. In the 'Get' calls, the ShippingProfileID value will always be returned if business policies are set for the listing, and the person making the API call is the seller of the listing. The ShippingProfileName value will be returned if a name is assigned to the shipping business policy. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally Information about a user returned in the context of an item's seller. PaisaPay is no longer a supported payment method, so this field is no longer applicable. Indicates whether the user as a seller by default allows buyers to edit the total cost of an item (while in checkout). (Sellers enable this property in their My eBay user preferences on the eBay site.) GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Currency type in which the user is billed seller fees. GetItem Conditionally This flag indicates whether or not the seller's Checkout Enabled preference is turned on (at account level or at listing level). This preference is managed through Payment Preferences in My eBay. If this preference is enabled, a Pay Now button will appear in checkout flow pages and in the email notifications that are sent to buyers. GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always If true, this flag indicates that the seller has stored bank account information on file with eBay. A seller must have stored bank account information on file with eBay in order to use 'CashOnPickup' as a payment method (known as 'Pay upon Pickup' on the site). This field is applicable to all eBay sites that support 'CashOnPickup' as a payment method. GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always If true, indicates that the user is in good standing with eBay. (One of the requirements for listing a new item with immediate payment.) GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always This field is deprecated. Indicates whether the user is subject to VAT. Users who have registered with eBay as VAT-exempt are not subject to VAT. GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always This field is deprecated. 773 Avoid 889 The user's eBay PowerSeller tier. Possible values are enumerated in the SellerLevelCodeType code list. SellerInfo.SellerLevel is no longer returned in the GetUser, GetBidderList, GetSellerList, GetItem, and GetItemTransactions responses for the US, DE/AT/CH, and UK/IE sites, for version 629 and later. If you are using a version older than 629, SellerInfo.SellerLevel will still be returned. Developers should note that SellerInfo.SellerLevel could potentially be removed from other sites as well. GetBidderList Always GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Address used by eBay for purposes of billing the user for seller fees. GetUser

DetailLevel: ReturnAll

Conditionally Container for scheduling limits for the user. Conveys the minimum and maximum minutes the user may schedule listings in advance, as well as the maximum number of items the user may schedule at any given time. GetUser

DetailLevel: none, ReturnAll

Conditionally Boolean value indicates whether or not the seller is an eBay Store owner. GetBidderList Always GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always The URL for the seller's eBay Store. This field is only returned if the seller is a store owner (look for a value of <code>true</code> in the SellerInfo.StoreOwner field). GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This enumeration value indicates the type of eBay account used by the seller. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally If true, the user is registered as a vehicle dealer on the eBay Motors site. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This enumeration value indicates the eBay marketplace hosting the seller's eBay Store. GetUser Conditionally This enumeration value indicates the default payment method that the seller is using to pay eBay fees. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. Indicates whether or not the seller is a registered charity seller. If CharityRegistered is <code>false</code>, the user must register their nonprofit organization with the PayPal Giving Fund to list eBay for Charity items. eBay for Charity http://pages.ebay.com/help/sell/nonprofit.html GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Always If this field is <code>true</code>, the user is exempt from the requirement to offer at least one safe payment method when listing items. false GetBidderList Always Seller

DetailLevel: none, ReturnAll

GetItem Always Seller

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription,ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Always GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always This field is deprecated since eBay India is no longer a functioning marketplace. GetUser

DetailLevel: none, ReturnAll

Conditionally This container consists of one or more of nonprofit organizations associated with the seller's account. This container will not be returned if the user is not affiliated with any nonprofit organizations. A seller must be registered with the PayPal Giving Fund to be affiliated with an eBay for Charity nonprofit organization. eBay for Charity http://pages.ebay.com/help/sell/nonprofit.html GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Percentage of the number of times a member has sold successfully vs. the number of times a member has bought an item in the preceding 365 days. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally The container is no longer returned in GetUser response, as eBay sellers can no longer use iMCC gateway accounts to handle buyer payments. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Contains eligibility details about seller- or platform-based features. This is returned only if the IncludeFeatureEligibility field is included and set to <code>true</code> in the request. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This boolean field indicates if the seller is certified as a Top Rated Seller. Only Top Rated Sellers can qualify for Top Rated Plus listings, which receive the Top Rated Plus seal, and will help those listings stand out. Top Rated Plus listings also receive a 20 percent discount on the Final Value Fee. This field is only returned for the following sites: US (EBAY-US), Motors (EBAY-MOTOR), AT (EBAY-AT), CH (EBAY-CH), DE (EBAY-DE), IE (EBAY-IE), UK (EBAY-GB), and AU (EBAY-AU). The Top Rated Seller and Top Rated Plus listing requirements will differ by site. Below are some links to Help pages that discusss these requirements: <ul> <li>eBay US: <a href="http://pages.ebay.com/help/sell/top-rated.html">Becoming a Top Rated Seller and qualifying for Top Rated Plus</a></li> <li>eBay US Motors: <a href="http://pages.ebay.com/help/sell/top-rated.html#becoming">Becoming a Top Rated Seller in Motors vehicles categories</a></li> <li>eBay UK/IE: <a href="http://pages.ebay.co.uk/help/sell/top-rated.html">eBay Top-rated Seller status and the eBay Premium Service</a></li> <li>eBay DE/AT/CH: <a href="http://pages.ebay.de/help/sell/top-rated/2.html"> Anforderungen fur den Verkaufer mit Top-Bewertung</a></li> <li>eBay AU: <a href="http://pages.ebay.com.au/help/sell/top-rated.html"> Becoming a Top Rated Seller and qualifying for eBay Premium Service</a></li> </ul> Top Rated Sellers, registered in the US, can qualify for Top Rated Seller programs in other countries as long as they meet the selling requirements in those countries. However, even if US sellers qualify for programs in other countries, they will not receive the Final Value Fee discount on sales in those countries. For more information, see the <a href="http://pages.ebay.com/help/sell/top-rated.html#qualifying"> Qualifying for Top Rated Seller status on other eBay sites</a> help topic. GetBidderList Conditionally GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Conditionally Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Seller Help Page https://pages.ebay.com/help/sell/top-rated.html more information about how to qualify as a Top Rated Seller on the eBay US, AT, CH, DE, IE and UK sites Contains Top Rated Seller program details for the seller. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally The list of the sites where a seller has agreed to the cross-border recoupment terms. Sellers who engage in cross-border trade on sites that require a recoupment agreement, must agree to the recoupment terms before adding items to the site. This agreement allows eBay to reimburse a buyer during a dispute and then recoup the cost from the seller. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Always A returned value of <code>true</code> indicates that the seller has configured a default, domestic shipping rate table in their My eBay shipping preferences. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally A returned value of <code>true</code> indicates that the seller has configured a default, international shipping rate table in their My eBay shipping preferences. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is no longer used. This field is no longer used. This type is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. This value is not used. Returned if the user is a Selling Manager user. Defines product information for Selling Manager users. The name of a Selling Manager product. GetItemTransactions GetSellerTransactions Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Contains various details about the current status of a listing. These values are computed by eBay and cannot be specified at listing time. Number of bids placed so far against the auction item. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetMyeBayBuying BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList UnsoldList DeleteFromUnsoldList BidList Variations

DetailLevel: none, ReturnAll

Conditionally GetBidderList Always GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Item.SellingStatus Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Always GetSellerEvents

DetailLevel: none, ReturnAll

Item Conditionally The minimum amount a progressive bid must be above the current high bid to be accepted. This field is only applicable to auction listings. The value of this field will always be '0.00' for Classified Ad and fixed-price listings. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Always Converted value of the CurrentPrice in the currency of the site that returned this response. For active items, refresh the listing's data every 24 hours to pick up the current conversion rates. Only returned when the item's CurrentPrice on the listing site is in different currency than the currency of the host site for the user/application making the API call. ConvertedCurrentPrice is not returned for Classified listings (Classified listings are not available on all sites). In multi-variation listings, this value matches the lowest-priced variation that is still available for sale. GetBidderList GetDispute PlaceOffer Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Conditionally GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Item.SellingStatus Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetMyeBayBuying BestOfferList BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList Variations

DetailLevel: none, ReturnAll

Conditionally The current price of the item in the original listing currency. For auction listings, this price is the starting minimum price (if the listing has no bids) or the current highest bid (if bids have been placed) for the item. This does not reflect the BuyItNow price. For fixed-price and ad format listings, this is the current listing price. In multi-variation, fixed-price listings, this value matches the lowest-priced variation that is still available for sale. GetBidderList GetDispute PlaceOffer Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Always GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Item.SellingStatus Always GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetMemberMessages Conditionally GetMyeBayBuying BestOfferList BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling BidList ActiveList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList Variations

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Item Conditionally For ended auction listings that have a winning bidder, this field is a container for the high bidder's user ID. For ended, single-item, fixed-price listings, this field is a container for the user ID of the purchaser. This field isn't returned for auctions with no bids, or for active fixed-price listings. In the case of PlaceOffer, for auction listings, this field is a container for the high bidder's user ID. In the PlaceOffer response, the following applies: For multiple-quantity, fixed-price listings, the high bidder is only returned if there is just one order line item (or only for the first order line item that is created). PlaceOffer Conditionally GetBidderList

DetailLevel: ReturnAll

GranularityLevel: Medium

Variation Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Conditionally GetMyeBayBuying BidList LostList WatchList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling BidList ActiveList Variations

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: ReturnAll

Item Conditionally Applicable to Ad type listings only. Indicates how many leads to potential buyers are associated with this item. Returns 0 (zero) for listings in other formats. You must be the seller of the item to retrieve the lead count. GetSellerList

DetailLevel: ReturnAll

Variation Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Conditionally Smallest amount the next bid on the item can be. Returns same value as Item.StartPrice (if no bids have yet been placed) or CurrentPrice plus BidIncrement (if at least one bid has been placed). Only applicable to auction listings. Returns null for fixed-price and Ad type listings. In multi-variation listings, this value matches the lowest-priced variation that is still available for sale. PlaceOffer Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Always The total number of items purchased so far (in the listing's lifetime). Subtract this from Quantity to determine the quantity available. If the listing has Item Variations, then in GetItem (and related calls) and GetItemTransactions, Item.SellingStatus.QuantitySold contains the sum of all quantities sold across all variations in the listing, and Variation.SellingStatus.QuantitySold contains the number of items sold for that variation. In GetSellerTransactions, Transaction.Item.SellingStatus.QuantitySold contains the number of items sold in that order line item. For order line item calls, also see Transaction.QuantityPurchased for the number of items purchased in the order line item. In multi-variation listings, this value matches total quantity sold across all variations. GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Item Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Variation Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList SoldList UnsoldList ScheduledList DeletedFromSoldList DeletedFromUnsoldList

DetailLevel: none, ReturnAll

Conditionally Indicates whether the reserve price has been met for the listing. Returns true if the reserve price was met or no reserve price was specified. PlaceOffer Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetMyeBayBuying BidList

DetailLevel: none, ReturnAll

Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Always GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList Variations

DetailLevel: none, ReturnAll

Conditionally Part of the Second Chance Offer feature, indicates whether the seller can extend a second chance offer for the item. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Always Number of bidders for an item. Only applicable to auction listings. Only returned for the seller of the item. GetMyeBaySelling ActiveList UnsoldList Variations

DetailLevel: none, ReturnAll

Conditionally Specifies an active or ended listing's status in eBay's processing workflow. <ul> <li>If a listing ends with a sale (or sales), eBay needs to update the sale details (e.g., total price and buyer/high bidder) and the final value fee. This processing can take several minutes.</li> <li>If you retrieve a sold item and no details about the buyer/high bidder are returned or no final value fee is available, use this listing status information to determine whether eBay has finished processing the listing.</li> </ul> GetAllBidders GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Always GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Item.SellingStatus Always GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetSellerEvents Item

DetailLevel: none, ReturnAll

Conditionally A seller is changed a Final Value Fee (FVF) when the item is sold, ends with a winning bid, or is purchased. This fee applies whether or not the sale is completed with the buyer and is generated before the buyer makes a payment. The FVF is calculated using a percentage. This percentage is based on whether the seller has a Store subscription or not. If a seller does have a Store subscription, the FVF is calculated based on the level of that plan. For complete information about selling fees and eBay Store subscription plans, see the <a href="http://www.feectr.ebay.com/feecenter/home">Fee Center Home Page</a>. The Final Value Fee for each order line item is returned by GetSellerTransactions, GetItemTransactions, GetOrders, and GetOrderTransactions, regardless of the checkout status. If a seller requests a Final Value Fee credit, the value of Transaction.FinalValueFee will not change if a credit is issued. The credit only appears in the seller's account data. See the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822" target="_blank">Selling fees</a> help page for more information about how Final Value Fees are calculated. GetBidderList Conditionally GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Item.SellingStatus Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally If a seller has reduced the price of a listed item with the Promotional Price Display feature, this field contains the original price of the discounted item, along with the start-time and end-time of the discount. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Variation Conditionally GetMyeBayBuying WatchList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList Variations

DetailLevel: none, ReturnAll

Conditionally If included in the response as <code>true</code>, indicates that the listing was administratively canceled due to a violation of eBay's listing policies and that the item can be relisted using RelistItem. Note: GetItem returns an error (invalid item ID) in the response if Item.SellingStatus.AdminEnded = <code>true</code> and the requesting user is not the seller of the item. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Variation Conditionally GetItem Variation Conditionally If this flag appears in the GetItem response, the auction has ended due to the item being sold to a seller using the Buy It Now option. This flag is not relevant for fixed-priced listings. GetItem Conditionally Indicates the total quantity of items sold and picked up by buyers using the In-Store Pickup option. This value is the total number of items purchased by one or more buyers using the In-Store Pickup option, and is not the total number of In-Store Pickup orders. So, if two buyers selected the In-Store Pickup option, but each of these buyers bought a quantity of five of these items (in same purchase), the Item.SellingStatus.QuantitySoldByPickupInStore value would be '10' and not '2'. In the case of multi-variation, fixed-price listings, each Item.Variations.Variation.SellingStatus.QuantitySoldByPickupInStore value indicates the total quantity of that corresponding item variation (for example, large blue shirts) sold and picked up by buyers using the In-Store Pickup option, and the Item.SellingStatus.QuantitySoldByPickupInStore value would be the total quantity of all item variations sold for the listing. This field is returned only if the listing is eligible for In-Store Pickup (EligibleForPickupInStore is returned as <code>true</code>). Note: At this time, the In-Store Pickup feature is generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always This container is only returned if the buyer is attempting to bid on an auction item. To bid on an auction item, the buyer sets the value of the Offer.Action field to <code>Bid</code>, and sets the maximum bid amount in the Offer.MaxBid field. The SuggestedBidValues container consists of an array of incremental bid values (up to the dollar value in the Offer.MaxBid field) that eBay will bid on behalf of the buyer each time that buyer is outbid for the auction item. PlaceOffer Conditionally Type used by the ServiceCost container to display any service cost to the buyer for an item that will go through the Authenticity Guarantee process. The amount charged to the buyer for any service cost related to an item going through the Authenticity Guarantee process. This amount is given in the currency of the listing site. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The amount (in the buyer's currency) charged to the buyer for any service cost related to an item going through the Authenticity Guarantee process. This amount is only applicable if the buyer resides in another country that uses a different currency than the currency of the listing site. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Details pertinent to one or more items for which calculated shipping (or flat rate shipping using shipping rate tables with weight surcharges) has been offered by the seller, such as package dimension and weight and packaging/handling costs. Also returned with the data for an item's transaction. Note: The ShippingPackageDetails container should now be used instead of the CalculatedShippingRate container to specify values for the MeasurementUnit, PackageDepth, PackageWidth, PackageLength, ShippingIrregular, ShippingPackage, WeightMajor, and/or WeightMinor fields. The CalculatedShippingRate container should only be used to specify values for the InternationalPackagingHandlingCosts, OriginatingPostalCode, and/or PackagingHandlingCosts fields. Specifies the unit type of the weight and dimensions of a shipping package. If MeasurementUnit is used, it overrides the system specified by measurementSystem. If MeasurementUnit and measurementSystem are not specified, the following defaults will be used: English: US Metric: CA, CAFR, AU CA and CAFR supports both English and Metric, while other sites only support the site's default. Use MeasurementUnit with weight and package dimensions. For example, to represent a 5 lbs 2 oz package: <code> <MeasurementUnit>English</MeasurementUnit> <WeightMajor>5</WeightMajor> <WeightMinor>2</WeightMinor> </code> AddItem AddItems RelistItem ReviseItem VerifyAddItem AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem VerifyRelistItem Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-TypesCosts.html#PackageDimensionsandWeight Package Dimensions and Weight Depth of the package, in whole number of inches, needed to ship the item. This is validated against the selected shipping service. Upon mismatch, a message is returned, such as, "Package dimensions exceeds maximum allowable limit for service XXXXX," where XXXXX is the name of the shipping service. For calculated shipping only. Only returned if the seller specified the value for the item. (In many cases, the seller only specifies the weight fields.) Developer impact: UPS requires dimensions for any Ground packages that are 3 cubic feet or larger and for all air packages, if they are to provide correct shipping cost. If package dimensions are not included for an item listed with calculated shipping, the shipping cost returned will be an estimate based on standard dimensions for the defined package type. eBay enforces a dimensions requirement on listings so that buyers receive accurate calculated shipping costs. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-TypesCosts.html#PackageDimensionsandWeight Package Dimensions and Weight Length of the package, in whole number of inches, needed to ship the item. Upon mismatch, a message is returned, such as, "Package dimensions exceeds maximum allowable limit for service XXXXX," where XXXXX is the name of the shipping service. For calculated shipping only. Only returned if the seller specified the value for the item. (In many cases, the seller only specifies the weight fields.) AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList GetItemShipping Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-TypesCosts.html#PackageDimensionsandWeight Package Dimensions and Weight Width of the package, in whole number of inches, needed to ship the item. Upon mismatch, a message is returned, such as, "Package dimensions exceeds maximum allowable limit for service XXXXX," where XXXXX is the name of the shipping service. For calculated shipping only. Only returned if the seller specified the value for the item. (In many cases, the seller only specifies the weight fields.) AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList GetItemShipping Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-TypesCosts.html#PackageDimensionsandWeight Package Dimensions and Weight Whether a package is irregular and therefore cannot go through the stamping machine at the shipping service office and thus requires special or fragile handling. For calculated shipping only. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The nature of the package used to ship the item(s). Required for calculated shipping only. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally WeightMajor and WeightMinor are used to specify the weight of a shipping package. WeightMajor is used to specify the weight of the package in pounds (in US) or kilograms (all countries that use metric system). Although MeasureType is of decimal type, decimal values should not be used in WeightMajor and WeightMinor. If a shipping package was 5 pounds and 1.8 ounces, the 1.8 ounces should be rounded up to an even 2 ounces. The same is for kilograms. If the package is 2.267 kilgram, you would round up the grams. Below shows you how to represent a package weight of 5 lbs 2 oz and and 2 kg 3 gr: <code> <WeightMajor unit="lbs">5</WeightMajor> <WeightMinor unit="oz">2</WeightMinor> <WeightMajor unit="kg">2</WeightMajor> <WeightMinor unit="gr">3</WeightMinor> </code> If a package weighed 14 oz or 324 gr, below is how you would represent this weight: <code> <WeightMajor unit="lbs">0</WeightMajor> <WeightMinor unit="oz">14</WeightMinor> <WeightMajor unit="kg">0</WeightMajor> <WeightMinor unit="gr">324</WeightMinor> </code> If a package weighed exactly 2 lbs or 105 kg, below is how you would represent this weight: <code> <WeightMajor unit="lbs">2</WeightMajor> <WeightMinor unit="oz">0</WeightMinor> <WeightMajor unit="kg">105</WeightMajor> <WeightMinor unit="gr">0</WeightMinor> </code> In all cases, both the WeightMajor and WeightMinor should be specified in an Add/Revise/Relist/Verify call, even if either's value is '0'. The WeightMajor and WeightMinor are applicable for calculated shipping or for flat-rate shipping if shipping rate tables are specified and the shipping rate table uses weight surcharges. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally WeightMajor and WeightMinor are used to specify the weight of a shipping package. WeightMinor is used to specify the weight of the package in ounces (in US) or grams (all countries that use metric system). Although MeasureType is of decimal type, decimal values should not be used in WeightMajor and WeightMinor. If a shipping package was 5 pounds and 1.8 ounces, the 1.8 ounces should be rounded up to an even 2 ounces. The same is for kilograms. If the package is 2.267 kilgram, you would round up the grams. Below shows you how to represent a package weight of 5 lbs 2 oz and and 2 kg 3 gr: <code> <WeightMajor unit="lbs">5</WeightMajor> <WeightMinor unit="oz">2</WeightMinor> <WeightMajor unit="kg">2</WeightMajor> <WeightMinor unit="gr">3</WeightMinor> </code> If a package weighed 14 oz or 324 gr, below is how you would represent this weight: <code> <WeightMajor unit="lbs">0</WeightMajor> <WeightMinor unit="oz">14</WeightMinor> <WeightMajor unit="kg">0</WeightMajor> <WeightMinor unit="gr">324</WeightMinor> </code> If a package weighed exactly 2 lbs or 105 kg, below is how you would represent this weight: <code> <WeightMajor unit="lbs">2</WeightMajor> <WeightMinor unit="oz">0</WeightMinor> <WeightMajor unit="kg">105</WeightMajor> <WeightMinor unit="gr">0</WeightMinor> </code> In all cases, both the WeightMajor and WeightMinor should be specified in an Add/Revise/Relist/Verify call, even if either's value is '0'. The WeightMajor and WeightMinor are applicable for calculated shipping or for flat-rate shipping if shipping rate tables are specified and the shipping rate table uses weight surcharges. 0 15 for ounces; 999 for grams AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList GetItemShipping Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Status of the delivery. Created (default). Dropped off. In transit. Delivered. Returned. Cancelled. Label printed. Unconfirmed. Unknown. Error. Reserved for future use. This type provides information about one or more order line items in a Global Shipping Program package. Contains information about one order line item in a Global Shipping Program package. The package can contain multiple units of a given order line item, and multiple order line items. CompleteSale SetShipmentTrackingInfo No This type details the shipping carrier and shipment tracking number associated with a package shipment. It also contains information about the line items shipped through the Global Shipping program. The name of the shipping carrier used to ship the item. This field and the ShipmentTrackingNumber field are mutually dependent. When you submit ShippingCarrierUsed, you must also supply a value for ShipmentTrackingNumber. When you submit ShipmentTrackingNumber, you must also supply a value for ShippingCarrierUsed. When the site ID is Austria, Poland, or UK, ShippingCarrierUsed can be any value, because it is not checked by eBay. For all other sites, only the following characters are allowed: letters (<code>a-z</code>, <code>A-Z</code>), numbers (<code>0-9</code>), space, and dash (<code>-</code>). The site ID is specified in the CompleteSale request header. Note: Commonly used shipping carriers can be found by calling GeteBayDetails with DetailName set to <code>ShippingCarrierDetails</code> and examining the returned ShippingCarrierDetails.ShippingCarrier field. <a href="https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/types/ShippingCarrierCodeType.html">ShippingCarrierCodeType</a> also has a list of valid shipping carriers, but eBay cannot guarantee that this enumerated type contains a full, updated list of shipping carriers. For the CompleteSale call: <ul> <li>This field is not case sensitive in the CompleteSale request.</li> <li>When using UPS Mail Innovations, supply the value <code>UPS-MI</code>. Buyers will subsequently be sent to the UPS Mail Innovations website for tracking status. </li> <li>When using FedEx SmartPost, supply the value <code>FedEx</code>. Buyers will subsequently be sent to the FedEx web site for tracking status. </li> </ul> For the Get calls: When using the Global Shipping Program, this field returns a value of <code>PBI</code>. ShippingCarrierCodeType CompleteSale SetShipmentTrackingInfo Conditionally GetItemTransactions GetOrderTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally The tracking number assigned by the shipping carrier to the item shipment. This field and the ShippingCarrierUsed field are mutually dependent. When you submit ShipmentTrackingNumber, you must also supply a value for ShippingCarrierUsed. When you submit ShippingCarrierUsed, you must also supply a value for ShipmentTrackingNumber. The seller is responsible for the accuracy of the shipment tracking number, as eBay only verifies that the tracking number is consistent with the numbering scheme used by the specified shipping carrier, but cannot verify the accuracy of the tracking number. For order management calls, For GetOrders, GetOrderTransactions, GetSellerTransactions, and GetItemTransactions only: This field is only returned if a valid tracking number is set. With the exception of the GetSellerTransactions (where it is only returned to the seller and not buyer), the tracking number will only be returned to the seller or buyer. If a user is using a Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, this field is returned to third parties, but the string value returned in the field will be <code>Unavailable</code>. Note: The Trading API only supports alphanumeric characters for shipment tracking numbers, and any other characters are not supported, including spaces, hyphens, and all other special characters. Users should not enter spaces even if spaces are shown for the tracking number on the shipping label. CompleteSale SetShipmentTrackingInfo Conditionally GetItemTransactions GetOrderTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally Contains information about one or more order line items in a Global Shipping Program package. Required or returned if the value of ShippingCarrierUsed is <code>PBI</code>. CompleteSale SetShipmentTrackingInfo No Type defining the Shipment container, which is used by the seller in CompleteSale to provide shipping information. This field is deprecated. 635 733 NoOp ShipmentType.ShipmentTrackingDetails This field is deprecated. 635 733 NoOp ShipmentType.ShipmentTrackingDetails The date and time that the seller handed off the package(s) to the shipping carrier. If this field is not included in the request, the timestamp of the call execution is used as the shipped time. Note that sellers have the ability to set this value up to 3 calendar days in the future. SetShipmentTrackingInfo No CompleteSale No This field is deprecated. 1027 NoOp 1033 Container consisting of the tracking number and shipping carrier associated with the shipment of one item (package). Because an order can have multiple line items and/or packages, there can be multiple ShipmentTrackingDetails containers under the Shipment container. CompleteSale SetShipmentTrackingInfo No GetItemTransactions GetOrderTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally Type defining the ShippingDetails container, which contains the shipping-related details for an order line item (pre-checkout) or order (post-checkout). IMPORTANT: To avoid loss of shipping details when revising a listing, you must include all ShippingDetails fields that were originally provided. Do not omit any tag, even if its value does not change. Omitting a shipping field when revising an item will remove that detail from the listing. This field is deprecated and has been replaced by the ShippingDetails.PaymentEdited field. This field is deprecated. 663 NoOp 759 Indicates whether eBay's Global Shipping Program is offered for the listing. If the value of GlobalShipping is <code>True</code>, international shipping through the Global Shipping Program is available for the listing, and eBay automatically sets one of the available shipping service options to <code>International Priority Shipping</code>. If the value of GlobalShipping is <code>false</code>, the seller is responsible for specifying one or more international shipping service options if the seller is willing to ship internationally. When calling RelistFixedPriceItem, RelistItem, ReviseFixedPriceItem or ReviseItem, you can omit this field if its value doesn't need to change. Before using this field for a listing, ensure that the seller and the item being listed are eligible for the Global Shipping Program. AddFixedPriceItem VerifyAddFixedPriceItem AddItem VerifyAddItem AddItems RelistFixedPriceItem RelistItem VerifyRelistItem ReviseFixedPriceItem ReviseItem Conditionally GetItem GetSellerList GetMyeBaySelling

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally International Shipping with the Global Shipping Program https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-Managing.html#InternationalShippingwiththeGlobalShippi information about Global Shipping Program eligibility Details pertinent to one or more items for which calculated shipping has been offered by the seller, such as package dimension and weight and packaging/handling costs. If your call specifies a large-dimension item listed with UPS, see <a href= "https://ebaydts.com/eBayKBDetails?KBid=1159" >Dimensional Weight limit on UPS shipping services results in failure of shipping calculator</a>. Note: The CalculatedShippingRate container should only be used to specify values for the InternationalPackagingHandlingCosts, OriginatingPostalCode, and/or PackagingHandlingCosts fields. The rest of the fields in the CalculatedShippingRate container are used to specify package dimensions and package weight, and these values should now be specified in the ShippingPackageDetails container instead. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemShipping Conditionally GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Whether the seller specified payment and shipping instructions during checkout (for example, to update the details of an order). Valid for flat and calculated shipping. GetItemShipping Conditionally GetItemTransactions GetOrderTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Whether or not the buyer selected to pay for insurance as an option offered by the seller. This only has a value after the buyer has gone through checkout and selected the insurance preference. Valid only on the following sites: FR and IT 1031 Avoid 1085 Whether the seller allows the buyer to edit the payment amount for the order. (Sellers enable this property in their My eBay user preferences on the eBay site.) GetItemShipping Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This free-form string field gives sellers the ability to add detailed payment instructions to their listings. 500 This container shows sales tax information for an item in a specific tax jurisdiction. The concept of 'sales tax' is only applicable to eBay US and Canada (English and French) sites. This container can be used in an Add/Revise/Relist/Verify call to set sales tax settings for a specific tax jurisdiction, but it is actually a better practice if a user sets up sales tax rates through the Sales Tax Table tool in My eBay (or by using the SetTaxTable call). A seller's Sales Tax Table is applied to the listing by including the UseTaxTable field in the request and setting its value to <code>true</code>. The GetTaxTable call can be used to retrieve the current sales tax rates for different tax jurisdictions. This container is only returned in order management 'Get' calls if sales tax is applicable to the order line item. For eBay Collect and Remit states, the sales tax information is displayed in the Transaction.Taxes container instead. Note: As of November 2021, buyers in all US states except for Missouri (and several US territories), will automatically be charged sales tax for purchases, and the seller does not set this rate. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. For more US state-level information on sales tax, see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/taxes-import-charges?id=4121#section4">eBay sales tax collection</a> help topic. AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetBidderList GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Enabling Multi-Jurisdiction Sales Tax https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Feature-SalesTax.html For most applicable calls, returns the words No Error or returns an error message related to an attempt to calculate shipping rates. For calculated shipping only. The message text explains that a postal code is needed to calculate shipping. Only returned when ItemDetails is set to <code>Fine</code>. GetItemShipping Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally A shipping rate scale for shipping through USPS that affects the shipping cost calculated for USPS (lower if ShippingRateType is <code>DailyPickup</code>). ShippingRateType is returned only if the value of ShippingService is one of the USPS shipping services. For calculated shipping only. GetItemShipping Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-TypesCosts.html#UPSRateScales UPS Rate Scales This container is used to provide details on a specific domestic shipping service option, including the unique identifier of the shipping service option and the costs related to domestic shipping service. A separate ShippingServiceOptions container is needed for each domestic shipping service option that is available to ship the item. Unless a fulfillment business policy is being used, generally at least one ShippingServiceOptions container will be required. If you specify multiple ShippingServiceOptions nodes, the repeating nodes must be contiguous. For example, you can insert InternationalShippingServiceOption nodes after a list of repeating ShippingServiceOptions nodes, but not between them: <code> <ShippingServiceOptions>...</ShippingServiceOptions> <ShippingServiceOptions>...</ShippingServiceOptions> <ShippingServiceOptions>...</ShippingServiceOptions> <InternationalShippingServiceOption>...</InternationalShippingServiceOption> <InternationalShippingServiceOption>...</InternationalShippingServiceOption> </code> If you specify ShippingDetails when you revise or relist an item but you omit ShippingServiceOptions, eBay will drop the domestic shipping services from the listing. This may also have unintended side effects, as other fields that depend on this data may be dropped as well. To retain the shipping services and dependent fields when you modify other shipping details, it may be simplest to specify all ShippingDetails that you still want to include in the listing. A seller can offer up to four domestic shipping services and up to five international shipping services. However, if the seller is opted in to the Global Shipping Program, only four other international shipping services may be offered (regardless of whether or not Global Shipping is offered for the listing). All specified domestic and international shipping services must be the same shipping type (for example, Flat versus Calculated). Note: If the seller has set the shipping cost model to 'Flat' or 'Calculated' (ShippingDetails.ShippingType field), at least one actual shipping service option must be specified through a ShippingServiceOptions container. In the past, eBay allowed users to set the shipping cost model to 'Flat' or 'Calculated', and then just pass in one ShippingServiceOptions container with the ShippingServiceOptions.ShipppingService value set to a 'Local Pickup' option. Now, sellers must pass in at least one actual domestic shipping service option in addition to any 'Local Pickup' option, or the listing will be blocked with the following error: 17510 - You must specify at least one domestic shipping service, other than or in addition to Local Pickup. For GetItemShipping, results are filtered: if any service is not available in the buyer's region, it is removed. If no services remain after this filtering, a warning is returned. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Always AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetMyeBayBuying BestOfferList BidList DeletedFromWonList WonList WatchList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemShipping

DetailLevel: none

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally AddOrder No https://developer.ebay.com/DevZone/guides/features-guide/default.html#Basics/Call-APISchema.html#Repeating Repeating (Unbounded) Fields rules regarding repeating instances of a nodes (nodes for which maxOccurs is "unbounded" or is greater than 1) Shipping costs and options related to an international shipping service. If used, at least one domestic shipping service must also be provided in ShippingServiceOptions. If you specify multiple InternationalShippingServiceOption nodes, the repeating nodes must be contiguous. That is, you cannot insert other nodes between InternationalShippingServiceOption nodes. All specified domestic and international shipping services must be the same shipping type (for example, Flat versus Calculated). A seller can offer up to four domestic shipping services and up to five international shipping services. However, if the seller is opted in to the Global Shipping Program, only four other international shipping services may be offered (regardless of whether or not Global Shipping is offered for the listing). If you specify ShippingDetails when you revise or relist an item but you omit InternationalShippingServiceOption, eBay will drop the international shipping services (except the Global Shipping Program) from the listing. This may also have unintended side effects, as other fields that depend on this data may be dropped as well. To retain the shipping services and dependent fields when you modify other shipping details, it may be simplest to specify all ShippingDetails that you still want to include in the listing. For GetItemShipping, results are filtered: if any service is not available in the buyer's region, it is removed. If no services remain after this filtering, a warning is returned. AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetItemShipping

DetailLevel: none

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying BestOfferList BidList DeletedFromWonList WonList WatchList

DetailLevel: none, ReturnAll

Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Basics/Call-APISchema.html#Repeating Repeating (Unbounded) Fields rules regarding repeating instances of a nodes (nodes for which maxOccurs is "unbounded" or is greater than 1) The shipping cost model offered by the seller. This is not returned for various calls since shipping type can be deduced: if a CalculatedShippingRate structure is returned by the call, the shipping type is Calculated. Otherwise, it is one of the other non-Calculated shipping types. GetItemShipping and GetItemTransactions: If the type was a mix of flat and calculated services, this is set simply to Flat or Calculated because it is the buyer's selection that results in one of these. GetMyeBayBuying: If the seller has set the ShipToLocation to <code>Worldwide</code> for an item, but has not specified any international shipping service options, <code>NotSpecified</code> is returned as the ShippingType value. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Free, Freight No GetItemShipping Always Free, Freight GetBidderList Free Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Free, Freight Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ReturnAll

Free, Freight Conditionally GetMyeBayBuying GetMyeBaySelling Free, Freight Conditionally The sale record ID. Applicable to Selling Manager users. When an item is sold, Selling Manager generates a sale record. A sale record contains buyer information, shipping, and other information. A sale record is displayed in the Sold view in Selling Manager. Each sale record has a sale record ID. In the following calls, the value for the sale record ID is in the SellingManagerSalesRecordNumber field: GetItemTransactions, GetSellerTransactions, GetOrders, GetOrderTransactions. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the real record number is only returned to the buyer or seller, and a dummy value of <code>0</code> will be returned to all third parties. The sale record ID can be for a single or a multiple line item order. Note: For the GetItemTransactions, GetOrders, and GetOrderTransactions calls, this field is only returned to the seller of the order; this field is not returned for the buyer or third party. GetItemTransactions GetOrderTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field is deprecated. Tax details for a jurisdiction, such as a state or province. If no tax table is associated with the item, a tax table is not returned. For GetItem, a tax table is returned if it exists when: <ul> <li>DetailLevel is set to <code>ReturnAll</code> or ItemReturnDescription (in this case, the value of IncludeTaxTable does not matter)</li> <li>IncludeTaxTable is set to <code>true</code> and DetailLevel is not set or it is set to <code>ItemReturnAttributes</code></li> </ul> GetItem

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field is deprecated. The shipping service actually used by the seller to ship the item(s) to the buyer. ShippingServiceCodeType GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The field is deprecated. On input, this is the ID of the shipping discount to offer for the domestic shipping services (where the shipping discount is either of type FlatShippingDiscount or CalculatedShippingDiscount). On output, this is the ID of the shipping discount offered and corresponds to whichever is returned: FlatShippingDiscount or CalculatedShippingDiscount. Only returned if the calling user is the seller. If the user created a shipping discount profile, use the ShippingDiscountProfileID. In the RelistItem and ReviseItem family of calls, you can remove the existing ShippingDiscountProfileID associated with the item by supplying a value of 0 (zero). Only returned if the calling user is the seller. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-OtherFeatures.html#ShippingCostDiscountProfiles Shipping Cost Discount Profiles If a flat rate shipping discount was offered for the domestic shipping services, this contains the details of the flat rate shipping discount. Otherwise, it is not returned. Only returned if the calling user is the seller. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-OtherFeatures.html#ShippingCostDiscountProfiles Shipping Cost Discount Profiles If a calculated shipping discount was offered for the domestic shipping services, this contains the details of the calculated shipping discount. Otherwise, it is not returned. Only returned if the calling user is the seller. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-OtherFeatures.html#ShippingCostDiscountProfiles Shipping Cost Discount Profiles On input, this specifies whether to offer the promotional shipping discount for the domestic shipping services of this listing (only applicable if the seller has a promotional shipping discount in effect at the moment). Returned on output only if the seller is making the call. This indicates whether the promotional shipping discount is being offered for the domestic shipping services of this listing (if the listing is still active—this is only possible if the seller has a promotional shipping discount in effect at the moment) or whether the discount was offered at the time the listing ended. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-OtherFeatures.html#ShippingCostDiscountProfiles Shipping Cost Discount Profiles On input, this is the ID of the shipping discount to offer for the international shipping services (where the shipping discount is either of type FlatShippingDiscount or CalculatedShippingDiscount). In the RelistItem and ReviseItem family of calls, you can remove the existing InternationalShippingDiscountProfileID associated with the item by supplying a value of 0 (zero). Returned on output only if the seller is making the call. The value is the ID of the shipping discount offered and corresponds to whichever is returned: FlatShippingDiscount or CalculatedShippingDiscount. If the user created a shipping discount profile, use InternationalShippingDiscountProfileID. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-OtherFeatures.html#ShippingCostDiscountProfiles Shipping Cost Discount Profiles This value is returned only if the seller is making the call. If a flat rate shipping discount was offered for the international shipping services, this contains the details of the flat rate shipping discount. Otherwise, it is not returned. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-OtherFeatures.html#ShippingCostDiscountProfiles Shipping Cost Discount Profiles This value is returned only if the seller is making the call. If a calculated shipping discount was offered for the international shipping services, this contains the details of the calculated shipping discount. Otherwise, it is not returned. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-OtherFeatures.html#ShippingCostDiscountProfiles Shipping Cost Discount Profiles On input, this specifies whether to offer the promotional shipping discount for the listing's international shipping services (only applicable if the seller has a promotional shipping discount in effect at the moment). Returned on output only if the seller is making the call. This value indicates whether the promotional shipping discount is being offered for the international shipping services of this listing (if the listing is still active—this is only possible if the seller has a promotional shipping discount in effect at the moment) or whether the discount was offered at the time the listing ended. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-OtherFeatures.html#ShippingCostDiscountProfiles Shipping Cost Discount Profiles This value is returned only if the seller is making the call. Contains details of the promotional shipping discount, if such is being offered while the listing is active or if it was offered at the time the listing ended. GetShippingDiscountProfiles Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-OtherFeatures.html#ShippingCostDiscountProfiles Shipping Cost Discount Profiles This dollar value indicates the money due from the buyer upon delivery of the item. This field should only be specified in the request if 'COD' (cash-on-delivery) is a valid payment method for the site and listing category, and it is included as a PaymentMethods value in the same request. This field is only returned if set for the listing. To see if 'COD' is a supported payment method for a site and category, call GetCategoryFeatures, specifying the listing category ID, and including the FeatureID field set to PaymentMethods. Look for a value of 'CashOnPickup' in one of the Category.PaymentMethod fields in the response. For some eBay sites, the 'COD' enum may also get returned. AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions Order

DetailLevel: none, ItemReturnDescription, ReturnAll

Transaction Conditionally Specifying the COD Option in Shipping Details https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-OtherFeatures.html#SpecifyingtheCashonDeliveryOptioninShipp Use this field to specify an international country or region, or a special domestic location, such as 'PO Box' (in US) or 'Packstation' (in DE), to where you will not ship the associated item. Repeat this element in the call request for each location that you want to exclude as a shipping destination for your item. Set ShipToRegistrationCountry to <code>true</code> to have your ExcludeShipToLocation settings applied to your listing. The locations you have excluded display in the Shipping and Handling section of your item listing. If a buyer's primary ship-to location is a location that you have listed as an excluded ship-to location (or if the buyer does not have a primary ship-to location), they will receive an error message if they attempt to buy or place a bid on your item. The exclude ship-to location values are eBay regions and countries. To see the valid exclude ship-to locations for a specified site, call GeteBayDetails with DetailName set to ExcludeShippingLocationDetails, and then look for the ExcludeShippingLocationDetails.Location fields in the response. Repeat GeteBayDetails for each site on which you list. This field works in conjunction with Item.ShipToLocations to create a set of international countries and regions to where you will, and will not, ship. You can list a region in the ShipToLocations field, then exclude specific countries within that region with this field (for example, you can specify Africa in ShipToLocations, yet exclude Chad with a ExcludeShipToLocation setting). In addition, if your ShipToLocations is <code>Worldwide</code>, you can use this field to specify both regions and countries that you want to exclude from your shipping destinations. You can specify a default set of locations to where you will not ship in My eBay. If you create an Exclude Ship-To List, it is, by default, in effect when you list items. However, if you specify any value in this field on input, it nullifies the default settings in your Exclude Ship-To List. (If you use ExcludeShipToLocation when you list an item, you will need to list all the locations to where you will not ship the associated item, regardless of the default settings in your Exclude Ship-To List.) Specify <code>none</code> in this field to override the default Exclude Ship-To List you might have set up in My eBay and indicate that you do not want to exclude any shipping locations from the respective item listing. Note: To enable your default Exclude Ship-To List, you must enable Exclude Shipping Locations and Buyer Requirements in your My eBay Site Preferences. For details, see the KnowledgeBase Article <a href= "https://ebaydts.com/eBayKBDetails?KBid=1495" >HowTo: ExcludeShipToLocation</a>. ShippingRegionCodeType, CountryCodeType GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

GetItemShipping Conditionally GetItemTransactions GetOrderTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally Sellers can set up a global Exclude Ship-To List through their My eBay account. The Exclude Ship-To List defines the countries to where the seller does not ship, by default. This flag returns true if the Exclude Ship-To List is enabled by the seller for the associated item. If <code>false</code>, the seller's Exclude Ship-To List is either not set up, or it has been overridden by the seller when they listed the item with ExcludeShipToLocation fields. In the response, ExcludeShipToLocation fields detail the locations to where the seller will not ship the item, regardless of the value returned in this field. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

VerifyRelistItem Conditionally Container for the shipping carrier and tracking information associated with the shipment of an order. As each package has a unique tracking number, this container should be repeated for each package in the order. Note: Top-rated sellers must have a record of uploading shipment tracking information (through site or through API) for at least 90 percent of their order line items (purchased by U.S. buyers) to keep their status as Top-rated sellers. For more information on eBay's Top-rated seller program, see the <a href="http://pages.ebay.com/help/sell/top-rated.html">Becoming a Top Rated Seller and qualifying for Top Rated Plus</a> page. Note: Shipment tracking information does not appear in Merchant Data API's OrderReport responses, because once shipment tracking information is provided to the buyer, the order/order line item is considered acknowledged, and acknowledged orders do not show up in OrderReport responses. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally This container is used to reference and apply a seller's domestic and/or international shipping rate tables to a listing. Shipping rate tables allow sellers to configure specific shipping costs based on the shipping destinations and level of service (e.g. economy, standard, expedited, and one-day). Generally speaking, sellers want to use these shipping rate tables so they can charge a higher shipping cost to the buyer whenever shipping costs are higher for them as well. For example, shipping to Alaska or Hawaii is generally more expensive than shipping to any other of the 48 US states, or in regards to international shipping, shipping to some regions and countries are more expensive than others. Sellers configure domestic and international shipping rate tables in My eBay Shipping Preferences. To apply shipping rate tables to a listing, the shipping cost type must be flat-rate. For domestic shipping rate tables, the three supported domestic regions are Alaska & Hawaii, US Protectorates (e.g. Puerto Rico and Guam), and APO/FPO destinations, which are US military bases/locations outside of the continental US. In addition to setting one flat rate based on the destination and service level, the seller also has the option of adding an extra charge based on the weight of the shipping package, or they can add a surcharge instead. To determine if a domestic shipping rate table is set up for the seller's account, the GetUser call can be used, and then the seller will look for a value of <code>true</code> in the User.SellerInfo.DomesticRateTable field. Although the GetUser call can be used to see if a domestic shipping rate table exists for the seller's account, details of the shipping rate table, including all specified costs for the different regions, can only be viewed and modified in My eBay Shipping Preferences. This functionality is not yet available in any public APIs. For international shipping rate tables, specific rates may be set up for any and all of the nine geographical regions and individual countries within those regions. Similar to domestic shipping rate tables, the seller has the option of adding an extra charge based on the weight of the shipping package. Sellers cannot add a surcharge for international shipping. To determine if a international shipping rate table is set up for the seller's account, the GetUser call can be used, and then the seller will look for a value of <code>true</code> in the User.SellerInfo.InternationalRateTable field. Although the GetUser call can be used to see if an international shipping rate table exists for the seller's account, details of the shipping rate table, including all specified costs for the different regions/countries, can only be viewed and modified in My eBay Shipping Preferences. This functionality is not yet available in any public APIs. If you are applying a domestic or international shipping rate table that specifies a surcharge by weight, you must specify the item weight in the ShippingPackageDetails container's WeightMajor and WeightMinor fields, even though the listing is using flat-rate shipping. Do not use any other fields in the ShippingPackageDetails container because none of those fields are applicable in this use case. This container is only returned in the 'Get' calls if one or more shipping rate tables have been applied to the listing, and if the call is being made by the seller who listed the item. Note: The capability to create and use multiple domestic and international shipping rate tables (up to 40 per seller account) has rolled out to the US, Australia, Canada (English and French), Italy, UK, and Germany sites. For other sites, only one domestic and one international shipping rate table may be set up per seller. Whether a seller is using the old default domestic and international shipping rate tables or the new shipping rate tables, these shipping rate tables are set up in My eBay Shipping Preferences or as part of a Shipping Business Policy. If using the Trading API to create a listing that will use the new shipping rate tables, the DomesticRateTableId and InternationalRateTableId fields are used to reference and apply these new shipping rate tables to the listing. If desired, sellers can still use the old default shipping rate tables, but they are not allowed to mix and match old and new shipping rate tables, meaning that they will get an error if they pass in both the old fields (DomesticRateTable and InternationalRateTable) and the new fields (DomesticRateTableId and InternationalRateTableId). The new shipping rate tables have all of the functionality of the old shipping rate tables, plus the seller has access to all domestic regions and not just the special regions (such as Alaska & Hawaii, US Protectorates, and APO/FPO locations in US). AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Using Shipping Rate Tables https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Shipping-TypesCosts.html#UsingShippingRateTables more information on using shipping rate tables. Miscellaneous details of the shipment. Confirmation requested. Signature requested upon receipt. Stealth postage. Saturday delivery. Other. Not defined. (out) Reserved for internal or future use. The nature of the package used to ship the item(s). Required for calculated shipping only. Not all package types are supported by a specific shipping service (ShippingServiceCodeType). None Letter LargeEnvelope USPS Large Package/Oversize 1 Very Large Package/Oversize 2 Extra Large Package/Oversize 3 UPS Letter USPS Flat Rate Envelope Package/thick envelope Roll Europallet Onewaypallet Bulky goods Furniture Cars Motorbikes Caravan Industry vehicles Parcel or padded Envelope Small Canada Post Box Medium Canada Post Box Large Canada Post Box Small Canada Post Bubble Mailer Medium Canada Post Bubble Mailer Large Canada Post Bubble Mailer Padded Bags Tough Bags Expandable Tough Bags Mailing Boxes Winepak Reserved for internal or future use. Type defining the ShippingPackageInfoType container, which is returned in order management calls. The ShippingPackageInfoType container provides information on delivery times and tracking information for a shipping package. The unique identifier of the store from where the order will be delivered. This field is only applicable to 'In-Store Pickup' and 'Click and Collect' orders. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This enumeration value indicates whether or not the order has been picked up from the store indicated by the StoreID value. This field is only applicable to 'In-Store Pickup' and 'Click and Collect' orders. ShippingTrackingEventCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The ScheduledDeliveryTimeMin and ScheduledDeliveryTimeMax timestamps indicate the delivery window for which the buyer can expect to receive the order. The ScheduledDeliveryTimeMin value indicates the earliest time that the buyer can expect to receive the order. The ScheduledDeliveryTimeMin and ScheduledDeliveryTimeMax fields will start being returned once the seller marks the order as shipped/provides tracking information. Until then, the EstimatedDeliveryTimeMin and EstimatedDeliveryTimeMax dates are returned instead. Note: This field does not appear in Merchant Data API's OrderReport responses, because once shipment tracking information is provided to the buyer, the order/order line item is considered acknowledged, and acknowledged orders do not show up in OrderReport responses. GetOrders

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The ScheduledDeliveryTimeMin and ScheduledDeliveryTimeMax timestamps indicate the delivery window for which the buyer can expect to receive the order. The ScheduledDeliveryTimeMax value indicates the latest time that the buyer can expect to receive the order. The ScheduledDeliveryTimeMin and ScheduledDeliveryTimeMax fields will start being returned once the seller marks the order as shipped/provides tracking information. Until then, the EstimatedDeliveryTimeMin and EstimatedDeliveryTimeMax dates are returned instead. Note: This field does not appear in Merchant Data API's OrderReport responses, because once shipment tracking information is provided to the buyer, the order/order line item is considered acknowledged, and acknowledged orders do not show up in OrderReport responses. GetOrders

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This timestamp indicates when the order was actually delivered to the buyer. This field is only returned after the order has been delivered to the buyer. Note: This field does not appear in Merchant Data API's OrderReport responses, because once shipment tracking information is provided to the buyer (or marked as shipped), the order/order line item is considered acknowledged, and acknowledged orders do not show up in OrderReport responses. GetOrders

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The EstimatedDeliveryTimeMin and EstimatedDeliveryTimeMax timestamps indicate the window during which the buyer can expect delivery. The EstimatedDeliveryTimeMin value indicates the earliest date and time that the buyer can expect to receive the order. The EstimatedDeliveryTimeMin and EstimatedDeliveryTimeMax dates are only estimates made by eBay, and their accuracy will depend on the seller meeting the handling time deadline. Once the seller ships the order, and marks it as shipped/provides tracking information, the more accurate delivery dates can be found in the the ScheduledDeliveryTimeMin and ScheduledDeliveryTimeMax fields. GetOrders ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally OrderReport ShippingServiceSelected Conditionally GetOrderTransactions ShippingServiceSelected

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally The EstimatedDeliveryTimeMin and EstimatedDeliveryTimeMax timestamps indicate the window during which the buyer can expect delivery. The EstimatedDeliveryTimeMax value indicates the latest date and time that the buyer can expect to receive the order. The EstimatedDeliveryTimeMin and EstimatedDeliveryTimeMax dates are only estimates made by eBay, and their accuracy will depend on the seller meeting the handling time deadline. Once the seller ships the order, and marks it as shipped/provides tracking information, the more accurate delivery dates can be found in the the ScheduledDeliveryTimeMin and ScheduledDeliveryTimeMax fields. GetOrders ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally OrderReport ShippingServiceSelected Conditionally GetOrderTransactions ShippingServiceSelected

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally This timestamp indicates the latest date/time that the seller should ship the package to ensure that the package arrives to the buyer within the estimated delivery window. This date/time is calculated by adding the handling time (in days) to the purchase time. This field is applicable for domestic shipping services, and for Click and Collect orders in the UK and Australia. GetOrders

DetailLevel: none, ReturnAll

ShippingServiceSelected Conditionally OrderReport ShippingServiceSelected Conditionally GetOrderTransactions ShippingServiceSelected

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally The MinNativeEstimatedDeliveryTime and MaxNativeEstimatedDeliveryTime timestamps indicate the window during which the buyer can expect delivery based on the seller's handling time and selected shipping service. The MinNativeEstimatedDeliveryTime value indicates the earliest date and time that the buyer can expect to receive the order. This field is applicable for domestic shipping services, and for Click and Collect orders in the UK and Australia. GetOrders ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally OrderReport ShippingServiceSelected Conditionally GetOrderTransactions ShippingServiceSelected

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally The MinNativeEstimatedDeliveryTime and MaxNativeEstimatedDeliveryTime timestamps indicate the window during which the buyer can expect delivery based on the seller's handling time and selected shipping service. The MaxNativeEstimatedDeliveryTime value indicates the latest date and time that the buyer can expect to receive the order. This field is applicable for domestic shipping services, and for Click and Collect orders in the UK and Australia. GetOrders ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally OrderReport ShippingServiceSelected Conditionally GetOrderTransactions ShippingServiceSelected

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally A shipping rate scale for shipping through UPS that affects the shipping cost calculated for UPS (lower if ShippingRateType is <code>DailyPickup</code>). For calculated shipping only. "On-demand" shipping rate scale. "Daily pickup" shipping rate scale. "Standard List" shipping rate scale. "Counter" shipping rate scale. "Discounted" shipping rate scale. "Commercial Plus" shipping rate scale. "Commercial Plus Discounted Rate1" shipping rate scale. "Commercial Plus Discounted Rate2" shipping rate scale. (out) Reserved for internal or future use. Type defining the ShippingServiceCostOverrideList container, which is used when the seller wants to override flat-rate shipping costs for one or more domestic and/or international shipping service options defined in the Business Policies shipping profile referenced in the SellerProfiles.SellerShippingProfile.ShippingProfileID field of an Add/Revise/Relist call. Shipping service cost overrides are a listing-level concept, and the shipping costs specified through each ShippingServiceCostOverrideList.ShippingServiceCostOverride container will not change the shipping costs defined for the same shipping services in the Business Policies shipping profile. A ShippingServiceCostOverride container is required for each domestic and/or international shipping service option, defined in the domesticShippingPolicyInfoService and intlShippingPolicyInfoService containers of the Business Policies shipping profile, that the seller wishes to override the shipping costs. Shipping costs include the cost to ship one item, the cost to ship each additional identical item, and any shipping surcharges applicable to domestic shipping services. Shipping service cost overrides are a listing-level concept, and the shipping costs specified through each ShippingServiceCostOverride container will not change the shipping costs defined for the same shipping service options in the Business Policies shipping profile. To override the shipping costs for any domestic shipping service option in the Business Policies shipping profile, the ShippingServiceType field should be set to 'Domestic', and to override the shipping costs for any international shipping service option, the ShippingServiceType field should be set to 'International'. For both domestic and international shipping services, the ShippingServicePriority value should match the sortOrderId value for the matching shipping service in the shipping profile. If any of the domestic and/or international shipping service priorities and shipping service options in the Add/Revise/Relist call and Business Policies shipping profile do not match, an error occurs. If shipping service cost overrides are used in a listing, the ShippingServiceCostOverride container will be returned in the GetItem, and GetSellerList calls. AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No GetItem GetSellerList Conditionally Type defining the ShippingServiceCostOverride container, which is used to override the flat shipping costs for a domestic and/or international shipping service option that is defined in the domesticShippingPolicyInfoService and intlShippingPolicyInfoService containers of the Business Policies shipping profile. Shipping costs include the cost to ship one item, the cost to ship each additional identical item, and any shipping surcharges applicable to domestic shipping services. A ShippingServiceCostOverride container is required for each domestic and/or international shipping service option whose costs the seller wishes to override. This integer value maps the particular instance of the ShippingServiceCostOverride container to the domesticShippingPolicyInfoService or intlShippingPolicyInfoService container of the Business Policies shipping profile. The ShippingServicePriority value should match the sortOrderId value for the matching shipping service in the Business Policies shipping profile. If overriding the shipping costs for a domestic shipping service, the ShippingServiceType field should be set to 'Domestic', and to override the shipping costs for an international shipping service, the ShippingServiceType field should be set to 'International'. If any of the domestic and/or international shipping service priorities and shipping service options in the Add/Revise/Relist call and Business Policies shipping profile do not match, an error occurs. AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No GetItem GetSellerList Conditionally This enumerated value indicates whether the shipping costs of a domestic or an international shipping costs are being overridden. To override the shipping costs for any domestic shipping service in the Business Policies shipping profile, this field should be set to 'Domestic', and to override the shipping costs for any international shipping service, this field should be set to 'International'. AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No GetItem GetSellerList Conditionally This dollar value indicates the shipping service cost to ship one item to the buyer. If the shipping service costs override operation is successful, this value will override the corresponding shippingServiceCost value set in the domesticShippingPolicyInfoService (domestic shipping service) or intlShippingPolicyInfoService (international shipping service) containers in the Business Policies shipping profile. AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No GetItem GetSellerList Conditionally This dollar value indicates the cost to ship each additional identical item to the buyer. If the shipping service costs override operation is successful, this value will override the corresponding shippingServiceAdditionalCost value set in the domesticShippingPolicyInfoService (domestic shipping service) or intlShippingPolicyInfoService (international shipping service) containers in the Business Policies shipping profile. This field is only applicable to multi-quantity, fixed-price listings. AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No GetItem GetSellerList Conditionally Container consisting of shipping costs and other details related to a domestic shipping service. A ShippingServiceOptions container is required for each domestic shipping service option that the seller will make available to buyers in an Add/Revise/Relist call. Up to four domestic shipping service options can be offered per listing. This field is no longer applicable as it is not longer possible for a seller to offer a buyer shipping insurance. 1035 NoOp 1035 This enumeration value indicates a specific domestic shipping service option being offered by the seller to ship an item to a buyer who is located within the same country as the item. This field is required to identify each domestic shipping service option that is specified with a ShippingServiceOptions container. For a list of valid ShippingService values, call GeteBayDetails with DetailName set to <code>ShippingServiceDetails</code>. The ShippingServiceDetails.ValidForSellingFlow flag must also be present. Otherwise, that particular shipping service option is no longer valid and cannot be offered to buyers through a listing. To view the full list of domestic shipping service options in the response, look for the ShippingServiceDetails.ShippingService fields. Domestic shipping service options will not have a InternationalService = <code>true</code> field, as this indicates that the ShippingService value is an International shipping service option. Note: The eBay standard envelope (eSE) is a domestic envelope service with tracking through eBay. This service applies to specific sub-categories of Trading Cards categories, and to Coins & Paper Money, Postcards, and Stamps. To use this service, send envelopes using the USPS mail and set the ShippingService field to <code>US_eBayStandardEnvelope</code>. See <a href="https://pages.ebay.com/seller-center/shipping/ebay-standard-envelope.html#lower-cost-way">eBay standard envelope</a> for details and restrictions. For the REST equivalent, see <a href="https://developer.ebay.com/api-docs/sell/static/seller-accounts/using-the-ebay-standard-envelope-service.html" target=/"_blank/">Using the eBay standard envelope (eSE) service</a>. ShippingServiceCodeType SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemShipping GetMyeBayBuying Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GeteBayDetails https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GeteBayDetails.html The base cost of shipping one unit of the item using the shipping service specified in the corresponding ShippingService field. In the case of a multiple-quantity, fixed-price listing, the ShippingServiceAdditionalCost field also becomes applicable, and shows the cost to ship each additional unit of the item if the buyer purchases multiple quantity of the same line item. Note: If the corresponding shipping service option is set as a 'free shipping' option (FreeShipping=true), the seller still needs to include this ShippingServiceCost field and set its value to <code>0.0</code>, as eBay will not do this automatically. When returned by GetItemShipping, it includes the packaging and handling cost. Note that if ShippingService is set to <code>LocalPickup</code>, ShippingServiceCost must be set to <code>0.0</code>. Also, if a shipping service has been specified (even LocalPickup), GetItem returns the shipping service cost, even if the cost is zero. If this is for calculated shipping for a listing that has not yet ended, note that the cost cannot be determined until the listing has ended and the buyer has specified a postal code. SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping GetMyeBayBuying Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying BidList WonList WatchList DeletedFromWonList BestOfferList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally The cost of shipping each additional item if the same buyer purchases multiple quantity of the same line item. This field is required when creating a multiple-quantity, fixed-price listing. Generally, the seller will give the buyer a shipping discount if that buyer purchases multiple quantity of the item, so this value should usually be less than the value set for ShippingServiceCost. The value of this field can even be set to <code>0</code> if the seller wants to encourage buyers to buy multiple quantity of the item, or it could be that the seller can fit multiple quantities of the line item in a single shipping package, so the seller is just passing this shipping savings onto the buyer. This field is not applicable for single-quantity listings. SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping GetMyeBayBuying Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Controls the order (relative to other shipping services) in which the corresponding ShippingService will appear in the View Item and Checkout page. Sellers can specify up to four domestic shipping services (with four ShippingServiceOptions containers), so valid values are 1, 2, 3, and 4. A shipping service with a ShippingServicePriority value of 1 appears at the top. Conversely, a shipping service with a ShippingServicePriority value of 4 appears at the bottom of a list of four shipping service options. If this field is omitted from domestic shipping service options, the order of the shipping service options in View Item and Checkout pages will be determined by the order that these shipping service options are presented in the request payload of an Add/Revise/Relist call. SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping GetMyeBayBuying Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This field is returned as <code>true</code> if the domestic shipping service is considered an expedited shipping service. An expedited service is typically a shipping service that can ship an order that will arrive at the buyer's location within one to two business days. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemShipping GetMyeBayBuying Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The integer value returned here indicates the minimum number of business days that the shipping service (indicated in the corresponding ShippingService field) will take to be delivered to the buyer. This minimum shipping time does not include the seller's handling time, and the clock starts on the shipping time only after the seller has delivered the item to the shipping carrier for shipment to the buyer. 'Business days' can vary by shipping carrier and by country, but 'business days' are generally Monday through Friday, excluding holidays. This field is returned if defined for that particular shipping service option. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemShipping GetMyeBayBuying Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The integer value returned here indicates the maximum number of business days that the shipping service (indicated in the corresponding ShippingService field) will take to be delivered to the buyer. This maximum shipping time does not include the seller's handling time, and the clock starts on the shipping time only after the seller has delivered the item to the shipping carrier for shipment to the buyer. 'Business days' can vary by shipping carrier and by country, but 'business days' are generally Monday through Friday, excluding holidays. This field is returned if defined for that particular shipping service option. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemShipping GetMyeBayBuying Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This boolean field indicates whether or not the corresponding domestic shipping service option is free to the buyer. In an Add/Revise/Relist call, free shipping can only be offered for the first specified shipping service (so, the corresponding ShippingServicePriority value should be <code>1</code> or included first in the call request). If 'free shipping' is for any other shipping service, this field is ignored. For 'Get' calls, including GetItem, this field is only returned if <code>1</code>. Note: If a seller is specifying a shipping service option as 'free shipping', in addition to this FreeShipping boolean field, the seller will also need to include the corresponding ShippingServiceCost field and set its value to <code>0.0</code>, as eBay will not do this automatically. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemShipping

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying Conditionally https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Shipping-Services.html#SpecifyingFreeShipping Specifying Free Shipping The LocalPickup flag is used by the GetMyEbayBuying and GetMyEbaySelling calls to indicate whether the buyer has selected local pickup as the shipping option or the seller has specified local pickup as the first shipping option. The LocalPickup flag can also be used with other fields to indicate if there is no fee for local pickup. For example, if the LocalPickup flag is used with the ShippingServiceOptions and ShippingServiceCost fields, the seller can indicate that local pickup is an available option and that no is fee charged. This is the equivalent of free shipping. GetMyeBayBuying GetMyeBaySelling Conditionally The total cost of customs and taxes for the international leg of an order shipped using the Global Shipping Program. This amount is calculated and supplied for each item by the international shipping provider when a buyer views the item properties. GetItemShipping Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying Conditionally This container is no longer applicable, and it was only applicable to eBay Now and 'eBay On Demand Delivery' orders, and neither of these features are available any longer. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The last time of day that an order using the specified shipping service will be accepted by the seller for the current listing. The cut off time applies and is returned only when the ShippingService field contains the name of a qualifying time-sensitive shipping service, such as <code>eBayNowImmediateDelivery</code>. The cut off time is set by eBay and determined in part by the policies and locations of the seller and the shipping carrier. GetItemShipping Conditionally Reserved for internal or future use. This enumerated type defines the possible values that can be used in the ShippingServiceType field of the ShippingServiceCostOverride container. This value should be used if the seller is overriding shipping costs for all domestic shipping services defined in the Business Policies shipping profile. This value should be used if the seller is overriding shipping costs for all international shipping services defined in the Business Policies shipping profile. The shipping cost model offered by the seller. Flat shipping model: the seller establishes the cost of shipping and cost of shipping insurance, regardless of what any buyer-selected shipping service might charge the seller. Note: This shipping type includes an option for a Flat Rate Freight shipping service. For details about freight shipping, see <a href="https://developer.ebay.com/devzone/guides/features-guide/default.html#development/Shipping-TypesCosts.html#SpecifyingFreightShipping">Specifying Freight Shipping</a> in the eBay Features Guide. Calculated shipping model: the cost of shipping is determined in large part by the seller-offered and buyer-selected shipping service. The seller might assess an additional fee via PackagingHandlingCosts. Freight shipping model. Available only for US domestic shipping. The cost of shipping is automatically determined by an affiliated third party, FreightQuote.com, based on the item location (postal code). Note: This shipping type cannot be set via API, but it is automatically set by eBay when a buyer selects the FreightQuote.com option on the US eBay website. For details about types of freight shipping that you can specify via API, see <a href="https://developer.ebay.com/devzone/guides/features-guide/default.html#development/Shipping-TypesCosts.html#SpecifyingFreightShipping">Specifying Freight Shipping</a> in the eBay Features Guide. Free shipping. This field is output-only so if you want to use AddItem to specify a free Shipping Cost, specify 0 in Item.ShippingDetails.ShippingServiceOptions.ShippingServiceCost. The seller did not specify the shipping type. The seller specified one or more flat domestic shipping services and one or more calculated international shipping services. The seller specified one or more calculated domestic shipping services and one or more flat international shipping services. Freight shipping model. Available only for the US, UK, AU, CA and CAFR sites, and only for domestic shipping. <code>FreightFlat</code> applies to shipping with carriers that are not affiliated with eBay. It is negotiated freight, not a flat rate. Sellers negotiate the shipping cost with their chosen carrier and the buyer before completing the sale. FreightFlat shipping may be used when calculated shipping cannot be used due to the greater weight of the item. For details about freight shipping, see <a href="https://developer.ebay.com/devzone/guides/features-guide/default.html#development/Shipping-TypesCosts.html#SpecifyingFreightShipping">Specifying Freight Shipping</a> in the eBay Features Guide. Reserved for future use. eBay sites (by the country in which each resides) on which a user is registered and on which items can be listed through the Trading API. China, Sweden, Taiwan USA, site ID 0, abbreviation US, currency USD. (<a href="http://www.ebay.com" target="_blank">http://www.ebay.com</a>) Canada, site ID 2, abbreviation CA, currencies CAD and USD. (<a href="http://www.ebay.ca" target="_blank">http://www.ebay.ca</a>) United Kingdom, site ID 3, abbreviation UK, currency GBP. (<a href="http://www.ebay.co.uk" target="_blank">http://www.ebay.co.uk</a>) Australia, site ID 15, abbreviation AU, currency AUD. (<a href="http://www.ebay.com.au" target="_blank">http://www.ebay.com.au</a>) Austria, site ID 16, abbreviation AT, currency EUR. (<a href="http://www.ebay.at" target="_blank">http://www.ebay.at</a>) Belgium (French), site ID 23, abbreviation BEFR, currency EUR. (<a href="http://www.ebay.be" target="_blank">http://www.ebay.be</a>) France, site ID 71, abbreviation FR, currency EUR. (<a href="http://www.ebay.fr" target="_blank">http://www.ebay.fr</a>) Germany, site ID 77, abbreviation DE, currency EUR. (<a href="http://www.ebay.de" target="_blank">http://www.ebay.de</a>) Italy, site ID 101, abbreviation IT, currency EUR. (<a href="http://www.ebay.it" target="_blank">http://www.ebay.it</a>) Belgium (Dutch), site ID 123, abbreviation BENL, currency EUR. (<a href="http://www.ebay.be" target="_blank">http://www.ebay.be</a>) Netherlands, site ID 146, abbreviation NL, currency EUR. (<a href="http://www.ebay.nl" target="_blank">http://www.ebay.nl</a>) Spain, site ID 186, abbreviation ES, currency EUR. (<a href="http://www.ebay.es" target="_blank">http://www.ebay.es</a>) Switzerland, site ID 193, abbreviation CH, currency CHF. (<a href="http://www.ebay.ch" target="_blank">http://www.ebay.ch</a>) Taiwan, currency TWD. Note that the old eBay Taiwan site is no longer in operation, and the new site does not use this API. Although Site ID 100 is still valid in APIs, eBay Motors US is no longer its own site, but just a vertical within the eBay US site. Hong Kong, site ID 201, abbreviation HK, currency HKD. (<a href="http://www.ebay.com.hk" target="_blank">http://www.ebay.com.hk</a>) Singapore, site ID 216, abbreviation SG, currency SGD. (<a href="http://www.ebay.com.sg" target="_blank">http://www.ebay.com.sg</a>) India, site ID 203, abbreviation IN, currency INR. (<a href="http://www.ebay.in" target="_blank">http://www.ebay.in</a>) Ireland, site ID 205, abbreviation IE, currency EUR. (<a href="http://www.ebay.ie" target="_blank">http://www.ebay.ie</a>) Malaysia, site ID 207, abbreviation MY, currency MYR. (<a href="http://www.ebay.com.my" target="_blank">http://www.ebay.com.my</a>) Philippines, site ID 211, abbreviation PH, currency PHP. (<a href="http://www.ebay.ph" target="_blank">http://www.ebay.ph</a>) Poland, site ID 212, abbreviation PL, currency PLN. (<a href="http://www.ebay.pl" target="_blank">http://www.ebay.pl</a>) Reserved for internal or future use. Canada French, site ID 210, abbreviation CAFR, currencies CAD and USD. Russia, site ID 215, abbreviation RU, currency RUB. Sellers must use Merchant Integration Platform (MIP) to create and revise listings on the Russia site. Russian listings cannot be created or revised through the Trading API's add and revise calls, so 'Russia' would not be a valid value to pass in through Item.Site field of an Add or Revise Trading API call. This type specifies the sort order of a returned array of elements. The array or list to be sorted, the sort key, and the default sort order depend on the call. The results will be sorted by the specified key in ascending (low to high) order. The results will be sorted by the specified key in descending (high to low) order. (out) Reserved for internal or future use. This type defines the Storefront container, which can be used by eBay Stores sellers to list an item under two primary custom categories either by category ID or category name. A custom category is a category that was created by a seller in their eBay store. This container is used by Add/Revise/Relist calls. The Storefront container is also returned in GetItem and other Trading calls that retrieve Item data. Note: This type is applicable only for eBay Store sellers. Unique identifier of a primary custom category in which to list the item. A custom category is a category that the seller created in their eBay Store. eBay Store sellers can create up to three levels of custom categories for their stores, but the API only supports root-level categories. To list an item using the categories in a seller's store, you must set this field to a root-level custom category or a custom category that has no child categories (subcategories). If you attempt to list an item in a category that has subcategories, the call response contains a warning, and the item is listed in the 'Other' store category. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Unique identifier for the secondary custom category in which to list the item. Set this field to a root-level custom category or a custom category that has no child categories (subcategories). The system resets the value to 0 (None) in the following cases: - The values of StoreCategoryID and StoreCategory2ID field are the same - You specify StoreCategory2ID but not StoreCategoryID In other words, StoreCategoryID must be set to a valid custom category and be different from StoreCategory2ID. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Category name of a primary custom category in which to list the item. A custom category is a category that the seller created in their eBay Store. eBay Store sellers can create up to three levels of custom categories for their stores, but the API only supports root-level categories. To list an item using a category name from a seller's store, you must set this field to a root-level custom category or a custom category that has no child categories (subcategories). If you attempt to list an item in a category that has subcategories, the call response contains a warning, and the item is listed in the store category called 'Other'. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No Name of the secondary custom category in which to list the item. Set this field to a root-level custom category or a custom category that has no child categories (subcategories). The system resets the value to 0 (None) in the following cases: - The values of StoreCategoryName and StoreCategory2Name field are the same - You specify StoreCategory2Name but not StoreCategoryName In other words StoreCategoryName must be set to a valid custom category name and be different from StoreCategory2Name. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No The URL of the seller's eBay Stores page. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The name of the seller's eBay Store. 200 This type is used by the SuggestedBidValues container that is returned if the buyer is attempting to bid on an auction item through the PlaceOffer call. The SuggestedBidValues container is only returned if the buyer is attempting to bid on an auction item. A BidValue field is returned for each incremental bid value (up to the dollar value specified in the Offer.MaxBid field in the request) that eBay will bid on behalf of the buyer each time that buyer is outbid for the auction item. How many BidValue fields that appear will depend on the current winning bid amount, the required bid increment, and the buyer's specified max bid amount. PlaceOffer Conditionally Enumerated type that lists the types of taxes that may be charged to the buyer for each order line item purchased. This enumeration value indicates that standard sales tax was charged to the buyer against the order line item. This enumeration value indicates that an electronic waste recycling fee was charged to the buyer against the order line item. This enumeration value indicates that a tire recycling fee was charged to the buyer against the order line item. This enumeration value indicates that a Goods and Services import tax was charged to the buyer against the order line item. Note: At this time, this tax type is only applicable to the Australia site. Reserved for internal or future use. Type used by the TaxDetails container, which consists of detailed tax information for an order line item, including the tax type and description, tax on the item cost, and tax related to shipping and handling. The information in this container supercedes/overrides the sales tax information in the ShippingDetails.SalesTax container (if returned). A separate TaxDetails container will be returned for each type of tax that applied to an order line item. For tax that is subject to 'eBay collect and remit', such as US sales tax or 'Goods and Services tax' for Australia or New Zealand, the TaxDetails container will be returned under the eBayCollectAndRemitTaxes container. For all other tax, the tax details will be returned under the Taxes container. This field indicates the tax type. A separate TaxDetails container is returned for each unique imposition (tax type). GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This enumeration value indicates the type of tax charged against the item. GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value is the total amount of tax charges for the order line item for the corresponding tax type (see Imposition value). TaxAmount = TaxOnSubtotalAmount + TaxOnShippingAmount + TaxOnHandlingAmount GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value is the amount of sales tax applied based on the unit cost of the order line item for the corresponding impositiion (tax type). GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value is the amount of sales tax applied based on shipping costs for the order line item for the corresponding impositiion (tax type). GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value is the amount of sales tax applied based on handling costs for the order line item for the corresponding impositiion (tax type). GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value is the actual tax ID for the buyer. This field will generally only be returned if a seller on the Italy or Spain sites required that the buyer supply a tax ID during the checkout process. If the Order.BuyerTaxIdentifier container is returned, the type of tax ID can be found in the BuyerTaxIdentifier.Type field. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This field indicates the collection method used to collect the 'eBay Collect and Remit' or 'Good and Services' tax for the order. This field is always returned for orders subject to 'Collect and Remit' or 'Good and Services' tax, and its value is always <code>NET</code>. Note: Although the CollectionMethod field is returned for all orders subject to 'Collect and Remit' sales tax or 'Good and Services' tax, the CollectionMethod field and CollectionMethodCodeType are not currently of any practical use, although this field may have use in the future. If and when the logic of this field is changed, this note will be updated and a note will also be added to the Release Notes. NET GetItemTransactions GetOrders OrderReport GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally eBayCollectAndRemitTaxes.TaxDetails NET OrderReport Conditionally eBayCollectAndRemitTaxes.TaxDetails This enumerated type contains the possible values that can be returned in the name attribute of the BuyerTaxIdentifier.Attribute field. Currently, this type only contains one enumeration value, but in the future, other attributes related to the tax ID may be created for this type. This value indicates that the value returned in the BuyerTaxIdentifier.Attribute field is the country that issued the buyer tax ID. Reserved for internal or future use. This type is used to display the value of the name attribute of the BuyerTaxIdentifier.Attribute field. The only supported value for this attribute is 'IssuingCountry', but in the future, other attributes related to the tax ID may be supported. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This type defines the BuyerTaxIdentifier container that is returned in order management calls. This container will either consist of VAT or Codice Fiscale taxpayer identification information for the buyer. This enumeration value identifies the type of tax ID that was supplied by the buyer during the checkout process. Date, Decimal, EAN, ISBN, Text, UPC GetOrders

DetailLevel: none, ReturnAll

Conditionally Date, Decimal, EAN, ISBN, Text, UPC OrderReport Conditionally Date, Decimal, EAN, ISBN, Text, UPC GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Date, Decimal, EAN, ISBN, Text, UPC GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This value is the actual tax ID for the buyer. The type of tax ID is shown in the Type field. GetOrders

DetailLevel:none,ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel:none,ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel:none,ReturnAll

Conditionally This field shows an attribute, and its corresponding value for the buyer's tax identification card. Currently, this field is only used to indicate which country issued the buyer's tax ID, but in the future, other attributes related to the tax ID may be returned in this field. This field's value will be an <a href="http://en.wikipedia.org/wiki/ISO_3166-1" target="_blank">ISO 3166-1 two-digit code</a> that represents the issuing country. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This type is used to show sales tax-related details for a tax jurisdiction. The concept of 'sales tax' is only applicable to eBay US and Canada (English and French) sites. This is the unique, two-digit identifier of the tax jurisdiction (such as 'CA' for California). To retrieve all JurisdictionID values for a site, a seller can either use a GetTaxTable call with DetailLevel set to <code>ReturnAll</code>, or they can use the GeteBayDetails call with DetailLevel name set to <code>TaxJurisdiction</code>. The JurisdictionID field is always required in a SetTaxTable call, and always returned with each TaxJurisdiction container to identify the tax jurisdiction. SetTaxTable Yes GetBidderList GeteBayDetails Conditionally GetTaxTable GetSellerList

DetailLevel: none, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This float value is the sales tax percentage rate applicable to the corresponding tax jurisdiction. Sellers are responsible for providing accurate sales tax rates for each jurisdiction. This sales tax rate comes into play when a buyer from that tax jurisdiction makes a purchase from the seller. The value passed in is stored with a precision of 3 digits after the decimal point (##.###). This field is only returned in GetTaxTable (and other 'Get' calls) if a sales tax percentage rate has been set. Note: As of April 1, 2020, buyers in 40 US states will automatically be charged sales tax for eBay purchases. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. So, if a sales tax rate is applied to the listing by the seller for a state that is subject to eBay 'Collect and Remit', the sales tax rate in this field is ignored by eBay during the checkout process. For a list of US states that are subject to eBay 'Collect and Remit' taxes (and effective dates), see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/taxes-import-charges?id=4121#section4">eBay sales tax collection</a> help topic. SetTaxTable Yes GetBidderList Conditionally GetSellerList GetTaxTable

DetailLevel: none, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field is included in a SetTaxTable call and set to <code>true</code> if the seller wants sales tax for the jurisdiction to apply to the cumulative amount of item cost and shipping charges. This value defaults to <code>false</code> if not specified. This field is always returned with each TaxJurisdiction container (whether <code>true</code> or <code>false</code>). Note: As of April 1, 2020, buyers in 40 US states will automatically be charged sales tax for eBay purchases. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. So, if a sales tax rate is applied to the listing by the seller for a state that is subject to eBay 'Collect and Remit', the sales tax rate in this field is ignored by eBay during the checkout process. For a list of US states that are subject to eBay 'Collect and Remit' taxes (and effective dates), see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/taxes-import-charges?id=4121#section4">eBay sales tax collection</a> help topic. GetBidderList Conditionally GetSellerList GetTaxTable

DetailLevel: none, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally False SetTaxTable Yes Full name for the jurisdiction or region for display purposes. GeteBayDetails Conditionally Returns the latest version number for this feature. Use the version to determine if and when to refresh your cached client data. GeteBayDetails Conditionally The time in GMT when the details for this feature were last updated. Use this timestamp to determine if and when to refresh your cached client data. GeteBayDetails Conditionally This type is used to express sales tax details for one or more tax jurisdictions. The concept of 'sales tax' is only applicable to eBay US and Canada (English and French) sites. In a SetTaxTable, a TaxJurisdiction container is required for each tax jurisdiction that the seller wishes to make additions/changes. Sales tax details for zero or more jurisdictions (states, provinces, etc). This can be just one jurisdiction, up to all jurisdictions defined for the site's country. Any values specified through a TaxJurisdiction container will override any existing values defined in the seller's Sales Tax Table. If GetTaxTable is called without the DetailLevel field, only tax jurisdictions where sales tax rates have been set up are returned. However, if the DetailLevel field is included in the request and set to <code>ReturnAll</code>, all tax jurisdictions are returned, regardless of whether or not the seller has modified settings for any/all of these jurisdictions. This container is only returned in order-related 'Get' calls if sales tax is applicable to the order line item. Note: As of April 1, 2020, buyers in 40 US states will automatically be charged sales tax for eBay purchases. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. So, if a sales tax rate is applied to the listing by the seller for a state that is subject to eBay 'Collect and Remit', the sales tax rate in this field is ignored by eBay during the checkout process. For a list of US states that are subject to eBay 'Collect and Remit' taxes (and effective dates), see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/taxes-import-charges?id=4121#section4">eBay sales tax collection</a> help topic. SetTaxTable Yes GetTaxTable

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Enumerated type that lists the types of taxes that may be charged to the buyer for each order line item purchased. This enumeration value indicates that standard sales tax was charged to the buyer against the order line item. This enumeration value indicates that an electronic waste recycling fee was charged to the buyer against the order line item. This enumeration value indicates that a Goods and Services import tax was charged to the buyer against the order line item. This tax type is only applicable for items being sold by Australian or New Zealand sellers. This enumeration value indicates that French VAT tax was charged to the buyer against the order line item. This tax type is only applicable for items sold on the eBay France marketplaces. This enumeration value indicates that European VAT tax was charged to the buyer against the order line item. This enumeration applies to VAT tax on the UK marketplace, the Norway marketplace, and other EU marketplaces (except for France). Reserved for internal or future use. Type defining the Taxes container, which contains detailed tax information (sales tax and VAT) for an order line item. The information in this container supercedes/overrides the sales tax information in the ShippingDetails.SalesTax container. The value returned in this field is the VAT ID for eBay, and this value may vary based on the region or country. The eBayReference field's name attribute will show the type of VAT ID, such as <code>IOSS</code>, <code>OSS</code>, or <code>ABN</code>. This field will be returned if VAT tax is applicable for the order. See the <a href="types/eBayTaxReferenceValue.html">eBayTaxReferenceValue</a> type page for more information on the VAT tax type strings that may appear for the name attribute. Note: For all VAT ID/VATIN values to be returned (except for France), developers will need to use a Trading WSDL with a version number of 1211 (or newer). For French VAT ID/VATIN values to be returned, developers will need to use a Trading WSDL with a version number of 1225 (or newer). Otherwise, the VAT information will be returned in the Order.ShippingAddress.Street2 field. Developers will also have the option of using older version, but setting the X-EBAY-API-COMPATIBILITY-LEVEL header value to 1211 or 1225 or higher. On January 31, 2022, the Order.ShippingAddress.Street2 will stop being used to return VAT information regardless of WSDL version or compatibility level. GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value indicates the total tax amount for the order line item, for all tax types, which may include sales tax (seller-applied or 'eBay Collect and Remit'), 'Goods and Services' tax (for Australian or New Zealand sellers), or other fees like an electronic waste recycling fee. GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Container consisting of detailed sales tax information for an order line item, including the tax type and description, sales tax on the item cost, and sales tax related to shipping and handling. GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Type defining the TicketListingDetails container, which is used in an Add/Revise/Relist call to provide more details about event tickets. The name of the event, as shown on the ticket. Typically the headliner. There is no maximum number of words or characters. However, the words in the name must be an exact match (or a subset consisting of complete words) to the words in the product title in the catalog. The words in the name are matched using OR logic (the order of the words does not matter). As with all strings, you need to escape reserved characters such as ampersand. 1024 Ticket Listings https://developer.ebay.com/Devzone/guides/features-guide/default.html#development/Specialty-Tickets.html AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally The name of the venue, as shown on the ticket. The validation rules are the same as the rules for the event name. In addition, eBay supports both US English and UK English spelling variations for typical words found on tickets (such as "theater" and "theatre"). As with all strings, you need to escape reserved characters such as ampersand. 4000 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally The date of the event, as shown on the ticket. Use the date shown on the ticket, without attempting to adjust it for a different time zone (such as Pacific time or GMT). In most cases, you should be able to specify any numeric date format in month/day/year order. eBay supports m or mm for the month, d or dd for the day, and yy or yyyy for the year, in all combinations. The delimiters must be forward slashes (/). AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally The time of the event, as shown on the ticket. Use the time value shown on the ticket, without attempting to convert it to a different time zone (such as Pacific time or GMT). Do not round the value up or down (e.g., do not round 7:01 PM to 7:00 PM). In most cases, you should be able to specify the time format exactly as shown on the ticket. Ticket Listings https://developer.ebay.com/Devzone/guides/features-guide/default.html#development/Specialty-Tickets.html AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally Enumerated type that consists of the Top-Rated Seller programs that exist around the world. If this enumeration value is returned, it indicates that the eBay user is in the US Top-Rated Seller program. If this enumeration value is returned, it indicates that the eBay user is in the UK Top-Rated Seller program. If this enumeration value is returned, it indicates that the eBay user is in the Germany Top-Rated Seller program. If this enumeration value is returned, it indicates that the eBay user is in the Global Top-Rated Seller program. Reserved for internal or future use. Container for Top-Rated Seller program information. A TopRatedProgram field is returned for each Top-Rated Seller program that the eBay user qualifies for. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally ComingSoon Enumerated type listing the possible roles an eBay user may have in regards to an eBay order. The eBay user is acting as the buyer for the order(s). In GetOrders, this value should be passed into the OrderRole field in the request to retrieve orders in which the calling eBay user is the buyer in the order. The eBay user is acting as the seller for the order(s). In GetOrders, this value should be passed into the OrderRole field in the request to retrieve orders in which the calling eBay user is the seller in the order. This value is reserved for future or internal use. Type defining the TransactionArray container, which contains an array of Transaction containers. Each Transaction container consists of detailed information on one order line item. A Transaction container is returned for each line item in the order. This container consists of detailed information on one order line item. For the AddOrder call, a Transaction container is used to identified the unpaid order line items that are being combined into one Combined Invoice order. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetItemsAwaitingFeedback Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying DeletedFromWonList WonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally AddOrder Yes Note: Currently, the only supported value for this enumeration type is <code>eBay</code>. Half.com listings will no longer be supported in APIs. Specifies the site on which the purchase was made. eBay This value indicates the purchase occurred on an eBay marketplace site. Note: eBay Express no longer exists. The order line item was created on the eBay Express site. Note: Half.com listings will no longer be supported in APIs. The order line item was created on Half.com site. Note: Shopping.com listings are no longer supported in APIs. The order line item was created on the Shopping.com site. Note: World Of Good is no longer associated with eBay. The order line item was created on the WorldOfGood site. Reserved for future use. This type is used by the Program container, which provides details on whether the order line item has passed or failed the authenticity inspection. This container gives status on whether the order line item has passed or failed the authenticity inspection. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container provides details about an order line item being handled by eBay fulfillment. It is only returned for paid orders being fulfilled by eBay or an eBay fulfillment partner. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Enumerated type defining the possible values that can returned in the attribute of the Payment.ReferenceID and Payment.PaymentReferenceID field. MandateReferenceNumber This value is the unique identifier of an external payment transaction. No longer applicable as the eBay Now service is no longer available to buyers and sellers. This value is reserved for future or internal use. Type defining the ReferenceID element, which is used to display the unique identifier of a payment (and payment type through the type attribute. This attribute indicates the type of payment. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Contains the order status, e.g. the buyer's online payment and whether the checkout process for the order is complete. Indicates the status of the buyer's payment for an order. If the payment was successfuly processed, a value of <code>NoPaymentFailure</code> will be returned. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates the current status of the checkout flow for the order. If the payment was successfuly processed, a value of <code>CheckoutComplete</code> will be returned. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates date and time an order's status was last updated (in GMT). GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The payment method that the buyer selected to pay for the order. Note: Sellers no longer have to specify any electronic payment methods at listing time, but this field is still returned. The value returned in this field will generally be <code>CreditCard</code>, unless an eBay gift card was used by the buyer to pay a partial or full balance of the order. If this is the case, the value returned in this field will be <code>CCAccepted</code>. Either of these two values will be returned, but neither accurately reflects the actual payment method that the buyer used. If the order was paid for off of eBay's platform using an 'offline' payment method such as 'CashOnPickup' or 'MOCC' (money order or cashier's check), and the seller marked the order as paid, either of those values may get returned here. OrderReport Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates whether checkout is complete, incomplete, or pending for an order. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates whether the buyer has selected shipping details during checkout. False indicates that the shipping service was selected by eBay for the buyer. For example, if the buyer has not yet completed the Review Your Purchase page, he has not picked a shipping service. If it is false, the application should ignore ShippingServiceCost and ShippingServiceSelected (items whose values are defaulted by eBay). GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field indicates the type and/or status of a payment hold on the item. Note: For the GetItemTransactions, GetOrders, and GetOrderTransactions calls, this field is only returned to the seller of the order; this field is not returned for the buyer or third party. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally This field is no longer applicable as eBay sellers can no longer use iMCC gateway accounts to handle buyer payments. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container is no longer used. This field gives the status of a buyer's Item Not Received (INR) Inquiry. This field is only returned if the buyer has created an INR Inquiry through the site or through the Post-Order API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This field gives the status of a buyer's return request. This field is only returned if the buyer has initiated a return request, or has escalated an existing return request into a return case. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The enumeration value in this field indicates which payment method was used by the German buyer who was offered the 'Pay Upon Invoice' option. This field will only be returned if a German buyer was offered the 'Pay Upon Invoice' option. Otherwise, the buyer's selected payment method is returned in the PaymentMethodUsed field by the GetItemTransactions call. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This enumeration value indicates the current state of a purchased digital gift card. The normal flow is for the buyer (or other recipient of the gift card) to download the gift card from the delivered email after purchase, and then to activate the card for use. This field is only applicable and returned for digital gift card order line items. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The current status for the order cancellation request if it exists. This field is only returned if a cancellation request has been made on an order, or if the order is currently going through the cancellation process, or if the order has already been cancelled. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally Contains information about a sales transaction from an eBay listing. This identifier is automatically created by the eBay system once a buyer has committed to make a purchase in an auction or fixed-price listing. A fixed-priced listing (single or multiple-variation) with multiple quantity can spawn one or more sales transactions. The total amount the buyer paid for the order line item. This amount includes all costs such as item cost, shipping/handling charges, and sales tax that is applied to the order by the seller. If the seller allowed the buyer to change the total for an order, the buyer is able to change the total up until the time when Checkout status is Complete. Determine whether the buyer changed the amount by retrieving the order line item data and comparing the AmountPaid value to what the seller expected. If multiple order line items between the same buyer and seller have been combined into a 'Combined Invoice' order, the AmountPaid value returned for each line item in the order reflects the total amount paid for the entire order, and not for the individual order line item. In a GetItemTransactions or GetSellerTransactions call, you can determine which order line items belong to the same 'Combined Invoice' order by checking to see if the ContainingOrder.OrderID value is the same. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This value indicates the dollar amount by which the buyer has adjusted the the total cost of the sales transaction. Adjustments to sales transaction costs may include shipping and handling, buyer discounts, or added services. A positive amount indicates the amount is an extra charge being paid to the seller by the buyer. A negative value indicates this amount is a credit given to the buyer by the seller. This field is always returned, even if there was no cost adjustment to the sales transaction. Its value will just be '0.0' if there was no cost adjustment. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This field shows the converted value of AdjustmentAmount in the currency of the site that returned the response. Refresh this value every 24 hours to pick up the current conversion rates. This field is always returned, even if there was no cost adjustment to the sales transaction. Its value will just be '0.0' if there was no cost adjustment. This value should be the same as the value in AdjustmentAmount if the eBay listing site and the site that returned the response are the same, or use the same currency. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Container consisting of user and shipping details for the order's buyer. To be returned by GetItemsAwaitingFeedback the seller must be the one making the request. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this container will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, real data is only returned to the buyer or seller, and dummy/masked data will be returned to all third parties. GetItemsAwaitingFeedback Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Container consisting of shipping-related details for a sales transaction. Shipping details may include shipping rates, package dimensions, handling costs, excluded shipping locations (if specified), shipping service options, sales tax information (if applicable), and shipment tracking details (if shipped). Note: For GetOrders and GetOrderTransactions, a ShippingDetails container is returned at the order at line item level. GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field shows the converted value of AmountPaid in the currency of the site that returned the response. Refresh this value every 24 hours to pick up the current conversion rates. This field is always returned for paid orders. This value should be the same as the value in AmountPaid if the eBay listing site and the site that returned the response are the same, or use the same currency. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field shows the converted value of TransactionPrice in the currency of the site that returned the response. Refresh this value every 24 hours to pick up the current conversion rates. This field is always returned for sales transactions. This value should be the same as the value in TransactionPrice if the eBay listing site and the site that returned the response are the same, or use the same currency. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally This timestamp indicates date/time when the sales transaction occurred. A sales transaction is created when there is a commitment to buy, or when the buyer purchases the item through a 'Buy it Now' option. For auction listings, a sales transaction is created when that listing ends with a high bidder whose bid meets or exceeds the Reserve Price (if set). For a fixed-price listing or a 'Buy It Now' auction listing, a sales transaction is created once the buyer clicks the Buy button. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally This value indicates whether or not the seller requires a deposit for the purchase of a motor vehicle. This field is only applicable to motor vehicle listings that require an initial deposit. A value of 'OtherMethod' will be returned if the motor vehicle listing requires an initial deposit, or a value of 'None' if an initial deposit is not required. Specifying a Vehicle Deposit and Deposit Amount https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Sites-eBayMotors.html#SpecifyingaVehicleDepositandDepositAmoun GetItemTransactions GetSellerTransactions None, OtherMethod

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions None, OtherMethod

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container consists of relevant details about the listing associated with the sales transaction. Which listing fields are returned under this container will depend on the listing, the eBay marketplace, and the API call. In an AddOrder call, only the unique identifier of the listing (ItemID) is needed to help identify the sales transaction to combine into a 'Combined Invoice' order. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetItemsAwaitingFeedback GetMyeBaySelling Conditionally AddOrder Yes GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This value indicates the quantity of the line item purchased at the same time by the same buyer from one listing. For auction listings, this value is always '1'. For fixed-price, non-variation listings, this value can be greater than 1. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Container consisting of checkout/payment status details for an order line item. Several of these fields change values during the checkout flow. For GetOrders, only a limited number of applicable fields are returned at the order line item level. The fields indicating the status of the order are actually found in the OrderArray.Order.CheckoutStatus container. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally Unique identifier for an eBay sales transaction. This identifier is created once there is a commitment from a buyer to purchase an item, or if/when the buyer actually purchases the line item through a 'Buy it Now' option. An ItemID/TransactionID pair can be used and referenced during an order checkout flow to identify a line item. The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer and seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, transaction ID is only returned to the buyer and seller, and a dummy value of <code>10000000000000</code> will be returned to all third parties. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetItemsAwaitingFeedback Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always AddOrder Yes The sale price for one unit of the line item. This price does not include any other costs like shipping charges or sales tax, and its value will remain the same before and after payment. If multiple units were purchased through a single-variation, fixed-price listing, to get the subtotal of the units purchased, the TransactionPrice value would have to be multiplied by the Transaction.QuantityPurchased value. For a motor vehicle listing that required a deposit/down payment, the amount in the TransactionPrice is actually the deposit amount. For GetMyeBaySelling: this field is only returned if the transaction came as a result of a buyer's Best Offer accepted by the seller. Otherwise, the Transaction.TotalPrice field should be viewed instead. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetMyeBaySelling

DetailLevel: ReturnAll

SoldList, DeletedFromSoldList Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always Indicates whether or not the sales transaction resulted from the seller accepting a Best Offer (or Counter Offer) from a buyer. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always VAT rate for the line item. When the VATPercent is specified, the item's VAT information appears on the item's listing page. In addition, the seller can choose to print an invoice that includes the item's net price, VAT percent, VAT amount, and total price. Since VAT rates vary depending on the item and on the user's country of residence, a seller is responsible for entering the correct VAT rate; it is not calculated by eBay. To specify a VATPercent, a seller must have a VAT-ID registered with eBay and must be listing the item on a VAT-enabled site. Max precision 3 decimal places. Max length 5 characters. Note: The View Item page displays the precision to 2 decimal places with no trailing zeros. However, the full value you send in is stored. Container consisting of payment details for an eBay sales transaction, including an identifier for the monetary transaction and a field to express any fees or credits applied to the monetary transaction. This field is only returned after payment for the order has occurred. For GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the real transaction identifier is only returned to the buyer or seller, and a string value of <code>Unavailable</code> will be returned to all third parties. Note: The MonetaryDetails container also shows payment information for the order. In the future, it is possible that the ExternalTransaction container will be deprecated, so you are encouraged to start using MonetaryDetails as soon as possible. GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetOrders

DetailLevel: ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally This container consists of Selling Manager product details and is only returned if the item was listed through Selling Manager Pro. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The shipping service actually selected by the buyer from the shipping services offered by the seller. The buyer typically selects the shipping service at checkout/payment time. GetItemTransactions GetSellerTransactions GetOrderTransactions GetOrders

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally OrderReport Conditionally Display message from buyer. This field holds transient data that is only being returned in Checkout-related notifications. Working with Platform Notifications https://developer.ebay.com/DevZone/guides/features-guide/default.html#Notifications/Notifications.html This field is deprecated. Specifies the paid status of the order. GetMyeBayBuying

DetailLevel: none, ReturnAll

WonList DeletedFromWonList Conditionally Specifies the paid status of the order. GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally Indicates the time when the buyer paid for the order and/or order was marked as 'Paid' by the seller. This field is returned once payment has been made by the buyer. This value will only be visible to the user on either side of the order. An order can be marked as 'Paid' in the following ways: <ul> <li>Automatically when a payment is made through eBay's system</li> <li>Seller marks the item as paid in My eBay or through Selling Manager Pro </li> <li>Programmatically by the seller through the CompleteSale call.</li> </ul> GetItemTransactions GetSellerTransactions GetOrders GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally OrderReport Conditionally GetMyeBayBuying

DetailLevel: none, ReturnAll

WonList DeletedFromWonList Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally Indicates the time when the line item was marked as 'Shipped'. This value will only be visible to the user on either side of the order. An order can be marked as 'Shipped' by purchasing an eBay shipping label, providing shipment tracking in My eBay or through Selling Manager Pro, or programmatically by the seller through the CompleteSale call. Note: This field does not appear in Merchant Data API's OrderReport responses, because once shipment tracking information is provided to the buyer (or marked as shipped), the order/order line item is considered acknowledged, and acknowledged orders do not show up in OrderReport responses. GetOrders

DetailLevel: none, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying

DetailLevel: none, ReturnAll

WonList DeletedFromWonList Conditionally This field indicates the total price for a sales transaction. Before payment, this dollar value will be the price before a shipping service option is selected. Once a shipping service option is selected, the price in this field will be updated to reflect the shipping and handling costs associated with that shipping service option. GetMyeBayBuying

DetailLevel: none, ReturnAll

WonList DeletedFromWonList Conditionally GetMyeBaySelling

DetailLevel: none, ReturnAll

SoldList DeletedFromSoldList Conditionally This container consists of Feedback left by the caller for their order partner. This container is only returned if the order is complete and feedback on the order line item has been left by the caller. GetMyeBayBuying DeletedFromWonList WonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling DeletedFromSoldList SoldList

DetailLevel: none, ReturnAll

Conditionally This container consists of Feedback received by the caller from their order partner. This container is only returned if the order is complete and feedback on the order line item has been received by the caller. GetItemsAwaitingFeedback Conditionally GetMyeBayBuying DeletedFromWonList WonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling DeletedFromSoldList SoldList

DetailLevel: none, ReturnAll

Conditionally This container is returned in a GetItemTransactions or GetSellerTransactions response if the IncludeContainingOrder field is included in the call request payload and set to 'true'. This container will be returned whether the order line item is the only line item in the order, or if the order has multiple line items. Note: The new OrderLineItemCount field is automatically returned if the user is using Version 1113 of the Trading WSDL (or newer, as versions roll out). If the user is using Versions 1107 or 1111 of the Trading WSDL, the OrderLineItemCount field will only be returned if the user includes the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header and sets its value to <code>1113</code>. If a user is using a Trading WSDL older than 1107, the OrderLineItemCount field will not be returned. GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally A Final Value Fee is calculated and charged to a seller's account immediately upon creation of an order line item. Note that this fee is created before the buyer makes a payment. As long as the IncludeFinalValueFee field is included in the call request and set to 'true', the Final Value Fee for each order line item is returned, regardless of the checkout status. If a seller requests a Final Value Fee credit, the value of Transaction.FinalValueFee will not change if a credit is issued. The credit only appears in the seller's account data. GetOrderTransactions GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field is no longer applicable Note: This container is only applicable for Half.com order refunds, and since the Half.com site has been shut down, this field is no longer applicable. 1027 NoOp 1033 The site upon which the line item was purchased. GetItemTransactions GetOrderTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally This value indicates the site on which the sales transaction originated. Note: Currently, the only value that should be returned in this field is <code>eBay</code>, as the Half.com marketplace no longer exists. GetItemTransactions GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always CustomCode, eBay GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally CustomCode, eBay GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally CustomCode, eBay This field is no longer applicable as Shopping.com listings are no longer created or managed with eBay APIs. This field is no longer applicable as Shopping.com listings are no longer created or managed with eBay APIs. This field is deprecated. GetItemTransactions GetOrderTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field is deprecated. GetMyeBayBuying GetMyeBaySelling No Conditionally The Buyer Guarantee price. This field is only applicable to the Australian site. GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally In a fixed-priced listing, a seller can offer variations of the same item. For example, the seller could create a fixed-priced listing for a t-shirt design, and offer the shirt in different colors and sizes. In this case, each color and size combination is a separate variation. Each variation can have a different quantity and price. Due to the possible price differentiation, buyers can buy multiple items from this listing at the same time, but all of the items must be of the same variation. One order line item is created whether one or multiple quanity of the same variation are purchased. The Variation node contains information about which variation was purchased. Therefore, applications that process orders should always check to see if this node is present. GetItemTransactions GetSellerTransactions GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field is returned if a buyer left a comment for the seller during the left by buyer during the checkout flow. For GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, real data is only returned to the buyer or seller, and a string value of <code>Unavailable</code> will be returned to all third parties. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The sale price of the order line item. This amount does not take into account shipping and handling charges, sales tax, or any other costs related to the order line item. If multiple units were purchased through a non- variation, fixed-price listing, this value will reflect that. So, if the base cost of the order line item was $15.00, and a quantity of two were purchased (Transaction.QuantityPurchased) the value in this field would show as <code>30.00</code>. To see the full price of the order line item, including any shipping and handling charges, and any sales tax, the (Transaction.TotalPrice) field value should be viewed instead. However, note that the TotalPrice field value is only updated after a shipping service option is selected and payment is made. And if the seller is offering free shipping, the values in the TotalTransactionPrice and the TotalPrice fields may be the same. GetMyeBaySelling DeletedFromSoldList SoldList

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally A container consisting of detailed tax information (sales tax, Goods and Services tax, or VAT) for a sales transaction. The Taxes container is returned if the order line item is subject to any taxes on the buyer's purchase. The information in this container supercedes/overrides any sales tax information in the ShippingDetails.SalesTax container. GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Boolean value indicating whether or not an order line item is part of a bundle purchase using Product Configurator. GetItemTransactions GetOrderTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

OrderReport Conditionally The shipping cost paid by the buyer for the order line item. This field is only returned after checkout is complete. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The handling cost that the seller has charged for the order line item. This field is only returned after checkout is complete. The value of this field is returned as zero dollars (0.0) if the seller did not specify a handling cost for the listing. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally A unique identifier for an eBay order line item. This identifier is created as soon as there is a commitment to buy from the seller, or the buyer actually purchases the item using a 'Buy it Now' option. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, order line item ID is only returned to the buyer or seller, and a dummy value of <code>10000000000000</code> will be returned to all third parties. GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Always GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetItemsAwaitingFeedback Conditionally GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions Always The generated eBay payment ID used by the buyer when he/she chooses electronic transfer as payment method for paying the seller. This field is only applicable to the eBay Germany site (Site ID 77). GetSellerTransactions

DetailLevel: none

Conditionally GetOrderTransactions

DetailLevel: none

Conditionally This container consists of information related to the payment hold on the order line item, including the reason why the buyer's payment for the order line item is being held, the expected release date of the funds into the seller's account, and possible action(s) the seller can take to expedite the payout of funds into their account. This container is only returned if a payment hold has been placed on the order line item. See PaymentHoldReasonCodeType for some details on why/when a seller's funds may be held, or visit the <a href="https://www.ebay.com/help/selling/getting-paid/getting-paid-items-youve-sold/pending-payments?id=4816">Pending payments</a> help topic for more information on eBay's payment hold policies. GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally A container consisting of name and ID of the seller's discount campaign, as well as the discount amount that is being applied to the order line item. This container is only returned if the order line item is eligible for seller discounts. GetItemTransactions GetOrders GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field is deprecated. This field is deprecated. This field is returned if the IncludeCodiceFiscale flag is included in the request and set to <code>true</code>, and if the buyer has provided this value at checkout time. This field is only applicable to buyers on the Italy and Spain sites. The Codice Fiscale number is unique for each Italian and Spanish citizen and is used for tax purposes. GetSellerTransactions Conditionally If IsMultilegShipping is <code>true</code>, the order line item will not be shipped directly to the buyer. Instead, the item may be shipped to eBay's Global Shipping Program (GSP) partner who will handle the international leg of shipment, or the item may be shipped to eBay's Authenticity Guarantee service partner if the item is subject to the Authenticity Guarantee service program. In both cases, the partner's shipping address can be found in the MultiLegShippingDetails.SellerShipmentToLogisticsProvider.ShipToAddress container. If an order line item is subject to the Authenticity Guarantee service, the Transaction.Program container will be returned. GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetMyeBaySelling

DetailLevel: none, ItemReturnDescription, ReturnAll

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This field indicates the date/time that an order invoice was sent from the seller to the buyer. This field is only returned if an invoice (containing the order line item) was sent to the buyer. GetOrderTransactions GetOrders GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally OrderReport Conditionally Container consisting of details related to the type and status of an Unpaid Item case. This container is only returned if there is an open (or recently closed) Unpaid Item case associated with the order line item. GetOrderTransactions GetOrders GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally OrderReport Conditionally This flag indicates whether or not the order line item is an intangible good, such as an MP3 track or a mobile phone ringtone. GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always Contains information about each monetary transaction that occurs for the order line item, including order payment, any refund, a credit, etc. Both the payer and payee are shown in this container. Note: MonetaryDetails can already be used instead of the older ExternalTransaction container, and the ExternalTransaction container may eventually get deprecated. Due to this possibility, you are encouraged to start using MonetaryDetails as soon as it is convenient. GetOrders

DetailLevel:ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel:ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel:ReturnAll

Conditionally Container consisting of an array of PickupOptions containers. Each PickupOptions container consists of the pickup method and its priority. The priority of each pickup method controls the order (relative to other pickup methods) in which the corresponding pickup method will appear in the View Item and Checkout page. This container is always returned prior to order payment if the seller created/revised/relisted the item with the EligibleForPickupInStore and/or EligibleForPickupDropOff flag in the call request set to 'true'. If and when the In-Store pickup method (US only) or 'Click and Collect' pickup method (UK and Australia only) is selected by the buyer and payment for the order is made, this container will no longer be returned in the response, and will essentially be replaced by the PickupMethodSelected container. Note: A seller must be eligible for the In-Store Pickup feature or Click and Collect feature to list an item that is eligible for In-Store Pickup or Click and Collect. At this time, the In-Store Pickup and Click and Collect features are generally only available to large retail merchants, and can only be applied to multiple-quantity, fixed-price listings. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally This container consists of details related to the selected In-Store pickup method, including the pickup method, the merchant's store ID, the status of the In-Store pickup, and the pickup reference code (if provided by merchant). GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Note: This field is no longer applicable/used. It was previously used for eBay Now and 'eBay On Demand Delivery' orders - two features that have been deprecated. 1095 1095 NoOp This field will be returned at the order line item level only if the buyer purchased a digital gift card, which is delivered by email, or if the buyer purchased an item that is enabled with the 'Click and Collect' feature. Currently, LogisticsPlanType has two applicable values: <code>PickUpDropOff</code>, which indicates that the buyer selected the 'Click and Collect' option. With Click and Collect, buyers are able to purchase from thousands of sellers on the eBay UK and Australia sites, and then pick up their order from the nearest 'eBay Collection Point', including over 750 Argos stores in the UK. The Click and Collect feature is only available on the eBay UK and Australia sites; or, <code>DigitalDelivery</code>, which indicates that the order line item is a digital gift card that will be delivered to the buyer or recipient of the gift card by email. LogisticsPlanCodeType GetOrders

DetailLevel:none,ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel:none,ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel:none,ReturnAll

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The unique identifier of the inventory reservation. GetOrders

DetailLevel:none,ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel:none,ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel:none,ReturnAll

Conditionally A unique identifier for an eBay order in the new eBay REST API model. ExtendedOrderID values will be used to identify orders in REST-based APIs, including the Post-Order API and the Fulfillment API. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the correct Order ID is returned to the buyer or seller, but a dummy Order ID value of <code>1000000000000</code> will be returned to all third parties. Note: As of June 2019, eBay has changed the format of order identifier values, and this new format is relevant to both legacy and REST API-based order ID fields. The new format is a non-parsable string, globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. Unlike in the past, instead of just being known and exposed to the seller, these unique order identifiers will also be known and used/referenced by the buyer and eBay customer support. Please note that the identifier for an order (for OrderID and ExtendedOrderID) will change as it goes from unpaid to paid status. Sellers can check to see if an order has been paid by looking for a value of 'Complete' in the CheckoutStatus.Status field in the response of GetOrders or GetOrderTransactions call, or in the Status.CompleteStatus field in the response of GetItemTransactions or GetSellerTransactions call. Both the paid and unpaid Order IDs will be accepted in all Trading API call request payloads. 40 GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally If <code>true</code>, the buyer of the order line item has a eBay Plus program subscription, and is eligible to receive the benefits of this program, such as fast, free shipping and free returns. Top-Rated eBay sellers must opt in to eBay Plus to be able offer the program on qualifying listings. Sellers must commit to next-day delivery of those items. Note: Currently, eBay Plus is available only to buyers in Germany and Australia. more details Offering eBay Plus ../../../../guides/features-guide/default.html#development/Feature-eBayPlus.html GetOrders GetOrderTransactions GetItemTransactions GetSellerTransactions Conditionally OrderReport Conditionally This container is returned in GetOrders and other order management calls if a buyer has purchased a digital gift card but has sent it to another individual as a gift, and has left a message for the recipient. The GiftSummary container consists of the message that the buyer wrote for the recipient of the digital gift card. A digital gift card line item is indicated if the DigitalDeliverySelected container is returned in the response, and if the digital gift card is sent to another individual as a gift, the Gift boolean field will be returned with a value of <code>true</code>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container is only returned by GetOrders and other order management calls if the buyer purchased a digital gift card for themselves, or is giving the digital gift card to someone else as a gift (in this case, the Gift boolean field will be returned with a value of <code>true</code>). The DigitalDeliverySelected container consists of information related to the digital gift card order line item, including the delivery method, delivery status, and recipient of the gift card (either the buyer, or another individual that is receiving the gift card as a gift from the buyer. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This boolean field is returned as <code>true</code> if the seller is giving a digital gift card to another individual as a gift. This field is only applicable for digital gift card order line items. GetOrders GetOrderTransactions GetItemTransactions GetSellerTransactions Conditionally OrderReport Conditionally Note: This field is for future use, as the eBay Guaranteed Shipping feature has been put on hold. eBay Guaranteed Shipping should not be confused with eBay Guaranteed Delivery, which is a completely different feature. This field is returned as <code>true</code> if the seller chose to use eBay's Guaranteed Shipping feature at listing time. With eBay's Guaranteed Shipping, the seller will never pay more for shipping than what is charged to the buyer. eBay recommends the shipping service option for the seller to use based on the dimensions and weight of the shipping package. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field is returned as <code>true</code> if the order line item is qualified for eBay Guaranteed Delivery, or <code>false</code> if it is not eligible. At this time, eBay Guaranteed Delivery is only available to a select number of sellers on the US and Australia sites, but this feature will be enabled on more eBay sites in 2019. Only domestic shipments are available for eBay Guaranteed Delivery. For an order line item to be qualified for eBay Guaranteed Delivery, the following must be true: <ul> <li>The eBay Guaranteed Delivery feature must be available to the seller</li> <li>That seller must be opted in to one of the two eBay Guaranteed Delivery programs</li> <li>If the seller is opted into the "Door-to-Door" program, a domestic shipping rate table must be applied to the listing, and that shipping rate table must include the buyer's location with a transit time (handling + shipping time) of 3 business days or less; </li> <li>If the seller is opted into the "Handling Time" program, the handling time plus the max shipping time must equal 3 business days or less, and that shipping rate table must include the buyer's location with a transit time (handling + shipping time) of 3 business days or less</li> <li>The listing must have a return policy</li> </ul> With eBay Guaranteed Delivery, the sellers are committed to getting the order line item to the buyer within 3 business days. The seller's defined "Order Cutoff" time will control what is considered 3 business days. If a buyer wanted to get an order by Friday, that buyer would have to purchase that item on Monday before the seller's "Order Cutoff" time. The seller's "Order Cutoff" time is generally set in their timezone, so the buyer should take this into account before the purchase. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetOrderTransactions

DetailLevel: none, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This boolean field is returned as <code>true</code> if the line item is subject to a tax (US sales tax or Australian Goods and Services tax) that eBay will collect and remit to the proper taxing authority on the buyer's behalf. This field is also returned if <code>false</code> (not subject to eBay Collect and Remit). An eBayCollectAndRemitTaxes container is returned if the order line item is subject to such a tax, and the type and amount of this tax is displayed in the eBayCollectAndRemitTaxes.TaxDetails container. Australian 'Goods and Services' tax (GST) is automatically charged to buyers outside of Australia when they purchase items on the eBay Australia site. Sellers on the Australia site do not have to take any extra steps to enable the collection of GST, as this tax is collected by eBay and remitted to the Australian government. For more information about Australian GST, see the <a href="https://www.ebay.com.au/help/selling/fees-credits-invoices/taxes-import-charges?id=4121">Taxes and import charges</a> help topic. As of November 2021, buyers in all US states except for Missouri (and several US territories), will automatically be charged sales tax for purchases, and the seller does not set this rate. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. For more US state-level information on sales tax, see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/taxes-import-charges?id=4121#section4">eBay sales tax collection</a> help topic. GetItemTransactions GetOrders OrderReport GetOrderTransactions GetSellerTransactions Conditionally This container is returned if the order line item is subject to a tax (US sales tax or Australian Goods and Services tax) that eBay will collect and remit to the proper taxing authority on the buyer's behalf. The type of tax will be shown in the TaxDetails.Imposition and TaxDetails.TaxDescription fields, and the amount of this tax will be displayed in the TaxDetails.TaxAmount field. Australian 'Goods and Services' tax (GST) is automatically charged to buyers outside of Australia when they purchase items on the eBay Australia site. Sellers on the Australia site do not have to take any extra steps to enable the collection of GST, as this tax is collected by eBay and remitted to the Australian government. For more information about Australian GST, see the <a href="https://www.ebay.com.au/help/selling/fees-credits-invoices/taxes-import-charges?id=4121">Taxes and import charges</a> help topic. As of November 2021, buyers in all US states except for Missouri (and several US territories), will automatically be charged sales tax for purchases, and the seller does not set this rate. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. For more US state-level information on sales tax, see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/taxes-import-charges?id=4121#section4">eBay sales tax collection</a> help topic. GetItemTransactions GetOrders OrderReport GetOrderTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This container gives the status of an order line item going through the Authenticity Guarantee service process. In the Authenticity Guarantee service program, a third-party authenticator must verify the authenticity of the item before it can be sent to the buyer. This container is only returned for order line items subject to the Authenticity Guarantee service process, and if it is returned, the seller must make sure to send the item to the third-party authenticator's address (shown in the MultiLegShippingDetails.SellerShipmentToLogisticsProvider.ShipToAddress field), and not to the buyer's shipping address. If the item is successfully authenticated, the authenticator will ship the item to the buyer. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Designation of size, weight, volume or count to be used to specify the unit quantity of the item. This value can be one of the following: <pre> Kg 100g 10g L 100ml 10ml M M2 M3 Unit </pre> With GetItem, this field is returned only when you provide IncludeItemSpecifics in the request and set it to <code>true</code>. GetItem GetItems Conditionally Number of units of size, weight, volume or count of the specified unit type for the item. eBay divides the item price by this number to get the price per unit to be displayed in the item listing for comparison purposes. With GetItem, this field is returned only when you provide IncludeItemSpecifics in the request and set it to <code>true</code>. GetItem GetItems Conditionally Enumeration type that indicates the method used to open an Unpaid Item case. This value indicates that the Unpaid Item case was opened automatically through eBay's Unpaid Item Assistant feature. This value indicates that the seller opened an Unpaid Item case manually through the Resolution Center or by using the Trading API's AddDispute call. This value is reserved for future or internal use. Enumeration type that indicates the current status of an Unpaid Item case. This value indicates that the Unpaid Item case is open. This value indicates that the Unpaid Item case is closed with payment received from the buyer. This value indicates that the Unpaid Item case is closed with no payment received from the buyer. This value is reserved for future or internal use. Type defining the UnpaidItem container, which consists of details related to the type and status of an Unpaid Item case. This field indicates the status of the Unpaid Item case. This field is always returned with the UnpaidItem container. GetOrderTransactions GetOrders GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally OrderReport Conditionally This field indicates if the Unpaid Item case was opened manually by the customer or opened automatically by eBay's Unpaid Item Assistant feature. This field is always returned with the UnpaidItem container. GetOrderTransactions GetOrders GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally OrderReport Conditionally http://pages.ebay.com/help/sell/unpaid-item-assistant.html Using Unpaid Item Assistant more information about managing the Unpaid Item Assistant feature This type is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This is a string wrapper for the eBay ID that uniquely identifies a user. This is used by several other types to identify a specific eBay user, such as DisputeType.xsd, FeedbackInfoType.xsd, GetAllBidders, OrderType, and so on. For GetAllBidders, some bidder information is anonymous, to protect bidders from fraud. If the seller makes this API call, the actual IDs of all bidders on the seller's item will be returned. If a bidder makes this API call, the bidder's actual ID will be returned, but information for all competing bidders or outside watchers will be returned as anonymized userIDs. Enumerated type this is used to indicate the type of user that initiated a monetary transaction. This enumeration value indicates that an eBay user initiated the monetary transaction. This enumeration value indicates that an eBay partner (such as Pitney Bowes) initiated the monetary transaction. This value is reserved for future use. Based on the context of the field, this type defines the user is sending or receiving a payment. This attribute indicates if the payer or payee is an eBay user or an eBay partner. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally These codes indicate the current state or status of an eBay user account. UnconfirmedPassport, CreditCardVerifyPassport, UnconfirmedExpress, CreditCardVerifyHalfOptIn, UnconfirmedHalfOptIn This value indicates that the status of the user's eBay account is unknown. This value should seldom, if ever, be returned and typically represents a problem. This value indicates that the eBay user's account is suspended. A user with a suspended account cannot participate in buying or selling activity. This value indicates that the eBay user's account is a confirmed, active account. This value indicates that the eBay User has completed online registration, but has either not responded to confirmation email or has not yet been sent the confirmation email. Or, if this user began registration as a seller but did not complete it, the user will have this status. A seller with this status can begin to list an item but cannot complete the listing until the seller completes seller registration. This value indicates that the user originally registered on AuctionWeb (pre-eBay), but that user never re-registered on eBay. Note that there are very few (if any) eBay accounts in the 'Ghost' state. This value indicates that the eBay user's account is in maintenance mode. This value indicates that the eBay user's account has been deleted. This value indicates that the user has completed the registration and confirmation process, but needs to complete verification of credit card information. A user has this status if this user began registration as a seller but did not complete it. A seller with this status can begin to list an item but cannot complete the listing until the seller completes seller registration. This value indicates that the eBay user's account is currently on hold. A common reason for a user's account to go on hold is a non-payment of the monthly eBay invoice. A user cannot sell or buy items if their account is on hold. This value indicates that the user record has been merged with another account record for the same user This value indicates that the eBay User has completed online registration, and eBay has just sent the user a registration code in a confirmation email. The eBay user will have to respond to the confirmation email to get their account confirmed. This value indicates that the user has scheduled an account closure but eBay has yet to process the closure request. Note: The Half.com site has been shut down, so this value is no longer applicable. User has completed the registration for Half.com and opted to automatically also be registered with eBay, but the registration confirmation is still pending Note: The Half.com site has been shut down, so this value is no longer applicable. User has completed the registration for Half.com and opted to automatically also be registered with eBay, but the user needs to complete verification of credit card information. A user has this status on eBay if this user began registration as a seller but did not complete it. A seller with this status can begin to list an item but cannot complete the listing until the seller completes seller registration. This value is no longer applicable. This value is no longer applicable. This value is no longer applicable. This value indicates that the user is a guest user. The user has not added a password and has not confirmed an email address. The user has not signed up as a regular user, but has agreed to the User Agreement and Privacy Policy. The user has been through the buying flow for a guest; the user has been through checkout using the streamlined Buy-It-Now flow. Reserved for internal or future use Type to contain the data for one eBay user. Depending on the context, the user might be the seller or the buyer on either side of an order, or the bidder or winning bidder in a listing. An object of this type is returned by a number of calls, including the GetUser call. If <code>true</code>, indicates that the user has set up an About Me page. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer GetAllBidders GetBidderList Always Unique identifier for the user that does not change when the eBay user name is changed. Use when an application needs to associate a new eBay user name with the corresponding eBay user. https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-UserInformation.html#WorkingwithAnonymousUserInformation Working with Anonymous User Information GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally Email address for the user. Please see the links below to the topics related to anonymous user information and static email addresses. You cannot retrieve an email address for any user with whom you do not have an order relationship, regardless of site. An email address of another user is only returned if you and the other user are in an order relationship, within a certain time of order line item creation (although this limitation isn't applicable to the GetAllBidders call in the case of motor vehicles categories.) Based on Trust and Safety policies, the time is unspecified and can vary by site. Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. For the GetOrders call, the buyer's email address will be returned (to the seller only) for orders less than two weeks old, but for orders that occurred more than two weeks in the past, the buyer's email address will no longer be returned. This Email field will still be returned, but 'dummy data', such as <code>Invalid Request</code> will replace the actual email address. Note: For the GetItemTransactions call, this field is only returned to the seller of the order; this field is not returned for the buyer or third party. 64 for US. May differ for other countries. Note: The eBay database allocates up to 128 characters for this field https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-UserInformation.html#WorkingwithAnonymousUserInformation Working with Anonymous User Information https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-Communications.html#StaticEmailAddressesinTradingAPICalls Static Email Addresses in Trading API Calls GetAllBidders GetBidderList Conditionally GetBestOffers

DetailLevel: none, ReturnAll

Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetSellerList Seller

DetailLevel: ReturnAll

Conditionally GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer GetSellerEvents

DetailLevel: ReturnAll

Conditionally The aggregate feedback score for a user. A user's feedback score is the net positive feedback minus the net negative feedback left for the user. Feedback scores are a quantitative expression of the desirability of dealing with a user as a buyer or a seller in either side of an order. Each order line item can result in one feedback entry for a given user (the buyer can leave feedback for the seller, and the seller can leave feedback for the buyer.). That one feedback can be positive, negative, or neutral. The aggregated feedback counts for a particular user represent that user's overall feedback score (referred to as a "feedback rating" on the eBay site). If the user has chosen to make their feedback private and that user is not the user identified in the request's authentication token, FeedbackScore is not returned and FeedbackPrivate is returned with a value of <code>true</code>. In GetMyeBayBuying and GetMyeBaySelling, feedback information (FeedbackScore and FeedbackRatingStar) is returned in BidList.ItemArray.Item.Seller. For GetMyeBayBuying, the feedback score of each seller with an item having received a bid from the buyer is returned. For GetMyeBaySelling, the feedback score of the seller is returned. GetMyeBayBuying and GetMyeBaySelling also return feedback information (FeedbackScore and FeedbackRatingStar) in BidList.ItemArray.Item.SellingStatus.HighBidder. GetMyeBayBuying returns feedback information on the high bidder of each item the buyer is bidding on. GetMyeBaySelling returns feedback information on the high bidder of each item the seller is selling. Since a bidder's user info is anonymous, the real feedback score will be returned only to that bidder, and to the seller of an item that the user is bidding on. For all other users, the value -99 is returned. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the accurate Feedback Score for the user is returned to the buyer or seller, but a dummy value of <code>0</code> will be returned to all third parties. https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-UserInformation.html#WorkingwithAnonymousUserInformation Working with Anonymous User Information GetAllBidders Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList Always GetBestOffers

DetailLevel: none, ReturnAll

Always GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetSellerEvents

DetailLevel: ReturnAll

Conditionally GetMyeBayBuying GetMyeBaySelling BidList WatchList BestOfferList LostList DeletedFromLostList ActiveList

DetailLevel: none, ReturnAll

Conditionally Total count of negative Feedback entries received by the user, including weekly repeats. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Total count of positive Feedback entries received by the user, including weekly repeats. This contains the aggregate feedback score for a user. A member's feedback score is the net positive feedback minus the net negative feedback left for the member. Feedback scores are a quantitative expression of the desirability of dealing with that person as a Buyer or a Seller on either side of an order. Each order line item can result in one feedback entry for a given user (the buyer can leave feedback for the seller, and the seller can leave feedback for the buyer). Feedback can be positive, negative, or neutral. The aggregated feedback counts for a particular user represent that user's overall feedback score (referred to as a "feedback rating" on the eBay site). This rating is commonly expressed as the eBay Feedback score for the user. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Percent of total feedback that is positive. For example, if the member has 50 feedbacks, where 49 are positive and 1 is neutral or negative, the positive feedback percent could be 98.0. The value uses a max precision of 4 and a scale of 1. If the user has feedback, this value can be returned regardless of whether the member has chosen to make their feedback private. Not returned if the user has no feedback. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the accurate Positive Feedback Percentage value for the user is returned to the buyer or seller, but a dummy value of <code>0.0</code> will be returned to all third parties. GetAllBidders

DetailLevel: ReturnAll

Conditionally GetItem Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Indicates whether the user has chosen to make their feedback score and feedback details private (hidden from other users). The percentage of positive feedback can still be returned, even if other feedback details are private. Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-UserInformation.html#WorkingwithAnonymousUserInformation Working with Anonymous User Information GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetAllBidders GetBidderList Always GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer Visual indicator of user's feedback score. See FeedbackRatingStarCodeType for specific values. For GetOrders, GetOrderTransactions, and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the accurate Feedback Rating Star value for the user is returned to the buyer or seller, but a dummy value of <code>None</code> will be returned to all third parties. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetAllBidders GetBidderList Always GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer GetMyeBayBuying GetMyeBaySelling BidList WatchList BestOfferList LostList DeletedFromLostList ActiveList

DetailLevel: none, ReturnAll

Conditionally Indicates whether the user has been verified. For more information about the ID Verify program, see: <a href="http://pages.ebay.com/help/policies/identity-idverify.html">Protecting your account</a> GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetAllBidders GetBidderList Always GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer If <code>true</code>, indicates that the user is in good standing with eBay. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetAllBidders GetBidderList Always GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer If <code>true</code>, identifies a new user who has been a registered eBay user for 30 days or less. This is always <code>false</code> after the user has been registered for more than 30 days. Does not indicate an ID change (see UserIdChanged). GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetAllBidders GetBidderList Always GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer This container consists of the Registration address for the eBay user making the call. GetUser: eBay returns complete RegistrationAddress details (including Phone), as applicable to the registration site for the eBay user making the call. GetItem and GetSellerTransactions: RegistrationAddress for another user (except for Phone) is only returned if you have an order relationship with that user AND that user is registered on DE/AT/CH, regardless of your registration site and the site to which you send the request. For example, the seller can see the buyer's registration address if the buyer is registered on DE/AT/CH, or the buyer can see the seller's registration address if the seller is registered on DE/AT/CH. (The buyer and seller won't see their own registration addresses in GetItem.) GetUser

DetailLevel: ReturnAll

Conditionally GetItem Conditionally Seller HighBidder

DetailLevel: ReturnAll

GetSellerTransactions

DetailLevel: ReturnAll, none

Conditionally Indicates the date the specified user originally registered with eBay. Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-UserInformation.html#WorkingwithAnonymousUserInformation Working with Anonymous User Information GetBestOffers

DetailLevel: none, ReturnAll

Always GetAllBidders GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer eBay site the user is registered with. Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-UserInformation.html#WorkingwithAnonymousUserInformation Working with Anonymous User Information GetAllBidders GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer Indicates the user's registration/user status. GetAllBidders GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItem HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions Seller

DetailLevel: none, ReturnAll

Always GetItemTransactions GetSellerTransactions Buyer

DetailLevel: none, ReturnAll

Conditionally Unique eBay user ID for the user. Since a bidder's user info is anonymous, this tag contains the actual value of an ID only for that bidder, and for the seller of an item that the user is bidding on. For other users, the actual value is replaced by an anonymous value, according to these rules: When bidding on items, UserID is replaced with the value "a****b" where a and b are random characters from the UserID. For example, if the UserID = <code>IBidALot</code>, it might be displayed as, "I****A". Important: In this format, the anonymous bidder ID can change for each auction. For GetMyeBayBuying only, when bidding on items: UserID is replaced with the value "a****b" where a and b are random characters from the UserID. When bidding on items listed on the Philippines site: UserID is replaced with the value "Bidder X" where X is a number indicating the order of that user's first bid. For example, if the user was the third bidder, UserID = <code>Bidder 3</code>. Note that in this Philippines site format, the anonymous bidder ID stays the same for a given auction, but is different for different auctions. For example, a bidder who is the third and then the seventh bidder in an auction will be listed for both bids as "Bidder 3". However, if that same bidder is the first bidder on a different auction, the bidder will be listed for that auction as "Bidder 1", not "Bidder 3". For GetMyeBayBuying only, when bidding on items listed on the UK and AU sites: UserID is replaced with the string "High Bidder". For PlaceOffer, see also SellingStatus.HighBidder. https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-UserInformation.html#WorkingwithAnonymousUserInformation Working with Anonymous User Information PlaceOffer Conditionally GetAllBidders GetBidderList Conditionally GetBestOffers

DetailLevel: none, ReturnAll

Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemsAwaitingFeedback Conditionally Buyer GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList SoldList BidList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer GetSellerEvents

DetailLevel: ReturnAll

Conditionally If <code>true</code>, identifies a user whose ID has changed within the last 30 days. Does not indicate a new user (see NewUser). Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. Note: For the GetItemTransactions call, this field is only returned to the seller of the order; this field is not returned for the buyer or third party. https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-UserInformation.html#WorkingwithAnonymousUserInformation Working with Anonymous User Information GetAllBidders GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer Date and time the user's data was last changed (in GMT). Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. Note: For the GetItemTransactions call, this field is only returned to the seller of the order; this field is not returned for the buyer or third party. https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-UserInformation.html#WorkingwithAnonymousUserInformation Working with Anonymous User Information GetAllBidders GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer Indicates whether or not the user is subject to VAT. Users who have registered with eBay as VAT-exempt are not subject to VAT. See documentation on Value-Added Tax (VAT). VATStatus https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Sites-IntlDiffsVATB2B.html#VATexemptSellers GetAllBidders GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrderTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer Contains information about the user as a buyer, such as the shipping address. See BuyerType for its child elements. Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-UserInformation.html#WorkingwithAnonymousUserInformation Working with Anonymous User Information GetAllBidders Always GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally Buyer OrderReport Buyer Conditionally Contains information about a seller, including listing settings, listing preferences, seller rankings, and seller type. This field is replaced by the SellerBusinessType field if the user is a business seller with a site ID of 77 (Germany), ID of 3 (UK), ID of 205 (Ireland) or ID of 0 (US Motors). See SellerType or SellerBusinessCodeType for the child elements. GetBidderList Seller Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller This field indicates whether the user's account is enabled for buying and selling (indicated by FullMarketPlaceParticipant) on eBay, or if the account is a Partially Provisioned Account (indicated by Shopper) without selling and buying privileges on eBay. GetUser Always This field is deprecated. This field is deprecated. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Specifies the subscription level for a user. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. This field is deprecated. Indicates whether a user has read-only access to the eBay Wiki (<code>true</code>) or whether the user is able contribute or edit articles on the eBay Wiki (<code>false</code>). By default, all registered eBay users have access to contribute and edit articles on the eBay Wiki. All content contributed to the eBay Wiki is subject to the Community Content Policy. false GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Always TUV level is a number allocated to a user based on various characteristics such as buyer, seller, new buyer, new seller, high risk, or bid limit. Applies to eBay Motors Pro applications only. AU, DE, FR, IT, UK GetUser

DetailLevel: ReturnAll

Conditionally The value added tax identifier (VATID) is applicable to the VAT-enabled sites. Applies to eBay Motors Pro applications only. AU, DE, FR, IT, UK GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. Contains information about the user as a bidder on a certain item. Returned by GetAllBidders if IncludeBiddingSummary = <code>true</code> is included in the request. GetAllBidders Conditionally Indicates whether or not the User container has been made anonymous. If <code>true</code>, some elements in the User container have either been removed, or had their values changed to remove identifying characteristics. If false, all expected elements are returned, and no values are changed. Since a bidder's user info is anonymous, this tag is returned as false only to the bidder, and to the seller of an item that the user is bidding on. For all other users, this tag is returned as <code>true</code>. https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-UserInformation.html#WorkingwithAnonymousUserInformation Working with Anonymous User Information GetAllBidders GetSellerEvents Always GetSellerList

GranularityLevel: Fine

Always GetItem Always

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

HighBidder GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Total count of neutral Feedback entries received by the user, including weekly repeats. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Reserved for internal or future use. GetUser

DetailLevel: none, ReturnAll

Always When a user has their billing option set to <code>email</code>, they can include this element in a GetUser request to retrieve their own email bills. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This flag indicates whether or not the user is eligible to sell items on eBay. This field is only returned if the IncludeFeatureEligibility flag is included in the call request and set to <code>true</code>. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Contains the static email address of an eBay member, used within the "reply to" email address when the eBay member sends a message. (Each eBay member is assigned a static alias. The alias is used within a static email address.) https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/CRM-Communications.html#StaticEmailAddressesinTradingAPICalls Static Email Addresses in Trading API Calls GetOrderTransactions GetOrders

DetailLevel: ReturnAll

Conditionally OrderReport Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer Contains the shipping address of a bidder who has made a Best Offer for an item. You cannot retrieve a shipping address for any user with whom you do not have an order relationship, regardless of site. The shipping address of another user is returned only if you and the other user are in an order relationship, within a certain time of order line item creation. Because a bidder's user information is anonymous, this container is returned only to that bidder, and to the seller of an item that the user is bidding on. GetBestOffers

DetailLevel: none, ReturnAll

Conditionally The Membership container will be returned if the seller is enrolled in one or more membership programs on one or more eBay sites. A Program container will be returned for each applicable membership program, and provides details on that program, including the eBay site, the program name (such as '<code>EBAYPLUS</code>'), and the membership expiration date. This container will not be returned at all if the seller is not enrolled in any applicable membership programs. GetUser

DetailLevel: none, ReturnAll

Conditionally The first name of the buyer who purchased the order. GetOrderTransactions GetOrders

DetailLevel: none,ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The last name of the buyer who purchased the order. GetOrderTransactions GetOrders

DetailLevel: none,ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This type is used to set/display details related to VAT (Value-Added Tax) and Business Seller features. Note: VAT is not applicable to all countries, including the US. Sellers must be registered as Business Sellers on the site they are selling on in order to use the Business Seller-related fields. This field should be included in an Add/Revise/Relist call and set to <code>true</code> if the seller is registered on the selling site as a Business Seller. This field must be included and set to <code>true</code> if the RestrictedToBusiness field is also included and set to <code>true</code>. The RestrictedToBusiness field is used by German (Site ID 77), Austrian (Site ID 16), and Swiss (Site ID 193) sellers who wish to restrict sales of their item to other users registered as business users. This field is returned in 'Get' calls only if set on the listing, and the person making the call owns the listing. However, other Business Seller-related information will be returned to all users in 'Get' calls under the SellerInfo and BusinessSellerDetails containers. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

BusinessSellerDetails Conditionally This field must be included in an Add/Revise/Relist call and set to <code>true</code> if a German (Site ID 77), Austrian (Site ID 16), or Swiss (Site ID 193) seller wishes to restrict sales of their item to other users registered on eBay as business users. If this field is set as <code>true</code>, the BusinessSeller field must also be included and set to <code>true</code>. This feature is not available on any other eBay marketplaces. This field can be included and set to <code>true</code> only by Business Sellers registered on one of the three sites above, and only if the listing category supports Business-to-Business listings. The GetCategories call can be used by the seller (using one of the Site IDs above) to see which categories support Business-to-Business listings. A B2BVATEnabled boolean field will be returned as <code>true</code> if a listing category supports Business-to-Business listings. This field is returned in 'Get' calls only if set on the listing, and the person making the call owns the listing. However, other Business Seller-related information will be returned to all users in 'Get' calls under the SellerInfo and BusinessSellerDetails containers. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList BusinessSellerDetails Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

BusinessSellerDetails Conditionally This container is used in an Add/Revise/Relist call to set the VAT (Value-added Tax) percentage rate that will be charged to buyers when an item is purchased from the listing. VAT is not applicable to all countries, including the US. Allowed VAT percentage rates can vary by region/country, so sellers should be aware of the rates they are legally required/allowed to charge, and they are responsible for charging the correct VAT rate. If VAT is charged on a listing, the seller can choose to print an invoice for the buyer that shows the item's net price, the VAT percentage rate, the VAT amount, and the total price. This field is returned in 'Get' calls only if the listing is subject to VAT. Note: Previously, up to three digits beyond the decimal point were allowed for this float value, but now a seller can include only one digit beyond the decimal point (e.g. 12.3) when using an Add/Revise/Relist call to set this value. An error will occur if more digits beyond the decimal point are specified. 0.0 27.0 4 4 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Item Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Item Conditionally This string value is the Site ID value of the eBay Marketplace where the VAT is applicable and where the seller is registered as a Business Seller. The eBay sites that support VAT (and their corresponding Site IDs) can be found in the <a href="https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/IntlDiffs-B2BFields.html" target="_blank">Business Feature Field Differences</a> topic. GetItem Conditionally BusinessSellerDetails

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This is the unique VAT identifier associated with the Business Seller's account. This field will only be returned to Business Sellers who own the specified listing. Non-Business Sellers will not have a VAT identifier associated with their account, so this field will never be returned for those users. GetItem Conditionally BusinessSellerDetails

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Indicates whether or not the user is subject to VAT. Users who have registered with eBay as VAT-exempt are not subject to VAT. See documentation on Value-Added Tax (VAT). (out) VAT is not applicable (out) Residence in a country with VAT and user is not registered as VAT-exempt (out) Residence in a country with VAT and user is registered as VAT-exempt (out) Reserved for internal or future use This type is only applicable for Half.com listings, and since the Half.com site has been shut down, this type is no longer applicable. Note: ValType and all of its fields are no longer applicable since the Half.com site has been shut down. For Half.com, use AttributeArray.Attribute.Value.ValueLiteral in listing requests. AttributeArray.Attribute.Value.ValueLiteral is required when you use AddItem. For the Half.com Notes attribute, the max length is 500 characters. You can revise AttributeArray.Attribute.Value.ValueLiteral for Half.com listings. 1027 NoOp 1033 Note: ValType and all of its fields are no longer applicable since the Half.com site has been shut down. 1027 NoOp 1033 Note: ValType and all of its fields are no longer applicable since the Half.com site has been shut down. 1027 NoOp 1033 This enumeration type is used by the order management calls (like GetOrders), and indicates the type of tax ID used in the BuyerTaxIdentifier container.. Decimal,Numeric,Text,ISBN,UPC,EAN,Date This value is deprecated. This value is deprecated. This value is deprecated. This value is deprecated. This value is deprecated. This value is deprecated. This value is deprecated. This value indicates that the tax ID in the ID field is a Codice Fiscale ID, which is an identifier used by the Italian government to identify taxpayers in Italy. This value indicates that the tax ID in the ID field is a Spanish National Identity Number, which is one identifier used by the Spanish government to identify taxpayers in Spain. In Spanish, this ID is known as the 'Documento nacional de identidad'. The other tax identifier for Spanish residents is the NIE number, or 'Numero de Identidad de Extranjero'. This value indicates that the tax ID in the ID field is a Russian Passport number. This value indicates that the tax ID in the ID field is a Tax Registration Number, which is an identifier used by the Brazilian government to identify taxpayers in Brazil. In Portuguese, this ID is known as the 'Cadastro de Pessoas Fisicas', or 'CPF'. This value indicates that the tax ID in the ID field is a Turkish Identification Number, which is an identifier used by the Turkish government to identify taxpayers in Turkey. In Turkish, this ID is known as the 'Turkiye Cumhuriyeti Kimlik Numarasi', often abbreviated as T.C. Kimlik No. This value indicates that the tax ID in the ID field is a NIE Number, which is one identifier used by the Spanish government to identify taxpayers in Spain. 'NIE' stands for 'Numero de Identidad de Extranjero'. The other tax identifier for Spanish residents is the DNI number, or 'Documento nacional de identidad'. Spanish residents can also be identified by their Spanish VAT (Value-Added Tax) number, which is also called the 'Numero de Identificacion Fiscal' or NIF. This value indicates that the ID in the ID field is an NIF Number, which is also known as their Spanish VAT (Value-Added Tax) number. 'NIF' stands for 'Numero de Identificacion Fiscal'. Spanish residents can also be identified by their DNI ('Documento nacional de identidad') number or their NIE ('Numero de Identidad de Extranjero') number. This value indicates that the tax ID in the ID field is a Cedula number, which is an identifier used by the Chilean, Columbian, and Dominican Republic governments to identify taxpayers in those countries. This ID is sometimes referred to as a 'Cedula de Identidad'. This value indicates that the tax ID in the ID field is a NIT number, which is an identifier used by the Guatemalan government to identify taxpayers in Guatemala. In Spanish, this ID is known as the 'Numero de identificacion tributaria'. This value indicates that the identifier in the ID field is a driver's license number. This value indicates that the tax ID in the ID field is a CNPJ number, which is an identifier used by the Brazilian government to identify taxpayers in Brazil. In Portuguese, this ID is known as the 'Cadastro Nacional da Pessoa Juridica'. This value indicates that the tax ID in the ID field is a VAT Identification Number for the buyer. Reserved for future use. This type specifies variation-specific Extended Producer Responsibility information, specifically the EcoParticipationFee. For multiple-variation listings, this type's EcoParticipationFee is used and not the EcoParticipationFee in the ExtendedProducerResponsibility type. This type is supported by a limited number of sites and specific categories. Use the <a href="../../../../../api-docs/sell/metadata/resources/marketplace/methods/getExtendedProducerResponsibilityPolicies" target="_blank">getExtendedProducerResponsibilityPolicies</a> method of the Sell Metadata API to retrieve valid categories for a site. For GetItem calls, this container is only returned to the listing owner, if the container is available. This is the fee paid for new items to the eco-organization (for example, "eco-organisme" in France) fee for each variation in a multiple-variation listing. It is a contribution to the financing of the elimination of the item responsibly. For multiple-variation listings, this EcoParticipationFee (in the VariationExtendedProducerResponsibility container) is used and not the EcoParticipationFee in the ExtendedProducerResponsibility container. 16 0.0 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This type defines the VariationProductListingDetails container that is used to specify a Global Trade Item Number (GTIN), such as an EAN, an ISBN, or a UPC value, to identify a specific product variation in a multiple-variation listing. For a multiple-variation listing, the same GTIN type(s) must be used for all product variations within the same listing. For instance, if specify an ISBN value for one product variation within the listing, an ISBN value (and not an EAN or UPC value) must be specified for all product variations within the listing. This field is used if the seller wants to, or is required to identify each product variation within a multiplge-variation listing by an ISBN (International Standard Book Number) value. An ISBN is a unique identifer for books. Both 10 and 13-character ISBNs are supported. When specifying a 13-character ISBN, the value must begin with either '978' or '979'. The seller can use the GetCategoryFeatures call to see if an ISBN is supported/required for a category. Note: If the listing is being posted to a category that expects ISBN values, but one doesn't exist for the product, the seller must pass in the text that can be found in the ProductDetails.ProductIdentifierUnavailableText field of the GeteBayDetails response. To get the ProductDetails container to return in the GeteBayDetails response, <code>ProductDetails</code> should be included as a DetailName value in the call request. AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents Conditionally

DetailLevel: none, ReturnAll

This field is used if the seller wants to, or is required to identify each product variation within a multiple-variation listing by a UPC (Universal Product Code) value. A UPC is a commonly-used identifier for many different products. The seller can use the GetCategoryFeatures call to see if a UPC is supported/required for a category. Note: If the listing is being posted to a category that expects UPC values, but one doesn't exist for the product, the seller must pass in the text that can be found in the ProductDetails.ProductIdentifierUnavailableText field of the GeteBayDetails response. To get the ProductDetails container to return in the GeteBayDetails response, <code>ProductDetails</code> should be included as a DetailName value in the call request. AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents Conditionally

DetailLevel: none, ReturnAll

This field is used if the seller wants to, or is required to identify each product variation within a multiple-variation listing by an EAN (European Article Number) value. An EAN is a unique 8 or 13-digit identifier that many industries (such as book publishers) use to identify products. The seller can use the GetCategoryFeatures call to see if an EAN is supported/required for a category. Note: If the listing is being posted to a category that expects EAN values, but one doesn't exist for the product, the seller must pass in the text that can be found in the ProductDetails.ProductIdentifierUnavailableText field of the GeteBayDetails response. To get the ProductDetails container to return in the GeteBayDetails response, <code>ProductDetails</code> should be included as a DetailName value in the call request. AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents Conditionally

DetailLevel: none, ReturnAll

Note: DO NOT USE. Currently, sellers cannot associate an eBay catalog product with single variations within a multiple-variation listing for any eBay category. If the seller attempts to supply an eBay Product Identifier (ePID) at the variation level, a warning will get returned in the response stating that, 'Specifying a product identifier on a variant is not allowed in this category.'. The ProductReferenceID field was originally added as part of the Product-Based Shopping Experience (PBSE) mandate, and eBay was going to allow and even require ePIDs to be specified for some leaf categories. However, with the rollback of the PBSE mandate, this field is not currently applicable or supported. 38 (42 with "EPID") AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem VerifyAddFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This container is for future use. If it used, it will be ignored. Type defining the VariationSpecificPictureSet container, which is used to specify the URL(s) where the picture(s) of the variation specific will be hosted. If the Variations.Pictures container is used, at least one VariationSpecificPictureSet container is required. A value that is associated with VariationSpecificName. For example, suppose this set of pictures is showing blue shirts, and some of the variations include Color=Blue in their variation specifics. If VariationSpecificName is <code>Color </code>, then VariationSpecificValue would be <code>Blue</code>. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

The URL of a picture that is associated with the VariationSpecificValue. A variation specific picture set can consist of up to 12 self-hosted or eBay Picture Services (EPS) hosted pictures. eBay Picture Services and self-hosted images can never be combined into the same variation specific picture set. To specify more than one image, use multiple PictureURL fields, passing in a distinct URL in each of those fields. This field cannot have an empty/null value. The UploadSiteHostedPictures call can be used to upload pictures to EPS. Note that if pictures are externally-hosted, they must be hosted on a site that is using the 'https' protocol. The image specified in the first PictureURL field is also used as the thumbnail image for applicable variations. For example, if the picture set contains pictures of red shirts (i.e., VariationSpecificName=Color and VariationSpecificValue=Red), the first picture is used as the thumbnail image for all the red shirt variations. Note: All images, whether they are hosted by EPS or self-hosted, must comply with eBay picture requirements, including the requirement that all images must be at least 500 pixels on its longest side. If the image does not satisfy the 500 pixels requirement, the listing may be blocked. For more information about other requirements and tips for adding pictures to listings, see the <a href="https://www.ebay.com/help/selling/listings/adding-pictures-listings?id=4148">Adding pictures to your listings</a> help page. You can use Item.PictureDetails to specify additional pictures. For example, the item-level pictures could include a model wearing a black shirt, as a typical example of the shirt style. Note: If a URL contains spaces, those spaces can be replaced with <code>%20</code>. For example, <code>https://example.com/my image.jpg</code> must be submitted as <code>https://example.com/my%20image.jpg</code> to replace the space in the image file name. However, a semicolon character (;) cannot be replaced with <code>%20</code>, so a semicolon cannot be a part of the URL, as an error will occur. Variation pictures cannot be added or removed from a fixed-price listing when the listing is scheduled to end within 12 hours or if the item variation has already had transactions. Note: For some large merchants, there are no limitations on when variation pictures can be added or removed from a fixed-price listing, even when the item variation has had transactions or is set to end within 12 hours. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

No longer used. Returns the URL of a variation-specific picture that is hosted outside of eBay. When you list, revise, or relist a variation, use VariationSpecificPictureSet.PictureURL (not ExternalPictureURL) to specify your self-hosted picture or EPS picture. Note: All images must comply to the <a href="https://developer.ebay.com/DevZone/guides/features-guide/default.html#development/Pictures-Intro.html">Picture Requirements</a>. This is returned only when the seller used a self-hosted picture for the variation. 150 https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Pictures-InListing.html#UsingaSelfHostedPicture Using a Self-Hosted Picture GetItem Conditionally

outputSelector: Variations

Returns the URLs of the seller's self-hosted (hosted outside of eBay) variation specific pictures and the URL for the corresponding eBay Picture Services (EPS), that was generated when the picture was uploaded. GetItem Conditionally This type is used by the Variation container, which provides full details on each item variation in a multiple-variation listing. A SKU (stock keeping unit) is a seller-defined identifier. It is only intended for the seller's use (not for buyers). A SKU value is not required, but many large sellers like to add SKU value to their listings. If defined on a listing, a SKU value can be used by sellers to reconcile their eBay inventory with your own inventory system, instead of using the VariationSpecifics identifying values. If specified, all SKU values must be unique within the Variations node. That is, no two variations within the same listing can have the same SKU. If you include the Item.InventoryTrackingMethod field in an 'FixedPriceItem' call and set its value to <code>SKU</code>, the Variation.SKU values become required for each variation.. For GetItem, GetOrders and other 'Get' calls: Only returned if the seller specified a SKU for the variation. 80 Setting a SKU to Uniquely Identify the Variation https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Variations-Configuring.html#SettingaSKUtoUniquelyIdentifytheVariatio AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetMyeBaySelling ActiveList DeletedFromSoldList DeletedFromUnsoldList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally The fixed price for this item variation. For example, a "Blue, Large" variation price could be USD 10.00, and a "Black, Medium" variation price could be USD 5.00. Each variation requires this field, and the prices can be the same for all variations, or be different for each variation. This enables sellers to provide discounts on certain variations without affecting the price of others. Required (and always returned) for listings with variations. You can revise a variation's price at any time (even if it has purchases). When you modify a variation during revise or relist, you need to include both its StartPrice and Quantity. Setting the Variation Price https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Variations-Configuring.html#SettingtheVariationPrice AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Variations.Variation Conditionally GetMyeBaySelling ActiveList DeletedFromSoldList DeletedFromUnsoldList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally This value indicates the quantity of the specific variation that are available for purchase. If you set Variation.Quantity to <code>0</code> when you create, revise, or relist an item listing, the variation is dropped from the listing. To prevent this, you can set <a href="https://developer.ebay.com/DevZone/XML/docs/Reference/ebay/SetUserPreferences.html#Request.OutOfStockControlPreference">SetUserPreferences.OutOfStockControlPreference</a> to <code>true</code>. For GetItem (and other related calls that retrieve the Item object), the Variation.Quantity value indicates the total quantity associated with the variation, including the quantity available and the quantity sold. To calculate the quantity available for sale, subtract SellingStatus.QuantitySold from this value. For RelistFixedPriceItem: <ul> <li>For an item variation that had an available quantity greater than <code>0</code> when the listing ended, the Quantity value of the item variation for the newly relisted item is set to the actual quantity available. For item variations, there is actually no QuantityAvailable field, but this value may be derived if you look at the corresponding item variation in a GetMyeBaySelling) response and subtract the Variation.QuantitySold value from the Variation.Quantity value, which represents the original Variation.Quantity value at creation time of the previous listing. </li> <li>For item variations with an available quantity of <code>0</code> when the listing ended, the relisted item will retain the Variaton.Quantity value that was passed in at creation time of the previous listing. </li> </ul> So, if you are relisting an item that had one or more item variations with an available quantity of <code>0</code> when the listing ended, we strongly recommend that you pass in the correct available quantity through the corresponding Variation.Quantity field of a relist call. Alternatively, you can update the correct quantity available by using a ReviseInventoryStatus call and passing in a Quantity value, while also making sure to pass in the correct SKU value(s) to identify the correct item variation. A ReviseInventoryStatus call can be used to revise the quantity of up to four single item listings and/or item variations (from the same or different listings). For ReviseFixedPriceItem: You can revise a variation's quantity at any time, even if it has purchases. However, unless you set the <a href="https://developer.ebay.com/DevZone/XML/docs/Reference/ebay/SetUserPreferences.html#Request.OutOfStockControlPreference">OutOfStockControlPreference</a> boolean field of the SetUserPreferences call to <code>true</code>, at least one variation must remain with a non-zero quantity in order for the listing to remain active. If you set the OutOfStockControlPreference field to <code>true</code>, a multiple-variation listing will remain active but hidden from search even if the quantity of all variations in the listing is set to <code>0</code>. When you modify a variation during revise or relist, you need to include both its StartPrice and Quantity. If you revise the Quantity value for a variation after items have already sold, specify the quantity available for sale. (eBay will automatically add the quantity sold to the value you specify.) If you set the quantity to <code>0</code> and the variation has no purchases, the variation may be dropped from the listing. For GetSellerTransactions: See Item.Quantity instead. See the <a href="https://developer.ebay.com/Devzone/guides/features-guide/default.html#development/Variations-Updating.html">eBay Features Guide</a> for more details about setting and modifying a variation's quantity. Note: The number in the Variation.Quantity field represents the current quantity of the item variation that is available using the "Ship to home" fulfillment method. This number does not take into account any quantity of the item variation that is available through "local" fulfillment methods such as In-Store Pickup or Click and Collect. This is due to the fact that there is no current implementation (or API field) where the seller informs eBay about the quantity of item variations available through each local fulfillment method. In the case where a listing is only offering the item variations through a local fulfillment method, this value should default to <code>0</code>, and the Item.IgnoreQuantity will also be returned as <code>True</code>. Setting and Modifying a Variation's Quantity https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Variations-Configuring.html#SettingandModifyingaVariationsQuantity Using the Out-of-Stock Feature for more details https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Listings-UseOutOfStock.html AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Yes GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetMyeBaySelling ActiveList DeletedFromSoldList DeletedFromUnsoldList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Variations.Variation Conditionally A list of name/value pairs that uniquely identify the variation within the listing. All variations must specify the same set of Item Specific names, but each variation must provide a unique combination of values for those Item Specific names. For example, if the items vary by color and size, then every variation must specify 'Color' and 'Size' as Item Specific names, but no two variations can specify the same combination of 'Color' and 'Size' values. When you revise a listing that includes variations, you can change names of Variationpecifics by using the Variations.ModifyNameList container. You can also add, delete, or replace individual variations as needed to match your current inventory. Use the Variation.Delete field to delete a variation that has no sales (order line items). If the variation has sales, then set the Quantity to 0. For GetSellerEvents To keep the GetSellerEvents response smaller, Variationpecifics are not returned if the variation has a SKU. If the variation has no SKU, then Variationpecifics are returned instead. Optionally, you can pass IncludeVariationSpecifics as <code>true</code> in the request to force Variationpecifics to be returned, even when the SKU is returned. 2 5 Configuring Variation Specifics https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Variations-Configuring.html#ConfiguringVariationSelectionWidgetsforB Revising and Relisting with Variations https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Variations-Updating.html AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetMyeBayBuying LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList DeletedFromSoldList DeletedFromUnsoldList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally Quantity of items in the seller's inventory for this Selling Manager product. This is not the same as the quantity available in a listed item. Required when a Selling Manager product defines variations. Contains the variation's quantity sold. Always returned when variations are present. GetItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetMyeBaySelling ActiveList DeletedFromSoldList DeletedFromUnsoldList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Variations.Variation Conditionally The title of the variation. This is a concatenation of the listing title plus the values (no names) from Variationpecifics. For example, if the Title is "Polo Shirt" and the variation is for a medium pink shirt, the variation title could be "Polo Shirt[Pink,M]. 120 GetSellerTransactions GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Transaction.Variation Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetMyeBaySelling ActiveList DeletedFromSoldList DeletedFromUnsoldList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally URL for the variation on eBay. This links to eBay's View Item page, with the page configured to show details of the specified variation. The syntax of this URL is similar to Item.ViewItemURL (not optimized for natural search). GetSellerTransactions GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Transaction.Variation Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally If this field is included and set to true, the corresponding variation is deleted from the listing with a successful call. In general, a listing with variations must have at least one variation with a non-zero quantity in order to remain active. Additional deletion rules depend on whether you are revising or relisting. For ReviseFixedPriceItem only: This boolean field can now be used in a Revise call to delete a variation even if the variation still has quantity and/or has had one or more previous sales during the life of the listing. Previously, if a variation had any purchases, you could not delete the variation, but only set its quantity to zero. To replace a varation, you can delete it and add the new or corrected one. However, you can't specify the same SKU twice in the same request (because the intent would be ambiguous). So, either use a new SKU for the newer variation, or use the call twice (once to delete the variation, and once to add the new variation with the same SKU). For RelistFixedPriceItem only: You can delete any variation, as long as the relisted listing includes at least 1 variation with a non-zero quantity. (That is, when you relist, you could delete all but one variation, or you could delete all existing variations and add a new one.) ReviseFixedPriceItem RelistFixedPriceItem Conditionally false The number of watches placed on this variation by eBay users. GetMyeBaySelling ActiveList DeletedFromSoldList DeletedFromUnsoldList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally A note a user makes on an item with variations in My eBay. For eBay.com, only GetMyeBaySelling (not GetItem) returns this field, and only if you pass IncludeNotes in the request. Only visible to the user who created the note. Not supported as input in ReviseFixedPriceItem. Use SetUserNotes instead. In SoldList, notes for variations are only returned at the Item level, not the variation level. GetMyeBaySelling ActiveList DeletedFromUnsoldList ScheduledList UnsoldList

DetailLevel: none, ReturnAll

Conditionally This container provides information for a single variation (within a multiple-variation listing) that has a Strikethrough Price (STP) or a Minimum Advertised Price (MAP) discount pricing treatment. For a multiple-variation listing, the discount pricing information should be set at the variation level and not at the item level (e.g. Item.DiscountPriceInfo). STP and MAP apply only to fixed-price listings. STP is available on the US, eBay Motors, UK, Germany, Canada (English and French), France, Italy, Spain, and Ireland sites, while MAP is available only on the US site. Discount pricing is available to qualified sellers (and their associated developers) who participate in the Discount Pricing Program. Once qualified, sellers receive a 'special account flag' (SAF) that allows them to apply Discount Pricing to both single-variation and multi-variation items. STP is intended for eBay partners and their sellers only. As a seller listing Discount Price items, you are required to maintain records of your discount pricing in the event you are called upon to substantiate your item pricing. Displaying Discount Pricing Information to Buyers https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Items-Retrieving.html#DisplayingDiscountPricingInformationtoBu AddFixedPriceItem AddItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This container is used to provide one or more product identifiers for a product variation within a multiple-variation, fixed-price listing. The same product identifier type(s) must be used for all product variations within the listing. For instance, if one product variation uses ISBNs, all product variations must use ISBN values. Note: Currently, the EAN, ISBN, or UPC fields are used to specify a Global Trade Item Number (GTIN), and the GetCategoryFeatures call is used to see if particular product identifier types are supported/required. The ProductReferenceID field can only be used to specify an ePID for an eBay Catalog product that is part of the Product-Based Shopping Experience mandate. For more information about PBSE, see the <a href="https://developer.ebay.com/pbse/" target="_blank">Product-Based Shopping Experience</a> page. When you include the VariationProductListingDetails container in a call, you must specify at least one GTIN or ePID. If an ePID is provided, a matching eBay catalog product must exist for the value that is passed in. For ReviseItem and RelistItem only: When you revise a listing, if it ends within 12 hours, you cannot change the product identifier and you cannot remove existing product variation listing details data. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents Conditionally

DetailLevel: none, ReturnAll

This container defines variation-specific Extended Producer Responsibility information, specifically the EcoParticipationFee. For GetItem calls, this container is only returned to the listing owner, if the container is available. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem AddItem ReviseItem RelistItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Variations are multiple similar (but not identical) items in a fixed-price listing. For example, a single listing could contain multiple items of the same brand and model that vary by color and size (like "Blue, Large" and "Black, Medium"). Each variation can have its own quantity and price. For example, a listing could include 10 "Blue, Large" variations and 20 "Black, Medium" variations. Contains data that distinguishes one item variation from another. For example, if an item varies by color and size, each Variation node specifies a combination of one of those colors and sizes. When listing or relisting an item, you are allowed to create a listing with only one item variation, and you might have a plan to add more item variations to the listing in the future. However, if you don't plan to add other item variations in the future, we recommend that you avoid listing with only one variation, so that you avoid confusing buyers. If you specify multiple Variation containers in an add/revise/relist/verify add call to define multiple item variations, the Variation containers must be contiguous or an error will occur. This means that you would not want to input a Pictures or a VariationSpecificsSet container in between Variation containers in an API call. When you modify an item variation with a ReviseFixedPriceItem call, the best practice is to include all applicable fields under the Variation container, even if some of the values/settings are not being modified. The StartPrice and VariationSpecifics must be included when modifying an existing item variation, even if these values are not being changed. If a SKU value is defined for the item variation, it is strongly recommended that you include the SKU field, regardless of whether the SKU value is changing or not. If the SKU field is not included, any existing SKU value will be removed from the item variation. It is also strongly recommended that you include the Quantity field and input an accurate value, because if the Quantity field is omitted in the API call, the quantity for the item variation is set to <code>0</code>. Using Multi-Variation Listings https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Variations.html AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally 1 120 GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList DeletedFromSoldList DeletedFromUnsoldList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Contains a set of pictures that correspond to one of the variation specifics, such as Color. For example, if a listing has blue and black color variations, you could choose Color for all the pictures, and then include a set of pictures for the blue variations and another set of pictures for the black variations. We strongly recommend that you also include shared pictures in Item.PictureDetails, as this results in a better experience for buyers. For ReviseFixedPriceItem only: To replace or delete individual pictures, pass in the entire Pictures node with the complete set of variation pictures that you want in the listing. If the applicable variations have purchases or the listing ends in less than 12 hours, you can add pictures, but you can't remove existing pictures. Variation, Pictures, or ModifyNameList (or all) need to be specified when the Variations node is specified in listing requests Note: Only one Pictures node is allowed for a listing. However, the node has been defined as unbounded (repeatable) in the schema to allow for different use cases for some calls or sites in the future. 1 Variation Pictures https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Variations-Configuring.html#DefiningPicturesforVariations AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

The set of all variation specific names and values that can be applicable to the listing (at any time in its life cycle). This must include all names and values specified in the VariationSpecifics nodes. Required when Variations are specified in a new listing, and when you modify the name of a variation by using ModifyNameList. When you modify variation specific names, VariationSpecificsSet must include the new names plus the names that are not changing (but omit the old names), This set configures variation selection widgets that appear on eBay's View Item page. For example, if you specify Color and Size names in the set, eBay's View Item page displays Color and Size drop-down lists to enable a buyer to choose a variation of interest. The order in which you specify the names and values also controls the order in which the selection widgets appear on the View Item page. For example, if you specify "Color", then "Size", and then "Sleeve Style" as names, the View Item page shows drop-down lists with those labels in that order. For "Size", if you specify "S", "M", and "L" as values, the View Item page shows the values in that order in the Size drop-down list. Use the <a href="/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API to retrieve recommendations for names and values. Required when Variations are specified in a new listing (e.g., in AddFixedPriceItem). Also required when you change variation specific names or values in ReviseFixedPriceItem and RelistFixedPriceItem. Configuring Variation Specifics https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Variations-Configuring.html#ConfiguringVariationSelectionWidgetsforB AddFixedPriceItem VerifyAddFixedPriceItem Conditionally ReviseFixedPriceItem RelistFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Modifies variation specific names when you revise or relist items. You can modify a variation specific name regardless of the quantity sold (i.e., no restrictions on whether the item has orders or order line items (transactions)). (Use VariationSpecifics to modify variation specific values.) You are not required to specify SKU, VariationSpecifics, and other variation details in the request when you are only modifying a variation specific name. Variation, Pictures, VariationSpecificsSet, or ModifyNameList (or all) need to be specified when the Variations node is specified in listing requests. Revising and Relisting with Variations https://developer.ebay.com/DevZone/guides/features-guide/default.html#Development/Variations-Updating.html RelistFixedPriceItem ReviseFixedPriceItem Conditionally This type is used by the Add/Revise/Relist calls to add a video to a listing. Videos can be added to listings using the <a href="/api-docs/commerce/media/overview.html" target="_blank">Media API</a>. See the <a href="/api-docs/commerce/media/overview.html" target="_blank">Media API</a> reference documentation for all of the necessary details to upload videos to eBay. The GetItem call will return the VideoDetails container if the listing contains a video, and the seller of the item is the one making the GetItem call. Unique identifier of a video. This identifier is automatically created by eBay once a seller successfully uploads a video to eBay. Videos can be added using the <a href="/api-docs/commerce/media/resources/video/methods/uploadVideo" target="_blank">uploadVideo</a> method of the <a href="/api-docs/commerce/media/overview.html" target="_blank">Media API</a>. In an Add/Revise/Relist call, passing in the ID for the video will add the video to the listing. Although a video can be added to a listing before it is in the <code>LIVE</code> state, the video won't be available for viewing in the listing until it does reach this state. The status of an uploaded video can be retrieved with the <a href="/api-docs/commerce/media/resources/video/methods/getVideo" target="_blank">getVideo</a> method and seen in the <a href=" /api-docs/commerce/media/resources/video/methods/getVideo#response.status" target="_blank">status</a> field of the response. To replace a video already attached to the listing, the seller could make a Revise or Relist call and just send in a different VideoID value. As long as the VideoID value was valid, the specified video would replace the existing video in the listing. To remove a video from a listing (and not replace it) using a Revise or Relist call, the seller can include a DeletedField tag in the request and set its value to <code>Item.VideoDetails.VideoID</code>. If the call is successful, the video will be removed from the listing. Note: eBay will perform a validation check on each specified VideoID value to verify that the video belongs to, and was uploaded by the seller. The GetItem call can be used by the seller to see which video (if any) is attached to the listing. The VideoDetails container will be returned if the listing contains a video. The VideoDetails container will only be returned to the seller of the item and no one else. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem Conditionally This type is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This type is used to indicate the type of tax identifier that is appearing in the eBayReference field. The tax identifier type which will vary by country/region. This attribute value is returned to indicate the VAT tax type, which will vary by country/region. This string value will be one of the following: <ul><li><code>ABN</code>: if this string is returned, the ID in the field is an eBay Australia tax number </li><li><code>IOSS</code>: if this string is returned, the ID in the field is an eBay EU or UK IOSS number</li><li><code>IRD</code>: if this string is returned, the ID in the field is an eBay New Zealand tax number</li><li><code>OSS</code>: if this string is returned, the ID in the field is an eBay Germany VAT ID</li><li><code>VOEC</code>: if this string is returned, the ID in the field is an eBay Norway tax number</li><li><code>VAT_ID</code>: if this string is returned, the ID in the field is an eBay France VAT ID</li></ul> GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport

DetailLevel: none, ReturnAll

Conditionally GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally