GetSellerTransactions

Use this call to retrieve transaction information related to the user for which the call is made. The call returns zero, one, or multiple transactions, depending on the number of items the authenticated user has recently sold.

A transaction contains information about the sale of one or more items. It involves one buyer, one seller, and a single listing. For a more detailed definition, see Transactions (End of Auction).

For competitive-bid item listings (Chinese auctions), transactions are not created until the auction ends and the winning bidder is determined. For immediate-purchase listings (Store Inventory and Fixed-Price listings), transactions are created after a buyer has committed to purchase the item(s). In these cases, the creation of a transaction does not depend on the ending of a listing.

GetSellerTransactions returns the seller's transactions in a TransactionArray object. This container has zero, one, or multiple transactions associated with the respective user ID, with each transaction contained in a Transaction object.

In addition to transaction data, each TransactionArray also contains an Item object that contains the details needed to process each of the transactions. For example, if it is a multi-quantity listing of 20 items and 10 of the items have sold, Item.Quantity is 20 and Item.SellingStatus.QuantitySold is 10.(Be aware that the Item objects returned by this call do not contain all possible details about the item. If you need more detailed item information, use GetSellerList or GetItem.)

GetSellerTransactions also returns a Seller object that describes the seller whose transactions are retrieved. Because all transactions returned by this call are for the same seller, Seller is returned at the root level.

Note: To retrieve transaction data for one particular listing, use GetItemTransactions.

Request Details

This call does not take a seller ID as input because it only retrieves transactions for the user authenticated by the call. However, because this call can potentially return a very large number of transactions, it can be desirable to control the amount of data returned from your GetSellerTransactions calls.

For example, you can pass in a time filter to limit the volume of the response to a particular time range and you can set the number of transaction to return per call. You can also control the amount of information returned for each call with DetailLevel settings. See the Detail Controls section for information on the fields returned for each of the settings.

Returned transactions are sorted by Transaction.Status.LastTimeModified in ascending order (that is, the most recently modified transactions are returned last).

Filtering by Time

Because of the number of transactions this call can return, it's recommended that you specify a time filter so you only get transactions whose status was modified within a narrow time frame. For example, the NumberOfDays field enables you to specify the number of days worth of new and modified transactions to return for a given call.

The time filters used with GetSellerTransactions do not represent the start and end times of the listing, but instead represent transaction-status modification times related to the item listing. The transaction-status modification time is available in the Transaction.Status.LastTimeModified output field. This value is updated each time the Checkout status of an item changes. The Checkout status can change any time (in seconds, minutes, or days) after the transaction is created.

Perhaps the most useful time filter is the NumberOfDays filter. This filter narrows the request to transactions that occurred within the specified number of days since the time of the request. In addition, the call also supports ModTimeFrom and ModTimeTo time filters.

Some transactions are processed by means of back-end batch jobs. Because of this, there can be a short delay between the end time of the item and the recording of the initial transaction entry in the eBay database. The following approaches help to ensure you do not miss any transactions when using ModTimeFrom and ModTimeTo:

Depending on the time range you specify, the call can still return hundreds of transactions. Therefore, it is often a good idea to configure the request to retrieve one page of data at a time (where each page contains a more manageable number of transactions). See Pagination for more information.

Pagination

To help manage large sets of output data, you can configure the request to retrieve controlled pages of data where each page contains a more manageable number of transactions.

Use the Pagination input property to control the number of transactions returned per request. The Pagination.EntriesPerPage controls the number of items returned and Pagination.PageNumber specifies which page of data to retrieve for the current call. The value specified for EntriesPerPage must be between 1 and 200.

In the output, ReturnedTransactionCountActual indicates how many transactions were actually returned in the call. HasMoreTransactions, if true, indicates that there are more transactions to be returned, requiring one or more additional calls to retrieve the entire result set. PageNumber indicates the page of data returned and TransactionsPerPage gives the number of transactions returned per call.

If you use pagination in a call, you must set at least one date-range filter. However, the reverse is not true, you can use a date-range filter without also using pagination.

Pertinent Response Data

In general, only fields relevant to transactions are returned. To note:

Working with the Response

GetSellerTransactions returns the transactions for the specified listing in a TransactionArray object.

  1. Traverse the elements of the array to visit each Transaction object contained in the response and inspect the properties of each Transaction object to get the values for each of the transactions in the response.
  2. As applicable for the application, store the data for later use. See Completing the Sale for a more information.

The following Knowledge Base article contains some tips for working with this call: Best Practices for GetSellerEvents and GetSellerTransactions

Related Information

See:
    Email and Address Privacy Policy for the conditions under which buyer and seller email and address are returned
    Retrieving the Transactions for a Specific Seller

See also the reference documentation for these calls:



Back to top

Input Output Detail Controls Samples Change History Top Errors for GetSellerTransactions
GetSellerTransactions Input

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also Samples.

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are (or soon will be) non-operational.

The XML prototype does not include requester credentials. This is a documentation limitation only (see Standard Requester Credentials for Making Calls). 

<?xml version="1.0" encoding="utf-8"?>
<GetSellerTransactionsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Standard Input Fields -->
  <DetailLevel> DetailLevelCodeType </DetailLevel>
  <!-- ... more DetailLevel nodes here ... -->
  <ErrorLanguage> string </ErrorLanguage>
  <MessageID> string </MessageID>
  <OutputSelector> string </OutputSelector>
  <!-- ... more OutputSelector nodes here ... -->
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
  <!-- Call-specific Input Fields -->
  <IncludeContainingOrder> boolean </IncludeContainingOrder>
  <IncludeFinalValueFee> boolean </IncludeFinalValueFee>
  <InventoryTrackingMethod> InventoryTrackingMethodCodeType </InventoryTrackingMethod>
  <ModTimeFrom> dateTime </ModTimeFrom>
  <ModTimeTo> dateTime </ModTimeTo>
  <NumberOfDays> int </NumberOfDays>
  <Pagination> PaginationType 
    <EntriesPerPage> int </EntriesPerPage>
    <PageNumber> int </PageNumber>
  </Pagination>
  <Platform> TransactionPlatformCodeType </Platform>
  <SKUArray> SKUArrayType 
    <SKU> SKUType (string) </SKU>
    <!-- ... more SKU nodes here ... -->
  </SKUArray>
</GetSellerTransactionsRequest>
Argument Type Occurrence Meaning
Standard Input Fields   [Jump to call-specific fields]
DetailLevel DetailLevelCodeType Optional,
repeatable: [0..*]		 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 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. (Some detail level tables are still in the eBay Web Services guide. They will be moved to the Input/Output Reference in a future release.)

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 a GranularityLevel or use the GetSellerEvents call instead. If you do use ReturnAll with GetSellerList, use a small EntriesPerPage value and a short EndTimeFrom/EndTimeTo range for better performance.

Applicable values:

•   ItemReturnDescription

(in) Returns Description, plus the ListingDesigner node and some additional information if applicable

•   ReturnAll

(in) 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.


(Not all values in DetailLevelCodeType apply to this field.)
ErrorLanguage string Optional 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. Specify the standard RFC 3066 language identification tag (e.g., en_US).
ID--- country
----- -----
de_AT Austria
de_CH Switzerland
de_DE Germany
en_AU Australia
en_CA Canada
en_GB United Kingdom
en_SG Singapore
en_US United States
es_ES Spain
fr_BE Belgium (French)
fr_CA Canada (French)
fr_FR France
it_IT Italy
nl_BE Belgium (Dutch)
nl_NL Netherlands
zh_CN China
en_IN India
en_IE Ireland
zh_HK Hong Kong

See Tags for the Identification of Languages.
MessageID string Optional In most cases, all calls support a MessageID element in the request and a CorrelationID element in the response. If you pass a message ID in a request, we will return the same value in CorrelationID in the response. You can use this for tracking that a response is returned for every request and to match particular responses to particular requests. If you do not pass MessageID in the request, CorrelationID is not returned.

Note: GetCategories, GetAttributesCS, GetCategory2CS, GetAttributesXSL, GetProductFinder, GetProductFinderXSL, and GetProductSearchPage 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, 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.
OutputSelector string Optional,
repeatable: [0..*]		 You can use the OutputSelector field to restrict the data returned by this call. When you make a call such as GetItem that retrieves data from eBay, the OutputSelector field is useful for restricting the data returned. This field makes the call response easier to use, especially when a large payload would be returned. If you use the OutputSelector field, the output data will include only the fields you specified in the request. For example, if you are using GetItem and you want the item data in the response to be restricted to the ViewItemURL (the URL where a user can view the listing) and BuyItNowPrice, then within the GetItem request, specify those output fields. To use this field, see the information at the following link.

See Selecting Fields to Retrieve.
Version string Conditional The version number of the API code that you are programming against (e.g., 549). The version you specify for a call has these basic effects:
- It indicates the version of the code lists and other data that eBay should use to process your request.
- It indicates the schema version you are using.
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.)

See:
    HTTP Headers (XML API Only)
    eBay Schema Versioning Strategy
    Lowest Supported Version

WarningLevel WarningLevelCodeType Optional 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 in your production code.

Applicable values:

•   High

(in) Return warnings when the application passes unrecognized or deprecated elements in a request.

•   Low

(in) Do not return warnings when the application passes unrecognized or deprecated elements in a request. This is the default value if WarningLevel is not specified.


See Warning Level.
Call-specific Input Fields
IncludeContainingOrder boolean Optional Whether to retrieve the order information. Default is false.
Default: false.
IncludeFinalValueFee boolean Optional Indicates whether to include Final Value Fee (FVF) in the response. For most listing types, the Final Value Fee is returned in Transaction.FinalValueFee. The Final Value Fee is returned on a transaction-by-transaction basis for FixedPriceItem and StoresFixedPrice listing types. For all other listing types, the Final Value Fee is returned when the listing status is Completed. This value is not returned if the auction ended with Buy It Now.

For Dutch (multi-item) auctions that end with bids (not Buy It Now purchases), the Final Value Fee is returned in Item.SellingStatus.FinalValueFee. For Dutch Buy It Now listings, the Final Value Fee is returned on a transaction-by-transaction basis.

Note: As of version 619, Dutch-style (multi-item) competitive-bid auctions are deprecated. eBay throws an error if you submit a Dutch item listing with AddItem or VerifyAddItem. If you use RelistItem to update a Dutch auction listing, eBay generates a warning and resets the Quantity value to 1.
InventoryTrackingMethod InventoryTrackingMethodCodeType Optional Filters the response to only include transactions for listings that match this InventoryTrackingMethod setting.

For example, if you set this to SKU, the call returns transactions for your listings that are tracked by SKU. If you set this to ItemID, the call omits transactions for your listings that are tracked by SKU. If you don't pass this in, the call returns all transactions, regardless of whether they are tracked by SKU or ItemID.

Note: To specify InventoryTrackingMethod when you create a listing, use AddFixedPriceItem or RelistFixedPriceItem. AddFixedPriceItem and RelistFixedPriceItem are defined in the Merchant Data API (part of Large Merchant Services).

You can combine SKUArray with InventoryTrackingMethod. For example, if you set this to SKU and you also pass in SKUArray, the response only includes transactions for listings that include InventoryTrackingMethod=SKU and one of the requested SKUs.

Applicable values:

•   CustomCode

(in/out) Reserved for internal or future use

•   ItemID

(in/out) The seller prefers to track the listing by its eBay item ID. This is the default for all listings.

•   SKU

(in/out) The seller prefers to track the listing by their own SKU. When you track by SKU, it means you can pass 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.
ModTimeFrom dateTime Optional Also see NumberOfDays, which (if used), takes precedence over ModTimeFrom and ModTimeTo. If you prefer to use ModTimeFrom and ModTimeTo, specify the time range within which retrieved transactions' statuses were modified. ModTimeFrom is the earlier (older) date and ModTimeTo is the later (more recent) date. If you specify ModTimeFrom, but do not specify the other end of the range, the time range is set to 30 days. The time range between ModTimeFrom to ModTimeTo cannot be greater than 30 days.
ModTimeTo dateTime Optional Also see NumberOfDays, which (if used), takes precedence over ModTimeFrom and ModTimeTo. If you prefer to use ModTimeFrom and ModTimeTo, specify the time range within which retrieved transactions' statuses were modified. ModTimeFrom is the earlier (older) date and ModTimeTo is the later (more recent) date. If you specify ModTimeTo, but do not specify the other end of the range, the time range is set to 30 days. The time range between ModTimeFrom to ModTimeTo cannot be greater than 30 days.
NumberOfDays int Optional NumberOfDays enables you to specify the number of days' worth of new and modified transactions that you want to retrieve. The call response contains the transactions whose status was modified within the specified number of days since the API call was made. NumberOfDays is often preferable to using the ModTimeFrom and ModTimeTo filters because you only need to specify one value. If you use NumberOfDays, then ModTimeFrom and ModTimeTo are ignored. For this field, one day is defined as 24 hours.
Max: 30.
Pagination PaginationType Optional Child elements control pagination of the output. Use EntriesPerPage property to control the number of transactions to return per call and PageNumber property to specify the page of data to return.
Pagination.EntriesPerPage int Optional Specifies the maximum number of entries to return in a single call. If the number of entries that can be returned is less than the value in EntriesPerPage, then the lower number is returned. For most calls, the max is 200 and the default is 25. For GetUserDisputes, the value is hard-coded at 200, and any input is ignored. For GetProducts, the maximum is 20 (and higher values are ignored). See the annotations for other individual calls to determine the correct max and default values. For GetOrders, not applicable to eBay.com (but applicable to Half.com for GetOrders).
Pagination.PageNumber int Optional Specifies the number of the page of data to return in the current call. Default is 1 for most calls. For some calls, the default is 0. Specify a positive value equal to or lower than the number of pages available (which you determine by examining the results of your initial request). See the documentation for other individual calls to determine the correct default value. For GetOrders, not applicable to eBay.com (for GetOrders, applicable to Half.com).
Min: 1. Default: 1.
Platform TransactionPlatformCodeType Optional Name of the eBay co-branded site upon which the transaction was made. This will serve as a filter for the transactions to get emitted in the response.

Applicable values:

•   CustomCode

(in/out) Reserved for future use.

•   eBay

(in/out) The transaction was created (i.e., the purchase was made) on the main eBay site.

•   Express

(in/out) The transaction was created on the eBay Express site.

•   Half

(in/out) The transaction was created on Half.com site.

•   Shopping

(in/out) The transaction was created on the Shopping.com site.

•   WorldOfGood

(in/out) The transaction was created on the WorldOfGood site.
SKUArray SKUArrayType Optional Container for a set of SKUs. Filters (reduces) the response to only include transactions for listings that include any of the specified SKUs. If multiple listings include the same SKU, transactions for all of them are returned (assuming they also match the other criteria in the GetSellerTransactions request).

You can combine SKUArray with InventoryTrackingMethod. For example, if you also pass in InventoryTrackingMethod=SKU, the response only includes transactions for listings that include InventoryTrackingMethod=SKU and one of the requested SKUs.
SKUArray.SKU SKUType (string) Optional,
repeatable: [0..*]		 A SKU (stock keeping unit) is an identifier defined by a seller. Some sellers use SKUs to track complex flows of products and information on the client side. 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 a transaction is created. (SKU is recommended as an alternative to ApplicationData.)

A SKU is not required to be unique. A seller can specify a particular SKU value on one item or on multiple items. Different sellers can use the same SKUs.

If the SKU is unique across a seller's active listings, and if the seller listed the item by using AddFixedPriceItem or RelistFixedPriceItem, the seller can also set Item.InventoryTrackingMethod to SKU. This allows the seller to use SKU instead of ItemID as a unique identifier in subsequent calls, such as GetItem and ReviseInventoryStatus.

Note: AddFixedPriceItem and RelistFixedPriceItem are defined in the Merchant Data API (part of Large Merchant Services).
Max length: 50.



Back to top

Input Output Detail Controls Samples Change History Top Errors for GetSellerTransactions
GetSellerTransactions Output

The box below lists all fields that might be returned in the response. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also Samples.

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are not returned (or soon will not be returned) or are not operational (or soon will be non-operational).

The XML prototype does not include requester credentials. This is a documentation limitation only (see Standard Requester Credentials for Making Calls). 

<?xml version="1.0" encoding="utf-8"?>
<GetSellerTransactionsResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Standard Output Fields -->
  <Ack> AckCodeType </Ack>
  <Build> string </Build>
  <CorrelationID> string </CorrelationID>
  <Errors> ErrorType 
    <ErrorClassification> ErrorClassificationCodeType </ErrorClassification>
    <ErrorCode> token </ErrorCode>
    <ErrorParameters ParamID="string"> ErrorParameterType 
      <Value> string </Value>
    </ErrorParameters>
    <!-- ... more ErrorParameters nodes here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes here ... -->
  <HardExpirationWarning> string </HardExpirationWarning>
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
  <!-- Call-specific Output Fields -->
  <HasMoreTransactions> boolean </HasMoreTransactions>
  <PageNumber> int </PageNumber>
  <PaginationResult> PaginationResultType 
    <TotalNumberOfEntries> int </TotalNumberOfEntries>
    <TotalNumberOfPages> int </TotalNumberOfPages>
  </PaginationResult>
  <PayPalPreferred> boolean </PayPalPreferred>
  <ReturnedTransactionCountActual> int </ReturnedTransactionCountActual>
  <Seller> UserType 
    <AboutMePage> boolean </AboutMePage>
    <CharityAffiliations> CharityAffiliationsType 
      <CharityID> CharityIDType (string) </CharityID>
      <!-- ... more CharityID nodes here ... -->
    </CharityAffiliations>
    <eBayGoodStanding> boolean </eBayGoodStanding>
    <EIASToken> string </EIASToken>
    <Email> string </Email>
    <FeedbackPrivate> boolean </FeedbackPrivate>
    <FeedbackRatingStar> FeedbackRatingStarCodeType </FeedbackRatingStar>
    <FeedbackScore> int </FeedbackScore>
    <IDVerified> boolean </IDVerified>
    <NewUser> boolean </NewUser>
    <PositiveFeedbackPercent> float </PositiveFeedbackPercent>
    <RegistrationDate> dateTime </RegistrationDate>
    <SellerInfo> SellerType 
      <AllowPaymentEdit> boolean </AllowPaymentEdit>
      <CheckoutEnabled> boolean </CheckoutEnabled>
      <CIPBankAccountStored> boolean </CIPBankAccountStored>
      <GoodStanding> boolean </GoodStanding>
      <MerchandizingPref> MerchandizingPrefCodeType </MerchandizingPref>
      <QualifiesForB2BVAT> boolean </QualifiesForB2BVAT>
      <SafePaymentExempt> boolean </SafePaymentExempt>
      <SellerGuaranteeLevel> SellerGuaranteeLevelCodeType </SellerGuaranteeLevel>
      <SellerLevel> SellerLevelCodeType </SellerLevel>
      <StoreOwner> boolean </StoreOwner>
      <StoreURL> anyURI </StoreURL>
      <TopRatedSeller> boolean </TopRatedSeller>
    </SellerInfo>
    <Site> SiteCodeType </Site>
    <Status> UserStatusCodeType </Status>
    <UserID> UserIDType (string) </UserID>
    <UserIDChanged> boolean </UserIDChanged>
    <UserIDLastChanged> dateTime </UserIDLastChanged>
    <VATStatus> VATStatusCodeType </VATStatus>
  </Seller>
  <TransactionArray> TransactionArrayType 
    <Transaction> TransactionType 
      <AdjustmentAmount> AmountType (double) </AdjustmentAmount>
      <AmountPaid> AmountType (double) </AmountPaid>
      <BestOfferSale> boolean </BestOfferSale>
      <Buyer> UserType 
        <AboutMePage> boolean </AboutMePage>
        <BuyerInfo> BuyerType 
          <ShippingAddress> AddressType 
            <CityName> string </CityName>
            <Country> CountryCodeType </Country>
            <CountryName> string </CountryName>
            <ExternalAddressID> string </ExternalAddressID>
            <Name> string </Name>
            <Phone> string </Phone>
            <PostalCode> string </PostalCode>
            <StateOrProvince> string </StateOrProvince>
            <Street> string </Street>
            <Street1> string </Street1>
            <Street2> string </Street2>
          </ShippingAddress>
        </BuyerInfo>
        <CharityAffiliations> CharityAffiliationsType 
          <CharityID> CharityIDType (string) </CharityID>
          <!-- ... more CharityID nodes here ... -->
        </CharityAffiliations>
        <eBayGoodStanding> boolean </eBayGoodStanding>
        <EIASToken> string </EIASToken>
        <Email> string </Email>
        <FeedbackPrivate> boolean </FeedbackPrivate>
        <FeedbackRatingStar> FeedbackRatingStarCodeType </FeedbackRatingStar>
        <FeedbackScore> int </FeedbackScore>
        <IDVerified> boolean </IDVerified>
        <NewUser> boolean </NewUser>
        <PositiveFeedbackPercent> float </PositiveFeedbackPercent>
        <RegistrationDate> dateTime </RegistrationDate>
        <Site> SiteCodeType </Site>
        <Status> UserStatusCodeType </Status>
        <UserID> UserIDType (string) </UserID>
        <UserIDChanged> boolean </UserIDChanged>
        <UserIDLastChanged> dateTime </UserIDLastChanged>
        <VATStatus> VATStatusCodeType </VATStatus>
      </Buyer>
      <BuyerCheckoutMessage> string </BuyerCheckoutMessage>
      <BuyerGuaranteePrice> AmountType (double) </BuyerGuaranteePrice>
      <CartID> string </CartID>
      <ContainingOrder> OrderType 
        <CreatingUserRole> TradingRoleCodeType </CreatingUserRole>
        <IntegratedMerchantCreditCardEnabled> boolean </IntegratedMerchantCreditCardEnabled>
        <OrderID> OrderIDType (string) </OrderID>
        <OrderStatus> OrderStatusCodeType </OrderStatus>
      </ContainingOrder>
      <ConvertedAdjustmentAmount> AmountType (double) </ConvertedAdjustmentAmount>
      <ConvertedAmountPaid> AmountType (double) </ConvertedAmountPaid>
      <ConvertedTransactionPrice> AmountType (double) </ConvertedTransactionPrice>
      <CreatedDate> dateTime </CreatedDate>
      <DepositType> DepositTypeCodeType </DepositType>
      <ExternalTransaction> ExternalTransactionType 
        <ExternalTransactionID> string </ExternalTransactionID>
        <ExternalTransactionTime> dateTime </ExternalTransactionTime>
        <FeeOrCreditAmount> AmountType (double) </FeeOrCreditAmount>
        <PaymentOrRefundAmount> AmountType (double) </PaymentOrRefundAmount>
      </ExternalTransaction>
      <!-- ... more ExternalTransaction nodes here ... -->
      <FinalValueFee> AmountType (double) </FinalValueFee>
      <Item> ItemType 
        <ApplicationData> string </ApplicationData>
        <ApplyShippingDiscount> boolean </ApplyShippingDiscount>
        <AutoPay> boolean </AutoPay>
        <BuyerProtection> BuyerProtectionCodeType </BuyerProtection>
        <BuyItNowPrice> AmountType (double) </BuyItNowPrice>
        <Charity> CharityType 
          <CharityListing> boolean </CharityListing>
        </Charity>
        <Country> CountryCodeType </Country>
        <Currency> CurrencyCodeType </Currency>
        <GetItFast> boolean </GetItFast>
        <IntegratedMerchantCreditCardEnabled> boolean </IntegratedMerchantCreditCardEnabled>
        <InventoryTrackingMethod> InventoryTrackingMethodCodeType </InventoryTrackingMethod>
        <ItemID> ItemIDType (string) </ItemID>
        <ListingDetails> ListingDetailsType 
          <Adult> boolean </Adult>
          <BindingAuction> boolean </BindingAuction>
          <CheckoutEnabled> boolean </CheckoutEnabled>
          <ConvertedBuyItNowPrice> AmountType (double) </ConvertedBuyItNowPrice>
          <ConvertedReservePrice> AmountType (double) </ConvertedReservePrice>
          <ConvertedStartPrice> AmountType (double) </ConvertedStartPrice>
          <EndTime> dateTime </EndTime>
          <HasPublicMessages> boolean </HasPublicMessages>
          <HasReservePrice> boolean </HasReservePrice>
          <MinimumBestOfferMessage> string </MinimumBestOfferMessage>
          <MinimumBestOfferPrice> AmountType (double) </MinimumBestOfferPrice>
          <RelistedItemID> ItemIDType (string) </RelistedItemID>
          <StartTime> dateTime </StartTime>
          <TCROriginalItemID> ItemIDType (string) </TCROriginalItemID>
          <ViewItemURL> anyURI </ViewItemURL>
          <ViewItemURLForNaturalSearch> anyURI </ViewItemURLForNaturalSearch>
        </ListingDetails>
        <ListingType> ListingTypeCodeType </ListingType>
        <LotSize> int </LotSize>
        <PaymentMethods> BuyerPaymentMethodCodeType </PaymentMethods>
        <!-- ... more PaymentMethods nodes here ... -->
        <PrivateListing> boolean </PrivateListing>
        <Quantity> int </Quantity>
        <SellingStatus> SellingStatusType 
          <BidCount> int </BidCount>
          <ConvertedCurrentPrice> AmountType (double) </ConvertedCurrentPrice>
          <CurrentPrice> AmountType (double) </CurrentPrice>
          <FinalValueFee> AmountType (double) </FinalValueFee>
          <ListingStatus> ListingStatusCodeType </ListingStatus>
          <QuantitySold> int </QuantitySold>
        </SellingStatus>
        <Site> SiteCodeType </Site>
        <SKU> SKUType (string) </SKU>
        <StartPrice> AmountType (double) </StartPrice>
        <Title> string </Title>
      </Item>
      <ListingCheckoutRedirectPreference> ListingCheckoutRedirectPreferenceType 
        <SellerThirdPartyUsername> string </SellerThirdPartyUsername>
      </ListingCheckoutRedirectPreference>
      <PaidTime> dateTime </PaidTime>
      <PayPalEmailAddress> string </PayPalEmailAddress>
      <Platform> TransactionPlatformCodeType </Platform>
      <QuantityPurchased> int </QuantityPurchased>
      <SellerContactBuyerByEmail> boolean </SellerContactBuyerByEmail>
      <SellingManagerProductDetails> SellingManagerProductDetailsType 
        <ProductName> string </ProductName>
      </SellingManagerProductDetails>
      <ShippedTime> dateTime </ShippedTime>
      <ShippingDetails> ShippingDetailsType 
        <CalculatedShippingRate> CalculatedShippingRateType 
          <InternationalPackagingHandlingCosts> AmountType (double) </InternationalPackagingHandlingCosts>
          <OriginatingPostalCode> string </OriginatingPostalCode>
          <PackageDepth unit="token"> MeasureType (decimal) </PackageDepth>
          <PackageLength unit="token"> MeasureType (decimal) </PackageLength>
          <PackageWidth unit="token"> MeasureType (decimal) </PackageWidth>
          <PackagingHandlingCosts> AmountType (double) </PackagingHandlingCosts>
          <ShippingIrregular> boolean </ShippingIrregular>
          <ShippingPackage> ShippingPackageCodeType </ShippingPackage>
          <WeightMajor unit="token"> MeasureType (decimal) </WeightMajor>
          <WeightMinor unit="token"> MeasureType (decimal) </WeightMinor>
        </CalculatedShippingRate>
        <ChangePaymentInstructions> boolean </ChangePaymentInstructions>
        <CODCost> AmountType (double) </CODCost>
        <ExcludeShipToLocation> string </ExcludeShipToLocation>
        <!-- ... more ExcludeShipToLocation nodes here ... -->
        <GetItFast> boolean </GetItFast>
        <InsuranceFee> AmountType (double) </InsuranceFee>
        <InsuranceOption> InsuranceOptionCodeType </InsuranceOption>
        <InsuranceWanted> boolean </InsuranceWanted>
        <PaymentEdited> boolean </PaymentEdited>
        <PaymentInstructions> string </PaymentInstructions>
        <SalesTax> SalesTaxType 
          <SalesTaxAmount> AmountType (double) </SalesTaxAmount>
          <SalesTaxPercent> float </SalesTaxPercent>
          <SalesTaxState> string </SalesTaxState>
          <ShippingIncludedInTax> boolean </ShippingIncludedInTax>
        </SalesTax>
        <SellingManagerSalesRecordNumber> int </SellingManagerSalesRecordNumber>
        <ShipmentTrackingDetails> ShipmentTrackingDetailsType 
          <ShipmentTrackingNumber> string </ShipmentTrackingNumber>
          <ShippingCarrierUsed> string </ShippingCarrierUsed>
        </ShipmentTrackingDetails>
        <!-- ... more ShipmentTrackingDetails nodes here ... -->
        <ShippingRateErrorMessage> string </ShippingRateErrorMessage>
        <ShippingRateType> ShippingRateTypeCodeType </ShippingRateType>
        <ShippingServiceUsed> token </ShippingServiceUsed>
        <ShippingType> ShippingTypeCodeType </ShippingType>
        <TaxTable> TaxTableType 
          <TaxJurisdiction> TaxJurisdictionType 
            <JurisdictionID> string </JurisdictionID>
            <SalesTaxPercent> float </SalesTaxPercent>
            <ShippingIncludedInTax> boolean </ShippingIncludedInTax>
          </TaxJurisdiction>
          <!-- ... more TaxJurisdiction nodes here ... -->
        </TaxTable>
        <ThirdPartyCheckout> boolean </ThirdPartyCheckout>
      </ShippingDetails>
      <ShippingServiceSelected> ShippingServiceOptionsType 
        <ExpeditedService> boolean </ExpeditedService>
        <ShippingInsuranceCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingInsuranceCost>
        <ShippingService> token </ShippingService>
        <ShippingServiceAdditionalCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceAdditionalCost>
        <ShippingServiceCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceCost>
        <ShippingServicePriority> int </ShippingServicePriority>
        <ShippingSurcharge currencyID="CurrencyCodeType"> AmountType (double) </ShippingSurcharge>
        <ShippingTimeMax> int </ShippingTimeMax>
        <ShippingTimeMin> int </ShippingTimeMin>
      </ShippingServiceSelected>
      <Status> TransactionStatusType 
        <BuyerSelectedShipping> boolean </BuyerSelectedShipping>
        <CheckoutStatus> CheckoutStatusCodeType </CheckoutStatus>
        <CompleteStatus> CompleteStatusCodeType </CompleteStatus>
        <eBayPaymentStatus> PaymentStatusCodeType </eBayPaymentStatus>
        <IntegratedMerchantCreditCardEnabled> boolean </IntegratedMerchantCreditCardEnabled>
        <LastTimeModified> dateTime </LastTimeModified>
        <PaymentHoldStatus> PaymentHoldStatusCodeType </PaymentHoldStatus>
        <PaymentMethodUsed> BuyerPaymentMethodCodeType </PaymentMethodUsed>
      </Status>
      <TransactionID> string </TransactionID>
      <TransactionPrice> AmountType (double) </TransactionPrice>
      <TransactionSiteID> SiteCodeType </TransactionSiteID>
      <Variation> VariationType 
        <SKU> SKUType (string) </SKU>
        <VariationSpecifics> NameValueListArrayType 
          <NameValueList> NameValueListType 
            <Name> string </Name>
            <Value> string </Value>
            <!-- ... more Value nodes here ... -->
          </NameValueList>
          <!-- ... more NameValueList nodes here ... -->
        </VariationSpecifics>
        <VariationTitle> string </VariationTitle>
        <VariationViewItemURL> anyURI </VariationViewItemURL>
      </Variation>
    </Transaction>
    <!-- ... more Transaction nodes here ... -->
  </TransactionArray>
  <TransactionsPerPage> int </TransactionsPerPage>
</GetSellerTransactionsResponse>
Return Value Type Occurrence Meaning
Standard Output Fields   [Jump to call-specific fields]
Ack AckCodeType 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 Ack.

Applicable values:

•   CustomCode

(out) Reserved for internal or future use.

•   Failure

(out) Request processing failed

•   Success

(out) Request processing succeeded

•   Warning

(out) Request processing completed with warning information being included in the response message


(Not all values in AckCodeType apply to this field.)
Build string 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.
CorrelationID string Conditionally In most cases, all calls support a MessageID element in the request and a CorrelationID element in the response. If you pass a message ID in a request, we will return the same value in CorrelationID in the response. You can use this for tracking that a response is returned for every request and to match particular responses to particular requests. If you do not pass MessageID in the request, CorrelationID is not returned.

Note: GetCategories, GetAttributesCS, GetCategory2CS, GetAttributesXSL, GetProductFinder, GetProductFinderXSL, and GetProductSearchPage 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, 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.
Errors ErrorType Conditionally,
repeatable: [0..*]		 A list of application-level errors (if any) that occurred when eBay processed the request.

See Error Handling.
Errors.ErrorClassification ErrorClassificationCodeType Conditionally API errors are divided between two classes: system errors and request errors.

Applicable values:

•   CustomCode

(out) Reserved for internal or future use.

•   RequestError

(out) 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.

•   SystemError

(out) 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.
Errors.ErrorCode token 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.
Errors.ErrorParameters ErrorParameterType Conditionally,
repeatable: [0..*]		 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.
Errors.ErrorParameters
  [ attribute ParamID ]		 string Conditionally The index of the parameter in the list of parameter types returned within the error type.
Errors.ErrorParameters.Value string Conditionally The value of the variable (e.g., the attribute set ID)
Errors.LongMessage string Conditionally A more detailed description of the condition that raised the error.
Errors.SeverityCode SeverityCodeType 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.

Applicable values:

•   CustomCode

(out) Reserved for internal or future use

•   Error

(out) Application-level error

•   Warning

(out) Warning or informational error
Errors.ShortMessage string Conditionally A brief description of the condition that raised the error.
HardExpirationWarning string Conditionally 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.
Timestamp dateTime Always 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 Time Values in the eBay Web Services guide for information about this time format and converting to and from the GMT time zone.

Note: GetCategories, GetAttributesCS, GetCategory2CS, GetAttributesXSL, GetProductFinder, GetProductFinderXSL, and GetProductSearchPage 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.
Version string Always The version of the response payload schema. Indicates the version of the schema that eBay used to process the request. See "Standard Data for All Calls" in the eBay Web Services Guide for information on using the response version when troubleshooting "CustomCode" values that appear in the response.
Call-specific Output Fields
HasMoreTransactions boolean Always Indicates whether there are additional transactions to retrieve. That is, indicates whether more pages of data are available to be returned, given the filters that were specified in the request. Returns false for the last page of data.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
PageNumber int Always Page number for the page of transactions the response returned.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
PaginationResult PaginationResultType Always Contains the total number of pages (TotalNumberOfPages) and the total number of entries (TotalNumberOfEntries) that could be returned given repeated calls that use the same selection criteria as the call that returned this response.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
PaginationResult
  .TotalNumberOfEntries 		int Always Indicates the total number of entries that could be returned by repeated requests. For GetOrders, not applicable to eBay.com (for GetOrders, applicable to Half.com). Returned with a value of 0 if no entries are available.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
PaginationResult
  .TotalNumberOfPages 		int Always Indicates the total number of pages of data that could be returned by repeated requests. For GetOrders, not applicable to eBay.com (for GetOrders, applicable to Half.com). Returned with a value of 0 if no pages are available.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
PayPalPreferred boolean Always Indicates whether the seller has the preference enabled that shows that the seller prefers PayPal as the method of payment for an item. This preference is indicated on an item's View Item page and is intended to influence a buyer to use PayPal to pay for the item.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
ReturnedTransactionCountActual int Always Number of transactions retrieved in the current page of results just returned. May be a lower value than TransactionsPerPage if the page returned is the last page and more than one page of data exists.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
Seller UserType Always Contains information about the seller whose transactions are being returned. See the reference guide for information about the fields of the Seller object that are returned.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.AboutMePage boolean Always If true, indicates that the user has set up an About Me page.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.CharityAffiliations CharityAffiliationsType Conditionally Contains information about the seller's charity affliations. Returned if the user is affiliated with one or more charities. Seller must be registered with the eBay Giving Works provider to be affiliated with a charity non-profit organization.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See eBay Giving Works Program.
Seller.CharityAffiliations
  .CharityID 		CharityIDType (string) Conditionally,
repeatable: [0..*]		 Indicates the affiliation status for nonprofit charity organizations registered with the dedicated eBay Giving Works provider.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.eBayGoodStanding boolean Always If true, indicates that the user is in good standing with eBay.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.EIASToken string 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.

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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
Seller.Email string Always Email address for the user. You cannot retrieve an email address for any user with whom you do not have a transactional relationship, regardless of site. Email is only returned for applicable calls when you are retrieving your own user data OR when you and the other user are in a transactional relationship and the call is being executed within a certain amount of time after the transaction is created. 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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
Seller.FeedbackPrivate boolean Always Indicates whether the user has chosen to make their feedback score and feedback details private (hidden from other users). Note that the percentage of positive feedback can still be returned, even if other feedback details are private. In GetSearchResults and GetCategoryListings, feedback information is only returned if IncludeFeedback = true in the request.

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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
Seller.FeedbackRatingStar FeedbackRatingStarCodeType Always Visual indicator of user's feedback score. See FeedbackRatingStarCodeType for specific values.

Applicable values:

•   Blue

(out) Blue Star, feedback score 50-99.

•   CustomCode

(out) Reserved for internal or future use.

•   Green

(out) Green Star, feedback score 5,000-9,999.

•   GreenShooting

(out) Green Shooting Star, feedback score 500,000-999,999.

•   None

(out) No graphic displayed, feedback score 0-9.

•   Purple

(out) Purple Star, feedback score 500-999.

•   PurpleShooting

(out) Purple Shooting Star, feedback score 50,000-99,999.

•   Red

(out) Red Star, feedback score 1,000-4,999

•   RedShooting

(out) Red Shooting Star, feedback score 100,000-499,999.

•   SilverShooting

(out) Silver Shooting Star, feedback score 1,000,000 and above.

•   Turquoise

(out) Turquoise Star, feedback score 100-499.

•   TurquoiseShooting

(out) Turquoise Shooting Star, feedback score 25,000-49,999.

•   Yellow

(out) Yellow Star, feedback score 10-49.

•   YellowShooting

(out) Yellow Shooting Star, feedback score 10,000-24,999.




DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.FeedbackScore int Always 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 transactions. Each transaction 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 true.

In GetSearchResults and GetCategoryListings, feedback information is only returned if IncludeFeedback = true in the request.
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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
Seller.IDVerified boolean Always Indicates whether the user has been verified. For more information about the ID Verify program, see: http://pages.ebay.com/help/policies/identity-idverify.html

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.NewUser boolean Always If true, identifies a new user who has been a registered eBay user for 30 days or less. Always false after the user has been registered for more than 30 days. Does not indicate an ID change (see UserIdChanged).

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.PositiveFeedbackPercent float 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. In GetSearchResults and GetCategoryListings, feedback information is only returned if IncludeFeedback = true in the request.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.RegistrationDate dateTime Always 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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
Seller.SellerInfo SellerType Always Contains information about the user as a seller, such as whether the seller is authorized to list Live Auction items or opts to have items cross-promoted.

This field is replaced by the SellerBusinessType field if the user is a business seller with a site ID of 77 (Germany), 3 (UK), 205 (Ireland) or 100 (Motors).

See SellerType or SellerBusinessCodeType for the child elements.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.SellerInfo
  .AllowPaymentEdit 		boolean Always 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.)

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.SellerInfo
  .CheckoutEnabled 		boolean Always Indicates whether the user as a seller has the option set to default new item listings to go through checkout. (Sellers enable this property in their My eBay user preferences on the eBay site.)

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.SellerInfo
  .CIPBankAccountStored 		boolean Always If true, indicates that the user has stored bank account information with eBay in order to use the "CIP in checkout" feature. Applicable to all eBay sites that support CIP as a payment method.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.SellerInfo.GoodStanding boolean 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.)

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.SellerInfo
  .MerchandizingPref 		MerchandizingPrefCodeType Always Indicates whether the seller participates in the Merchandising Manager feature. If so, the seller can set up rules for cross-promoting items from the seller's store. If not, eBay cross-promotes items as the seller's items are being viewed or purchased.

Applicable values:

•   CustomCode

(out) Reserved for internal or future use.

•   OptIn

(out) Seller allows item cross-promotion.

•   OptOut

(out) Seller does not allow item cross-promotion.




DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.SellerInfo
  .QualifiesForB2BVAT 		boolean Always Indicates whether the user is subject to VAT. Users who have registered with eBay as VAT-exempt are not subject to VAT.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.SellerInfo
  .SafePaymentExempt 		boolean Always If true, the user is currently exempt from the requirement to offer at least one safe payment method (PayPal/PaisaPay or one of the credit cards specified in Item.PaymentMethods) when listing items. This value should only return true for sellers who registered before January 17, 2007. Otherwise, it should return false. This setting overrides both the site and category values for SafePaymentRequired.
Default: false.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.SellerInfo
  .SellerGuaranteeLevel 		SellerGuaranteeLevelCodeType Conditionally Maximum level of Motor's Seller guarantee the seller is authorized to offer.

Applicable values:

•   CustomCode

(out) Reserved for internal or future use.

•   NotEligible

(out) Not eligible for Seller Level Guarantee

•   Premium

(out) Premium eligibility level

•   Regular

(out) Regular eligibility level

•   Ultra

(out) Ultra eligibility level




DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.SellerInfo.SellerLevel SellerLevelCodeType Always The user's eBay PowerSeller tier. Possible values are enumerated in the SellerLevelCodeType code list.

Applicable values:

•   Bronze

(out) Bronze (lowest tier)

•   CustomCode

(out) Reserved for internal or future use

•   Gold

(out) Gold (between Silver and Platinum)

•   None

(out) 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.)

•   Platinum

(out) Platinum (between Gold and Titanium)

•   Silver

(out) Silver (between Bronze and Gold)

•   Titanium

(out) Titanium (highest tier)




DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.SellerInfo.StoreOwner boolean Always Indicates whether the user has an eBay Store (boolean value).

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.SellerInfo.StoreURL anyURI Always URL for the user's eBay Store, if the user is a Store owner. Blank if not.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.SellerInfo
  .TopRatedSeller 		boolean Conditionally Coming soon. Whether seller is certified as a Top-Rated Seller, and is qualified for benefits such as final value fee discount and increased visibility in fixed-price searches. Returned when seller is a Top-Rated Seller.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.Site SiteCodeType Always 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.

Applicable values: See Site.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
Seller.Status UserStatusCodeType Always Indicates the user's registration/user status.

Applicable values:

•   AccountOnHold

(out) User's account is on hold, such as for non-payment of amounts due eBay; user cannot sell or buy items

•   Confirmed

(out) User has completed online registration and has properly responded to confirmation email; most users should fall in this category

•   CreditCardVerify

(out) User has completed registration and confirmation, but is pending a verification of credit card information

•   CreditCardVerifyHalfOptIn

(out) User has completed the registration for Half.com and opted to automatically also be registered with eBay, but the verification of credit card information is still pending

•   CustomCode

(out) Reserved for internal or future use

•   Deleted

(out) Records for the specified user have been deleted

•   Ghost

(out) Registered users of AuctionWeb (pre-eBay) who never re-registered on eBay

•   Guest

(out) 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.

•   InMaintenance

(out) Temporary user record state indicating the record is in the process of being changed by eBay; query user information again to get new status

•   Merged

(out) User record has been merged with another account record for the same user

•   RegistrationCodeMailOut

(out) User has completed online registration and has been sent the confirmation email, but has not yet responded to the confirmation email

•   Suspended

(out) User has been suspended from selling and buying, such as for violations of eBay terms or agreement

•   TermPending

(out) User has been scheduled for account closure (typically when a user has requested to have their account closed) A user in this state should not be considered an active user

•   Unconfirmed

(out) User has completed online registration, but has either not responded to confirmation email or has not yet been sent the confirmation email

•   UnconfirmedExpress

Deprecated as of version 579.
(out) Half.com User; user has completed the registration for Half.com and opted to automatically also be registered with eBay, but the registration confirmation is still pending
Deprecation version: 579. See also Deprecated Objects.

•   UnconfirmedHalfOptIn

(out) User has completed the registration for Half.com and opted to automatically also be registered with eBay, but the registration confirmation is still pending

•   Unknown

(out) User properties have never been set; this value should seldom, if ever, be returned and typically represents a problem


(Not all values in UserStatusCodeType apply to this field.)


DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
Seller.UserID UserIDType (string) Always 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 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.

For 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 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".

For GetMyeBayBuying only, when bidding on items listed on the UK and AU sites: UserID is replaced with the string "High Bidder".

Note that when IncludeFeedback is true in a GetSearchResults request, the response contains the seller's User ID. Please note that a seller's UserID is not anonymized.

For PlaceOffer, see also SellingStatus.HighBidder.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
Seller.UserIDChanged boolean Always If true, 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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
Seller.UserIDLastChanged dateTime Always 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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
Seller.VATStatus VATStatusCodeType Always 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).

Applicable values:

•   CustomCode

(out) Reserved for internal or future use

•   NoVATTax

(out) VAT is not applicable

•   VATExempt

(out) Residence in a country with VAT and user is registered as VAT-exempt

•   VATTax

(out) Residence in a country with VAT and user is not registered as VAT-exempt




DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See VAT-exempt Sellers.
TransactionArray TransactionArrayType Conditionally List of Transaction objects representing the seller's recent sales. Each Transaction object contains the data for one purchase (of one or more items in the same listing). See the reference guide for more information about the fields that are returned for each transaction.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction TransactionType Conditionally,
repeatable: [0..*]		 Information about one transaction. Also applicable to Half.com (for GetOrders).

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Combined Payment.
TransactionArray.Transaction
  .AdjustmentAmount 		AmountType (double) Conditionally Adjustment amount entered by the buyer. 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.

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .AmountPaid 		AmountType (double) Conditionally The amount the buyer paid for the item(s) in the transaction. If the seller allowed the buyer to change the item total, the buyer is able to change the total until the time that the transaction's status moves to Complete. Determine whether the buyer changed the amount by retrieving the transaction data and comparing the AmountPaid value to what the seller expected. For combined payment (the transaction is part of an order), GetSellerTransactions and GetItemTransactions return the amount paid for the order to which the transaction belongs. For Motors items, AmountPaid is the amount paid by the buyer for the deposit.

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .BestOfferSale 		boolean Conditionally Whether the transaction was completed with the seller selecting a best offer.

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer 		UserType Conditionally Contains the data for the transaction's buyer. See UserType for its child elements. Returned by GetItemsAwaitingFeedback if Seller is making the request.

Applicable to Half.com (for GetOrders only).

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.AboutMePage 		boolean Conditionally If true, indicates that the user has set up an About Me page.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.BuyerInfo 		BuyerType Conditionally 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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
TransactionArray.Transaction
  .Buyer.BuyerInfo
  .ShippingAddress 		AddressType Conditionally Contains the address of the buyer in the transaction, to which the seller would ship the item(s). See AddressType for its child elements. GetAllBidders is returning only Country and PostalCode currently. Output only.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.BuyerInfo
  .ShippingAddress.CityName 		string Conditionally The name of the user's city. Also applicable to Half.com (for GetOrders).
Max length: 64.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.BuyerInfo
  .ShippingAddress.Country 		CountryCodeType Conditionally The country code of the user.

If not provided as input for GetCart or SetCart, eBay uses the country associated with the SiteID in effect when the call is made.

Also applicable to Half.com (for GetOrders).

Applicable values: See Country.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.BuyerInfo
  .ShippingAddress.CountryName 		string Conditionally The name of the user's country. Also applicable to Half.com (for GetOrders).

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.BuyerInfo
  .ShippingAddress
  .ExternalAddressID 		string Conditionally ID assigned to the address by the owner of the address (fitting only if the address is owned by PayPal; see AddressOwner). Also applicable to Half.com (for GetOrders).
Max length: 20.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.BuyerInfo
  .ShippingAddress.Name 		string Conditionally User's name for the address. Also applicable to Half.com (for GetOrders).
Max length: 64.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.BuyerInfo
  .ShippingAddress.Phone 		string Conditionally User's primary phone number. This may return a value of "Invalid Request" if you are not authorized to see the user's phone number. Also applicable to Half.com (for GetOrders).

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.BuyerInfo
  .ShippingAddress.PostalCode 		string Conditionally User's postal code.

If not provided as input for GetCart or SetCart, eBay uses the country associated with the SiteID in effect when the call is made.

Also applicable to Half.com (for GetOrders).
Max length: 12.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.BuyerInfo
  .ShippingAddress
  .StateOrProvince 		string Conditionally The region of the user's address. Also applicable to Half.com (for GetOrders).
Max length: 64.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.BuyerInfo
  .ShippingAddress.Street 		string Conditionally A concatenation of Street1 and Street2, primarily for RegistrationAddress. Not applicable to Half.com.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.BuyerInfo
  .ShippingAddress.Street1 		string Conditionally Line 1 of the user's street address. Also applicable to Half.com (for GetOrders).
Max length: 100.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.BuyerInfo
  .ShippingAddress.Street2 		string Conditionally Line 2 of the user's address (such as an apartment number). Returned if the user specified a second street value for their address. Also applicable to Half.com (for GetOrders).
In case of Item.SellerContactDetails, Street2 can be used to provide City, Address, State, and Zip code (if applicable).
Max length: 100.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.CharityAffiliations 		CharityAffiliationsType Conditionally Contains information about the seller's charity affliations. Returned if the user is affiliated with one or more charities. Seller must be registered with the eBay Giving Works provider to be affiliated with a charity non-profit organization.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See eBay Giving Works Program.
TransactionArray.Transaction
  .Buyer.CharityAffiliations
  .CharityID 		CharityIDType (string) Conditionally,
repeatable: [0..*]		 Indicates the affiliation status for nonprofit charity organizations registered with the dedicated eBay Giving Works provider.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.eBayGoodStanding 		boolean Conditionally If true, indicates that the user is in good standing with eBay.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.EIASToken 		string 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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
TransactionArray.Transaction
  .Buyer.Email 		string Conditionally Email address for the user. You cannot retrieve an email address for any user with whom you do not have a transactional relationship, regardless of site. Email is only returned for applicable calls when you are retrieving your own user data OR when you and the other user are in a transactional relationship and the call is being executed within a certain amount of time after the transaction is created. 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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
TransactionArray.Transaction
  .Buyer.FeedbackPrivate 		boolean Conditionally Indicates whether the user has chosen to make their feedback score and feedback details private (hidden from other users). Note that the percentage of positive feedback can still be returned, even if other feedback details are private. In GetSearchResults and GetCategoryListings, feedback information is only returned if IncludeFeedback = true in the request.

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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
TransactionArray.Transaction
  .Buyer.FeedbackRatingStar 		FeedbackRatingStarCodeType Conditionally Visual indicator of user's feedback score. See FeedbackRatingStarCodeType for specific values.

Applicable values:

•   Blue

(out) Blue Star, feedback score 50-99.

•   CustomCode

(out) Reserved for internal or future use.

•   Green

(out) Green Star, feedback score 5,000-9,999.

•   GreenShooting

(out) Green Shooting Star, feedback score 500,000-999,999.

•   None

(out) No graphic displayed, feedback score 0-9.

•   Purple

(out) Purple Star, feedback score 500-999.

•   PurpleShooting

(out) Purple Shooting Star, feedback score 50,000-99,999.

•   Red

(out) Red Star, feedback score 1,000-4,999

•   RedShooting

(out) Red Shooting Star, feedback score 100,000-499,999.

•   SilverShooting

(out) Silver Shooting Star, feedback score 1,000,000 and above.

•   Turquoise

(out) Turquoise Star, feedback score 100-499.

•   TurquoiseShooting

(out) Turquoise Shooting Star, feedback score 25,000-49,999.

•   Yellow

(out) Yellow Star, feedback score 10-49.

•   YellowShooting

(out) Yellow Shooting Star, feedback score 10,000-24,999.




DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.FeedbackScore 		int 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 transactions. Each transaction 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 true.

In GetSearchResults and GetCategoryListings, feedback information is only returned if IncludeFeedback = true in the request.
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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
TransactionArray.Transaction
  .Buyer.IDVerified 		boolean Conditionally Indicates whether the user has been verified. For more information about the ID Verify program, see: http://pages.ebay.com/help/policies/identity-idverify.html

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.NewUser 		boolean Conditionally If true, identifies a new user who has been a registered eBay user for 30 days or less. Always false after the user has been registered for more than 30 days. Does not indicate an ID change (see UserIdChanged).

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.PositiveFeedbackPercent 		float 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. In GetSearchResults and GetCategoryListings, feedback information is only returned if IncludeFeedback = true in the request.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.RegistrationDate 		dateTime 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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
TransactionArray.Transaction
  .Buyer.Site 		SiteCodeType Conditionally 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.

Applicable values: See Site.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
TransactionArray.Transaction
  .Buyer.Status 		UserStatusCodeType Conditionally Indicates the user's registration/user status.

Applicable values:

•   AccountOnHold

(out) User's account is on hold, such as for non-payment of amounts due eBay; user cannot sell or buy items

•   Confirmed

(out) User has completed online registration and has properly responded to confirmation email; most users should fall in this category

•   CreditCardVerify

(out) User has completed registration and confirmation, but is pending a verification of credit card information

•   CreditCardVerifyHalfOptIn

(out) User has completed the registration for Half.com and opted to automatically also be registered with eBay, but the verification of credit card information is still pending

•   CustomCode

(out) Reserved for internal or future use

•   Deleted

(out) Records for the specified user have been deleted

•   Ghost

(out) Registered users of AuctionWeb (pre-eBay) who never re-registered on eBay

•   Guest

(out) 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.

•   InMaintenance

(out) Temporary user record state indicating the record is in the process of being changed by eBay; query user information again to get new status

•   Merged

(out) User record has been merged with another account record for the same user

•   RegistrationCodeMailOut

(out) User has completed online registration and has been sent the confirmation email, but has not yet responded to the confirmation email

•   Suspended

(out) User has been suspended from selling and buying, such as for violations of eBay terms or agreement

•   TermPending

(out) User has been scheduled for account closure (typically when a user has requested to have their account closed) A user in this state should not be considered an active user

•   Unconfirmed

(out) User has completed online registration, but has either not responded to confirmation email or has not yet been sent the confirmation email

•   UnconfirmedExpress

Deprecated as of version 579.
(out) Half.com User; user has completed the registration for Half.com and opted to automatically also be registered with eBay, but the registration confirmation is still pending
Deprecation version: 579. See also Deprecated Objects.

•   UnconfirmedHalfOptIn

(out) User has completed the registration for Half.com and opted to automatically also be registered with eBay, but the registration confirmation is still pending

•   Unknown

(out) User properties have never been set; this value should seldom, if ever, be returned and typically represents a problem


(Not all values in UserStatusCodeType apply to this field.)


DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Buyer.UserID 		UserIDType (string) 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 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.

For 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 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".

For GetMyeBayBuying only, when bidding on items listed on the UK and AU sites: UserID is replaced with the string "High Bidder".

Note that when IncludeFeedback is true in a GetSearchResults request, the response contains the seller's User ID. Please note that a seller's UserID is not anonymized.

For PlaceOffer, see also SellingStatus.HighBidder.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
TransactionArray.Transaction
  .Buyer.UserIDChanged 		boolean Conditionally If true, 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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
TransactionArray.Transaction
  .Buyer.UserIDLastChanged 		dateTime Conditionally 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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Working with Anonymous User Information.
TransactionArray.Transaction
  .Buyer.VATStatus 		VATStatusCodeType Conditionally 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).

Applicable values:

•   CustomCode

(out) Reserved for internal or future use

•   NoVATTax

(out) VAT is not applicable

•   VATExempt

(out) Residence in a country with VAT and user is registered as VAT-exempt

•   VATTax

(out) Residence in a country with VAT and user is not registered as VAT-exempt




DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See VAT-exempt Sellers.
TransactionArray.Transaction
  .BuyerCheckoutMessage 		string Conditionally The Comment left by buyer during checkout.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .BuyerGuaranteePrice 		AmountType (double) Conditionally For the Australia site, BuyerGuaranteePrice is the PayPal Buyer Protection coverage, offered for the item at the time of purchase. Details of coverage are in the following sections of the View Item page: the Buy Safely section and the Payment Details section.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .CartID 		string Conditionally Shopping cart identifier. Only returned for transactions made on Shopping.com using the Shopping.com shopping cart.
Max length: 10.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ContainingOrder 		OrderType Conditionally The order to which the transaction belongs. This is only returned if IncludeContainingOrder is true and and if this transaction is part of an active or completed order.

Not applicable to Half.com.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ContainingOrder
  .CreatingUserRole 		TradingRoleCodeType Conditionally Indicates whether the order is created by the buyer or by the seller.

Applicable values:

•   Buyer

(in/out) Acting as buyer.

•   CustomCode

(in/out) Reserved for future use.

•   Seller

(in/out) Acting as seller. For GetOrders, you can use this value to limit orders to those where the calling user is the seller.




DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ContainingOrder
  .IntegratedMerchantCreditCardEnabled 		boolean Conditionally Indicates whether the item can be paid for through a payment gateway (Payflow) account. If IntegratedMerchantCreditCardEnabled is true, then integrated merchant credit card (IMCC) is enabled for credit cards because the seller has a payment gateway account. Therefore, if IntegratedMerchantCreditCardEnabled is true, and AmEx, Discover, or VisaMC is returned for an item, then on checkout, an online credit-card payment is processed through a payment gateway account.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ContainingOrder.OrderID 		OrderIDType (string) Conditionally Unique identifier that eBay generates for the order.

For calls like GetItemTransactions (and the Checkout notification), no OrderID will appear when only 1 item is purchased in a single end-to-end checkout flow (because the transaction would not be part of an order in this case).

Also applicable to Half.com (for GetOrders).

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ContainingOrder.OrderStatus 		OrderStatusCodeType Conditionally The current status of the order.

Also applicable to Half.com (for GetOrders).

Applicable values:

•   Active

(in/out) The cart is active. Items can only be added, deleted, or updated in the cart when status is Active.

•   Authenticated

(out) The cart was authenticated.

•   Cancelled

(out) The cart was cancelled.

•   Completed

(in/out) The order is completed.

•   CustomCode

(out) Reserved for internal or future use.

•   Default

(out) Default status.

•   Inactive

(out) The cart is invalid; it does not exist. An example is a cart that has expired.

•   InProcess

(out) After placing the order and before completion of checkout, the card is "in process."

•   Invalid

(out) Invalid.

•   Shipped

(in/out) The order was shipped. Half.com users can specify this in the GetOrders input.




DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ConvertedAdjustmentAmount 		AmountType (double) Conditionally 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.

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ConvertedAmountPaid 		AmountType (double) Conditionally 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.

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ConvertedTransactionPrice 		AmountType (double) Conditionally 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.

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .CreatedDate 		dateTime Conditionally Indicates when the transaction was created. For fixed-price, Stores, and BIN items this indicates when the purchase (or BIN) occurred. For competitive-bid item listing types this indicates when listing ended, the winning bidder(s) determined, and the transaction created.

Applicable to Half.com (for GetOrders only).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .DepositType 		DepositTypeCodeType Conditionally Whether the seller requires a deposit for the vehicle. Only applicable to US eBay Motors listings. If item is not a Motors item, then this returns an empty value.

Not applicable to Half.com.

Applicable values:

•   None

(out) No deposit needed.

•   OtherMethod

(out) Pay the deposit using PayPal, and then use any of the other specified payment methods to pay the balance.


(Not all values in DepositTypeCodeType apply to this field.)


DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See Specifying a Vehicle Deposit and Deposit Amount.
TransactionArray.Transaction
  .ExternalTransaction 		ExternalTransactionType Conditionally,
repeatable: [0..*]		 A PayPal transaction that relates to this eBay transaction. Returned only if there is at least one PayPal transaction related to this eBay transaction.

Not applicable to Half.com.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .ExternalTransaction
  .ExternalTransactionID 		string Conditionally Unique payment transaction ID.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .ExternalTransaction
  .ExternalTransactionTime 		dateTime Conditionally Date on which transaction occurs.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .ExternalTransaction
  .FeeOrCreditAmount 		AmountType (double) Conditionally

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .ExternalTransaction
  .PaymentOrRefundAmount 		AmountType (double) Conditionally If positive, the amount the buyer pays the seller through PayPal on the purchase of items. If negative, the amount refunded the buyer. Default = 0.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .FinalValueFee 		AmountType (double) Conditionally You are charged a Final Value Fee (FVF) if your item is sold, ends with a winning bid, or is purchased. This fee applies whether or not you actually complete the sale with the buyer. The Final Value Fee is returned in Transaction.FinalValueFee. See the eBay.com Web site online help for more information about the Final Value Fee.

The Final Value Fee for fixed price format (FixedPriceItem) and Store Inventory (StoresFixedPrice) items is returned by GetSellerTransactions, GetItemTransactions, and GetOrderTransactions on a transaction-by-transaction basis, regardless of the listing status. For all other listing types, (excluding Buy It Now purchases), the Final Value Fee is returned when the listing status is Completed.

If you request a Final Value Fee Credit, the value of Transaction.FinalValueFee will not change for the item if a credit is issued. (The credit only appears in the seller's account data.)

Not applicable to Half.com.

If the item was a Dutch auction that ended with bids (not Buy It Now purchases), the Final Value Fee is returned on a transaction-by-transaction basis in Item.SellingStatus.FinalValueFee.

Note: As of version 619, Dutch-style (multi-item) competitive-bid auctions are deprecated. eBay throws an error if you submit a Dutch item listing with AddItem or VerifyAddItem. If you use RelistItem to update a Dutch auction listing, eBay generates a warning and resets the Quantity value to 1.


DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item 		ItemType Always Information about the item that spawned the transaction. It is a purchase from this item's listing that the transaction represents. To remove a property from an item, specify it in ModifyType as a changed property, but do not give it a value in Item.

Applicable to Half.com (for GetOrders).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.ApplicationData 		string Conditionally Returns 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.

Not applicable to Half.com, use SellerInventoryID instead.
Max length: 32.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.ApplyShippingDiscount 		boolean Conditionally Multiple Item Shipping Discount. Seller specifies as input when listing, re-listing, or revising an item to indicate whether a shipping discount is to be applied when the buyer pays for the item in the checkout process and the item's transaction is combined with other transactions into an order. Returned with retrieved item data, indicating a shipping discount is applicable.

Not returned by GetItem (see Item.ShippingDetails.ShippingDiscount instead).

ApplyShippingDiscount can only be used if the user has not set up a shipping discount profile.

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.AutoPay 		boolean Always If true, the seller requests immediate payment for the item. If false or not specified, immediate payment is not requested. (In responses, does not indicate whether the item is actually still a candidate for purchase via immediate payment.)

Only applicable to items listed on PayPal-enabled sites in categories that support immediate payment (see AutoPayEnabled in GetCategories), when seller has a Premier or Business PayPal account (see PayPalAccountType in Getuser). If true, the seller must also accept PayPal as a payment method for the item (see Item.PaymentMethods).

See the eBay Web Services guide section on Immediate Payment for additional requirements and dependencies. Also see the section on working with the eBay Motors site for additional rules.

To create an Immediate Payment listing ThirdPartyCheckout must be true, AutoPay must be true, PayPalEmailAddress must be a valid PayPal email address for the seller, and PaymentMethods must be PayPal. For a non-Immediate Payment listing, if ThirdPartyCheckout is true, AutoPay is not supported.

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See:
    Requiring Immediate Payment
    Requiring Immediate Payment of a Vehicle Deposit

TransactionArray.Transaction
  .Item.BuyerProtection 		BuyerProtectionCodeType Always Indicates the status of the item's eligibility for the PayPal Buyer Protection program.

Not applicable to Half.com.

Applicable values:

•   CustomCode

(out) Reserved for internal or future use.

•   ItemEligible

(out) Item is eligible per standard criteria.

•   ItemIneligible

(out) Item is ineligible (e.g., category not applicable).

•   ItemMarkedEligible

(out) Item marked eligible per other criteria.

•   ItemMarkedIneligible

(out) Item marked ineligible per special criteria (e.g., seller's account closed).

•   NoCoverage

(out) For the Australia site, indicates that there is no PayPal Buyer Protection coverage. Coverage details would be in the following sections of the View Item page: the Buy Safely section and the Payment Details section.




DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See Miscellaneous Item Field Differences.
TransactionArray.Transaction
  .Item.BuyItNowPrice 		AmountType (double) Conditionally For Chinese auction listings, Buy It Now allows a user to purchase the item at a fixed price and end the auction immediately. Use this field to add Buy It Now and specify the amount a buyer would need to bid to take advantage of the Buy It Now feature.

On the main eBay site, not applicable to fixed-price items (ListingType values StoresFixedPrice or FixedPriceItem), AdFormat listings, or Half.com listings. For fixed-price and Half.com listings, see StartPrice instead. See the eBay Web Services Guide for validation rules when revising US eBay Motors listings, including rules for lowering the Buy It Now price of a Motors listing.

Once a Chinese auction has bids (and the high bid exceeds the reserve price, if specified), the listing is no longer eligible for Buy It Now (with some exceptions noted below). However, calls like GetItem and GetSearchResults still return the BuyItNowPrice that the seller originally set for the listing. You can use Item.SellingStatus.BidCount to determine whether an auction with Buy It Now has bids or not. With GetSearchResults, you can use the Item.SearchDetails.BuyItNowEnabled flag to determine whether the item can still be purchased using Buy It Now. With GetItem, you can use the Item.ListingDetails.BuyItNowAvailable flag to determine whether the item can still be purchased using Buy It Now.

On some sites, the Buy It Now price for a Chinese auction may remain available for certain categories even after a bid is placed. See the "Longer Lasting Buy It Now" link below for more details and the latest list of eBay US categories that support this behavior. The eBay Spain site supports this behavior for all categories.

There might be price limits imposed for Buy It Now items, subject to the seller's PayPal account or the payment method used. Such limits cannot be determined via the eBay API and are not covered in eBay's API documentation because they can vary for each user.

To remove this value when revising or relisting an item, use DeletedField.

DetailLevel: ReturnAll.

See:
    Longer Lasting Buy It Now
    Revising US eBay Motors Listings

TransactionArray.Transaction
  .Item.Charity 		CharityType Conditionally Identifies a Giving Works listing and the benefiting nonprofit charity organization selected by the charity seller, if any. If specified, the seller must also accept PayPal as a payment method for the item (see Item.PaymentMethods).

When you revise an item, you can add a charity to a non-charity listing, but you cannot remove or change the charity designation. The rules for adding a charity to a listing depend on the listing type. For an auction listing, you can revise an item to add a charity if there are more than 12 hours left for the listing (whether or not the item has bids). For a fixed-price listing, you can revise an item to add a charity if there are more than 12 hours left for the listing, and the item has not been sold. For a Store Inventory listing, you can revise an item to add a charity if the item has not been sold. You cannot revise listings to add charity for Ad Format listings.

When you relist an item, use DeletedField to remove charity information.

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See:
    Miscellaneous Item Field Differences
    Identifying Listings that Benefit Nonprofits

TransactionArray.Transaction
  .Item.Charity.CharityListing 		boolean Conditionally If true, indicates that the seller has chosen to use eBay Giving Works to donate a percentage of the item's purchase price to a selected nonprofit organization.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.Country 		CountryCodeType Conditionally Two-letter ISO 3166 country code. In some calls, used with the Location field to indicate the city and country where the item is located. Also applicable as input to AddItem and related calls when you list items to Half.com (specify US).

For English names that correspond to each code (e.g., KY="Cayman Islands"), call GeteBayDetails or see the following ISO site:
http://www.iso.ch/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html

Applicable values: See Country.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.Currency 		CurrencyCodeType Always Currency associated with the item's price information. 3-letter ISO 4217 currency code that corresponds to the site specified in the item-listing request. Also applicable as input to AddItem and related calls when you list items to Half.com (specify USD). You cannot modify a listing's currency when you revise or relist an item.

Applicable values: See Currency.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See Field Differences for eBay Sites.
TransactionArray.Transaction
  .Item.GetItFast 		boolean Conditionally Indicates whether the seller has opted the listing into the Get It Fast feature. If GetItFast is true and if at least one of the domestic shipping services offered by the seller is an expedited shipping service, every shipping service offered by the seller is considered a Get It Fast service, and the seller commits to delivering the item to the buyer-selected shipping service within one day.

Not supported for UK Store Inventory format items.
Not applicable to Half.com.

DetailLevel: ReturnAll.

See:
    Enabling Multi-jurisdiction Sales Tax
    Miscellaneous Item Field Differences

TransactionArray.Transaction
  .Item
  .IntegratedMerchantCreditCardEnabled 		boolean Always Indicates whether the item can be paid for through a payment gateway (Payflow) account. If IntegratedMerchantCreditCardEnabled is true, then integrated merchant credit card (IMCC) is enabled for credit cards because the seller has a payment gateway account. Therefore, if IntegratedMerchantCreditCardEnabled is true, and AmEx, Discover, or VisaMC is returned for an item, then on checkout, an online credit-card payment is processed through a payment gateway account. A payment gateway account is used by sellers to accept online credit cards (Visa, MasterCard, American Express, and Discover).

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.InventoryTrackingMethod 		InventoryTrackingMethodCodeType Conditionally Indicates whether you prefer to track your eBay listings by eBay Item ID or by your own SKU.

Not applicable to Half.com.

Applicable values:

•   CustomCode

(in/out) Reserved for internal or future use

•   ItemID

(in/out) The seller prefers to track the listing by its eBay item ID. This is the default for all listings.

•   SKU

(in/out) The seller prefers to track the listing by their own SKU. When you track by SKU, it means you can pass 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.




DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See eBay Merchant Data API for AddFixedPriceItem and ReviseFixedPriceItem.
TransactionArray.Transaction
  .Item.ItemID 		ItemIDType (string) 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.

Also applicable to Half.com. For Half.com, you can specify either ItemID or SellerInventoryID in a ReviseItem request to uniquely identify the listing.

In transaction calls (e.g., GetItemTransactions), use a combination of ItemID and TransactionID to uniquely identify a transaction. With multi-quantity listings, a single ItemID can be associated with more than one TransactionID. (For single-quantity listings, the TransactionID is 0.)

In GetItemRecommendations, the item ID is required when the value of ListingFlow is ReviseItem or RelistItem, but it is not applicable when the value of ListingFlow is AddItem.

In GetSearchResults, the same ItemID may be returned for multiple results if the results are variations from the same mult-variation listing.

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. eBay will increase the size of IDs over time. Your code should be prepared to handle IDs of up to 19 digits. For more information about item IDs, see Common FAQs on eBay Item IDs and other eBay IDs in the Knowledge Base.
Max length: 19 (Note: the eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.ListingDetails 		ListingDetailsType 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.

Not applicable to Half.com.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingDetails.Adult 		boolean Conditionally If true, 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.)

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingDetails
  .BindingAuction 		boolean Conditionally Applicable for Real Estate auctions only. If true, buyers and sellers are expected to follow through on the sale. If false, bids for the Real Estate auction are only expressions of interest.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingDetails
  .CheckoutEnabled 		boolean Conditionally Indicates whether checkout is enabled for this item. If true, indicates that the seller elects to allow the item purchase to go through the checkout process, if the buyer chooses to do so.

DetailLevel: ReturnAll.

See Checkout.
TransactionArray.Transaction
  .Item.ListingDetails
  .ConvertedBuyItNowPrice 		AmountType (double) 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.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingDetails
  .ConvertedReservePrice 		AmountType (double) Conditionally 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 and Store Inventory listings.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingDetails
  .ConvertedStartPrice 		AmountType (double) Conditionally 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.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingDetails.EndTime 		dateTime 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. In GetSearchResults, for StoresFixedPrice items which are "Good Till Canceled," this value is 5 minutes later than the actual end time of the item. The discrepancy is intended to facilitate renewal every 30 days of such items' end times.

In GetSearchResults, the same EndTime may be returned for multiple results if the results are variations from the same multi-variation listing.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingDetails
  .HasPublicMessages 		boolean 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.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingDetails
  .HasReservePrice 		boolean Conditionally If true, the seller specified a value in ReservePrice.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingDetails
  .MinimumBestOfferMessage 		string Conditionally Deprecated as of version 547. No longer functional.
Specifies the message sent from the seller to the buyer when a submitted best offer is automatically declined by the seller. A best offer is automatically declined if it does not meet the minimum acceptable best offer price specified by the seller with MinimumBestOfferPrice. Applies only to items listed in categories that support the Best Offer Auto-Decline feature. Best Offer must be enabled for the item. To remove this value when revising or relisting an item, use DeletedField.

DetailLevel: ReturnAll.
Deprecation version: 547. See also Deprecated Objects.
TransactionArray.Transaction
  .Item.ListingDetails
  .MinimumBestOfferPrice 		AmountType (double) Conditionally Specifies the minimum acceptable best offer price. If a buyer submits a best offer that is below this value, the offer is automatically declined by the seller. Applies only to items listed in categories that support the Best Offer Auto-Decline feature. Best Offer must be enabled for the item, and only the seller who listed the item can see this value. To remove this value when revising or relisting an item, use DeletedField.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingDetails
  .RelistedItemID 		ItemIDType (string) Conditionally Indicates the new item ID for a re-listed item. When an item is re-listed, the item ID for the new (re-list) item is added to the old (expired) listing to provide buyers a means to navigate to the new listing. This value only appears when the old listing is retrieved. Output only.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingDetails.StartTime 		dateTime Conditionally The StartTime value returned by non-search calls such as GetItem is the time stamp (in GMT) for when the item was listed. The StartTime value returned by search calls such as GetSearchResults and GetCategoryListings may vary from the value returned by GetItem. The time value is the same value in the following: The StartTime value returned by GetSearchResults, the StartTime value returned by GetCategoryListings, and the time the item became available for search on the eBay site.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingDetails
  .TCROriginalItemID 		ItemIDType (string) 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.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingDetails
  .ViewItemURL 		anyURI 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 eBay Partner Network).

In search results (like the GetSearchResults response), this link to the View Item page is configured to select the applicable variation.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingDetails
  .ViewItemURLForNaturalSearch 		anyURI 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 ?.

In search results (like the GetSearchResults response), if the result is a variation from a multi-variation listing, this link to the View Item page is configured to select the applicable variation.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.ListingType 		ListingTypeCodeType Always The format of the listing the seller wants to use, such as Chinese auction or fixed price.

Optional for eBay.com listings (defaults to Chinese auction) in AddItem and VerifyAddItem. Do not specify ListingType for eBay.com listings in ReviseItem. (You can't modify the listing type of an active eBay listing.

Required for Half.com listings (and the value must be Half) in AddItem, VerifyAddItem, and ReviseItem. If you don't specify Half when revising Half.com listings, ReviseItem won't use the correct logic and you may get strange errors (or unwanted side effects in the listing, even if no errors are returned).

Applicable values:

•   AdType

(in/out) Advertisement to solicit inquiries on listings such as real estate. Permits no bidding on that item, service, or property. To express interest, a buyer fills out a contact form that eBay forwards to the 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.

•   Chinese

(in/out) Single-quantity online auction format. A Chinese auction has a Quantity of 1. Buyers engage in competitive bidding, although Buy It Now may be offered as long as no bids have been placed. Online auctions are listed on eBay.com, and they are also listed in the seller's eBay Store if the seller is a Store owner.

•   CustomCode

(in/out) Reserved for internal or future use.

•   Dutch

Deprecated as of version 611.
(in/out) Multiple-quantity online auction format. A Dutch auction has a Quantity greater than 1. Buyers engage in competitive bidding. Some sites also offer Buy It Now for Dutch auctions. Online auctions are listed on eBay.com, and they are also listed in the seller's eBay Store if the seller is a Store owner.

Note: As of version 619, Dutch-style (multi-item) competitive-bid auctions are deprecated. eBay throws an error if you submit a Dutch item listing with AddItem or VerifyAddItem. If you use RelistItem to update a Dutch auction listing, eBay generates a warning and resets the Quantity value to 1.

Deprecation version: 611. See also Deprecated Objects.

•   Express

Deprecated as of version 561.
(in/out) For Germany only: eBay Express format (item is listed only on eBay Express only, not on eBay). You must be an Express Germany seller to use this format. See "Express Format Criteria" in the eBay Web Services guide. As of late April 2008, this value will no longer work, regardless of the API version you are using.
Deprecation version: 561. See also Deprecated Objects.

•   FixedPriceItem

(in/out) A basic fixed-price item format. Bids do not occur. The quantity of items is one or more. Also known as Buy It Now Only on some sites (not to be confused with the BuyItNow option that is available for Chinese auctions). Sellers must meet certain feedback requirements and/or be ID Verified to use this format. See Minimum Feedback Requirements for Various Features in the Trading Web Services guide. Fixed-price listings are listed on eBay.com, and they are listed in the seller's eBay Store if the seller is a Store owner. Stores fixed price items will be treated as basic fixed-price items. Permitted durations of 30 days and GTC are now available for store and non-store subscribers (in addition to the existing durations of 3, 5, 7, and 10 days). Use the GetCategoryFeatures call to determine if a particular site has adopted this method. The release notes will also contain much of this information.

•   LeadGeneration

(in/out) Lead Generation format (advertisement-style listing to solicit inquiries or offers, no bidding or fixed price, listed on eBay).

•   Live

Deprecated as of version 601.
(out) Live auction, on-site auction that can include non-eBay bidders. (Use AddLiveAuctionItem to list live auctions.) Live auctions are listed on the eBay Live Auctions site, in live auction categories. They can also appear on eBay if the seller lists the lot in a secondary category that is an eBay category.
Deprecation version: 601. See also Deprecated Objects.

•   PersonalOffer

(out) 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.

•   StoresFixedPrice

(in/out) A fixed-price format for eBay Store sellers. Store Inventory listings appear after other listings in regular browse and search item lists on eBay. They have a lower Insertion Fee and longer listing durations. Only available to sellers who have an eBay Store. Store Inventory listings are listed on eBay.com, and they are also listed in the seller's eBay Store. Stores fixed price items will be treated as basic fixed-price items; please see the documentation for FixedPriceItem (that is, for the basic fixed-price item format). Use the GetCategoryFeatures call to determine if a particular site has adopted this method. The release notes will also contain much of this information.


(Not all values in ListingTypeCodeType apply to this field.)


DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See:
    Different Ways of Selling
    Listing Types (Formats)
    GetCategoryFeatures
    Fees per Site

TransactionArray.Transaction
  .Item.LotSize 		int Conditionally A lot is a set of two or more similar items that must be purchased together in a single transaction. A listing can have multiple lots (instead of multiple items). When LotSize is specified, the listing price reflects the price of each lot (not each item within the lot). In this case, Quantity indicates the number of lots being listed, and LotSize indicates the number of items in each lot. (If a listing has no lots, Quantity indicates the number of separate items being listed.) Important: Lot items can be listed only in lot-enabled categories. GetCategories returns LSD (lot size disabled) with a value of true for categories that do not support lots.

Not applicable to Half.com.
Max: 100000.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.PaymentMethods 		BuyerPaymentMethodCodeType Always,
repeatable: [1..*]		 Identifies the payment method (such as PayPal) that the seller will accept when the buyer pays for the item.

Use GetCategoryFeatures to determine the payment methods that are allowed for a category on a site. For example, the response data of GetCategoryFeatures will show that on the US site, most categories only allow electronic payments. Also use GetCategoryFeatures to determine the default payment methods for a site.

Do not use GeteBayDetails to determine the payment methods for a site.

If you specify multiple PaymentMethods fields, the repeating fields must be contiguous. For example, you can specify PayPalEmailAddress after a list of repeating PaymentMethods fields, but not between them:

<PaymentMethods>VisaMC</PaymentMethods>
<PaymentMethods>PayPal</PaymentMethods>
<PayPalEmailAddress>mypaypalemail@ebay.com</PayPalEmailAddress>

In general, if you separate repeating instances of a field, the results will be unpredictable. This rule applies to all repeating fields (maxOccurs="unbounded" or greater than 1) in the schema. See "Overview of the Schema" in the eBay Web Services guide.

Note: Required or allowed payment methods vary by site and category. Refer to Payment Method Differences (PaymentMethod) in the eBay Trading API Guide for information to help you determine which payment methods you are required or allowed to specify.


Payment methods are not applicable to eBay Real Estate ad format listings, Classified Ad format listings, or Half.com.

For ReviseItem and RelistItem only: A listing must have at least one valid payment method. When you revise or relist an item and you specify a payment method that is invalid for the target site, eBay ignores the invalid payment method, applies the other valid changes, and returns a warning to indicate that the invalid payment method was ignored. If multiple payment methods were invalid, the warning indicates that they were all ignored. If you modify the listing so that it includes no valid payment methods, an error is returned. This situation could occur when the seller removes all valid payment methods or when all the payment methods specified for the item are no longer valid on the target site.

For GetProducts only: Only PayPal is returned in product search results.

Applicable values: See PaymentMethods.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See:
    Payment Method Differences (PaymentMethod)
    Listing an Item
    (SetUserPreferences) SellerPaymentPreferences
    Overview of the API Schema for rules regarding repeating nodes

TransactionArray.Transaction
  .Item.PrivateListing 		boolean Always If true, designates the listing as private. When you create a private listing, a buyer's User ID will not appear in the listing or in the listing's bid history. Sellers may want to use this option when they believe that potential bidders for a listing would not want their User IDs disclosed to others.

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.Quantity 		int Always This meaning of this value depends on the context.

For AddItem and related calls: Specify the number of identical items the seller has available for sale in this listing. For auctions (with competitive bidding), Quantity must be 1. For certain other formats (e.g., fixed-price) the Quantity can be 1 or more. See the eBay Web site online help to learn which selling formats support multi-quantity sales.

For AddFixedPriceItem and VerifyAddFixedPriceItem: Required when no variations are specified. If variations are specified, use Variation.Quantity for each variation instead.

For ReviseItem and ReviseFixedPriceItem: When you revise a listing (with no variations), 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. For auction items, a change in the auction's quantity could result in a change in the auction type. For example, on sites that support multi-quantity auctions (Dutch auctions), if the quantity is changed from 1 (a Chinese auction) to 2, the auction is now a Dutch auction. This may impose new requirements and fees on the seller.

For GetSellerEvents calls, Quantity is returned only for listings where item quantity is greater than 1.

In multi-variation listings, this value is the sum of all the variation quantities in the listing.

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. Even for items that supported Dutch auctions, where one of several items can be purchased during the auction, this number does not change.

For transaction 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).

For SetCart input, this is only required if the parent container is submitted.

Also applicable to Half.com (valid range 1 to 1000). You can revise this field for Half.com listings.

Note: As of version 619, Dutch-style (multi-item) competitive-bid auctions are deprecated. eBay throws an error if you submit a Dutch item listing with AddItem or VerifyAddItem. If you use RelistItem to update a Dutch auction listing, eBay generates a warning and resets the Quantity value to 1.


DetailLevel: ReturnAll.

See Selecting a Selling Format.
TransactionArray.Transaction
  .Item.SellingStatus 		SellingStatusType Always Various details about the current status of the listing, such as the current number of bids and the current high bidder.

Not applicable to Half.com.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.SellingStatus.BidCount 		int Conditionally Number of bids placed so far against the item. Only applicable to competitive-bid item listings (Chinese auctions).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.SellingStatus
  .ConvertedCurrentPrice 		AmountType (double) Conditionally 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.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.SellingStatus
  .CurrentPrice 		AmountType (double) Always For competitive-bid item listings (Chinese auctions), current minimum asking price (start price) or the current highest bid for the item if bids have been placed. Shows minimum bid if no bids have been placed on the item. For Basic Fixed-Price (FixedPriceItem), Store Inventory (StoresFixedPrice), or Ad type (AdType) listings this returns the original price specified when the item was listed/re-listed or the revised price if the item was revised using the ReviseItem call.

In multi-variation listings, this value matches the lowest-priced variation that is still available for sale.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.SellingStatus
  .FinalValueFee 		AmountType (double) Conditionally You are charged a Final Value Fee (FVF) if your item is sold, ends with a winning bid, or is purchased. This fee applies whether or not you actually complete the sale with the buyer. The Final Value Fee is returned in Transaction.FinalValueFee. See the eBay.com Web site online help for more information about the final value fee.

The Final Value Fee for fixed price format (FixedPriceItem) and Store Inventory (StoresFixedPrice) items is returned by GetSellerTransactions, GetItemTransactions, and GetOrderTransactions on a transaction-by-transaction basis, regardless of the listing status. For all other listing types, (excluding Buy It Now purchases), the Final Value Fee is returned when the listing status is Completed.

If you request a Final Value Fee Credit, the value of Transaction.FinalValueFee will not change for the item if a credit is issued. (The credit only appears in the seller's account data.)

If the item was a Dutch auction that ended with bids (not Buy It Now purchases), the Final Value Fee is returned on a transaction-by-transaction basis in Item.SellingStatus.FinalValueFee.

Note: As of version 619, Dutch-style (multi-item) competitive-bid auctions are deprecated. eBay throws an error if you submit a Dutch item listing with AddItem or VerifyAddItem. If you use RelistItem to update a Dutch auction listing, eBay generates a warning and resets the Quantity value to 1.


DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.SellingStatus
  .ListingStatus 		ListingStatusCodeType Always 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.

Applicable values:

•   Active

(out) 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.

•   Completed

(out) 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.

Dutch (multi-listing) Buy It Now auctions are Completed on a transaction-by-transaction basis, and the Final Value Fee is returned by GetSellerTransactions and GetItemTransactions.

Note: As of version 619, Dutch-style (multi-item) competitive-bid auctions are deprecated. eBay throws an error if you submit a Dutch item listing with AddItem or VerifyAddItem. If you use RelistItem to update a Dutch auction listing, eBay generates a warning and resets the Quantity value to 1.

•   Custom

(out) Reserved for internal or future use.

•   CustomCode

(out) Reserved for internal or future use.

•   Ended

(out) 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.




DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.SellingStatus
  .QuantitySold 		int Always For most listings, this is the total number of items purchased so far (in the listing's lifetime). (If the seller has not changed the original quantity, subtract from the value returned in Quantity to calculate the number of items still available for purchase.)

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 transaction.

For transaction calls, also see Transaction.QuantityPurchased for the number of items purchased in the transaction.
In multi-variation listings, this value matches total quantity sold across all variations.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Item.Site 		SiteCodeType Conditionally The name of the site on which the item is listed. 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 Web 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 Web 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, 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).

Not applicable to Half.com.

Applicable values: See Site.

DetailLevel: ReturnAll.

See:
    The US and International eBay Sites
    Specifying the Target Site
    Field Differences for eBay Sites

TransactionArray.Transaction
  .Item.SKU 		SKUType (string) Conditionally A SKU (stock keeping unit) is an identifier defined by a seller. Some sellers use SKUs to track complex flows of products and information on the client side. 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 a transaction is created. (SKU is recommended as an alternative to ApplicationData.)

A SKU is not required to be unique. A seller can specify a particular SKU on one item or on multiple items. Different sellers can use the same SKUs.

If the SKU is unique across a seller's active listings, and if the seller listed the item by using AddFixedPriceItem or RelistFixedPriceItem, the seller can also set Item.InventoryTrackingMethod to SKU in those calls. This allows the seller to use SKU instead of ItemID as a unique identifier in subsequent calls, such as GetItem and ReviseInventoryStatus. If both ItemID and SKU are specified in calls that support the use of SKU as a unique identifier, the ItemID value takes precedence.

For multi-variation listings, the SKU can be used to uniquely identify a variation that is being revised or relisted. If InventoryTrackingMethod is ItemID, an ItemID is also required. When both SKU and VariationSpecifics are passed in the request, the variation specifics take precedence as the unique identifier.

Note: The eBay Web site UI 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 GetMyeBaySelling, this is only returned if set.
Not applicable to Half.com.
Max length: 50.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See eBay Merchant Data API for AddFixedPriceItem and ReviseFixedPriceItem.
TransactionArray.Transaction
  .Item.StartPrice 		AmountType (double) 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-type 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) and Store Inventory (StoresFixedPrice) listings: 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.

Also applicable to Half.com (valid range 0.75 to 9999.99). You can revise this field for Half.com listings.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .Item.Title 		string Conditionally Name of the item as it appears in the listing or search results. Required for most items. Optional if you list in Books, Music, Movies, or Video Games categories and you use Pre-filled Item Information (as the title can be pre-filled based on the catalog product title). That is, optional if you specify Item.ExternalProductID or Item.ProductListingDetails.

You cannot use HTML or JavaScript in the Title. (HTML characters will be interpreted literally as plain text.)

For AddItem, not applicable to Half.com. For GetOrders, not returned from eBay.com, but a title from the Half.com catalog is returned from Half.com instead.

You can add or change the value of this tag only if an item has no bids (or no items have sold) and the listing does not end for 12 hours.

In GetItemRecommendations, more keywords in the title usually results in more relevant recommendations.
Max length: 55.

DetailLevel: ReturnAll.
TransactionArray.Transaction
  .ListingCheckoutRedirectPreference 		ListingCheckoutRedirectPreferenceType Conditionally ProStores listing level preferences regarding the store to which checkout should be redirected for the listing if ThirdPartyCheckout is true.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See Third Party Checkout Redirect to ProStores.
TransactionArray.Transaction
  .ListingCheckoutRedirectPreference
  .SellerThirdPartyUsername 		string Conditionally The user name of the associated store, if ThirdPartyCheckout is true. To remove this value when revising or relisting an item, use DeletedField.
Max length: 200.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .PaidTime 		dateTime Conditionally Indicates the time when the transaction was marked paid. There are many ways to mark a transaction as paid. eBay sets it when payment is made via PayPal. A seller can mark an item as paid in My eBay or Selling Manager Pro. An application can use ReviseCheckoutStatus or CompleteSale on behalf of the seller. Note: This value is only visible to the user if the request user is the buyer or seller associated with the transaction.

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .PayPalEmailAddress 		string Conditionally The seller's Paypal email address.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Platform 		TransactionPlatformCodeType Always Name of the eBay co-branded site upon which the transaction was made.

Applicable values:

•   CustomCode

(in/out) Reserved for future use.

•   eBay

(in/out) The transaction was created (i.e., the purchase was made) on the main eBay site.

•   Express

(in/out) The transaction was created on the eBay Express site.

•   Half

(in/out) The transaction was created on Half.com site.

•   Shopping

(in/out) The transaction was created on the Shopping.com site.

•   WorldOfGood

(in/out) The transaction was created on the WorldOfGood site.




DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .QuantityPurchased 		int Conditionally Indicates the number of items the buyer purchased from the listing identified in ItemID.

Applicable to Half.com (for GetOrders).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .SellerContactBuyerByEmail 		boolean Conditionally Indicates whether the buyer has opted to accept emails from all the seller(s) in the Shopping.com shopping cart. Only returned for transactions made on Shopping.com using the Shopping.com shopping cart.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .SellingManagerProductDetails 		SellingManagerProductDetailsType Conditionally Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .SellingManagerProductDetails
  .ProductName 		string Conditionally The name of a Selling Manager product. The AddSellingManagerProduct call is used to create a Selling Manager product.
TransactionArray.Transaction
  .ShippedTime 		dateTime Conditionally Indicates the time when the item(s) associated with the transaction were marked as shipped, if known. The value is set when the seller uses shipment tracking features offered by eBay or an eBay partner. This value is also set when the seller marks the item as shipped by using CompleteSale. If the seller is a Selling Manager Pro user, they can also mark the item as shipped by using My eBay. Note that this value is only visible if the request user is the buyer or seller associated with the transaction.

Applicable to Half.com (for GetOrders only).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails 		ShippingDetailsType Conditionally The shipping-related details for an item or transaction, including flat and calculated shipping costs and shipping insurance costs. For GetOrders, minimal ShippingDetails information is returned under the Transaction container.

Applicable to Half.com (for GetOrders only).

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Shipping.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate 		CalculatedShippingRateType Conditionally 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 Dimensional Weight limit on UPS shipping services results in failure of shipping calculator.

Not applicable to Half.com.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .InternationalPackagingHandlingCosts 		AmountType (double) Conditionally 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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .OriginatingPostalCode 		string Conditionally Postal code for the location from which the package will be shipped. Required for calculated shipping. Use Item.PostalCode to specify the location of the item used for searches by location.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .PackageDepth 		MeasureType (decimal) Conditionally 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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Package Dimensions and Weight.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .PackageDepth
  [ attribute unit ]		 token Conditionally The unit of measure (e.g., lbs, oz, in). Currently ignored and assumed to be "inches" when used as input for PackageDepth, PackageWidth, PackageLength, WeightMajor, WeightMinor.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .PackageLength 		MeasureType (decimal) Conditionally 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.)

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Package Dimensions and Weight.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .PackageLength
  [ attribute unit ]		 token Conditionally The unit of measure (e.g., lbs, oz, in). Currently ignored and assumed to be "inches" when used as input for PackageDepth, PackageWidth, PackageLength, WeightMajor, WeightMinor.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .PackageWidth 		MeasureType (decimal) Conditionally 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.)

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Package Dimensions and Weight.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .PackageWidth
  [ attribute unit ]		 token Conditionally The unit of measure (e.g., lbs, oz, in). Currently ignored and assumed to be "inches" when used as input for PackageDepth, PackageWidth, PackageLength, WeightMajor, WeightMinor.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .PackagingHandlingCosts 		AmountType (double) Conditionally 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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .ShippingIrregular 		boolean Conditionally 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.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .ShippingPackage 		ShippingPackageCodeType Conditionally The nature of the package used to ship the item(s). Required for calculated shipping only.

Applicable values: See ShippingPackage.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .WeightMajor 		MeasureType (decimal) Conditionally WeightMajor and WeightMinor are used to specify the weight of a shipping package. Here is how you would represent a package weight of 5 lbs 2 oz: <WeightMajor unit="lbs">5</WeightMajor> <WeightMinor unit="oz">2</WeightMinor> See http://www.ups.com for the maximum weight allowed by UPS. Above this maximum, the shipping type becomes Freight, an option that can only be selected via the eBay Web site and not via API. The weight details are validated against the selected shipping service. For calculated shipping only. Required on input when calculated shipping is used.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .WeightMajor
  [ attribute unit ]		 token Conditionally The unit of measure (e.g., lbs, oz, in). Currently ignored and assumed to be "inches" when used as input for PackageDepth, PackageWidth, PackageLength, WeightMajor, WeightMinor.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .WeightMinor 		MeasureType (decimal) Conditionally See the definition of WeightMajor. For calculated shipping only. Required on input when calculated shipping is used.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .CalculatedShippingRate
  .WeightMinor
  [ attribute unit ]		 token Conditionally The unit of measure (e.g., lbs, oz, in). Currently ignored and assumed to be "inches" when used as input for PackageDepth, PackageWidth, PackageLength, WeightMajor, WeightMinor.
TransactionArray.Transaction
  .ShippingDetails
  .ChangePaymentInstructions 		boolean Conditionally Whether the seller specified payment and shipping instructions during checkout (for example, to update the details of a transaction). Flat and calculated shipping.

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails.CODCost 		AmountType (double) Conditionally Valid only for the Italy site (site ID 101); contains the cash-on-delivery (COD) cost for COD shipping.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See Specifying the Cash on Delivery Option in Shipping Details.
TransactionArray.Transaction
  .ShippingDetails
  .ExcludeShipToLocation 		string Conditionally,
repeatable: [0..*]		 This field works in conjunction with Item.ShipToLocations and specifies an international country or region to where you will not ship the associated item. On input, repeat this element for each location that you want to exclude as a shipping destination for the associated item. As output, this field is repeated for each location to where you will not ship.

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.

You can specify a default set of locations to where you will not ship items 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 specify any location with this field on input, 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 NONE 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.

To see the valid exclude ship-to locations for a specified site, call GeteBayDetails with DetailName set to ExcludeShippingLocationDetails. You can repeat this call for each site on which you list. The location values are eBay regions and countries. Note that 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 Worldwide, you can specify both regions and countries that you wish to exclude from your shipping destinations.

Note: To enable the display of your excluded ship-to locations in your item listings, you must enable Exclude Shipping Locations and Buyer Requirements in your My eBay Site Preferences. For details, see the KnowledgeBase Article HowTo: ExcludeShipToLocation.


DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

Applicable values: See CountryCodeType, ShippingRegionCodeType
TransactionArray.Transaction
  .ShippingDetails.GetItFast 		boolean Conditionally Indicates whether the seller has opted the listing into the Get It Fast feature. If GetItFast is true and if at least one of the domestic shipping services offered by the seller is an expedited shipping service, every shipping service offered by the seller is considered a Get It Fast service, and the seller commits to delivering the item to the buyer-selected shipping service within one day.

Applicable to Half.com for GetOrders.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails.InsuranceFee 		AmountType (double) Conditionally Cost of shipping insurance set by the seller. If the buyer bought more than one of this item, this is the insurance for just a single item. Exception: for GetItemShipping, this is proportional to QuantitySold. Value should be greater than 0.00 if InsuranceOption is Optional or Required. For flat shipping only. Optional as input and only allowed if ChangePaymentInstructions is true. This field is ignored when InsuranceOption is not specified in the request.

Valid only on the following sites: AU, FR, and IT
Applicable to Half.com for GetOrders.
Default: 0.00.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .InsuranceOption 		InsuranceOptionCodeType Conditionally Whether the seller offers shipping insurance and, if so, whether the insurance is optional or required. Optional as input and only allowed if ChangePaymentInstructions is true. If this field is not included in the request, values specified in the InsuranceFee field will be ignored.

Note: Note that sellers are responsible for the items they sell until they safely arrive in their customers' hands, and that offering buyer-paid insurance (either as an optional or required service) infers that the buyer is somehow responsible for the safe delivery of the items they purchase. This notion can reduce buyer confidence in the marketplace and the practice of including buyer- paid shipping insurance in your item listings is discouraged.
This field is always returned with a request version lower than 635. With a request version of 635 or higher, this field is only returned if the value is other than NotOffered.

Valid only on the following sites: AU, FR, and IT
If you include buyer-paid shipping insurance for an item listed on one of the sites that supports this option, a buyer on a site that does not support buyer-paid shipping insurance can still purchase the item. In these cases, the buyer is responsible for all the shipping insurance terms that have been outlined in the item listing.

Applicable to Half.com

Applicable values:

•   CustomCode

(in/out) Reserved for internal or future use

•   IncludedInShippingHandling

(in/out) The seller is not charging separately for shipping insurance costs; any insurance is already included in the base shipping cost.

•   NotOffered

(in/out) The seller does not offer shipping insurance to the buyer.

•   NotOfferedOnSite

(out) Shipping insurance is not offered as a separate option on the site where the item is listed. (Some shipping services, such as DE_InsuredExpressOrCourier, include insurance as part of the service.) If another insurance option is specified in the listing request and the site does not support shipping insurance as a separate option, eBay will reset the insurance option to this value. At the time of this writing, this option is only meaningful for the eBay Germany, Austria, and Switzerland sites.

•   Optional

(in/out) The seller offers the buyer the choice of paying for shipping insurance or not.

•   Required

(in/out) The seller requires that the buyer pay for shipping insurance.




DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .InsuranceWanted 		boolean 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: AU, FR, and IT
Applicable to Half.com for GetOrders.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails.PaymentEdited 		boolean Conditionally Whether the seller allows the buyer to edit the payment amount for the transaction. (Sellers enable this property in their My eBay user preferences on the eBay site.)

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .PaymentInstructions 		string Conditionally Payment instructions (or message) from the seller to the buyer. These instructions appear on eBay's View Item page and on eBay's checkout page when the buyer pays for the item.

Sellers usually use this field to specify payment instructions, how soon the item will shipped, feedback instructions, and other reminders that the buyer should be aware of when they bid on or buy an item. This field can be specified regardless of the shipping type eBay only allows 500 characters as input, but due to the way the eBay Web site UI treats characters, this field can return more than 500 characters in the response. Characters like & and ' (apostrophe/single quote) count as 5 characters each. Use DeletedField to remove this value when revising or relisting an item.

Applicable to eBay Motors (usually used to elaborate on the return policy).
Not applicable to Half.com.
Max length: 1000.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See:
    Offering a Clear Return Policy
    (AddItem) Item.AttributeSetArray
    (GetItem) Item.AttributeSetArray

TransactionArray.Transaction
  .ShippingDetails.SalesTax 		SalesTaxType Conditionally Sales tax details. US site only. Flat and calculated shipping.

Not applicable to eBay Motors vehicle listings.
Applicable to Half.com (for GetOrders).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See Enabling Multi-jurisdiction Sales Tax.
TransactionArray.Transaction
  .ShippingDetails.SalesTax
  .SalesTaxAmount 		AmountType (double) Conditionally (US only) The amount of sales tax, calculated for a transaction based on the SalesTaxPercent and pricing information.

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 ItemID and TransactionID to call GetOrderTransactions.

Applicable to Half.com (for GetOrders).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails.SalesTax
  .SalesTaxPercent 		float Conditionally Percent of an item's price to be charged as the sales tax for the transaction. The value passed in is stored with a precision of 3 digits after the decimal point (##.###).

Applicable to Half.com (for GetOrders).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails.SalesTax
  .SalesTaxState 		string Conditionally State or jurisdiction for which the sales tax is being collected. Only returned if the seller specified a value.

Applicable to Half.com (for GetOrders).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails.SalesTax
  .ShippingIncludedInTax 		boolean Conditionally (US only) Whether shipping costs were part of the base amount that was taxed. Flat or calculated shipping.

Applicable to Half.com (for GetOrders).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .SellingManagerSalesRecordNumber 		int 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. In the Selling Manager calls, the value for the sale record ID is in the SaleRecordID field. The sale record ID can be for one transaction or for an order (which contains multiple transactions).
Applicable to Half.com (for GetOrders).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .ShipmentTrackingDetails 		ShipmentTrackingDetailsType Conditionally,
repeatable: [0..*]		 Container for the shipping carrier and tracking information associated with an item shipment.

This is a repeatable container, allowing for multiple package shipments to be input for a single item transaction.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .ShipmentTrackingDetails
  .ShipmentTrackingNumber 		string Conditionally The tracking number assigned by the shipping carrier to the item shipment. The format of the tracking number must be consistent with the format used by the specified shipping carrier (ShippingCarrierUsed).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .ShipmentTrackingDetails
  .ShippingCarrierUsed 		string Conditionally Name of the shipping carrier used to ship the item.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .ShippingRateErrorMessage 		string Conditionally 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 Fine.

Not applicable to Half.com or eBay Motors vehicle listings.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .ShippingRateType 		ShippingRateTypeCodeType Conditionally A shipping rate scale for shipping through UPS that affects the shipping cost calculated for UPS (lower if ShippingRateType is DailyPickup). ShippingRateType is only returned if ShippingService is one of the UPS shipping services. For calculated shipping only.

Not applicable to Half.com or eBay Motors vehicle listings.

Applicable values:

•   CustomCode

(out) Reserved for internal or future use.

•   DailyPickup

(out) "Daily pickup" shipping rate scale.

•   OnDemand

(out) "On-demand" shipping rate scale.




DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See Shipping.
TransactionArray.Transaction
  .ShippingDetails
  .ShippingServiceUsed 		token Conditionally The shipping service that actually shipped the item(s).

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

Applicable values: See ShippingServiceCodeType
TransactionArray.Transaction
  .ShippingDetails.ShippingType 		ShippingTypeCodeType Conditionally 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.

Not applicable to Half.com.

Applicable values:

•   Calculated

(in/out) 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.

•   CalculatedDomesticFlatInternational

(in/out) The seller specified one or more calculated domestic shipping services and one or more flat international shipping services.

•   CustomCode

(in/out) Reserved for future use.

•   Flat

(in/out) 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.

•   FlatDomesticCalculatedInternational

(in/out) The seller specified one or more flat domestic shipping services and one or more calculated international shipping services.

•   FreightFlat

(in/out) Freight shipping model: freight shipping may be used when flat or calculated shipping cannot be used due to the greater weight of the item. See "Specifying Freight Shipping" in the Shipping chapter for details on freight shipping.

•   NotSpecified

(in/out) The seller did not specify the shipping type.


(Not all values in ShippingTypeCodeType apply to this field.)


DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails.TaxTable 		TaxTableType Conditionally 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:
- DetailLevel is set to ReturnAll or ItemReturnDescription (in this case, the value of IncludeTaxTable does not matter).
- IncludeTaxTable is set to true and DetailLevel is not set or it is set to ItemReturnAttributes.

Not applicable to Half.com.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails.TaxTable
  .TaxJurisdiction 		TaxJurisdictionType Conditionally,
repeatable: [0..*]		 Sales tax details for zero or more jurisdictions (states, provinces, etc).

For GetTaxTable: If DetailLevel is not specified, information is returned only for the jurisdictions for which the user provided tax information. If DetailLevel is ReturnAll, tax information is returned for all possible jurisdictions, whether specified by the user or not. ShippingIncludedInTax and SalesTaxPercent are returned, but are empty.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails.TaxTable
  .TaxJurisdiction
  .JurisdictionID 		string Conditionally Representative identifier for the jurisdiction. Typically an abbreviation (for example, CA for California).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails.TaxTable
  .TaxJurisdiction
  .SalesTaxPercent 		float Conditionally The tax percent to apply for a listing shipped to this jurisdiction. The value passed in is stored with a precision of 3 digits after the decimal point (##.###).
For GetTaxTable: this tag has no value if the user's tax table has not been set.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails.TaxTable
  .TaxJurisdiction
  .ShippingIncludedInTax 		boolean Conditionally Whether shipping costs are to be part of the base amount that is taxed.
For GetTaxTable: This tag is empty if the user did not previously provide information.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingDetails
  .ThirdPartyCheckout 		boolean Conditionally Whether checkout for this is to be handled by a Third-Party Checkout application. The counterpart in the AddItem family of calls is Item.ThirdPartyCheckout.

Not applicable to Half.com.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See:
    Third Party Checkout
    (AddItem) Item.ThirdPartyCheckout

TransactionArray.Transaction
  .ShippingServiceSelected 		ShippingServiceOptionsType Conditionally The shipping service selected by the buyer from the services offered by the seller.

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See Shipping.
TransactionArray.Transaction
  .ShippingServiceSelected
  .ExpeditedService 		boolean Conditionally Indicates whether the service is an expedited shipping service. See Enabling Get It Fast. Not applicable to Half.com.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingServiceSelected
  .ShippingInsuranceCost 		AmountType (double) Conditionally The insurance cost associated with shipping a single item with this shipping service. Exception: for GetItemShipping, this is proportional to QuantitySold. If the item has not yet been sold, insurance information cannot be calculated and the value is 0.00. For calculated shipping only. Also applicable to Half.com (for GetOrders).

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Determining Shipping Costs for a Listing.
TransactionArray.Transaction
  .ShippingServiceSelected
  .ShippingInsuranceCost
  [ attribute currencyID ]		 CurrencyCodeType Conditionally Currency in which the monetary amount is specified.

In the AddItem family of calls, the currency can be specified in the Item.Currency field instead. If you do specify this attribute in the AddItem family of calls, the value must match the site currency (i.e., it must be the same as the value in Item.Currency) unless otherwise stated.

For a list of possible enumeration values, see CurrencyCodeType.
TransactionArray.Transaction
  .ShippingServiceSelected
  .ShippingService 		token Conditionally A domestic shipping service offered for shipping the item (for example, UPS Ground). For a list of valid values that you can cache for future use, call GeteBayDetails with DetailName set to ShippingServiceDetails. For flat and calculated shipping. Also applicable to Half.com (for GetOrders).

If there are two or more services and one is "pickup", "pickup" must not be specified as the first service.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See GeteBayDetails.



Applicable values: See ShippingServiceCodeType
TransactionArray.Transaction
  .ShippingServiceSelected
  .ShippingServiceAdditionalCost 		AmountType (double) Conditionally The cost of shipping each additional item beyond the first item. For input, this is required if the listing is for multiple items and should be zero for single-item listings. Default value is 0.00. For flat shipping only. Not applicable to Half.com.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Determining Shipping Costs for a Listing.
TransactionArray.Transaction
  .ShippingServiceSelected
  .ShippingServiceAdditionalCost
  [ attribute currencyID ]		 CurrencyCodeType Conditionally Currency in which the monetary amount is specified.

In the AddItem family of calls, the currency can be specified in the Item.Currency field instead. If you do specify this attribute in the AddItem family of calls, the value must match the site currency (i.e., it must be the same as the value in Item.Currency) unless otherwise stated.

For a list of possible enumeration values, see CurrencyCodeType.
TransactionArray.Transaction
  .ShippingServiceSelected
  .ShippingServiceCost 		AmountType (double) Conditionally The meaning of this element depends on the call and on whether flat or calculated shipping has been selected. (For example, it could be the cost to ship a single item, the cost to ship all items, or the cost to ship just the first of many items, with ShippingServiceAdditionalCost accounting for the rest.) When returned by GetItemShipping, it includes the packaging and handling cost. For flat and calculated shipping.

Also applicable to Half.com (for GetOrders).

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.

See Determining Shipping Costs for a Listing.
TransactionArray.Transaction
  .ShippingServiceSelected
  .ShippingServiceCost
  [ attribute currencyID ]		 CurrencyCodeType Conditionally Currency in which the monetary amount is specified.

In the AddItem family of calls, the currency can be specified in the Item.Currency field instead. If you do specify this attribute in the AddItem family of calls, the value must match the site currency (i.e., it must be the same as the value in Item.Currency) unless otherwise stated.

For a list of possible enumeration values, see CurrencyCodeType.
TransactionArray.Transaction
  .ShippingServiceSelected
  .ShippingServicePriority 		int Conditionally Seller-preferred presentation order relative to other service options. Valid values: 1 (1st choice), 2 (2nd choice), 3 (3rd choice). For flat and calculated shipping. Not applicable to Half.com.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingServiceSelected
  .ShippingSurcharge 		AmountType (double) Conditionally An additional fee to charge US buyers who ship via UPS to Alaska, Hawaii or Puerto Rico. Can only be assigned a value for the eBay US site and for items in the Parts and Accessories category of the eBay Motors site. Only returned if set. If some transactions in an order have a surcharge, surcharge is added only for those transactions. Flat rate shipping only.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingServiceSelected
  .ShippingSurcharge
  [ attribute currencyID ]		 CurrencyCodeType Conditionally Currency in which the monetary amount is specified.

In the AddItem family of calls, the currency can be specified in the Item.Currency field instead. If you do specify this attribute in the AddItem family of calls, the value must match the site currency (i.e., it must be the same as the value in Item.Currency) unless otherwise stated.

For a list of possible enumeration values, see CurrencyCodeType.
TransactionArray.Transaction
  .ShippingServiceSelected
  .ShippingTimeMax 		int Conditionally The maximum guaranteed number of days the shipping carrier will take to ship an item (not including the time it takes the seller to deliver the item to the shipping carrier). See Enabling Get It Fast. Not applicable to Half.com.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .ShippingServiceSelected
  .ShippingTimeMin 		int Conditionally The minimum guaranteed number of days in which the shipping carrier can ship an item (not including the time it takes the seller to deliver the item to the shipping carrier). See Enabling Get It Fast. Not applicable to Half.com.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Status 		TransactionStatusType Conditionally Contains the status of the transaction, such as the buyer's online payment and whether the checkout process for the transaction has been completed. See TransactionStatusType for its child elements.

Not applicable to Half.com.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Status.BuyerSelectedShipping 		boolean 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).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Status.CheckoutStatus 		CheckoutStatusCodeType Conditionally Indicates the current status of the checkout process for the transaction.

Applicable values:

•   BuyerRequestsTotal

(out) Buyer requests total from seller.

•   CheckoutComplete

(out) Checkout complete.

•   CheckoutIncomplete

(out) Checkout incomplete--no details specified.

•   CustomCode

(out) Reserved for future use.

•   SellerResponded

(out) Seller responded to buyer's request.




DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Status.CompleteStatus 		CompleteStatusCodeType Conditionally Indicates whether the transaction process is complete or incomplete.

Applicable values:

•   Complete

(in/out) Transaction is complete.

•   CustomCode

(in/out) Reserved for internal or future use

•   Incomplete

(in/out) Transaction is incomplete.

•   Pending

(in/out) Transaction is pending.




DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Status.eBayPaymentStatus 		PaymentStatusCodeType Conditionally Indicates the success or failure of the buyer's online payment for a transaction. Applicable for the payment method that the buyer chose for the transaction. If the payment failed, the value returned indicates the reason for the failure. Output only.

Applicable values:

•   BuyerCreditCardFailed

(out) The buyer's credit card failed.

•   BuyerECheckBounced

(out) The buyer's eCheck bounced.

•   BuyerFailedPaymentReportedBySeller

(out) The seller reports that the buyer's payment failed.

•   CustomCode

(out) Reserved for internal or future use.

•   NoPaymentFailure

(out) No payment failure.

•   PaymentInProcess

(out) Currently for eBay Germany only.

•   PayPalPaymentInProcess

(out) The payment from buyer to seller is in PayPal process, but has not yet been completed.




DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Status
  .IntegratedMerchantCreditCardEnabled 		boolean Conditionally Indicates whether the item can be paid for through a payment gateway account. If IntegratedMerchantCreditCardEnabled is true, then integrated merchant credit card (IMCC) is enabled for credit cards because the seller has a payment gateway (Payflow) account. Therefore, if IntegratedMerchantCreditCardEnabled is true, and AmEx, Discover, or VisaMC is returned for an item, then on checkout, an online credit-card payment is processed through a payment gateway account.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Status.LastTimeModified 		dateTime Conditionally Indicates date and time a transaction's status or incomplete state was last updated (in GMT).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Status.PaymentHoldStatus 		PaymentHoldStatusCodeType Conditionally Contains the current status of a hold on a PayPal payment. The payment hold that is referred to as a "payment review" hold results from a possible issue with a buyer. The payment hold referred to as a "merchant hold" results from a possible issue with a seller. For more information, please see the link below. Additionally, in the cases of the GetMyeBaySelling and GetMyeBayBuying calls, the PaymentHoldStatus value can affect the value returned in in SellerPaidStatus and BuyerPaidStatus; see the PaymentHoldStatus applicable values.

Applicable values:

•   CustomCode

(out) Reserved for internal or future use.

•   MerchantHold

(out) The payment hold referred to as a "merchant hold" results from a possible issue with a seller. If this value is returned, then the following values, as a result, will be returned: In GetMyeBaySelling, PaidWithPayPal is returned in TransactionArray.Transaction.SellerPaidStatus. In GetMyeBayBuying, PaidWithPayPal is returned in TransactionArray.Transaction.BuyerPaidStatus.

•   None

(out) Indicates that there is no payment review hold and no merchant hold.

•   PaymentReview

(out) The payment hold referred to as a "payment review" hold results from a possible issue with a buyer. If this value is returned, then the following values, as a result, will be returned: In GetMyeBaySelling, NotPaid is returned in TransactionArray.Transaction.SellerPaidStatus. In GetMyeBayBuying, PaidWithPayPal is returned in TransactionArray.Transaction.BuyerPaidStatus.

•   Released

(out) Indicates that a payment hold has been released.




DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See Holds on PayPal Payments.
TransactionArray.Transaction
  .Status.PaymentMethodUsed 		BuyerPaymentMethodCodeType Conditionally Payment method the buyer selected for paying the seller for the transaction. If checkout is not yet complete, PaymentMethodUsed is set to whatever the buyer selected as his or her preference on the Review Your Purchase page.

Applicable values: See PaymentMethodUsed.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .TransactionID 		string Always Identifier for the transaction. A value of zero is used for the Chinese auction format. Thus, a value of zero is a valid transaction ID. A transaction ID is only unique to the listing that spawned it, so a transaction is only uniquely identified on a global basis by a combination of ItemID and TransactionID.

Applicable to Half.com (for GetOrders only).
Max length: 19 (Note: The eBay database specifies 38. Currently, transaction IDs are usually 9 to 12 digits.) .

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .TransactionPrice 		AmountType (double) Conditionally Price of the transaction (before shipping and sales tax) that the buyer needs to pay to complete the purchase. Note that for GetItemTransactions and GetSellerTransactions, TransactionPrice is the per-item price for the transaction; transactions with TransactionArray.Transaction.QuantityPurchased of more than 1 have the same value for TransactionPrice as transactions with TransactionArray.Transaction.QuantityPurchased of 1. For eBay Motors, TransactionPrice is the deposit amount.

Applicable to Half.com (for GetOrders).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .TransactionSiteID 		SiteCodeType Conditionally The site upon which the item transaction was made.

Applicable values: See TransactionSiteID.

DetailLevel: ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Variation 		VariationType 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.

When a user purchases items from a multi-variation listing, this Variation node contains information about which variation was purchased. Therefore, applications that process transactions should always check to see if this node is present. A single transaction can contain items from only one variation.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Variation.SKU 		SKUType (string) Conditionally A SKU (stock keeping unit) is an identifier defined by a seller. Some sellers use SKUs to track complex flows of products and information on the client side. eBay preserves the SKU on the variation, enabling you to obtain it before and after a transaction is created. 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 specified). If Item.InventoryTrackingMethod is set to true, the SKU values must be specified and they must be unique across all the seller's active listings. Only returned if the seller specified a SKU for the variation.
Max length: 70.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See Setting the Variation SKU.
TransactionArray.Transaction
  .Variation.VariationSpecifics 		NameValueListArrayType Conditionally A list of name/value pairs that uniquely identify the variation within the listing. All variations must specify the same set of names, and each variation must provide a unique combination of values for those names. For example, if the items vary by color and size, then every variation must specify Color and Size as names, and no two variations can specify the same combination of color and size values.

When you revise a listing that includes variations, you can't add or change names or values in variation specifics (because the set of variation specifics serves as a unique identifier). However, you can 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 (transactions). If the variation has sales, then set the Quantity to 0.

For GetSellerEvents To keep the GetSellerEvents response smaller, variation specifics are not returned if the variation has a SKU. If the variation has no SKU, then variation specifics are returned instead. Optionally, you can pass IncludeVariationSpecifics as true in the request to force variation specifics to be returned, even when the SKU is returned.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.

See:
    Setting Item Specifics for Variations
    Revising and Relisting with Variations

TransactionArray.Transaction
  .Variation.VariationSpecifics
  .NameValueList 		NameValueListType Conditionally,
repeatable: [0..*]		 For the AddItem family of calls: Contains the name and value(s) for an Item Specific. Only required when the ItemSpecifics container is specified.

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 varations, 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:
a) Specify shared Item Specifics (e.g., Brand) in the ItemSpecifics node.
b) Specify up to five VariationSpecifics in each Variation node.
c) Specify all applicable names with all their supported values in the VariationSpecificSet node.

See the Variation sample in the AddFixedPriceItem call reference for examples.

For PlaceOffer: Required if the item being purchased includes Item Variations.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Variation.VariationSpecifics
  .NameValueList.Name 		string Conditionally A name in a name/value pair.

For the AddItem and AddFixedPriceItem families of calls: In the Item.ItemSpecifics context, this can be any name that the seller wants to use. However, to help buyers find items more easily, it is a good idea to try to use a recommended name when possible (see GetCategorySpecifics or GetItemRecommendations). You can't specify the same name twice within the same listing.

For the AddFixedPriceItem family of calls: In the VariationSpecifics context, this can be any name that the seller wants to use, unless the VariationsEnabled flag is false for the name in the GetCategorySpecifics response. For example, for some categories eBay may recommend that you only use "Brand" as a shared name at the Item level, not in variations.

For GetCategorySpecifics and GetItemRecommendations: This is a recommended (popular) name to use for items in the specified category (e.g., "Brand" might be recommended, not "Manufacturer").

For search calls: In the GetSearchResults response, this the name of an attribute (Attribute) that was used in the listing. Specifically: If SearchRequest was used to perform a "Product Finder" search, this contains the name of one attribute (i.e, the name of one ID-based Item Specifics field). If IncludeCondition was true in the request, this returns the condition attribute name (e.g., "Item Condition").

In the GetProducts response, this is an attribute name that is defined for a catalog product.

For PlaceOffer: Required if the item being purchased includes Item Variations.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Variation.VariationSpecifics
  .NameValueList.Value 		string Conditionally,
repeatable: [0..*]		 A value associated with the name.

For the AddItem family of calls: If you specify multiple values for Item Specifics, eBay only stores the first one, unless GetCategorySpecifics or GetItemRecommendations indicates that the corresponding name supports multiple values.

For the AddFixedPriceItem family of calls: If you specify multiple values for Item Specifics or Variation Specifics, eBay only stores the first one, unless GetCategorySpecifics or GetItemRecommendations indicates that the corresponding name supports multiple values.

In VariationSpecificSet, you typically specify multiple Value fields for each name. For example, if Name=Size, you would specify all size values that you wan to offer in the listing.

For GetCategorySpecifics and GetItemRecommendations: The most highly recommended values are returned first. For these calls, Value is only returned when recommended values are available.

For search calls: In the GetSearchResults response, if SearchRequest was used to perform a "Product Finder" search, this contains the value of one attribute. If IncludeCondition was true in the request, this returns the condition attribute value (e.g., "New").

For PlaceOffer: Required if the item being purchased includes Item Variations.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Variation.VariationTitle 		string Conditionally The title of the variation. This is a concatenation of the listing title plus the values (no names) from the VariationSpecifics. 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]. PayPal may also use this value to identify variations in transactions (for buyers and sellers).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionArray.Transaction
  .Variation
  .VariationViewItemURL 		anyURI 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).

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.
TransactionsPerPage int Always Number of transactions returned per page (per call). May be a higher value than ReturnedTransactionCountActual if the page returned is the last page and more than one page of data exists.

DetailLevel: ItemReturnDescription, ReturnAll. Also returned if DetailLevel is not provided on input.



Back to top

Input Output Detail Controls Samples Change History Top Errors for GetSellerTransactions
GetSellerTransactions Detail Controls


Detail Control: DetailLevel

The DetailLevel input field influences which call-specific fields may be returned. (All standard output fields are returned regardless of DetailLevel.)

The none column indicates the fields that are returned when you do not specify a DetailLevel.

YThe field is always returned.
(Y)The field is conditionally returned. See the field description for clarification of conditions.
-The field is not returned.

Output Field none ItemReturnDescription ReturnAll
HasMoreTransactionsYYY
PageNumberYYY
PaginationResultYYY
PaginationResult.TotalNumberOfEntriesYYY
PaginationResult.TotalNumberOfPagesYYY
PayPalPreferredYYY
ReturnedTransactionCountActualYYY
SellerY-Y
Seller.AboutMePageY-Y
Seller.CharityAffiliations(Y)-(Y)
Seller.CharityAffiliations.CharityID(Y)-(Y)
Seller.eBayGoodStandingY-Y
Seller.EIASTokenY-Y
Seller.EmailY-Y
Seller.FeedbackPrivateY-Y
Seller.FeedbackRatingStarY-Y
Seller.FeedbackScoreY-Y
Seller.IDVerifiedY-Y
Seller.NewUserY-Y
Seller.PositiveFeedbackPercent(Y)-(Y)
Seller.RegistrationDateY-Y
Seller.SellerInfoY-Y
Seller.SellerInfo.AllowPaymentEditY-Y
Seller.SellerInfo.CheckoutEnabledY-Y
Seller.SellerInfo.CIPBankAccountStoredY-Y
Seller.SellerInfo.GoodStandingY-Y
Seller.SellerInfo.MerchandizingPrefY-Y
Seller.SellerInfo.QualifiesForB2BVATY-Y
Seller.SellerInfo.SafePaymentExemptYYY
Seller.SellerInfo.SellerGuaranteeLevel(Y)-(Y)
Seller.SellerInfo.SellerLevelY-Y
Seller.SellerInfo.StoreOwnerY-Y
Seller.SellerInfo.StoreURLY-Y
Seller.SellerInfo.TopRatedSeller(Y)-(Y)
Seller.SiteY-Y
Seller.StatusY-Y
Seller.UserIDY-Y
Seller.UserIDChangedY-Y
Seller.UserIDLastChangedY-Y
Seller.VATStatusY-Y
TransactionArray(Y)-(Y)
TransactionArray.Transaction(Y)-(Y)
TransactionArray.Transaction.AdjustmentAmount(Y)(Y)(Y)
TransactionArray.Transaction.AmountPaid(Y)(Y)(Y)
TransactionArray.Transaction.BestOfferSale(Y)(Y)(Y)
TransactionArray.Transaction.Buyer(Y)-(Y)
TransactionArray.Transaction.Buyer.AboutMePage(Y)-(Y)
TransactionArray.Transaction.Buyer.BuyerInfo(Y)-(Y)
TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress(Y)-(Y)
TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress
  .CityName		(Y)-(Y)
TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress
  .Country		(Y)-(Y)
TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress
  .CountryName		(Y)-(Y)
TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress
  .ExternalAddressID		(Y)-(Y)
TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress.Name(Y)-(Y)
TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress
  .Phone		(Y)-(Y)
TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress
  .PostalCode		(Y)-(Y)
TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress
  .StateOrProvince		(Y)-(Y)
TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress
  .Street		(Y)-(Y)
TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress
  .Street1		(Y)-(Y)
TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress
  .Street2		(Y)-(Y)
TransactionArray.Transaction.Buyer.CharityAffiliations(Y)-(Y)
TransactionArray.Transaction.Buyer.CharityAffiliations.CharityID(Y)-(Y)
TransactionArray.Transaction.Buyer.eBayGoodStanding(Y)-(Y)
TransactionArray.Transaction.Buyer.EIASToken(Y)-(Y)
TransactionArray.Transaction.Buyer.Email(Y)-(Y)
TransactionArray.Transaction.Buyer.FeedbackPrivate(Y)-(Y)
TransactionArray.Transaction.Buyer.FeedbackRatingStar(Y)-(Y)
TransactionArray.Transaction.Buyer.FeedbackScore(Y)-(Y)
TransactionArray.Transaction.Buyer.IDVerified(Y)-(Y)
TransactionArray.Transaction.Buyer.NewUser(Y)-(Y)
TransactionArray.Transaction.Buyer.PositiveFeedbackPercent(Y)-(Y)
TransactionArray.Transaction.Buyer.RegistrationDate(Y)-(Y)
TransactionArray.Transaction.Buyer.Site(Y)-(Y)
TransactionArray.Transaction.Buyer.Status(Y)-(Y)
TransactionArray.Transaction.Buyer.UserID(Y)-(Y)
TransactionArray.Transaction.Buyer.UserIDChanged(Y)-(Y)
TransactionArray.Transaction.Buyer.UserIDLastChanged(Y)-(Y)
TransactionArray.Transaction.Buyer.VATStatus(Y)-(Y)
TransactionArray.Transaction.BuyerCheckoutMessage(Y)(Y)(Y)
TransactionArray.Transaction.BuyerGuaranteePrice(Y)(Y)(Y)
TransactionArray.Transaction.CartID(Y)(Y)(Y)
TransactionArray.Transaction.ContainingOrder(Y)-(Y)
TransactionArray.Transaction.ContainingOrder.CreatingUserRole(Y)(Y)(Y)
TransactionArray.Transaction.ContainingOrder
  .IntegratedMerchantCreditCardEnabled		(Y)-(Y)
TransactionArray.Transaction.ContainingOrder.OrderID(Y)-(Y)
TransactionArray.Transaction.ContainingOrder.OrderStatus(Y)-(Y)
TransactionArray.Transaction.ConvertedAdjustmentAmount(Y)(Y)(Y)
TransactionArray.Transaction.ConvertedAmountPaid(Y)(Y)(Y)
TransactionArray.Transaction.ConvertedTransactionPrice(Y)(Y)(Y)
TransactionArray.Transaction.CreatedDate(Y)(Y)(Y)
TransactionArray.Transaction.DepositType(Y)(Y)(Y)
TransactionArray.Transaction.ExternalTransaction--(Y)
TransactionArray.Transaction.ExternalTransaction
  .ExternalTransactionID		--(Y)
TransactionArray.Transaction.ExternalTransaction
  .ExternalTransactionTime		--(Y)
TransactionArray.Transaction.ExternalTransaction
  .FeeOrCreditAmount		--(Y)
TransactionArray.Transaction.ExternalTransaction
  .PaymentOrRefundAmount		--(Y)
TransactionArray.Transaction.FinalValueFee(Y)(Y)(Y)
TransactionArray.Transaction.ItemYYY
TransactionArray.Transaction.Item.ApplicationData(Y)(Y)(Y)
TransactionArray.Transaction.Item.ApplyShippingDiscount(Y)(Y)(Y)
TransactionArray.Transaction.Item.AutoPayYYY
TransactionArray.Transaction.Item.BuyerProtectionYYY
TransactionArray.Transaction.Item.BuyItNowPrice--(Y)
TransactionArray.Transaction.Item.Charity(Y)(Y)(Y)
TransactionArray.Transaction.Item.Charity.CharityListing(Y)(Y)(Y)
TransactionArray.Transaction.Item.Country(Y)(Y)(Y)
TransactionArray.Transaction.Item.CurrencyYYY
TransactionArray.Transaction.Item.GetItFast--(Y)
TransactionArray.Transaction.Item
  .IntegratedMerchantCreditCardEnabled		Y-Y
TransactionArray.Transaction.Item.InventoryTrackingMethod(Y)-(Y)
TransactionArray.Transaction.Item.ItemIDYYY
TransactionArray.Transaction.Item.ListingDetails--(Y)
TransactionArray.Transaction.Item.ListingDetails.Adult--(Y)
TransactionArray.Transaction.Item.ListingDetails.BindingAuction--(Y)
TransactionArray.Transaction.Item.ListingDetails.CheckoutEnabled--(Y)
TransactionArray.Transaction.Item.ListingDetails
  .ConvertedBuyItNowPrice		--(Y)
TransactionArray.Transaction.Item.ListingDetails
  .ConvertedReservePrice		--(Y)
TransactionArray.Transaction.Item.ListingDetails
  .ConvertedStartPrice		--(Y)
TransactionArray.Transaction.Item.ListingDetails.EndTime--(Y)
TransactionArray.Transaction.Item.ListingDetails
  .HasPublicMessages		--(Y)
TransactionArray.Transaction.Item.ListingDetails.HasReservePrice--(Y)
TransactionArray.Transaction.Item.ListingDetails
  .MinimumBestOfferMessage		--(Y)
TransactionArray.Transaction.Item.ListingDetails
  .MinimumBestOfferPrice		--(Y)
TransactionArray.Transaction.Item.ListingDetails.RelistedItemID--(Y)
TransactionArray.Transaction.Item.ListingDetails.StartTime--(Y)
TransactionArray.Transaction.Item.ListingDetails
  .TCROriginalItemID		--(Y)
TransactionArray.Transaction.Item.ListingDetails.ViewItemURL--(Y)
TransactionArray.Transaction.Item.ListingDetails
  .ViewItemURLForNaturalSearch		--(Y)
TransactionArray.Transaction.Item.ListingTypeYYY
TransactionArray.Transaction.Item.LotSize--(Y)
TransactionArray.Transaction.Item.PaymentMethodsY-Y
TransactionArray.Transaction.Item.PrivateListingYYY
TransactionArray.Transaction.Item.Quantity--Y
TransactionArray.Transaction.Item.SellingStatusY-Y
TransactionArray.Transaction.Item.SellingStatus.BidCount(Y)(Y)(Y)
TransactionArray.Transaction.Item.SellingStatus
  .ConvertedCurrentPrice		(Y)(Y)(Y)
TransactionArray.Transaction.Item.SellingStatus.CurrentPriceYYY
TransactionArray.Transaction.Item.SellingStatus.FinalValueFee(Y)(Y)(Y)
TransactionArray.Transaction.Item.SellingStatus.ListingStatusYYY
TransactionArray.Transaction.Item.SellingStatus.QuantitySoldYYY
TransactionArray.Transaction.Item.Site--(Y)
TransactionArray.Transaction.Item.SKU(Y)-(Y)
TransactionArray.Transaction.Item.StartPrice--(Y)
TransactionArray.Transaction.Item.Title--(Y)
TransactionArray.Transaction.ListingCheckoutRedirectPreference(Y)(Y)(Y)
TransactionArray.Transaction.ListingCheckoutRedirectPreference
  .SellerThirdPartyUsername		(Y)(Y)(Y)
TransactionArray.Transaction.PaidTime(Y)(Y)(Y)
TransactionArray.Transaction.PayPalEmailAddress(Y)(Y)(Y)
TransactionArray.Transaction.PlatformY-Y
TransactionArray.Transaction.QuantityPurchased(Y)(Y)(Y)
TransactionArray.Transaction.SellerContactBuyerByEmail(Y)(Y)(Y)
TransactionArray.Transaction.SellingManagerProductDetails(Y)(Y)(Y)
TransactionArray.Transaction.ShippedTime(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails(Y)-(Y)
TransactionArray.Transaction.ShippingDetails
  .CalculatedShippingRate		(Y)-(Y)
TransactionArray.Transaction.ShippingDetails
  .CalculatedShippingRate.InternationalPackagingHandlingCosts		(Y)-(Y)
TransactionArray.Transaction.ShippingDetails
  .CalculatedShippingRate.OriginatingPostalCode		(Y)-(Y)
TransactionArray.Transaction.ShippingDetails
  .CalculatedShippingRate.PackageDepth		(Y)-(Y)
TransactionArray.Transaction.ShippingDetails
  .CalculatedShippingRate.PackageLength		(Y)-(Y)
TransactionArray.Transaction.ShippingDetails
  .CalculatedShippingRate.PackageWidth		(Y)-(Y)
TransactionArray.Transaction.ShippingDetails
  .CalculatedShippingRate.PackagingHandlingCosts		(Y)-(Y)
TransactionArray.Transaction.ShippingDetails
  .CalculatedShippingRate.ShippingIrregular		(Y)-(Y)
TransactionArray.Transaction.ShippingDetails
  .CalculatedShippingRate.ShippingPackage		(Y)-(Y)
TransactionArray.Transaction.ShippingDetails
  .CalculatedShippingRate.WeightMajor		(Y)-(Y)
TransactionArray.Transaction.ShippingDetails
  .CalculatedShippingRate.WeightMinor		(Y)-(Y)
TransactionArray.Transaction.ShippingDetails
  .ChangePaymentInstructions		(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.CODCost(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails
  .ExcludeShipToLocation		(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.GetItFast(Y)-(Y)
TransactionArray.Transaction.ShippingDetails.InsuranceFee(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.InsuranceOption(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.InsuranceWanted(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.PaymentEdited(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.PaymentInstructions(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.SalesTax(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.SalesTax
  .SalesTaxAmount		(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.SalesTax
  .SalesTaxPercent		(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.SalesTax
  .SalesTaxState		(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.SalesTax
  .ShippingIncludedInTax		(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails
  .SellingManagerSalesRecordNumber		(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails
  .ShipmentTrackingDetails		(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails
  .ShipmentTrackingDetails.ShipmentTrackingNumber		(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails
  .ShipmentTrackingDetails.ShippingCarrierUsed		(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails
  .ShippingRateErrorMessage		(Y)-(Y)
TransactionArray.Transaction.ShippingDetails.ShippingRateType(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.ShippingServiceUsed(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.ShippingType(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.TaxTable(Y)-(Y)
TransactionArray.Transaction.ShippingDetails.TaxTable
  .TaxJurisdiction		(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.TaxTable
  .TaxJurisdiction.JurisdictionID		(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.TaxTable
  .TaxJurisdiction.SalesTaxPercent		(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.TaxTable
  .TaxJurisdiction.ShippingIncludedInTax		(Y)(Y)(Y)
TransactionArray.Transaction.ShippingDetails.ThirdPartyCheckout(Y)-(Y)
TransactionArray.Transaction.ShippingServiceSelected(Y)(Y)(Y)
TransactionArray.Transaction.ShippingServiceSelected
  .ExpeditedService		(Y)-(Y)
TransactionArray.Transaction.ShippingServiceSelected
  .ShippingInsuranceCost		(Y)-(Y)
TransactionArray.Transaction.ShippingServiceSelected
  .ShippingService		(Y)-(Y)
TransactionArray.Transaction.ShippingServiceSelected
  .ShippingServiceAdditionalCost		(Y)-(Y)
TransactionArray.Transaction.ShippingServiceSelected
  .ShippingServiceCost		(Y)-(Y)
TransactionArray.Transaction.ShippingServiceSelected
  .ShippingServicePriority		(Y)-(Y)
TransactionArray.Transaction.ShippingServiceSelected
  .ShippingSurcharge		(Y)-(Y)
TransactionArray.Transaction.ShippingServiceSelected
  .ShippingTimeMax		(Y)-(Y)
TransactionArray.Transaction.ShippingServiceSelected
  .ShippingTimeMin		(Y)-(Y)
TransactionArray.Transaction.Status(Y)(Y)(Y)
TransactionArray.Transaction.Status.BuyerSelectedShipping(Y)(Y)(Y)
TransactionArray.Transaction.Status.CheckoutStatus(Y)(Y)(Y)
TransactionArray.Transaction.Status.CompleteStatus(Y)(Y)(Y)
TransactionArray.Transaction.Status.eBayPaymentStatus(Y)(Y)(Y)
TransactionArray.Transaction.Status
  .IntegratedMerchantCreditCardEnabled		(Y)(Y)(Y)
TransactionArray.Transaction.Status.LastTimeModified(Y)(Y)(Y)
TransactionArray.Transaction.Status.PaymentHoldStatus(Y)(Y)(Y)
TransactionArray.Transaction.Status.PaymentMethodUsed(Y)(Y)(Y)
TransactionArray.Transaction.TransactionIDYYY
TransactionArray.Transaction.TransactionPrice(Y)(Y)(Y)
TransactionArray.Transaction.TransactionSiteID(Y)-(Y)
TransactionArray.Transaction.Variation(Y)(Y)(Y)
TransactionArray.Transaction.Variation.SKU(Y)(Y)(Y)
TransactionArray.Transaction.Variation.VariationSpecifics(Y)(Y)(Y)
TransactionArray.Transaction.Variation.VariationSpecifics
  .NameValueList		(Y)(Y)(Y)
TransactionArray.Transaction.Variation.VariationSpecifics
  .NameValueList.Name		(Y)(Y)(Y)
TransactionArray.Transaction.Variation.VariationSpecifics
  .NameValueList.Value		(Y)(Y)(Y)
TransactionArray.Transaction.Variation.VariationTitle(Y)(Y)(Y)
TransactionArray.Transaction.Variation.VariationViewItemURL(Y)(Y)(Y)
TransactionsPerPageYYY



Back to top

Input Output Detail Controls Samples Change History Top Errors for GetSellerTransactions
GetSellerTransactions Samples

New to making API calls? Please see Routing the Request.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Available samples:

Sample: Basic Call

Returns all transactions for a particular seller.

Description

A transaction is created as soon as someone is the winning bidder or buyer (regardless of whether the item has yet been paid for). User magicalbookseller wants to get basic transaction information for all items she has sold. (To set up this scenario, you could create a BuyItNow listing with one id and use PlaceOffer on that item with another id to buy the item and end the listing.)

Input

For this basic scenario, no input filters are used. RequestorCredentials establishes which user's transactions to look for. 

XML format (HTTP POST). Also available is the .txt version of this XML.

<?xml version="1.0" encoding="utf-8"?>
<GetSellerTransactionsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <RequesterCredentials>
    <eBayAuthToken>ABC...123</eBayAuthToken>
  </RequesterCredentials>
</GetSellerTransactionsRequest>

Output

The response shows all transactions for which magicalbookseller was the selling party. Each transaction is detailed in its own Transaction container within an overall TransactionArray. 

XML format. Also available is the .txt version of this XML.

<?xml version="1.0" encoding="UTF-8"?>
<GetSellerTransactionsResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2008-05-03T00:28:34.355Z</Timestamp>
  <Ack>Success</Ack>
  <Version>563</Version>
  <Build>e563_core_Bundled_6533515_R1</Build>
  <PaginationResult>
    <TotalNumberOfPages>1</TotalNumberOfPages>
    <TotalNumberOfEntries>2</TotalNumberOfEntries>
  </PaginationResult>
  <HasMoreTransactions>false</HasMoreTransactions>
  <TransactionsPerPage>100</TransactionsPerPage>
  <PageNumber>1</PageNumber>
  <ReturnedTransactionCountActual>2</ReturnedTransactionCountActual>
  <Seller>
    <AboutMePage>false</AboutMePage>
    <EIASToken>nY+sHZ2PrBmdj6wVnY+sEZ2PrA2dj6wFk4CpDZSLpwqdj6x9nY+seQ==</EIASToken>
    <Email>testuser_magicalbookseller@yahoo.com</Email>
    <FeedbackScore>25</FeedbackScore>
    <PositiveFeedbackPercent>0.0</PositiveFeedbackPercent>
    <FeedbackPrivate>false</FeedbackPrivate>
    <FeedbackRatingStar>Yellow</FeedbackRatingStar>
    <IDVerified>true</IDVerified>
    <eBayGoodStanding>true</eBayGoodStanding>
    <NewUser>false</NewUser>
    <RegistrationDate>2004-05-27T00:00:00.000Z</RegistrationDate>
    <Site>US</Site>
    <Status>Confirmed</Status>
    <UserID>testuser_magicalbookseller</UserID>
    <UserIDChanged>false</UserIDChanged>
    <UserIDLastChanged>2007-11-29T18:43:54.000Z</UserIDLastChanged>
    <VATStatus>NoVATTax</VATStatus>
    <SellerInfo>
      <AllowPaymentEdit>true</AllowPaymentEdit>
      <CheckoutEnabled>true</CheckoutEnabled>
      <CIPBankAccountStored>false</CIPBankAccountStored>
      <GoodStanding>true</GoodStanding>
      <LiveAuctionAuthorized>false</LiveAuctionAuthorized>
      <MerchandizingPref>OptIn</MerchandizingPref>
      <QualifiesForB2BVAT>false</QualifiesForB2BVAT>
      <SellerLevel>None</SellerLevel>
      <StoreOwner>true</StoreOwner>
      <StoreURL>http://www.stores.sandbox.ebay.com/id=132854966</StoreURL>
      <ExpressEligible>false</ExpressEligible>
      <ExpressWallet>false</ExpressWallet>
      <SafePaymentExempt>true</SafePaymentExempt>
    </SellerInfo>
  </Seller>
  <TransactionArray>
    <Transaction>
      <AmountPaid currencyID="USD">18.0</AmountPaid>
      <AdjustmentAmount currencyID="USD">0.0</AdjustmentAmount>
      <ConvertedAdjustmentAmount currencyID="USD">0.0</ConvertedAdjustmentAmount>
      <Buyer>
        <AboutMePage>false</AboutMePage>
        <EIASToken>nY+sHZ2PrBmdj6wVnY+sEZ2PrA2dj6wFk4CpDZSLpwudj6x9nY+seQ==</EIASToken>
        <Email>testuser_braggybuyer@yahoo.com</Email>
        <FeedbackScore>1</FeedbackScore>
        <PositiveFeedbackPercent>100.0</PositiveFeedbackPercent>
        <FeedbackPrivate>false</FeedbackPrivate>
        <FeedbackRatingStar>None</FeedbackRatingStar>
        <IDVerified>true</IDVerified>
        <eBayGoodStanding>true</eBayGoodStanding>
        <NewUser>false</NewUser>
        <RegistrationDate>2004-02-05T00:00:00.000Z</RegistrationDate>
        <Site>US</Site>
        <Status>Confirmed</Status>
        <UserID>testuser_braggybuyer</UserID>
        <UserIDChanged>false</UserIDChanged>
        <UserIDLastChanged>2007-11-29T18:48:12.000Z</UserIDLastChanged>
        <VATStatus>NoVATTax</VATStatus>
        <BuyerInfo>
          <ShippingAddress>
            <Name>Test User</Name>
            <Street1>address</Street1>
            <CityName>city</CityName>
            <StateOrProvince>WA</StateOrProvince>
            <CountryName>None</CountryName>
            <Phone>(180) 011-1111 ext.: 1</Phone>
            <PostalCode>98102</PostalCode>
            <AddressID>3839387</AddressID>
            <AddressOwner>eBay</AddressOwner>
          </ShippingAddress>
        </BuyerInfo>
        <UserAnonymized>false</UserAnonymized>
      </Buyer>
      <ShippingDetails>
        <ChangePaymentInstructions>false</ChangePaymentInstructions>
        <PaymentEdited>false</PaymentEdited>
        <SalesTax>
          <SalesTaxPercent>0.0</SalesTaxPercent>
          <ShippingIncludedInTax>false</ShippingIncludedInTax>
        </SalesTax>
        <ShippingType>NotSpecified</ShippingType>
        <SellingManagerSalesRecordNumber>129</SellingManagerSalesRecordNumber>
        <ThirdPartyCheckout>false</ThirdPartyCheckout>
        <TaxTable/>
        <GetItFast>false</GetItFast>
      </ShippingDetails>
      <ConvertedAmountPaid currencyID="USD">18.0</ConvertedAmountPaid>
      <ConvertedTransactionPrice currencyID="USD">18.0</ConvertedTransactionPrice>
      <CreatedDate>2008-05-03T00:23:49.000Z</CreatedDate>
      <DepositType>None</DepositType>
      <Item>
        <AutoPay>false</AutoPay>
        <BuyerProtection>ItemIneligible</BuyerProtection>
        <Currency>USD</Currency>
        <ItemID>110031137939</ItemID>
        <ListingType>Chinese</ListingType>
        <PaymentMethods>PayPal</PaymentMethods>
        <PaymentMethods>VisaMC</PaymentMethods>
        <PrivateListing>false</PrivateListing>
        <SellingStatus>
          <BidCount>1</BidCount>
          <CurrentPrice currencyID="USD">18.0</CurrentPrice>
          <ListingStatus>Ended</ListingStatus>
        </SellingStatus>
        <GetItFast>false</GetItFast>
      </Item>
      <QuantityPurchased>1</QuantityPurchased>
      <Status>
        <eBayPaymentStatus>NoPaymentFailure</eBayPaymentStatus>
        <CheckoutStatus>CheckoutIncomplete</CheckoutStatus>
        <LastTimeModified>2008-05-03T00:23:49.000Z</LastTimeModified>
        <PaymentMethodUsed>None</PaymentMethodUsed>
        <CompleteStatus>Incomplete</CompleteStatus>
        <BuyerSelectedShipping>false</BuyerSelectedShipping>
        <PaymentHoldStatus>None</PaymentHoldStatus>
      </Status>
      <TransactionID>0</TransactionID>
      <TransactionPrice currencyID="USD">18.0</TransactionPrice>
      <BestOfferSale>false</BestOfferSale>
      <ShippingServiceSelected>
        <ShippingService>NotSelected</ShippingService>
      </ShippingServiceSelected>
      <TransactionPlatform>eBay</TransactionPlatform>
      <TransactionSiteID>US</TransactionSiteID>
      <Platform>eBay</Platform>
    </Transaction>
    <Transaction>
      <AmountPaid currencyID="USD">18.0</AmountPaid>
      <AdjustmentAmount currencyID="USD">0.0</AdjustmentAmount>
      <ConvertedAdjustmentAmount currencyID="USD">0.0</ConvertedAdjustmentAmount>
      <Buyer>
        <AboutMePage>false</AboutMePage>
        <EIASToken>nY+sHZ2PrBmdj6wVnY+sEZ2PrA2dj6wFk4CpDZSLpwudj6x9nY+seQ==</EIASToken>
        <Email>testuser_braggybuyer@yahoo.com</Email>
        <FeedbackScore>1</FeedbackScore>
        <PositiveFeedbackPercent>100.0</PositiveFeedbackPercent>
        <FeedbackPrivate>false</FeedbackPrivate>
        <FeedbackRatingStar>None</FeedbackRatingStar>
        <IDVerified>true</IDVerified>
        <eBayGoodStanding>true</eBayGoodStanding>
        <NewUser>false</NewUser>
        <RegistrationDate>2004-02-05T00:00:00.000Z</RegistrationDate>
        <Site>US</Site>
        <Status>Confirmed</Status>
        <UserID>testuser_braggybuyer</UserID>
        <UserIDChanged>false</UserIDChanged>
        <UserIDLastChanged>2007-11-29T18:48:12.000Z</UserIDLastChanged>
        <VATStatus>NoVATTax</VATStatus>
        <BuyerInfo>
          <ShippingAddress>
            <Name>Test User</Name>
            <Street1>address</Street1>
            <CityName>city</CityName>
            <StateOrProvince>WA</StateOrProvince>
            <CountryName>None</CountryName>
            <Phone>(180) 011-1111 ext.: 1</Phone>
            <PostalCode>98102</PostalCode>
            <AddressID>3839387</AddressID>
            <AddressOwner>eBay</AddressOwner>
          </ShippingAddress>
        </BuyerInfo>
        <UserAnonymized>false</UserAnonymized>
      </Buyer>
      <ShippingDetails>
        <ChangePaymentInstructions>false</ChangePaymentInstructions>
        <PaymentEdited>false</PaymentEdited>
        <SalesTax>
          <SalesTaxPercent>0.0</SalesTaxPercent>
          <ShippingIncludedInTax>false</ShippingIncludedInTax>
        </SalesTax>
        <ShippingType>NotSpecified</ShippingType>
        <SellingManagerSalesRecordNumber>130</SellingManagerSalesRecordNumber>
        <ThirdPartyCheckout>false</ThirdPartyCheckout>
        <TaxTable/>
        <GetItFast>false</GetItFast>
      </ShippingDetails>
      <ConvertedAmountPaid currencyID="USD">18.0</ConvertedAmountPaid>
      <ConvertedTransactionPrice currencyID="USD">18.0</ConvertedTransactionPrice>
      <CreatedDate>2008-05-03T00:28:09.000Z</CreatedDate>
      <DepositType>None</DepositType>
      <Item>
        <AutoPay>false</AutoPay>
        <BuyerProtection>ItemIneligible</BuyerProtection>
        <Currency>USD</Currency>
        <ItemID>110031137942</ItemID>
        <ListingType>Chinese</ListingType>
        <PaymentMethods>PayPal</PaymentMethods>
        <PaymentMethods>VisaMC</PaymentMethods>
        <PrivateListing>false</PrivateListing>
        <SellingStatus>
          <BidCount>1</BidCount>
          <CurrentPrice currencyID="USD">18.0</CurrentPrice>
          <ListingStatus>Ended</ListingStatus>
        </SellingStatus>
        <GetItFast>false</GetItFast>
      </Item>
      <QuantityPurchased>1</QuantityPurchased>
      <Status>
        <eBayPaymentStatus>NoPaymentFailure</eBayPaymentStatus>
        <CheckoutStatus>CheckoutIncomplete</CheckoutStatus>
        <LastTimeModified>2008-05-03T00:28:09.000Z</LastTimeModified>
        <PaymentMethodUsed>None</PaymentMethodUsed>
        <CompleteStatus>Incomplete</CompleteStatus>
        <BuyerSelectedShipping>false</BuyerSelectedShipping>
        <PaymentHoldStatus>None</PaymentHoldStatus>
      </Status>
      <TransactionID>0</TransactionID>
      <TransactionPrice currencyID="USD">18.0</TransactionPrice>
      <BestOfferSale>false</BestOfferSale>
      <ShippingServiceSelected>
        <ShippingService>NotSelected</ShippingService>
      </ShippingServiceSelected>
      <TransactionPlatform>eBay</TransactionPlatform>
      <TransactionSiteID>US</TransactionSiteID>
      <Platform>eBay</Platform>
    </Transaction>
  </TransactionArray>
</GetSellerTransactionsResponse>

Back to list of samples

Sample: Transactions with Item Variations

Retrieves the transaction details for Item Variations that were sold.

Description

A salesperson from megaonlinemerchant was informed that some of their items have sold. He wants to retrieve the transactions so he can prepare the items for shipment.

Input

The request specifies a time range from the last time he retrieved megaonlinemerchant's transactions to the current time. 

XML format (HTTP POST). Also available is the .txt version of this XML.

<?xml version="1.0" encoding="utf-8"?>
<GetSellerTransactionsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <DetailLevel>ReturnAll</DetailLevel>
  <ModTimeFrom>2009-06-12T13:33:08.757Z</ModTimeFrom>
  <ModTimeTo>2009-06-12T14:33:08.757Z</ModTimeTo>
  <RequesterCredentials>
    <eBayAuthToken>ABC...123</eBayAuthToken>
  </RequesterCredentials>
</GetSellerTransactionsRequest>

Output

In the response, the fields he is particularly interested in for each transaction are the TransactionID, TransactionPrice Transaction.AmountPaid, and Transaction.QuantityPurchased. The salesman knows that megaonlinemerchant often lists with Item Variations, so he also checks for Variation nodes in each transaction. In this case, he finds them and is able to see which variations the buyers purchased. 

XML format. Also available is the .txt version of this XML.

<?xml version="1.0" encoding="utf-8"?>
<GetSellerTransactionsResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2009-06-12T14:40:55.788Z</Timestamp>
  <Ack>Success</Ack>
  <Version>619</Version>
  <Build>e619__Bundled_9183565_R1</Build>
  <PaginationResult>
    <TotalNumberOfPages>1</TotalNumberOfPages>
    <TotalNumberOfEntries>1</TotalNumberOfEntries>
  </PaginationResult>
  <HasMoreTransactions>false</HasMoreTransactions>
  <TransactionsPerPage>100</TransactionsPerPage>
  <PageNumber>1</PageNumber>
  <ReturnedTransactionCountActual>1</ReturnedTransactionCountActual>
  <Seller>
    <AboutMePage>false</AboutMePage>
    <EIASToken>nY+sHZ2PrBmdj6wVnY+sEZ2PrA2dj6wJnY+lDZWHqAidj6x9nY+seQ==</EIASToken>
    <Email>testuser_bountifulbuyer@ebay.com</Email>
    <FeedbackScore>500</FeedbackScore>
    <PositiveFeedbackPercent>0.0</PositiveFeedbackPercent>
    <FeedbackPrivate>false</FeedbackPrivate>
    <FeedbackRatingStar>Purple</FeedbackRatingStar>
    <IDVerified>true</IDVerified>
    <eBayGoodStanding>true</eBayGoodStanding>
    <NewUser>false</NewUser>
    <RegistrationDate>2008-12-11T00:00:00.000Z</RegistrationDate>
    <Site>US</Site>
    <Status>Confirmed</Status>
    <UserID>megaonlinemerchant</UserID>
    <UserIDChanged>false</UserIDChanged>
    <UserIDLastChanged>2006-02-08T21:55:29.000Z</UserIDLastChanged>
    <VATStatus>NoVATTax</VATStatus>
    <SellerInfo>
      <AllowPaymentEdit>true</AllowPaymentEdit>
      <CheckoutEnabled>true</CheckoutEnabled>
      <CIPBankAccountStored>false</CIPBankAccountStored>
      <GoodStanding>true</GoodStanding>
      <LiveAuctionAuthorized>false</LiveAuctionAuthorized>
      <MerchandizingPref>OptIn</MerchandizingPref>
      <QualifiesForB2BVAT>false</QualifiesForB2BVAT>
      <SellerLevel>None</SellerLevel>
      <StoreOwner>false</StoreOwner>
      <ExpressEligible>false</ExpressEligible>
      <ExpressWallet>false</ExpressWallet>
      <SafePaymentExempt>false</SafePaymentExempt>
    </SellerInfo>
    <eBayUnilateralEmail>true</eBayUnilateralEmail>
  </Seller>
  <TransactionArray>
    <Transaction>
      <AmountPaid currencyID="USD">39.13</AmountPaid>
      <AdjustmentAmount currencyID="USD">0.0</AdjustmentAmount>
      <ConvertedAdjustmentAmount currencyID="USD">0.0</ConvertedAdjustmentAmount>
      <Buyer>
        <AboutMePage>false</AboutMePage>
        <EIASToken>nY+sHZ2PrBmdj6wVnY+sEZ2PrA2dj6wJnY+iAZeEqQ2dj6x9nY+seQ==</EIASToken>
        <Email>tuser1@unicorn.qa.ebay.com</Email>
        <FeedbackScore>155</FeedbackScore>
        <PositiveFeedbackPercent>100.0</PositiveFeedbackPercent>
        <FeedbackPrivate>false</FeedbackPrivate>
        <FeedbackRatingStar>Turquoise</FeedbackRatingStar>
        <IDVerified>true</IDVerified>
        <eBayGoodStanding>true</eBayGoodStanding>
        <NewUser>false</NewUser>
        <RegistrationDate>2004-04-04T00:02:13.000Z</RegistrationDate>
        <Site>US</Site>
        <Status>Confirmed</Status>
        <UserID>testuser_bountifulbuyer</UserID>
        <UserIDChanged>false</UserIDChanged>
        <UserIDLastChanged>2001-08-29T21:52:58.000Z</UserIDLastChanged>
        <VATStatus>NoVATTax</VATStatus>
        <BuyerInfo>
          <ShippingAddress>
            <Name>testuser_bountifulbuyer</Name>
            <Street1>2145 Hamilton</Street1>
            <CityName>San Jose</CityName>
            <StateOrProvince>CA</StateOrProvince>
            <Country>US</Country>
            <CountryName>United States</CountryName>
            <PostalCode>95125</PostalCode>
            <AddressID>122205</AddressID>
            <AddressOwner>eBay</AddressOwner>
          </ShippingAddress>
        </BuyerInfo>
        <UserAnonymized>false</UserAnonymized>
      </Buyer>
      <ShippingDetails>
        <CalculatedShippingRate>
          <OriginatingPostalCode>95125</OriginatingPostalCode>
          <PackageDepth measurementSystem="English" unit="inches">6</PackageDepth>
          <PackageLength measurementSystem="English" unit="inches">7</PackageLength>
          <PackageWidth measurementSystem="English" unit="inches">7</PackageWidth>
          <PackagingHandlingCosts currencyID="USD">0.0</PackagingHandlingCosts>
          <ShippingIrregular>false</ShippingIrregular>
          <ShippingPackage>PackageThickEnvelope</ShippingPackage>
          <WeightMajor measurementSystem="English" unit="lbs">2</WeightMajor>
          <WeightMinor measurementSystem="English" unit="oz">0</WeightMinor>
        </CalculatedShippingRate>
        <ChangePaymentInstructions>true</ChangePaymentInstructions>
        <PaymentEdited>false</PaymentEdited>
        <PaymentInstructions>Payment must be received within 7 business days of purchase.</PaymentInstructions>
        <SalesTax>
          <SalesTaxPercent>8.75</SalesTaxPercent>
          <SalesTaxState>CA</SalesTaxState>
          <ShippingIncludedInTax>false</ShippingIncludedInTax>
          <SalesTaxAmount currencyID="USD">3.15</SalesTaxAmount>
        </SalesTax>
        <ShippingType>Calculated</ShippingType>
        <SellingManagerSalesRecordNumber>116</SellingManagerSalesRecordNumber>
        <ThirdPartyCheckout>false</ThirdPartyCheckout>
        <TaxTable>
          <TaxJurisdiction>
            <JurisdictionID>CA</JurisdictionID>
            <SalesTaxPercent>8.75</SalesTaxPercent>
            <ShippingIncludedInTax>false</ShippingIncludedInTax>
          </TaxJurisdiction>
        </TaxTable>
        <GetItFast>false</GetItFast>
      </ShippingDetails>
      <ConvertedAmountPaid currencyID="USD">39.13</ConvertedAmountPaid>
      <ConvertedTransactionPrice currencyID="USD">17.99</ConvertedTransactionPrice>
      <CreatedDate>2009-06-12T14:26:17.000Z</CreatedDate>
      <DepositType>None</DepositType>
      <Item>
        <AutoPay>false</AutoPay>
        <BuyItNowPrice currencyID="USD">0.0</BuyItNowPrice>
        <Currency>USD</Currency>
        <ItemID>110039490209</ItemID>
        <ListingDetails>
          <StartTime>2009-06-12T14:16:25.000Z</StartTime>
          <EndTime>2009-07-12T14:16:25.000Z</EndTime>
          <ExpressListing>false</ExpressListing>
        </ListingDetails>
        <ListingType>FixedPriceItem</ListingType>
        <PaymentMethods>PayPal</PaymentMethods>
        <PrimaryCategory>
          <CategoryID>37565</CategoryID>
        </PrimaryCategory>
        <PrivateListing>false</PrivateListing>
        <Quantity>8</Quantity>
        <SecondaryCategory>
          <CategoryID>0</CategoryID>
        </SecondaryCategory>
        <SellingStatus>
          <CurrentPrice currencyID="USD">17.99</CurrentPrice>
          <QuantitySold>2</QuantitySold>
          <ListingStatus>Active</ListingStatus>
        </SellingStatus>
        <Site>US</Site>
        <StartPrice currencyID="USD">17.99</StartPrice>
        <Title>New Ralph Lauren Polo shirt Pink Black Blue Yellow</Title>
        <GetItFast>false</GetItFast>
        <IntegratedMerchantCreditCardEnabled>false</IntegratedMerchantCreditCardEnabled>
      </Item>
      <QuantityPurchased>2</QuantityPurchased>
      <Status>
        <eBayPaymentStatus>NoPaymentFailure</eBayPaymentStatus>
        <CheckoutStatus>CheckoutIncomplete</CheckoutStatus>
        <LastTimeModified>2009-06-12T14:26:18.000Z</LastTimeModified>
        <PaymentMethodUsed>None</PaymentMethodUsed>
        <CompleteStatus>Incomplete</CompleteStatus>
        <BuyerSelectedShipping>false</BuyerSelectedShipping>
        <PaymentHoldStatus>None</PaymentHoldStatus>
        <IntegratedMerchantCreditCardEnabled>false</IntegratedMerchantCreditCardEnabled>
      </Status>
      <TransactionID>24005469001</TransactionID>
      <TransactionPrice currencyID="USD">17.99</TransactionPrice>
      <BestOfferSale>false</BestOfferSale>
      <ShippingServiceSelected>
        <ShippingService>USPSPriority</ShippingService>
        <ShippingServiceCost currencyID="USD">0.0</ShippingServiceCost>
      </ShippingServiceSelected>
      <TransactionSiteID>US</TransactionSiteID>
      <Platform>eBay</Platform>
      <BuyerGuaranteePrice currencyID="USD">20000.0</BuyerGuaranteePrice>
      <IntangibleItem>false</IntangibleItem>
      <Variation>
        <SKU>RLauren_Wom_TShirt_Pnk_M</SKU>
        <VariationSpecifics>
          <NameValueList>
            <Name>Color</Name>
            <Value>Pink</Value>
          </NameValueList>
          <NameValueList>
            <Name>Size</Name>
            <Value>M</Value>
          </NameValueList>
        </VariationSpecifics>
        <VariationTitle>New Ralph Lauren Polo shirt Pink Black Blue Yellow[Pink,M]</VariationTitle>
        <VariationViewItemURL>http://cgi.sandbox.ebay.com/ws/eBayISAPI.dll?ViewItem&item=110039490209&vti=Color%09Pink%0ASize%09M</VariationViewItemURL>
      </Variation>
    </Transaction>
  </TransactionArray>
</GetSellerTransactionsResponse>

Back to list of samples



Back to top

Input Output Detail Controls Samples Change History Top Errors for GetSellerTransactions
GetSellerTransactions Change History
Version Description
639
2009-10-14
  • ShippingDetails (modified): The ShipmentTrackingNumber element has been moved into the new ShipmentTrackingDetails container, which is returned as a node within the ShippingDetails container. ShipmentTrackingDetails contains both ShippingCarrierUsed and ShipmentTrackingNumber, and is a repeatable container that can provide details for multiple packages shipped for a single item. With this refinement, ShipmentTrackingNumber is no longer returned as individual child element of ShippingDetails.
635
2009-09-16
  • ExcludeShipToLocation (added): Sellers can now exclude specific regions and countries from where they will ship items.
  • InsuranceDetails, InsuranceFee, InsuranceOption, InternationalInsuranceDetails, InsuranceWanted, ShippingInsuranceCost (modified): Sellers can no longer give buyers the option to purchase shipping insurance for either domestic or international items. The buyer-paid shipping insurance option has been removed from the following sites:
    BEFR, BENL, CA, CAFR, HK, IE, IN, MY, Motors, NL, PH, PL, SG, UK, US
    Insurance tags are returned only when the associated item has buyer-paid shipping insurance values.
615
2008-04-29
  • Variation (added): Identifies a variation that was purchased from a multi-variation listing.
  • Quantity, StartPrice, CurrentPrice (modified): Item.Quantity returns the total quantity across all variations, when variations are present. Item.StartPrice and other price fields return the price of the lowest-priced variation. TransactionPrice returns the actual price of the transaction (based on the variation purchased).
603
2009-02-04
  • Item.IntegratedMerchantCreditCardEnabled (added): Indicates that the IntegratedMerchantCreditCard payment method applies to the item.
  • TransactionArray.Transaction.Status.IntegratedMerchantCreditCardEnabled (added): Indicates that the IntegratedMerchantCreditCard payment method applies.
  • TransactionArray.Transaction.ContainingOrder.IntegratedMerchantCreditCardEnabled (added): Indicates that the IntegratedMerchantCreditCard payment method applies.
587
2008-10-15
  • TransactionPlatformCodeType.WorldOfGood (added): The WorldOfGood site will now show up as a transaction platform.
581
2008-09-03
  • Item.ListingType.StoresFixedPrice, Item.ListingType.FixedPriceItem (modified): Listing duration for fixed price items has expanded to include Days_30 and GTC.
573
2008-07-09
  • TransactionArray.Transaction.Item.DigitalDeliveryDetails (deprecated): The digital delivery feature is disabled as of March 28, 2008. GetSellerTransactions no longer returns digital delivery details for digital download items.
563
2008-04-30
  • Transaction.BuyerGuaranteePrice (added): On the Australia site, by early June 2008, BuyerGuaranteePrice is the PayPal Buyer Protection coverage, offered for the item at the time of purchase. Details of coverage are in the following sections of the View Item page: the Buy Safely section and the Payment Details section.
  • BuyerProtection.NoCoverage (added): On the Australia site, by early June 2008, indicates that there is no PayPal Buyer Protection coverage.
561
2008-04-16
  • Item.ListingType.Express (deprecated): Due to the shutdown of UK and Germany eBay Express sites Item.ListingType.Express has been deprecated.
555
2008-03-05
  • ShippingDetails.CODCost (added): Applicable beginning in April. Applies to the Italy site (site ID 101). Contains the cost of cash-on-delivery shipping.
551
2008-02-06
  • NumberOfDays (added): Enables you to specify the number of days' worth of new and modified transactions that you want to retrieve.
  • PaymentHoldStatus (added): Returned in the case of a PayPal payment by the buyer. Provides a status value related to the occurrence of a payment review hold or merchant hold.
537
2007-10-31
  • Item.PaymentMethods.PaisaPayEscrow, Item.PaymentMethods.PaisaPayEscrowEMI (added): These enum will be returned for items offering PaisaPayEscrow and PaisaPayEscrowEMI payment methods.
535
2007-10-17
  • Status.Guest (added): The Guest enum can be returned in TransactionArray.Transaction.Buyer.Status.
519
2007-06-27
  • TransactionPrice (doc change): TransactionPrice is the per-item price for the transaction; transactions with QuantityPurchased of more than 1 have the same value for TransactionPrice as transactions with QuantityPurchased of 1.
503
2007-03-07
  • SellerType.SafePaymentExcempt (added): This field indicates whether a seller is exempt from providing a safe payment method. If a seller is exempt, any safe payment restrictions for a site or a category do not apply.
491
2006-12-13
  • TransactionArray.Transaction.ShippingDetails.PaymentInstructions (doc change): PaymentInstructions can return values longer than 500 characters, and it can be used without other shipping details (e.g., for eBay Motors vehicles).
483
2006-10-18
  • TransactionArray.Transaction.Status.PaymentInProcess, TransactionArray.Transaction.Status.PaymentFailure (added): New payment status values have been added for future use.
477
2006-09-06
  • ShippingTypes: CalculatedDomesticFlatInternational, FlatDomesticCalculatedInternational (added): Two more shipping types were introduced to enable a seller to use flat rate shipping for the domestic services and calculated shipping for the international shipping services, or vice versa. See the Shipping documentation for details.
  • BuyerPaymentMethodCodeType.ELV (added): Now supports a new payment method, enabling Express Germany to introduce bank payments through Elektronisches Lastschriftverfahren (direct debit). With ELV, a purchase amount is automatically deducted from a buyer's bank account, after the buyer has provided his or her bank details and agreed to the deduction.
475
2006-08-23
  • Item.SellingStatus.BidCount (modified): BidCount is now returned for items that allow competitive-bidding (Chinese and Dutch auctions).
467
2006-06-28
  • TransactionArray.Transaction.Item.DigitalDeliveryDetails (added): Returns empty for digital listing transactions.
459
2006-05-03
  • TransactionArray.Transaction.TransactionPlatform (added): The platform (eBay or Express) on which the transaction was created.
427
2005-09-21
  • IncludeFinalValueFee (added): Retrieves the final value fee, if any.
  • Transaction.Item.SellingStatus.FinalValueFee (added): The final value fee of a Dutch auction that ended with bids (not purchases).
  • Transaction.Item.SellingStatus.ListingStatus (added): Specifies an active or ended listing's status in eBay's processing workflow. For items that have sold, this to determine whether eBay has finished processing total price, winning bidder/buyer, and Final Value Fee details.
  • Transaction.FinalValueFee (added): The final value fee of a listing (except Dutch auctions that end with bids but not purchases).
  • TransactionStatus.PaymentMethodUsed (modified): Before this release, if checkout was not yet complete, PaymentMethodUsed was set to None. Now, if checkout is not yet complete, PaymentMethodUsed is set to whatever the buyer selected as his or her preference on the Review Your Purchase page.
415
2005-06-29
  • ShippingDetails.GetItFast (added): This tag has been added to support the new Get It Fast feature.
411
2005-6-1
  • ShippingPackage (modified): A new value, ExtraLargePack, has been added.
  • Transaction.Status (added): A new value, BuyerSelectedShipping, has been added.
  • ShippingRegion (modified): New values Worldwide and WillNotShip have been added.
403
2005-4-6
  • SellingManagerProductDetailsType (modified): ProductPartNumber is now returned as part of the SellingManagerProductDetailsType for part numbers that are strings.

This document was generated with a customized version of the apireferencedocs tool.

© 2005–2009 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.