eBay Trading API897

GetAccount

Use this call to retrieve a seller's invoice data for their eBay account, including the account's summary data.

Usage Details

GetAccount returns account data in one of three report formats, depending on the inputs used for the call. Specify the type of report to generate with AccountHistorySelection. The types of reports you can request are LastInvoice (returns entries since last invoice sent), SpecifiedInvoice (filters by a specific month and year), and BetweenSpecifiedDates (returns invoices posted between specific dates).

You can sort the response by specifying a AccountEntrySortType in the request. Sort the response by AccountEntry.Date, AccountEntry.ItemID, or AccountEntry.Description, in either ascending or descending order.

You can also use Pagination values to specify how to break the result set into smaller, more manageable chunks. Pagination.EntriesPerPage controls the number of account entries returned from the call, and Pagination.PageNumber (a value between 1 and 200) specifies which page of data to retrieve in the current call.

Working with the Response

GetAccount returns individual account entries in the AccountEntries field, and summary account data in the AccountSummary field.

The AccountEntries property is an array containing a set of AccountEntry objects, each of which represents one transaction posted to the seller's account. Each AccountEntry contains information about the respective transaction, such as the transaction type, the amount of the transaction, the date the transaction was posted to the account, and the associated item ID (if an item listing is associated with the transaction, such as a charge for listing fees).

  1. Inspect the contents of each AccountEntries.AccountEntry container to get the values for each invoice.
  2. Inspect AccountSummary to obtain the account's summary data (such as the current balance and the last amount paid), and for data relating to any additional accounts associated with the requesting user.
  3. Store the appropriate response data as applicable for your application.

You can uniquely identify entries in the AccountEntries container by combining the following fields to form a unique key: AccountEntry.Date, AccountEntry.AccountDetailsEntryType, AccountEntry.ItemID, and AccountEntry.RefNumber.

In the output, Pagination.TotalNumberOfEntries indicates the total number of account entries that can be returned with multiple calls (given the report type and date range). Pagination.TotalNumberOfPages indicates the total number of pages of data that can be returned.

There are no limits on the number of account entries that can be returned using GetAccount. However, eBay only returns records posted within the last four months. This is due to the way eBay archives user data.

Testing GetAccount

Because of certain restrictions, GetAccount is not fully functional in the Sandbox environment. To test GetAccount in the Sandbox, use the following test users:

Each of these special test users has a Password value of p@ss123.

Additionally, the Sandbox supports only the following currency codes: EUR, USD, GBP.

It is recommended that you test GetAccount with several of the test users because their account information is regularly updated with test data and each user has different account information (for example, Currency values and invoice information differs between the different test users).

Related Information

See:
    Getting Account Information
    Testing Applications

See also the reference documentation for these calls:



Back to top

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"?>
<GetAccountRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <AccountEntrySortType> AccountEntrySortTypeCodeType </AccountEntrySortType>
  <AccountHistorySelection> AccountHistorySelectionCodeType </AccountHistorySelection>
  <BeginDate> dateTime </BeginDate>
  <Currency> CurrencyCodeType </Currency>
  <EndDate> dateTime </EndDate>
  <ExcludeBalance> boolean </ExcludeBalance>
  <ExcludeSummary> boolean </ExcludeSummary>
  <IncludeConversionRate> boolean </IncludeConversionRate>
  <InvoiceDate> dateTime </InvoiceDate>
  <ItemID> ItemIDType (string) </ItemID>
  <Pagination> PaginationType
    <EntriesPerPage> int </EntriesPerPage>
    <PageNumber> int </PageNumber>
  </Pagination>
  <!-- Standard Input Fields -->
  <ErrorLanguage> string </ErrorLanguage>
  <MessageID> string </MessageID>
  <OutputSelector> string </OutputSelector>
  <!-- ... more OutputSelector values allowed here ... -->
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
</GetAccountRequest>
Argument Type Occurrence Meaning
Call-specific Input Fields [Jump to standard fields]
AccountEntrySortType AccountEntrySortTypeCodeType Optional Specifies how account entries should be sorted in the response, by an element and then in ascending or descending order.

Applicable values:

AccountEntryCreatedTimeAscending
(in) With this value set, account entries in the GetAccount response are sorted by transaction date (see AccountEntry.Date field) in ascending order (oldest transaction to most recent transaction). This value will produce the same results as the None value.
AccountEntryCreatedTimeDescending
(in) With this value set, account entries in the GetAccount response are sorted by transaction date (see AccountEntry.Date field) in descending order (most recent transaction to oldest transaction).
AccountEntryFeeTypeAscending
(in) With this value set, account entries in the GetAccount response are sorted in alphabetical order according to each entry's AccountEntry.Description value. When account entries are sorted according to fee type, the secondary sort criterion is transaction date, and for account entries with identical fee types, the oldest account entries will appear first in the response.
AccountEntryFeeTypeDescending
(in) With this value set, account entries in the GetAccount response are sorted in reverse alphabetical order according to each entry's AccountEntry.Description value. When account entries are sorted according to fee type, the secondary sort criterion is transaction date, and for account entries with identical fee types, the oldest account entries will appear first in the response.
AccountEntryItemNumberAscending
(in) With this value set, account entries in the GetAccount response are sorted by Item ID value (see AccountEntry.ItemID field) in ascending order (oldest eBay listing to most recent eBay listing).
AccountEntryItemNumberDescending
(in) With this value set, account entries in the GetAccount response are sorted by Item ID value (see AccountEntry.ItemID field) in descending order (most recent eBay listing to oldest eBay listing).
CustomCode
(in) Reserved for internal or future use.
None
(in) This is the default value. With this value set, account entries in the GetAccount response are sorted by transaction date (see AccountEntry.Date field) in ascending order (oldest transaction to most recent transaction). This value will produce the same results as the AccountEntryCreatedTimeAscending value.

AccountHistorySelection AccountHistorySelectionCodeType Optional This field is used by the user to control which account entries are returned. The user has options to retrieve all new account entries (since last invoice), all account entries between two specified dates, or all account entries from a specified invoice. If this field is not include
Default: LastInvoice.

Applicable values:

BetweenSpecifiedDates
(in) Contains entries that were posted to the seller's account between two dates. The period covered may cross the boundaries of formal invoices. If you use BetweenSpecifiedDates, then you also must specify BeginDate and EndDate. If you use BetweenSpecifiedDates, then InvoiceDate is ignored.
CustomCode
(in) Reserved for internal or future use.
LastInvoice
(in) Contains the entries since the last invoice eBay sent to the seller. If you use LastInvoice, then InvoiceDate, BeginDate and EndDate are ignored.
SpecifiedInvoice
(in) Contains the entries for a specific invoice, identified by the invoice month and year. If you use SpecifiedInvoice, then you must also use InvoiceDate. If you use SpecifiedInvoice, then BeginDate and EndDate are ignored.

BeginDate dateTime Conditional This field is used to retrieve all account entries dating back to the timestamp passed into this BeginDate field up until the timestamp passed into the EndDate field. The BeginDate value can not be set back any further than four months into the past.

The allowed date formats are YYYY-MM-DD and YYYY-MM-DD HH:mm:ss The BeginDate value must be less than or equal to the EndDate value. The user might use the same values in both fields if that user wanted to retrieve all account entries from a specific day (if YYYY-MM-DD format used) or wanted to retrieve a specific account entry (if YYYY-MM-DD HH:mm:ss format used).

This field is only applicable if the AccountHistorySelection value is set to 'BetweenSpecifiedDates'; otherwise, this field will be ignored. fiedDates' is used, both the BeginDate and EndDate must be included.
Currency CurrencyCodeType Optional Specifies the currency used in the account report. Do not specify Currency in the request unless the following conditions are met. First, the user has or had multiple accounts under the same UserID. Second, the account identified in the request uses the currency you specify in the request. An error is returned if no account is found that uses the currency you specify in the request.

Applicable values: See Currency.
EndDate dateTime Conditional This field is used to retrieve all account entries dating up to the timestamp passed into this EndDate field dating back to the timestamp passed into the BeginDate field. The EndDate value can not be set for a future date.

The allowed date formats are YYYY-MM-DD and YYYY-MM-DD HH:mm:ss The EndDate value must be more than or equal to the BeginDate value. The user might use the same values in both fields if that user wanted to retrieve all account entries from a specific day (if YYYY-MM-DD format used) or wanted to retrieve a specific account entry (if YYYY-MM-DD HH:mm:ss format used).

This field is only applicable if the AccountHistorySelection value is set to 'BetweenSpecifiedDates'; otherwise, this field will be ignored. If 'BetweenSpecifiedDates' is used, both the BeginDate and EndDate must be included.
ExcludeBalance boolean Optional By default, the current balance of the user's account will not be returned in the call response. To retrieve the current balance of their account, the user should include the ExcludeBalance flag in the request and set its value to 'false'. The current balance on the account will be shown in the AccountSummary.CurrentBalance field in the call response.
Default: true.
ExcludeSummary boolean Optional Specifies whether to return account summary information in an AccountSummary node. Default is true, to return AccountSummary.
IncludeConversionRate boolean Optional Specifies whether to retrieve the rate used for the currency conversion for usage transactions.
InvoiceDate dateTime Conditional This field is used to retrieve all account entries from a specific invoice, which is identified through this InvoiceDate field with the timestamp of the account invoice. This field is only applicable if the AccountHistorySelection value is set to 'SpecifiedInvoice'; otherwise, this field will be ignored.
ItemID ItemIDType (string) Optional Specifies the item ID for which to return account entries. If ItemID is used, all other filters in the request are ignored. If the specified item does not exist or if the requesting user is not the seller of the item, an error is returned.
Pagination PaginationType Optional This container is used to control how many account entries are returned on each page of data in the response. PaginationType is used by numerous Trading API calls, and the default and maximum values for the EntriesPerPage field differs with each call. For the GetAccount call, the default value is 500 (account entries) per page, and maximum allowed value is 2000 (account entries) per page.
Pagination.EntriesPerPage int Optional This integer value is used to specify the maximum number of entries to return in a single "page" of data. This value, along with the number of entries that match the input criteria, will determine the total pages (see PaginationResult.TotalNumberOfPages) in the result set. For most Trading API calls, the maximum value is 200 and the default value is 25 entries per page.

For GetOrders, the maximum value is 100 and the default value is 25 orders per page.

For GetUserDisputes, this value is hard-coded at 200, and any pagination input is ignored.

For GetProducts, the maximum value is 20, and any higher values are ignored.
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.
Min: 1. Default: 1.
Standard Input Fields  
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
en_AU Australia
de_AT Austria
nl_BE Belgium (Dutch)
fr_BE Belgium (French)
en_CA Canada
fr_CA Canada (French)
zh_CN China
fr_FR France
de_DE Germany
zh_HK Hong Kong
en_IN India
en_IE Ireland
it_IT Italy
nl_NL Netherlands
en_SG Singapore
es_ES Spain
de_CH Switzerland
en_GB United Kingdom
en_US United States

See Tags for the Identification of Languages.

MessageID string Optional Most Trading API calls support a MessageID element in the request and a CorrelationID element in the response. If you pass in a MessageID in a request, the same value will be returned in the CorrelationID field in the response. Pairing these values can help you track and confirm that a response is returned for every request and to match specific responses to specific requests. If you do not pass a MessageID value in the request, CorrelationID is not returned.

Note: GetCategories is designed to retrieve very large sets of metadata that change once a day or less often. To improve performance, these calls return cached responses when you request all available data (with no filters). When this occurs, the MessageID and CorrelationID fields aren't applicable. However, if you specify an input filter to reduce the amount of data returned, the calls retrieve the latest data (not cached). When this occurs, MessageID and CorrelationID are applicable.
OutputSelector string Optional,
repeatable: [0..*]
You can use the OutputSelector field to restrict the data returned by a call. This field can make the call response easier to manage, especially when a large payload is returned. If you use the OutputSelector field, the output data will only include the fields you specified in the request. For example, if you are using GetItem and you only want to retrieve the URL of the View Item page (emitted in ViewItemURL field) and the item's Buy It Now price (emitted in BuyItNowPrice field), you would include two separate OutputSelector fields and set the value for each one as 'ViewItemURL' and 'BuyItNowPrice' as in the following example:

 ...
<OutputSelector>ViewItemURL</OutputSelector>
<OutputSelector>BuyItNowPrice</OutputSelector>

...

See Selecting Fields to Retrieve.

Version string Conditional The version number of the API code that you are programming against (e.g., 859). 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:
    Routing the Request (Gateway URLs)
    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 performed in the Production environment.

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.



Back to top

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

<?xml version="1.0" encoding="utf-8"?>
<GetAccountResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <AccountEntries> AccountEntriesType
    <AccountEntry> AccountEntryType
      <AccountDetailsEntryType> AccountDetailEntryCodeType </AccountDetailsEntryType>
      <Balance currencyID="CurrencyCodeType"> AmountType (double) </Balance>
      <ConversionRate currencyID="CurrencyCodeType"> AmountType (double) </ConversionRate>
      <Date> dateTime </Date>
      <Description> string </Description>
      <GrossDetailAmount currencyID="CurrencyCodeType"> AmountType (double) </GrossDetailAmount>
      <ItemID> ItemIDType (string) </ItemID>
      <Memo> string </Memo>
      <NetDetailAmount currencyID="CurrencyCodeType"> AmountType (double) </NetDetailAmount>
      <OrderLineItemID> string </OrderLineItemID>
      <ReceivedTopRatedDiscount> boolean </ReceivedTopRatedDiscount>
      <RefNumber> string </RefNumber>
      <Title> string </Title>
      <TransactionID> string </TransactionID>
      <VATPercent> decimal </VATPercent>
    </AccountEntry>
    <!-- ... more AccountEntry nodes allowed here ... -->
  </AccountEntries>
  <AccountID> string </AccountID>
  <AccountSummary> AccountSummaryType
    <AccountState> AccountStateCodeType </AccountState>
    <AdditionalAccount> AdditionalAccountType
      <AccountCode> string </AccountCode>
      <Balance currencyID="CurrencyCodeType"> AmountType (double) </Balance>
      <Currency> CurrencyCodeType </Currency>
    </AdditionalAccount>
    <!-- ... more AdditionalAccount nodes allowed here ... -->
    <AmountPastDue currencyID="CurrencyCodeType"> AmountType (double) </AmountPastDue>
    <BankAccountInfo> string </BankAccountInfo>
    <BankModifyDate> dateTime </BankModifyDate>
    <BillingCycleDate> int </BillingCycleDate>
    <CreditCardExpiration> dateTime </CreditCardExpiration>
    <CreditCardInfo> string </CreditCardInfo>
    <CreditCardModifyDate> dateTime </CreditCardModifyDate>
    <CurrentBalance currencyID="CurrencyCodeType"> AmountType (double) </CurrentBalance>
    <InvoiceBalance currencyID="CurrencyCodeType"> AmountType (double) </InvoiceBalance>
    <InvoiceCredit currencyID="CurrencyCodeType"> AmountType (double) </InvoiceCredit>
    <InvoiceDate> dateTime </InvoiceDate>
    <InvoiceNewFee currencyID="CurrencyCodeType"> AmountType (double) </InvoiceNewFee>
    <InvoicePayment currencyID="CurrencyCodeType"> AmountType (double) </InvoicePayment>
    <LastAmountPaid currencyID="CurrencyCodeType"> AmountType (double) </LastAmountPaid>
    <LastPaymentDate> dateTime </LastPaymentDate>
    <PastDue> boolean </PastDue>
    <PaymentMethod> SellerPaymentMethodCodeType </PaymentMethod>
  </AccountSummary>
  <Currency> CurrencyCodeType </Currency>
  <EntriesPerPage> int </EntriesPerPage>
  <HasMoreEntries> boolean </HasMoreEntries>
  <PageNumber> int </PageNumber>
  <PaginationResult> PaginationResultType
    <TotalNumberOfEntries> int </TotalNumberOfEntries>
    <TotalNumberOfPages> int </TotalNumberOfPages>
  </PaginationResult>
  <!-- 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 allowed here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes allowed here ... -->
  <HardExpirationWarning> string </HardExpirationWarning>
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
</GetAccountResponse>
Return Value Type Occurrence Meaning
Call-specific Output Fields [Jump to standard fields]
AccountEntries AccountEntriesType Conditionally This container holds an array of account entries. The account entries that are returned are dependent on the selection that the user made in the AccountHistorySelection field in the call request. Each AccountEntry container consists of one credit, one debit, or one administrative action on the account. It is possible that no AccountEntry containers will be returned if no account entries exist since the last invoice (if 'LastInvoice' value is used), between the specified dates (if 'BetweenSpecifiedDates' value is used), or on a specified invoice (if 'SpecifiedInvoice' value is used).
AccountEntries.AccountEntry AccountEntryType Conditionally,
repeatable: [0..*]
Container consisting of detailed information for each debit or credit transaction that occurs on an eBay user's account.
AccountEntries.AccountEntry
  .AccountDetailsEntryType
AccountDetailEntryCodeType Conditionally This enumeration value indicates the type of transaction or administrative action that occurred on the eBay user's account. Possible values are defined in the AccountDetailEntryCodeType enumerated type.

Applicable values: See AccountDetailsEntryType.
AccountEntries.AccountEntry
  .Balance
AmountType (double) Conditionally This field is no longer returned. If the eBay user has an outstanding balance owed to eBay, the owed amount will be displayed in the AccountSummary.CurrentBalance field in the GetAccount response.
AccountEntries.AccountEntry
  .Balance
  [ attribute currencyID ]
CurrencyCodeType Always This field is no longer returned. If the eBay user has an outstanding balance owed to eBay, the owed amount will be displayed in the AccountSummary.CurrentBalance field in the GetAccount response.

For a list of possible enumeration values, see CurrencyCodeType.
AccountEntries.AccountEntry
  .ConversionRate
AmountType (double) Conditionally The rate used for the currency conversion for a transaction.
AccountEntries.AccountEntry
  .ConversionRate
  [ attribute currencyID ]
CurrencyCodeType Always The rate used for the currency conversion for a transaction.

For a list of possible enumeration values, see CurrencyCodeType.
AccountEntries.AccountEntry
  .Date
dateTime Conditionally Timestamp indicating the date and time that the entry was posted to the account, in GMT.
AccountEntries.AccountEntry
  .Description
string Conditionally The category of the monetary transaction or administrative action applied to an eBay account.
AccountEntries.AccountEntry
  .GrossDetailAmount
AmountType (double) Conditionally Gross fees that are assessed by eBay (net fees plus VAT, if any). Returned even if VAT does not apply. The value is positive for debits and negative for credits.
AccountEntries.AccountEntry
  .GrossDetailAmount
  [ attribute currencyID ]
CurrencyCodeType Always Gross fees that are assessed by eBay (net fees plus VAT, if any). Returned even if VAT does not apply. The value is positive for debits and negative for credits.

For a list of possible enumeration values, see CurrencyCodeType.
AccountEntries.AccountEntry
  .ItemID
ItemIDType (string) Conditionally If the account entry is associated with an eBay listing, this field shows the eBay ItemID value. If there is no correlation between the account entry and one of the user's eBay listings, '0' is returned in this field.
Max length: 19 (Note: The eBay database specifies 38. ItemIDs are usually 9 to 12 digits).
AccountEntries.AccountEntry
  .Memo
string Conditionally Memo line for the account entry. It can be an empty string.
AccountEntries.AccountEntry
  .NetDetailAmount
AmountType (double) Conditionally Net fees that are assessed by eBay, excluding additional surcharges and VAT (if any). Returned even if VAT does not apply. The value is positive for debits (user pays eBay) and negative for credits (eBay pays user).
AccountEntries.AccountEntry
  .NetDetailAmount
  [ attribute currencyID ]
CurrencyCodeType Always Net fees that are assessed by eBay, excluding additional surcharges and VAT (if any). Returned even if VAT does not apply. The value is positive for debits (user pays eBay) and negative for credits (eBay pays user).

For a list of possible enumeration values, see CurrencyCodeType.
AccountEntries.AccountEntry
  .OrderLineItemID
string Conditionally OrderLineItemID is a unique identifier for an eBay order line item and is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs. This field is only returned if the account entry is associated with an order line item.
Max length: 100.
AccountEntries.AccountEntry
  .ReceivedTopRatedDiscount
boolean Conditionally This boolean field is returned as 'true' if the seller received a discount on the Final Value Fee for the order line item. Only Top-Rated sellers are eligible for this Final Value Fee discount. The Final Value Fee discount percentage varies by country. For more information on becoming a Top-Rated Seller in the US and the requirements for Top-Rated Plus listings, see the Becoming a Top Rated Seller and qualifying for Top Rated Plus eBay Customer Support topic.
AccountEntries.AccountEntry
  .RefNumber
string Conditionally This value is the unique identifier for the account entry. This value is created by eBay once the transaction occurs on the user's account.
AccountEntries.AccountEntry
  .Title
string Conditionally A description or comment about the monetary transaction or administrative action applied to an eBay user account.
AccountEntries.AccountEntry
  .TransactionID
string Conditionally The unique identifier of an order line item. This field is only returned if the account entry is associated with an order line item.
Max length: 19.
AccountEntries.AccountEntry
  .VATPercent
decimal Conditionally The applicable rate that was used to calculate the VAT (Value-Added Tax) for the transaction. When the VATPercent is specified for a listing, the item's VAT information appears on the View Item page. In addition, the seller can choose to print an invoice that includes the item's net price, VAT percent, VAT amount, and total price. Since VAT rates vary depending on the item and on the user's country of residence, a seller is responsible for entering the correct VAT rate; it is not calculated by eBay. VAT is only applicable to sellers located in a European Union (EU) country. If VAT does not apply to the account entry, this field is still returned but it's value will be '0'.
AccountID string Always Specifies the seller's unique account number.
AccountSummary AccountSummaryType Conditionally Contains summary data for the seller's account, such as the overall balance, bank account and credit card information, and amount and date of any past due balances. Can also contain data for one or more additional accounts, if the user has changed country of residence.
AccountSummary.AccountState AccountStateCodeType Conditionally Indicates the current state of the account (such as active or inactive). Possible values are enumerated in the AccountStateCodeType code list.

Applicable values:

Active
(out) The account is active.
CustomCode
(out) Reserved for internal or future use.
Inactive
(out) The account is inactive. No new seller account entries would be posted by eBay to the account.
Pending
(out) The account has been created but is not yet active, pending additional information or processing by eBay.

AccountSummary
  .AdditionalAccount
AdditionalAccountType Conditionally,
repeatable: [0..*]
Contains the data for one additional account. An AccountSummaryType object may return zero, one, or multiple additional accounts. See the schema documentation for AdditionalAccountType for details on additional accounts. The value is positive for debits and negative for credits.
AccountSummary
  .AdditionalAccount.AccountCode
string Conditionally Indicates the unique identifier for the additional account (the account ID).
AccountSummary
  .AdditionalAccount.Balance
AmountType (double) Conditionally Indicates the current balance of the additional account.
AccountSummary
  .AdditionalAccount.Balance
  [ attribute currencyID ]
CurrencyCodeType Always Indicates the current balance of the additional account.

For a list of possible enumeration values, see CurrencyCodeType.
AccountSummary
  .AdditionalAccount.Currency
CurrencyCodeType Conditionally Indicates the currency in which monetary amounts for the additional account are expressed.

Applicable values: See Currency.
AccountSummary.AmountPastDue AmountType (double) Conditionally Amount past due, 0.00 if not past due. The value is positive for debits and negative for credits.
AccountSummary.AmountPastDue
  [ attribute currencyID ]
CurrencyCodeType Always Amount past due, 0.00 if not past due. The value is positive for debits and negative for credits.

For a list of possible enumeration values, see CurrencyCodeType.
AccountSummary.BankAccountInfo string Conditionally First four digits of the bank account the user associated with the seller account (with remainder Xed-out). This may be an empty string depending upon the payment type the user selected for the account (e.g., if no debit-card specified).
Max length: 4.
AccountSummary.BankModifyDate dateTime Conditionally Indicates the date and time BankAccountInfo was last modified, in GMT. (Also see the Data Types appendix for more information on how GMT dates are handled in SOAP.) This may be an empty string depending upon the payment type the user selected for the account (e.g., if no debit-card specified).
AccountSummary
  .BillingCycleDate
int Conditionally Indicates the billing cycle in which eBay sends a billing invoice to the user. A value of 0 (zero) indicates an invoice sent on the last day of the month. A value of 15 indicates an invoice sent on the 15th day of the month.
AccountSummary
  .CreditCardExpiration
dateTime Conditionally Expiration date for the credit card selected by the user as payment method for the account, in GMT. (Also see the Data Types appendix for more information on how GMT dates are handled in SOAP.) Empty string if no credit card is on file or if the account is inactive - even if there is a credit card on file.
AccountSummary.CreditCardInfo string Conditionally Last four digits of the credit card the user selected as payment method for the account. Empty string if no credit is on file.
AccountSummary
  .CreditCardModifyDate
dateTime Conditionally Indicates the date and time credit card or credit card expiration date was last modified, in GMT. (Also see the Data Types appendix for more information on how GMT dates are handled in SOAP.) This may be an empty string depending on the payment method the user selected for the account (e.g., Empty string if no credit card is on file.)
AccountSummary.CurrentBalance AmountType (double) Conditionally This field shows the current balance for the user's account. This value can be '0.00', a positive amount (debit), or a negative amount (credit).

This field is only returned if the ExcludeBalance flag is included in the call request and set to 'false'.
AccountSummary.CurrentBalance
  [ attribute currencyID ]
CurrencyCodeType Always This field shows the current balance for the user's account. This value can be '0.00', a positive amount (debit), or a negative amount (credit).

This field is only returned if the ExcludeBalance flag is included in the call request and set to 'false'.

For a list of possible enumeration values, see CurrencyCodeType.
AccountSummary.InvoiceBalance AmountType (double) Conditionally Amount of last invoice. 0.00 if account not yet invoiced. The value is positive for debits and negative for credits.
AccountSummary.InvoiceBalance
  [ attribute currencyID ]
CurrencyCodeType Always Amount of last invoice. 0.00 if account not yet invoiced. The value is positive for debits and negative for credits.

For a list of possible enumeration values, see CurrencyCodeType.
AccountSummary.InvoiceCredit AmountType (double) Conditionally Specifies credits granted since the previous invoice, but is only returned AccountHistorySelection is LastInvoice or Specified Invoice. The value is positive for debits and negative for credits.
AccountSummary.InvoiceCredit
  [ attribute currencyID ]
CurrencyCodeType Always Specifies credits granted since the previous invoice, but is only returned AccountHistorySelection is LastInvoice or Specified Invoice. The value is positive for debits and negative for credits.

For a list of possible enumeration values, see CurrencyCodeType.
AccountSummary.InvoiceDate dateTime Conditionally Date of last invoice sent by eBay to the user, in GMT. (Also see the Data Types appendix for more information on how GMT dates are handled in SOAP.) Empty string if this account has not been invoiced yet.
AccountSummary.InvoiceNewFee AmountType (double) Conditionally Specifies fees incurred since the last invoice, including tax if applicable. Returned only if AccountHistorySelection is LastInvoice or Specified Invoice. The value is positive for debits and negative for credits.
AccountSummary.InvoiceNewFee
  [ attribute currencyID ]
CurrencyCodeType Always Specifies fees incurred since the last invoice, including tax if applicable. Returned only if AccountHistorySelection is LastInvoice or Specified Invoice. The value is positive for debits and negative for credits.

For a list of possible enumeration values, see CurrencyCodeType.
AccountSummary.InvoicePayment AmountType (double) Conditionally Specifies payment made since the previous invoice, but is returned only if AccountHistorySelection is LastInvoice or Specified Invoice. The value is positive for debits and negative for credits.
AccountSummary.InvoicePayment
  [ attribute currencyID ]
CurrencyCodeType Always Specifies payment made since the previous invoice, but is returned only if AccountHistorySelection is LastInvoice or Specified Invoice. The value is positive for debits and negative for credits.

For a list of possible enumeration values, see CurrencyCodeType.
AccountSummary.LastAmountPaid AmountType (double) Conditionally Amount of last payment posted, 0.00 if no payments posted. The value is positive for debits and negative for credits.
AccountSummary.LastAmountPaid
  [ attribute currencyID ]
CurrencyCodeType Always Amount of last payment posted, 0.00 if no payments posted. The value is positive for debits and negative for credits.

For a list of possible enumeration values, see CurrencyCodeType.
AccountSummary.LastPaymentDate dateTime Conditionally Date of last payment by the user to eBay, in GMT. (Also see the Data Types appendix for more information on how GMT dates are handled in SOAP.) Empty string if no payments have been posted.
AccountSummary.PastDue boolean Conditionally Indicates whether the account has past due amounts outstanding. A value of true indicates that the account is past due. A value of false indicates the account is current.
AccountSummary.PaymentMethod SellerPaymentMethodCodeType Conditionally Indicates the method the user selected to pay eBay with for the account. The values for PaymentMethod vary from one global eBay site to the next. Payment methods are enumerated in the SellerPaymentMethodCodeType code list.

Applicable values:

CreditCard
(out) Credit Card
CustomCode
(out) Reserved for internal or future use
DirectDebit
(out) Direct Debit
DirectDebitPendingSignatureMandate
(out) Direct Debit, pending signature mandate
DirectDebitPendingVerification
(out) Direct Debit, pending verification
eBayDirectPay
(out) eBay Direct Pay
NothingOnFile
(out) Used for all other payment methods which are not specifically listed in other columns.
PayPal
(out) PayPal

Currency CurrencyCodeType Always Indicates the currency used for monetary amounts in the report.

Applicable values: See Currency.
EntriesPerPage int Always This integer value indicates the number of account entries that are being returned per virtual page of data. This value will be the same value passed into the Pagination.EntriesPerPage field in the request.
HasMoreEntries boolean Conditionally If this boolean value is returned as 'true', there are more account entries to view on one or more pages of data. To view additional entries, the user would have to make additional GetAccount calls and increment the value of the Pagination.PageNumber field by '1' to view additional pages of account entries.
PageNumber int Always This integer value indicates the current page number of account entries that is currently being shown. This value will be the same value passed into the Pagination.PageNumber field in the request.
PaginationResult PaginationResultType Always This container shows the total number of account entries and the total number of account entry pages that exist based on the filters used in the GetAccount call request. The total number of account entry pages is partly controlled by the Pagination.EntriesPerPage value that is set in the request.
PaginationResult
  .TotalNumberOfEntries
int Always Indicates the total number of entries that could be returned by repeated call requests. Returned with a value of 0 if no entries are available.
PaginationResult
  .TotalNumberOfPages
int Always Indicates the total number of pages of data that could be returned by repeated requests. Returned with a value of 0 if no pages are available.
Standard Output 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 the Ack field.

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 Most Trading API calls support a MessageID element in the request and a CorrelationID element in the response. If you pass in a MessageID in a request, the same value will be returned in the CorrelationID field in the response. Pairing these values can help you track and confirm that a response is returned for every request and to match specific responses to specific requests. If you do not pass a MessageID value in the request, CorrelationID is not returned.

Note: GetCategories is designed to retrieve very large sets of metadata that change once a day or less often. To improve performance, these calls return cached responses when you request all available data (with no filters). When this occurs, the MessageID and CorrelationID fields aren't applicable. However, if you specify an input filter to reduce the amount of data returned, the calls retrieve the latest data (not cached). When this occurs, MessageID and CorrelationID are applicable.
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 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.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) The request that triggered the error was not processed successfully. When a serious application-level error occurs, the error is returned instead of the business data.

If the source of the problem is within the application (such as a missing required element), change the application before you retry the request.
  • If the problem is due to end-user input data, please alert the end-user to the problem and provide the means for them to correct the data. Once the problem in the application or data is resolved, you can attempt to re-send the request to eBay.
  • If the source of the problem is on eBay's side, An application can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form.


See the Compatible Application Check section of the eBay Features Guide for more information.
Warning
(out) The request was processed successfully, but something occurred that may affect your application or the user. For example, eBay may have changed a value the user sent in. In this case, eBay returns a normal, successful response and also returns the warning.

When a warning occurs, the error is returned in addition to the business data. In this case, you do not need to retry the request (as the original request was successful). However, depending on the cause or nature of the warning, you might need to contact either the end user or eBay to effect a long term solution to the problem to prevent it from reoccurring in the future.

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 the Time Values section in the eBay Features Guide for information about this time format and converting to and from the GMT time zone.

Note: GetCategories and other Trading API calls are designed to retrieve very large sets of metadata that change once a day or less often. To improve performance, these calls return cached responses when you request all available data (with no filters). When this occurs, this time value reflects the time the cached response was created. Thus, this value is not necessarily when the request was processed. However, if you specify an input filter to reduce the amount of data returned, the calls retrieve the latest data (not cached). When this occurs, this time value does reflect when the request was processed.
Version string Always The version of the response payload schema. Indicates the version of the schema that eBay used to process the request. See the Standard Data for All Calls section in the eBay Features Guide for information on using the response version when troubleshooting CustomCode values that appear in the response.



Back to top

Detail Controls


DetailLevel

This call does not support varying Detail Levels. You do not need to pass DetailLevel in the request.



Back to top

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.

Sample: Basic Call

Retrieves the account data for the authenticated user.

Description

This call returns a user's account data, including a summary report. The call returns all account entries since the last account invoice request. Entries are sorted by the value specified in AccountEntrySortType.

Input

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

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

Output

XML format.
<GetAccountResponse xmlns="urn:ebay:apis:eBLBaseComponents">
   <Timestamp>2010-02-26T19:37:50.219Z</Timestamp>
   <Ack>Success</Ack>
   <Version>657</Version>
   <Build>E657_CORE_BUNDLED_10685945_R1</Build>
   <AccountID>E29243276001-USD</AccountID>
   <AccountSummary>
      <AccountState>Active</AccountState>
      <AmountPastDue currencyID="USD">0.0</AmountPastDue>
      <BillingCycleDate>15</BillingCycleDate>
      <InvoiceBalance currencyID="USD">0.0</InvoiceBalance>
      <InvoiceDate>2010-01-15T06:59:59.000Z</InvoiceDate>
      <LastAmountPaid currencyID="USD">-12.84</LastAmountPaid>
      <LastPaymentDate>2009-12-30T17:04:36.000Z</LastPaymentDate>
      <PastDue>false</PastDue>
      <PaymentMethod>NothingOnFile</PaymentMethod>
   </AccountSummary>
   <Currency>USD</Currency>
   <AccountEntries>
      <AccountEntry>
         <AccountDetailsEntryType>BuyItNowFee</AccountDetailsEntryType>
         <Description>Buy It Now Listing Fee</Description>
         <Date>2010-02-18T03:30:57.000Z</Date>
         <GrossDetailAmount currencyID="USD">0.2</GrossDetailAmount>
         <ItemID>220439083273</ItemID>
         <NetDetailAmount currencyID="USD">0.2</NetDetailAmount>
         <RefNumber>52594285636</RefNumber>
         <VATPercent>0</VATPercent>
         <Title>Cleveland XLS 4i 25 degree STIFF Graphite, EXCELLENT!</Title>
      </AccountEntry>
      <AccountEntry>
         <AccountDetailsEntryType>BuyItNowFee</AccountDetailsEntryType>
         <Description>Buy It Now Listing Fee</Description>
         <Date>2010-02-21T19:40:13.000Z</Date>
         <GrossDetailAmount currencyID="USD">0.25</GrossDetailAmount>
         <ItemID>220440760002</ItemID>
         <NetDetailAmount currencyID="USD">0.25</NetDetailAmount>
         <RefNumber>52713267436</RefNumber>
         <VATPercent>0</VATPercent>
         <Title>Titleist 735-CM Chrome, P-5 (6 irons) BEAUTIES!!! Stiff</Title>
      </AccountEntry>
      <AccountEntry>
         <AccountDetailsEntryType>FeeFinalValue</AccountDetailsEntryType>
         <Description>Final Value Fee</Description>
         <Date>2010-02-21T04:30:34.000Z</Date>
         <GrossDetailAmount currencyID="USD">3.94</GrossDetailAmount>
         <ItemID>220439083273</ItemID>
         <Memo>Final price: $45.00 (Auction)</Memo>
         <NetDetailAmount currencyID="USD">3.94</NetDetailAmount>
         <RefNumber>52692166426</RefNumber>
         <VATPercent>0</VATPercent>
         <Title>Cleveland XLS 4i 25 degree STIFF Graphite, EXCELLENT!</Title>
      </AccountEntry>
      <AccountEntry>
         <AccountDetailsEntryType>FeeFinalValue</AccountDetailsEntryType>
         <Description>Final Value Fee</Description>
         <Date>2010-02-22T05:30:39.000Z</Date>
         <GrossDetailAmount currencyID="USD">10.06</GrossDetailAmount>
         <ItemID>220440760002</ItemID>
         <Memo>Final price: $115.00 (Auction)</Memo>
         <NetDetailAmount currencyID="USD">10.06</NetDetailAmount>
         <RefNumber>52727310416</RefNumber>
         <VATPercent>0</VATPercent>
         <Title>Titleist 735-CM Chrome, P-5 (6 irons) BEAUTIES!!! Stiff</Title>
      </AccountEntry>
      <AccountEntry>
         <AccountDetailsEntryType>FeeIPIXPhoto</AccountDetailsEntryType>
         <Description>Picture Fee</Description>
         <Date>2010-02-21T19:40:13.000Z</Date>
         <GrossDetailAmount currencyID="USD">0.6</GrossDetailAmount>
         <ItemID>220440760002</ItemID>
         <NetDetailAmount currencyID="USD">0.6</NetDetailAmount>
         <RefNumber>52713267426</RefNumber>
         <VATPercent>0</VATPercent>
         <Title>Titleist 735-CM Chrome, P-5 (6 irons) BEAUTIES!!! Stiff</Title>
      </AccountEntry>
      <AccountEntry>
         <AccountDetailsEntryType>FeeIPIXPhoto</AccountDetailsEntryType>
         <Description>Picture Fee</Description>
         <Date>2010-02-21T20:11:48.000Z</Date>
         <GrossDetailAmount currencyID="USD">0.75</GrossDetailAmount>
         <ItemID>220440776662</ItemID>
         <NetDetailAmount currencyID="USD">0.75</NetDetailAmount>
         <RefNumber>52714914476</RefNumber>
         <VATPercent>0</VATPercent>
         <Title>Titleist 909 D3 9.5* Driver - Exotic Rombax 6X07 Stiff</Title>
      </AccountEntry>
   </AccountEntries>
   <PaginationResult>
      <TotalNumberOfPages>1</TotalNumberOfPages>
   </PaginationResult>
   <EntriesPerPage>6</EntriesPerPage>
   <PageNumber>1</PageNumber>
</GetAccountResponse>



Back to top

Change History

Version Description
893
2014-09-23
  • AccountDetailEntryCodeType (modified): FeePromotedListingFeature and CreditPromotedListingFeature added as new enumeration values. These two account entry values represent a fee charged or a credit granted, respectively, for the Promoted Listing feature.
847
2013-10-22
  • AccountDetailEntryCodeType (modified): FeeEBPReimbursement and CreditEBPReimbursement added as new enumeration values. These two account entry values represent a fee charged or a credit granted, respectively, by eBay to the account of a buyer or seller in connection with an eBay Buyer Protection case.
841
2013-09-19
  • AccountDetailEntryCodeType (modified): FeeAPACFedExShippingLabel, CreditAPACFedExShippingLabel, FeeAPACTNTShippingLabel, CreditAPACTNTShippingLabel, FeeAUPostShippingLabel and CreditAUPostShippingLabel added as new enumeration values. These six values handle fees and credits to the seller for printing out and using APAC FedEx, APAC TNT and AU Post shipping labels from eBay.
837
2013-08-29
  • AccountDetailEntryCodeType (modified): FeeVehicleSubscriptionEarlyTermination, CreditVehicleSubscriptionEarlyTermination, FeeVehicleSubscription, and CreditVehicleSubscription added as new enumeration values. These four values handle the fees and credits for monthly subscriptions and early termination fees for National Vehicle subsriptions for sellers.
803
2012-12-12
  • AccountEntry.AccountDetailsEntryType.CreditReturnRefund (added): A credit issued to the seller's account by eBay as part of the auto-refund process, which is initiated if the seller does not refund the buyer within seven business days after receiving the returned item from the buyer.
  • AccountEntry.AccountDetailsEntryType.FeeReturnRefund (added): The fee charged to the seller's account to compensate eBay for issuing the refund that was supposed to be issued by the seller.
795
2012-10-10
  • AccountEntry.AccountDetailsEntryType.FeeFedExShippingLabel (added): The fee charged to the seller for using a FedEx shipping label.
  • AccountEntry.AccountDetailsEntryType.CreditFedExShippingLabel (added): A credit issued by eBay to reimburse the seller for a FedEx shipping label. In some cases, this credit may be issued to the seller as a result of an Unpaid Item case that the seller has won against a buyer.
793
2012-09-26
  • AccountEntry.AccountDetailsEntryType.CreditAuctionEndEarly (added): A credit issued by eBay to the seller's account if a duplicate auction listing is ended administratively by eBay. A seller is only eligible for this credit if the auction listing had zero bids and the listing was never surfaced in Search.
  • AccountEntry.AccountDetailsEntryType.FeeAuctionEndEarly (added): A fee charged to the seller's account if the seller ends an auction (with one or more bids) early.
787
2012-08-15
  • AccountEntry.AccountDetailsEntryType.FeeGlobalShippingProgram (modified): The name of this enumeration value has changed from FeeGlobalShipping to FeeGlobalShippingProgram.
  • AccountEntry.AccountDetailsEntryType.CreditGlobalShippingProgram (modified): The name of this enumeration value has changed from CreditGlobalShipping to CreditGlobalShippingProgram.
785
2012-08-01
  • AccountEntry.AccountDetailsEntryType.FeeGlobalShipping (added): New enumeration value that indicates that the user's account was debited for Global Shipping charge.
  • AccountEntry.AccountDetailsEntryType.CreditGlobalShipping (added): New enumeration value that indicates that the user's account was credited for Global Shipping charge.
775
2012-05-23
  • AccountEntry.ReceivedTopRatedDiscount (added): This flag indicates that the seller received a top-rated seller discount on the final value fee for the item.
771
2012-04-29
  • AccountDetailEntryCodeType.CreditReturnShipping (added): New enumeration value that indicates that the user's account was credited for return shipping charge.
  • AccountDetailEntryCodeType.FeeReturnShipping (added): New enumeration value that indicates that the user's account was debited for return shipping charge.
685
2010-08-25
  • GetAccountRequestType.IncludeConversionRate, AccountEntryType.ConversionRate (added): Enable you to retrieve the rate used for the currency conversion for a transaction.
681
2010-08-04
  • AccountEntry.Title, AccountDetailsEntryType.Discount (doc change): Explained the meaning of Discount and updated explanation of Title.
679
2010-07-21
  • AccountDetailsEntryType (modified): Added Discount as a type of entry.
551
2008-02-07
  • GetAccount.ItemID (added): Use ItemID to retrieve all account information incurred as a result of the item specified by GetAccount.ItemID. Whenever you use the ItemID field, all other available filters in the request are ignored. If the item specified by ItemID does not exist or if the requesting user is not the seller of the item, an error is returned in the response. The response of GetAccount remains unchanged.
499
2007-02-07
  • Credit, Debit (modified): Deleted previously deprecated objects from the latest schema. Use NetDetailAmount instead.
453
2006-03-22
  • AccountDetailEntryCodeType (added): Enum values added to this element.



Back to top

User-Contributed Notes