GeteBayDetails
Use this call to retrieve the available meta-data for the specified eBay site. By storing the information, you can keep your applications up to date with the latest details. In addition, you can use GeteBayDetails to look up site information instead referring to the documentation or the eBay online help system.
You can also use GeteBayDetails to get the links to the eBay Content Logos, which you might be required to display in your applications per your API License Agreement.
Usage Details
Call GeteBayDetails without any input fields to get the complete set of meta-data for the site whose ID you provide in the request header. To retrieve specific site information, use DetailName elements. See GeteBayDetails Best Practices for how to programmatically obtain the supported DetailName input values.
Upon successful execution, GeteBayDetails returns meta-data on the specified DetailName fields. An unsuccessful call returns an error construct. However, if your call results in a warning, the result set will contain normal data along with an error construct outlining the warning.
Best Practices
The following sections list several hints and suggestions for working with GeteBayDetails.
Retrieving eBay Meta-Data Details
If you call GeteBayDetails without supplying a DetailName field, eBay returns the complete set of meta-data for the site specified in the request header. The top-level fields returned in the result set list the possible values you can use with DetailName). This gives you a programmatic way to determine the supported DetailName input values.
Change the site ID header value to view details for different sites. To determine the available site ID values for which you can request GeteBayDetails data, call GeteBayDetails with DetailName set to SiteDetails
.
It is recommended that you call GeteBayDetails once per week for each pertinent site ID and store the returned data for ease of lookup.
Other Sources of Meta-data Sets and Specialized Data
In addition to GeteBayDetails, you can use several other methods to get eBay site meta-data:
- GetCategories
- GetCategoryFeatures
- GetDescriptionTemplates
- Working with Custom Item Specifics (new method of working with Item Specifics )
Optimizing Your Calls
The amount of data returned from a call depends on the listed DetailName values. Call GeteBayDetails without a DetailName value to retrieve all the information available for the specified site, or use DetailName fields to filter the information returned.
Output Detail Controls Samples Change History |
Input
See also Samples.
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 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"?> <GeteBayDetailsRequest xmlns="urn:ebay:apis:eBLBaseComponents"> <!-- Call-specific Input Fields --> <DetailName> DetailNameCodeType </DetailName> <!-- ... more DetailName values allowed here ... --> <!-- Standard Input Fields --> <ErrorLanguage> string </ErrorLanguage> <MessageID> string </MessageID> <Version> string </Version> <WarningLevel> WarningLevelCodeType </WarningLevel> </GeteBayDetailsRequest>
Argument | Type | Occurrence | Meaning |
---|
Call-specific Input Fields [Jump to standard fields] |
DetailName | DetailNameCodeType | Optional,
repeatable: [0..*] |
One or more DetailName fields may be used to control the the type of metadata that is returned in the response. If no DetailName fields are used, all metadata will be returned in the response. It is a good idea to familiarize yourself with the metadata that can be returned with GeteBayDetails by reading through the enumeration values in DetailNameCodeType.
Applicable values: See DetailName. |
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. Below are some examples from different countries.
|
||||||||||||||||||||||||||||||||||||||||
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. |
||||||||||||||||||||||||||||||||||||||||
Version | string | Conditional |
The version number of the API code that you are programming against (e.g., 1149). The version you specify for a call has these basic effects:
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:
|
||||||||||||||||||||||||||||||||||||||||
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 if the user wishes to receive warnings when the application passes unrecognized or deprecated elements in an API call request. Setting the WarningLevel value to High is not recommended in a production environment. Instead, it should only be used during the development/debugging stage.Low if the user does not wish to receive warnings when the application passes unrecognized or deprecated elements in an API call request. This is the default value if WarningLevel is not specified in the call request.See Warning Level. |
Input Detail Controls Samples Change History |
Output
See also Samples.
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 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"?> <GeteBayDetailsResponse xmlns="urn:ebay:apis:eBLBaseComponents"> <!-- Call-specific Output Fields --> <BuyerRequirementDetails> SiteBuyerRequirementDetailsType <DetailVersion> string </DetailVersion> <LinkedPayPalAccount> boolean </LinkedPayPalAccount> <MaximumBuyerPolicyViolations> MaximumBuyerPolicyViolationsDetailsType <NumberOfPolicyViolations> NumberOfPolicyViolationsDetailsType </NumberOfPolicyViolations> <PolicyViolationDuration> PolicyViolationDurationDetailsType </PolicyViolationDuration> <!-- ... more PolicyViolationDuration nodes allowed here ... --> </MaximumBuyerPolicyViolations> <MaximumItemRequirements> MaximumItemRequirementsDetailsType <MaximumItemCount> int </MaximumItemCount> <!-- ... more MaximumItemCount values allowed here ... --> <MinimumFeedbackScore> int </MinimumFeedbackScore> <!-- ... more MinimumFeedbackScore values allowed here ... --> </MaximumItemRequirements> <MaximumUnpaidItemStrikesInfo> MaximumUnpaidItemStrikesInfoDetailsType <MaximumUnpaidItemStrikesCount> MaximumUnpaidItemStrikesCountDetailsType <Count> int </Count> <!-- ... more Count values allowed here ... --> </MaximumUnpaidItemStrikesCount> <MaximumUnpaidItemStrikesDuration> MaximumUnpaidItemStrikesDurationDetailsType <Description> string </Description> <Period> PeriodCodeType </Period> </MaximumUnpaidItemStrikesDuration> <!-- ... more MaximumUnpaidItemStrikesDuration nodes allowed here ... --> </MaximumUnpaidItemStrikesInfo> <MinimumFeedbackScore> MinimumFeedbackScoreDetailsType </MinimumFeedbackScore> <ShipToRegistrationCountry> boolean </ShipToRegistrationCountry> <UpdateTime> dateTime </UpdateTime> </BuyerRequirementDetails> <!-- ... more BuyerRequirementDetails nodes allowed here ... --> <CountryDetails> CountryDetailsType <Country> CountryCodeType </Country> <Description> string </Description> <DetailVersion> string </DetailVersion> <UpdateTime> dateTime </UpdateTime> </CountryDetails> <!-- ... more CountryDetails nodes allowed here ... --> <CurrencyDetails> CurrencyDetailsType <Currency> CurrencyCodeType </Currency> <Description> string </Description> <DetailVersion> string </DetailVersion> <UpdateTime> dateTime </UpdateTime> </CurrencyDetails> <!-- ... more CurrencyDetails nodes allowed here ... --> <DispatchTimeMaxDetails> DispatchTimeMaxDetailsType <Description> string </Description> <DetailVersion> string </DetailVersion> <DispatchTimeMax> int </DispatchTimeMax> <ExtendedHandling> boolean </ExtendedHandling> <UpdateTime> dateTime </UpdateTime> </DispatchTimeMaxDetails> <!-- ... more DispatchTimeMaxDetails nodes allowed here ... --> <ExcludeShippingLocationDetails> ExcludeShippingLocationDetailsType <Description> string </Description> <DetailVersion> string </DetailVersion> <Location> string </Location> <Region> string </Region> <UpdateTime> dateTime </UpdateTime> </ExcludeShippingLocationDetails> <!-- ... more ExcludeShippingLocationDetails nodes allowed here ... --> <ItemSpecificDetails> ItemSpecificDetailsType <DetailVersion> string </DetailVersion> <MaxCharactersPerName> int </MaxCharactersPerName> <MaxCharactersPerValue> int </MaxCharactersPerValue> <MaxItemSpecificsPerItem> int </MaxItemSpecificsPerItem> <MaxValuesPerName> int </MaxValuesPerName> <UpdateTime> dateTime </UpdateTime> </ItemSpecificDetails> <!-- ... more ItemSpecificDetails nodes allowed here ... --> <ListingFeatureDetails> ListingFeatureDetailsType <BoldTitle> BoldTitleCodeType </BoldTitle> <Border> BorderCodeType (token) </Border> <DetailVersion> string </DetailVersion> <FeaturedFirst> FeaturedFirstCodeType </FeaturedFirst> <FeaturedPlus> FeaturedPlusCodeType </FeaturedPlus> <GiftIcon> GiftIconCodeType (token) </GiftIcon> <Highlight> HighlightCodeType (token) </Highlight> <HomePageFeatured> HomePageFeaturedCodeType </HomePageFeatured> <ProPack> ProPackCodeType (token) </ProPack> <UpdateTime> dateTime </UpdateTime> </ListingFeatureDetails> <!-- ... more ListingFeatureDetails nodes allowed here ... --> <ListingStartPriceDetails> ListingStartPriceDetailsType <Description> string </Description> <DetailVersion> string </DetailVersion> <ListingType> ListingTypeCodeType </ListingType> <MinBuyItNowPricePercent> float </MinBuyItNowPricePercent> <StartPrice currencyID="CurrencyCodeType"> AmountType (double) </StartPrice> <UpdateTime> dateTime </UpdateTime> </ListingStartPriceDetails> <!-- ... more ListingStartPriceDetails nodes allowed here ... --> <PaymentOptionDetails> PaymentOptionDetailsType <Description> string </Description> <DetailVersion> string </DetailVersion> <PaymentOption> BuyerPaymentMethodCodeType </PaymentOption> <UpdateTime> dateTime </UpdateTime> </PaymentOptionDetails> <!-- ... more PaymentOptionDetails nodes allowed here ... --> <ProductDetails> ProductDetailsType <ProductIdentifierUnavailableText> string </ProductIdentifierUnavailableText> </ProductDetails> <RecoupmentPolicyDetails> RecoupmentPolicyDetailsType <DetailVersion> string </DetailVersion> <EnforcedOnListingSite> boolean </EnforcedOnListingSite> <EnforcedOnRegistrationSite> boolean </EnforcedOnRegistrationSite> <UpdateTime> dateTime </UpdateTime> </RecoupmentPolicyDetails> <!-- ... more RecoupmentPolicyDetails nodes allowed here ... --> <RegionDetails> RegionDetailsType </RegionDetails> <!-- ... more RegionDetails nodes allowed here ... --> <RegionOfOriginDetails> RegionOfOriginDetailsType </RegionOfOriginDetails> <!-- ... more RegionOfOriginDetails nodes allowed here ... --> <ReturnPolicyDetails> ReturnPolicyDetailsType <Description> boolean </Description> <DetailVersion> string </DetailVersion> <Refund> RefundDetailsType <Description> string </Description> <RefundOption> token </RefundOption> </Refund> <!-- ... more Refund nodes allowed here ... --> <ReturnsAccepted> ReturnsAcceptedDetailsType <Description> string </Description> <ReturnsAcceptedOption> token </ReturnsAcceptedOption> </ReturnsAccepted> <!-- ... more ReturnsAccepted nodes allowed here ... --> <ReturnsWithin> ReturnsWithinDetailsType <Description> string </Description> <ReturnsWithinOption> token </ReturnsWithinOption> </ReturnsWithin> <!-- ... more ReturnsWithin nodes allowed here ... --> <ShippingCostPaidBy> ShippingCostPaidByDetailsType <Description> string </Description> <ShippingCostPaidByOption> token </ShippingCostPaidByOption> </ShippingCostPaidBy> <!-- ... more ShippingCostPaidBy nodes allowed here ... --> <UpdateTime> dateTime </UpdateTime> </ReturnPolicyDetails> <ShippingCarrierDetails> ShippingCarrierDetailsType <Description> string </Description> <DetailVersion> string </DetailVersion> <ShippingCarrier> ShippingCarrierCodeType </ShippingCarrier> <ShippingCarrierID> int </ShippingCarrierID> <UpdateTime> dateTime </UpdateTime> </ShippingCarrierDetails> <!-- ... more ShippingCarrierDetails nodes allowed here ... --> <ShippingCategoryDetails> ShippingCategoryDetailsType <Description> string </Description> <DetailVersion> string </DetailVersion> <ShippingCategory> token </ShippingCategory> <UpdateTime> dateTime </UpdateTime> </ShippingCategoryDetails> <!-- ... more ShippingCategoryDetails nodes allowed here ... --> <ShippingLocationDetails> ShippingLocationDetailsType <Description> string </Description> <DetailVersion> string </DetailVersion> <ShippingLocation> string </ShippingLocation> <UpdateTime> dateTime </UpdateTime> </ShippingLocationDetails> <!-- ... more ShippingLocationDetails nodes allowed here ... --> <ShippingPackageDetails> ShippingPackageDetailsType <DefaultValue> boolean </DefaultValue> <Description> string </Description> <DetailVersion> string </DetailVersion> <DimensionsSupported> boolean </DimensionsSupported> <PackageID> int </PackageID> <ShippingPackage> ShippingPackageCodeType </ShippingPackage> <UpdateTime> dateTime </UpdateTime> </ShippingPackageDetails> <!-- ... more ShippingPackageDetails nodes allowed here ... --> <ShippingServiceDetails> ShippingServiceDetailsType <CostGroupFlat> token </CostGroupFlat> <DeprecationDetails> AnnouncementMessageType <AnnouncementStartTime> dateTime </AnnouncementStartTime> <EventTime> dateTime </EventTime> <MessageType> AnnouncementMessageCodeType </MessageType> </DeprecationDetails> <!-- ... more DeprecationDetails nodes allowed here ... --> <Description> string </Description> <DetailVersion> string </DetailVersion> <DimensionsRequired> boolean </DimensionsRequired> <ExpeditedService> boolean </ExpeditedService> <InternationalService> boolean </InternationalService> <MappedToShippingServiceID> int </MappedToShippingServiceID> <ServiceType> ShippingTypeCodeType </ServiceType> <!-- ... more ServiceType values allowed here ... --> <ShippingCarrier> ShippingCarrierCodeType </ShippingCarrier> <!-- ... more ShippingCarrier values allowed here ... --> <ShippingCategory> token </ShippingCategory> <ShippingPackage> ShippingPackageCodeType </ShippingPackage> <!-- ... more ShippingPackage values allowed here ... --> <ShippingService> token </ShippingService> <ShippingServiceID> int </ShippingServiceID> <ShippingServicePackageDetails> ShippingServicePackageDetailsType <DimensionsRequired> boolean </DimensionsRequired> <Name> ShippingPackageCodeType </Name> </ShippingServicePackageDetails> <!-- ... more ShippingServicePackageDetails nodes allowed here ... --> <ShippingTimeMax> int </ShippingTimeMax> <ShippingTimeMin> int </ShippingTimeMin> <SurchargeApplicable> boolean </SurchargeApplicable> <UpdateTime> dateTime </UpdateTime> <ValidForSellingFlow> boolean </ValidForSellingFlow> <WeightRequired> boolean </WeightRequired> </ShippingServiceDetails> <!-- ... more ShippingServiceDetails nodes allowed here ... --> <SiteDetails> SiteDetailsType <DetailVersion> string </DetailVersion> <Site> SiteCodeType </Site> <SiteID> int </SiteID> <UpdateTime> dateTime </UpdateTime> </SiteDetails> <!-- ... more SiteDetails nodes allowed here ... --> <TaxJurisdiction> TaxJurisdictionType <DetailVersion> string </DetailVersion> <JurisdictionID> string </JurisdictionID> <JurisdictionName> string </JurisdictionName> <UpdateTime> dateTime </UpdateTime> </TaxJurisdiction> <!-- ... more TaxJurisdiction nodes allowed here ... --> <TimeZoneDetails> TimeZoneDetailsType <DaylightSavingsInEffect> boolean </DaylightSavingsInEffect> <DaylightSavingsLabel> string </DaylightSavingsLabel> <DaylightSavingsOffset> string </DaylightSavingsOffset> <DetailVersion> string </DetailVersion> <StandardLabel> string </StandardLabel> <StandardOffset> string </StandardOffset> <TimeZoneID> string </TimeZoneID> <UpdateTime> dateTime </UpdateTime> </TimeZoneDetails> <!-- ... more TimeZoneDetails nodes allowed here ... --> <UpdateTime> dateTime </UpdateTime> <URLDetails> URLDetailsType <DetailVersion> string </DetailVersion> <UpdateTime> dateTime </UpdateTime> <URL> anyURI </URL> <URLType> URLTypeCodeType </URLType> </URLDetails> <!-- ... more URLDetails nodes allowed here ... --> <VariationDetails> VariationDetailsType <DetailVersion> string </DetailVersion> <MaxNamesPerVariationSpecificsSet> int </MaxNamesPerVariationSpecificsSet> <MaxValuesPerVariationSpecificsSetName> int </MaxValuesPerVariationSpecificsSetName> <MaxVariationsPerItem> int </MaxVariationsPerItem> <UpdateTime> dateTime </UpdateTime> </VariationDetails> <!-- 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> </GeteBayDetailsResponse>
Return Value | Type | Occurrence | Meaning |
---|
Call-specific Output Fields [Jump to standard fields] |
BuyerRequirementDetails | SiteBuyerRequirementDetailsType | Conditionally,
repeatable: [0..*] |
Lists the threshold values that can be passed in through the BuyerRequirementDetails container in the Add/Revise/Relist API calls. Buyer Requirements allow the seller to block buyers who have unpaid item defects, policy violations, low Feedback scores, and/or other undesirable qualities/statistics. Buyer Requirements are set at the seller's account level, but by using a BuyerRequirementDetails container in an Add/Revise/Relist API call, the values in that container will override values set at the account level. Note: This container is only returned if BuyerRequirementDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
BuyerRequirementDetails .DetailVersion |
string | Always | Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. |
BuyerRequirementDetails .LinkedPayPalAccount |
boolean | Conditionally | This field is deprecated. |
BuyerRequirementDetails .MaximumBuyerPolicyViolations |
MaximumBuyerPolicyViolationsDetailsType | Conditionally | Note: This field is no longer applicable, as sellers can no longer set the Buyer Requirement that buyers must have only a certain amount of buyer policy violations within a specified amount of time in order to purchase an item. |
BuyerRequirementDetails .MaximumBuyerPolicyViolations .NumberOfPolicyViolations |
NumberOfPolicyViolationsDetailsType | Conditionally | As a Maximum Buyer Policy Violations threshold value can no longer be set at the account or listing level, this field is no longer applicable. |
BuyerRequirementDetails .MaximumBuyerPolicyViolations .PolicyViolationDuration |
PolicyViolationDurationDetailsType | Conditionally,
repeatable: [0..*] |
As a Maximum Buyer Policy Violations threshold value can no longer be set at the account or listing level, this field is no longer applicable. |
BuyerRequirementDetails .MaximumItemRequirements |
MaximumItemRequirementsDetailsType | Conditionally | This container shows the supported values that can be set as the MaximumItemCount and MinimumFeedbackScore to help control inexperienced or low Feedback bidders/buyers from bidding on or buying an item in a listing. |
BuyerRequirementDetails .MaximumItemRequirements .MaximumItemCount |
int | Conditionally,
repeatable: [0..*] |
Values returned in this field indicate the maximum quantity of an order line item that one buyer can purchase during a consecutive 10-day period. |
BuyerRequirementDetails .MaximumItemRequirements .MinimumFeedbackScore |
int | Conditionally,
repeatable: [0..*] |
A Minimum Feedback Score threshold can be added to the Maximum Item Requirement rule if the seller only wishes to restrict possible buyers with low Feedback scores. The values returned in this field indicate the minimum Feedback Score thresholds that can be used. |
BuyerRequirementDetails .MaximumUnpaidItemStrikesInfo |
MaximumUnpaidItemStrikesInfoDetailsType | Conditionally | This container shows the supported values that can be set as the Maximum Unpaid Item count and period (number of days) to block buyers who have recent Unpaid Item Strikes from bidding on or buying an item in a listing. |
BuyerRequirementDetails .MaximumUnpaidItemStrikesInfo .MaximumUnpaidItemStrikesCount |
MaximumUnpaidItemStrikesCountDetailsType | Conditionally | The number of the maximum unpaid item strikes. This is applicable only to sellers. |
BuyerRequirementDetails .MaximumUnpaidItemStrikesInfo .MaximumUnpaidItemStrikesCount .Count |
int | Conditionally,
repeatable: [0..*] |
Each value returned in each MaximumUnpaidItemStrikesCount.Count field can be used in the BuyerRequirementDetails.MaximumUnpaidItemStrikesInfo.Count field when using the Trading API to add, revise, or relist an item. |
BuyerRequirementDetails .MaximumUnpaidItemStrikesInfo .MaximumUnpaidItemStrikesDuration |
MaximumUnpaidItemStrikesDurationDetailsType | Conditionally,
repeatable: [0..*] |
Range of time used to determine maximum unpaid item count. This is applicable only to sellers. |
BuyerRequirementDetails .MaximumUnpaidItemStrikesInfo .MaximumUnpaidItemStrikesDuration .Description |
string | Conditionally | The description of the period, such as 'month', 'quarter', or 'half a year'. The data in this field can be used as a label in your application's display. This is applicable only to sellers. |
BuyerRequirementDetails .MaximumUnpaidItemStrikesInfo .MaximumUnpaidItemStrikesDuration .Period |
PeriodCodeType | Conditionally |
The period is the number of days (last 60 days, last 180 days, etc.) during which the buyer's unpaid item strikes are calculated. This is applicable only to sellers.
Applicable values: Code so that your app gracefully handles any future changes to this list. |
BuyerRequirementDetails .MinimumFeedbackScore |
MinimumFeedbackScoreDetailsType | Conditionally | Note: This field is no longer applicable, as sellers can no longer set a buyer's Minimum Feedback Score threshold Buyer Requirement at the listing-level in Add/Revise/Relist calls. |
BuyerRequirementDetails .ShipToRegistrationCountry |
boolean | Conditionally |
A true value returned in this field indicates that the ShipToRegistrationCountry Buyer Requirement is supported for the specified site.
|
BuyerRequirementDetails .UpdateTime |
dateTime | Always | Gives the time in GMT when the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. |
CountryDetails | CountryDetailsType | Conditionally,
repeatable: [0..*] |
Lists the country code and associated name of the countries supported by the eBay system, regardless of the site specified in the request. Note: This container is only returned if CountryDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
CountryDetails.Country | CountryCodeType | Conditionally |
Two-letter code representing a country. These two-letter codes are typically used in Add/Revise/Relist calls when referring to a country.
Applicable values: See Country. Code so that your app gracefully handles any future changes to this list. |
CountryDetails.Description | string | Conditionally | Full country name for display purposes. May be similar to (but not necessarily identical to) CountryName in addresses (e.g., User.RegistrationAddress.CountryName in GetUser). |
CountryDetails.DetailVersion | string | Always | Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. |
CountryDetails.UpdateTime | dateTime | Always | Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. |
CurrencyDetails | CurrencyDetailsType | Conditionally,
repeatable: [0..*] |
Lists the currencies supported by the eBay system, regardless of the site specified in the request. Note: This container is only returned if CurrencyDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
CurrencyDetails.Currency | CurrencyCodeType | Conditionally |
Three-digit currency codes as defined in ISO 4217. The currency codes returned in GeteBayDetails can be used as values in the Currency field of the Add/Revise/Relist and other Trading API calls.
Applicable values: See Currency. Code so that your app gracefully handles any future changes to this list. |
CurrencyDetails.Description | string | Conditionally | Full currency name for display purposes. |
CurrencyDetails.DetailVersion | string | Always | Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. |
CurrencyDetails.UpdateTime | dateTime | Always | Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. |
DispatchTimeMaxDetails | DispatchTimeMaxDetailsType | Conditionally,
repeatable: [0..*] |
A dispatch time specifies the maximum number of business days a seller commits to for shipping an item to domestic buyers after receiving a cleared payment. Returns all dispatch times in the system, regardless of the site specified in the request. Note: This container is only returned if DispatchTimeMaxDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
DispatchTimeMaxDetails .Description |
string | Conditionally | Value and unit (e.g., 10 Days) for the maximum dispatch time. Useful for display purposes. |
DispatchTimeMaxDetails .DetailVersion |
string | Always | Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. |
DispatchTimeMaxDetails .DispatchTimeMax |
int | Conditionally |
Integer value that indicates the maximum number of business days that the eBay site allows as a seller's handling time. The clock starts ticking when the buyer pays for the order. This means that if a buyer pays for the order on a Wednesday, the seller would have to ship the item by the next day (Thursday) if the DispatchTimeMax value is set to 1 . Typical values for this field are 0, 1, 2, 3, 4, 5, 10, 15, or 20. A DispatchTimeMax value of 0 indicates same day handling for an item. In this case, the seller's handling time commitment depends on the order cut off time set in the seller's user preferences. This defaults to 2:00 PM local time on most eBay sites. For orders placed (and cleared payment received) before the local order cut off time, the item must be shipped by the end of the current day. For orders completed on or after the order cut off time, the item must be shipped by the end of the following day (excluding weekends and local holidays). Note: If a same day shipping carrier is selected, and the carrier delivers on one or both weekend days, sellers on the eBay US site are assumed to be open for business on the same days, and those days will be used when calculating total shipping time. If using GeteBayDetails specifically to return this value, the caller sets the DetailName field in the request to DispatchTimeMaxDetails. When creating, revising, or relisting an item, the seller cannot set the Item.DispatchTimeMax value higher than the value returned in this field. See Same day handling for details about dispatch cut off times. |
DispatchTimeMaxDetails .ExtendedHandling |
boolean | Always |
A value of true indicates that the seller has specified a handling time of 4 business days or more (an exception handling time). Sellers should be aware that long handling times might adversely affect the buying decisions of potential customers.
|
DispatchTimeMaxDetails .UpdateTime |
dateTime | Always | Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. |
ExcludeShippingLocationDetails | ExcludeShippingLocationDetailsType | Conditionally,
repeatable: [0..*] |
Lists the locations supported by the ExcludeShipToLocation feature. These are locations that a seller can list as areas where they will not ship an item. Note: This container is only returned if ExcludeShippingLocationDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
ExcludeShippingLocationDetails .Description |
string | Conditionally | The localized location name. |
ExcludeShippingLocationDetails .DetailVersion |
string | Conditionally | Returns the current version number of the ExcludeShippingLocation data. Use the version number to determine if you need to refresh your cached client data. |
ExcludeShippingLocationDetails .Location |
string | Conditionally | The location or region code to be used with the AddItem family of calls. These codes are also returned by GetItem. This code reflects the ISO 3166 codes. |
ExcludeShippingLocationDetails .Region |
string | Conditionally | The region code to which the location belongs. |
ExcludeShippingLocationDetails .UpdateTime |
dateTime | Conditionally | The time in GMT that the feature flags for the details were last updated. Use this timestamp to determine if you need to refresh your cached client data. |
ItemSpecificDetails | ItemSpecificDetailsType | Conditionally,
repeatable: [0..*] |
Lists the site's maximum thresholds for specifying Item Specifics. Note: This container is only returned if ItemSpecificDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
ItemSpecificDetails .DetailVersion |
string | Always | This string indicates the version of the Item Specifics metadata. |
ItemSpecificDetails .MaxCharactersPerName |
int | Conditionally | This value is the maximum number of characters that can be used for an Item Specific name on the specified site. |
ItemSpecificDetails .MaxCharactersPerValue |
int | Conditionally | This value is the maximum number of characters that can be used for an Item Specific value on the specified site. |
ItemSpecificDetails .MaxItemSpecificsPerItem |
int | Conditionally |
This value is the maximum number of Item Specifics name-value pairs that can be used when creating, revising, or relisting an item on the specified site. Item Specifics are used to provide descriptive details of an item in a structured manner.
See Setting Item Specifics in AddItem for instructions on adding Item Specifics when creating a listing. |
ItemSpecificDetails .MaxValuesPerName |
int | Conditionally |
This value is the maximum number of corresponding name values that can be used per Item Specific when creating, revising, or relisting an item on the specified site. An example of an Item Specific that might have multiple values is 'Features'. A product can have multiple features, hence multiple features can be passed in through multiple ItemSpecifics.NameValueList.Value fields. Once you know the site threshold, it can also be helpful to know specific Item Specifics in a category that can have more than one value, such as 'Features'. Multiple values can only be specified for an Item Specific if the corresponding itemToAspectCardinality field of the getItemAspectsForCategory method shows a value of MULTI .
See Setting one or more values for Item Specific in AddItem. |
ItemSpecificDetails.UpdateTime | dateTime | Always | This timestamp indicates the date and time when the Item Specifics metadata was last updated. Time is in Greenwich Mean Time (GMT) time. This timestamp can be useful in determining if and when to refresh cached client data. |
ListingFeatureDetails | ListingFeatureDetailsType | Conditionally,
repeatable: [0..*] |
Details the listing features available for the eBay site specified in the request. Note: This container is only returned if ListingFeatureDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
ListingFeatureDetails .BoldTitle |
BoldTitleCodeType | Always |
The enumeration value returned in this field indicates whether or not the Bold Title featured is enabled for the eBay site. If this feature is available for an eBay site, the seller can pass in BoldTitle as an enumeration value in the ListingEnhancement field of an Add/Revise/Relist call.
Applicable values: Code so that your app gracefully handles any future changes to this list. |
ListingFeatureDetails.Border | BorderCodeType (token) | Always |
Note: The Picture Border feature is no longer available on any eBay marketplace site, so this value should not be used in Add/Revise/Relist calls, and will not be returned in 'Get' calls. Defines the availability of the Picture Border feature for the site. |
ListingFeatureDetails .DetailVersion |
string | Always | Returns the current version of details. |
ListingFeatureDetails .FeaturedFirst |
FeaturedFirstCodeType | Always |
Note: Featured First is no longer available on any eBay marketplace. The enumeration value returned in this field indicates whether or not the Featured First feature is enabled for the eBay site. As of October 2017, this listing feature is only available to Top-Rated Sellers on the Germany site. Applicable values: Code so that your app gracefully handles any future changes to this list. |
ListingFeatureDetails .FeaturedPlus |
FeaturedPlusCodeType | Always |
Note: Featured Plus is no longer available on any eBay marketplace. The enumeration value returned in this field indicates whether or not the Featured Plus feature is enabled for the eBay site. Applicable values: Code so that your app gracefully handles any future changes to this list. |
ListingFeatureDetails.GiftIcon | GiftIconCodeType (token) | Always |
Note: The Gift Icon feature is no longer available on any eBay marketplace. Defines the availability of the Gift Icon feature for the site. |
ListingFeatureDetails .Highlight |
HighlightCodeType (token) | Always |
Note: The Highlight feature is no longer available on any eBay marketplace, so this value should not be used in Add/Revise/Relist calls, and will not be returned in 'Get' calls. Defines the availability of the Highlight feature for the site. |
ListingFeatureDetails .HomePageFeatured |
HomePageFeaturedCodeType | Always |
Note: Home Page Featured is no longer available on any eBay marketplace. The enumeration value returned in this field indicates whether or not the Home Page Featured feature is enabled for the eBay site. If this feature is available for an eBay site, the seller can pass in HomePageFeatured as an enumeration value in the ListingEnhancement field of an Add/Revise/Relist call.
Applicable values: Code so that your app gracefully handles any future changes to this list. |
ListingFeatureDetails.ProPack | ProPackCodeType (token) | Always |
Note: The Pro Pack Bundle feature is no longer available on any eBay marketplace. Defines the availability of the Pro Pack Bundle for the site. |
ListingFeatureDetails .UpdateTime |
dateTime | Always | Gives the time in GMT that the feature flags for the details were last updated. |
ListingStartPriceDetails | ListingStartPriceDetailsType | Conditionally,
repeatable: [0..*] |
Lists the minimum starting prices for the supported types of eBay listings. Note: This container is only returned if ListingStartPriceDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
ListingStartPriceDetails .Description |
string | Conditionally | This value is a string description of the listing type for which the pricing data is intended, such as "Pricing for the auction-like listings". |
ListingStartPriceDetails .DetailVersion |
string | Always | Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. |
ListingStartPriceDetails .ListingType |
ListingTypeCodeType | Conditionally |
This value indicates the listing type of the listing, and is a value defined in ListingTypeCodeType enumerated type. The only possible values for this field are 'Chinese' (auction listing) and 'FixedPriceItem'.
Applicable values: See ListingType. Code so that your app gracefully handles any future changes to this list. |
ListingStartPriceDetails .MinBuyItNowPricePercent |
float | Conditionally |
This field is only returned and applicable for auction listings. This float value indicates the minimum percentage value that a Buy It Now price for an auction listing must be above the Starting bid price for that same listing. On the US eBay Motors site (Site ID 100), this field only applies to the Parts and Accessories categories. |
ListingStartPriceDetails .StartPrice |
AmountType (double) | Conditionally |
For auction listings, the StartPrice indicates the lowest dollar value that can be set for the item's Starting bid. For fixed-price listings, the StartPrice indicates the lowest dollar value that can be set for the item's sale price. |
ListingStartPriceDetails .StartPrice [ attribute currencyID ] |
CurrencyCodeType | Always |
For auction listings, the StartPrice indicates the lowest dollar value that can be set for the item's Starting bid. For fixed-price listings, the StartPrice indicates the lowest dollar value that can be set for the item's sale price. For a list of possible enumeration values, see CurrencyCodeType. |
ListingStartPriceDetails .UpdateTime |
dateTime | Always | Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. |
PaymentOptionDetails | PaymentOptionDetailsType | Conditionally,
repeatable: [0..*] |
Deprecated as of version 613. No longer recommended. Use Category.PaymentMethod instead. Although the supported payment methods for the specified eBay site are returned, it is recommended that the seller use GetCategoryFeatures instead, and pass in PaymentMethods as a FeatureID value in the request. Note: This container is only returned if PaymentOptionDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. Deprecation version: 613. See also Deprecated Objects. |
PaymentOptionDetails .Description |
string | Conditionally |
Deprecated as of version 613. No longer recommended. Use Category.PaymentMethod instead. This field is a text-based/user-friendly description of the payment option. Deprecation version: 613. See also Deprecated Objects. |
PaymentOptionDetails .DetailVersion |
string | Conditionally |
Deprecated as of version 613. No longer recommended. Use Category.PaymentMethod instead. This string value indicates the version number of the update made to any payment options returned in GeteBayDetails. Deprecation version: 613. See also Deprecated Objects. |
PaymentOptionDetails .PaymentOption |
BuyerPaymentMethodCodeType | Conditionally |
Deprecated as of version 613. No longer recommended. Use Category.PaymentMethod instead. This enumeration value is the enumeration that the seller would pass in to one of the PaymentMethods fields in an Add/Revise/Relist call (or in to a Payment busines policy). Applicable values: Note: To see if this enumeration value is a supported payment method for a site and category, call GetCategoryFeatures specifying the listing category ID and including the FeatureID field set to PaymentMethods . Note: To see if this enumeration value is a supported payment method for a site and category, call GetCategoryFeatures specifying the listing category ID and including the FeatureID field set to PaymentMethods . Note: To see if this enumeration value is a supported payment method for a site and category, call GetCategoryFeatures specifying the listing category ID and including the FeatureID field set to PaymentMethods . Note: To see if this enumeration value is a supported payment method for a site and category, call GetCategoryFeatures specifying the listing category ID and including the FeatureID field set to PaymentMethods . Code so that your app gracefully handles any future changes to this list. Deprecation version: 613. See also Deprecated Objects. |
PaymentOptionDetails .UpdateTime |
dateTime | Conditionally |
Deprecated as of version 613. No longer recommended. Use Category.PaymentMethod instead. This timestamp indicates the date and time of the last update made to any payment options returned in GeteBayDetails. Deprecation version: 613. See also Deprecated Objects. |
ProductDetails | ProductDetailsType | Conditionally |
The ProductDetails.ProductIdentifierUnavailableText field contains the actual text that should be passed into the relevant product identification fields (EAN, ISBN, UPC, MPN/Brand) if eBay is prompting/expecting one of these fields in the call request, but the identifiers do not exist/apply for the product. The text will vary based on the listing site. This text should only be used if no product ID exists for the product. If a product identifier value does actually exist for a product, but the seller passes in 'Does not apply' text, that listing may get penalized in search. Note: This container is only returned if ProductDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
ProductDetails .ProductIdentifierUnavailableText |
string | Conditionally | This field contains the actual text that should be passed into the relevant product identifier fields (e.g. ProductListingDetails.UPC in an AddItem call) when creating a listing. Some eBay categories require one or more Global Trade Item Numbers (GTINs), so either the actual GTIN or this substitute text must be passed into the relevant fields. |
RecoupmentPolicyDetails | RecoupmentPolicyDetailsType | Conditionally,
repeatable: [0..*] |
Details the recoupment policies for the site specified in the request. Note: This container is only returned if RecoupmentPolicyDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
RecoupmentPolicyDetails .DetailVersion |
string | Always | Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. |
RecoupmentPolicyDetails .EnforcedOnListingSite |
boolean | Always | Indicates whether recoupment policy is enforced on the site on which the item is listed. |
RecoupmentPolicyDetails .EnforcedOnRegistrationSite |
boolean | Always | Indicates whether recoupment policy is enforced on the registration site for which the call is made. |
RecoupmentPolicyDetails .UpdateTime |
dateTime | Always | Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. |
RegionDetails | RegionDetailsType | Conditionally,
repeatable: [0..*] |
Lists the cities and other domestic regions for the specified site's country. Note: This container is only returned if RegionDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
RegionOfOriginDetails | RegionOfOriginDetailsType | Conditionally,
repeatable: [0..*] |
Lists the worldwide regions and individual countries that can be set as shipping locations from the specified eBay site. Note: This container is only returned if RegionOfOriginDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
ReturnPolicyDetails | ReturnPolicyDetailsType | Conditionally |
Deprecated as of version 1077. No longer recommended. Use GetCategoryFeatures instead. Lists the supported values that may be used for return policies on the specified eBay site, such as the return period, supported restocking fees, and refund options. Note: This container is only returned if ReturnPolicyDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. Note: This container has been staged for deprecation. Although domestic return policy metadata is still getting returned at the moment, it is recommended that users start making plans to use the GetCategoryFeatures call instead to retrieve category-level, domestic return policy metadata. Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails .Description |
boolean | Conditionally |
Deprecated as of version 1077. This field is returned with a value of true if the site supports a text description of the seller's Return Policy in listings. If the site does support a text description of the seller's Return Policy, it is set through the ReturnPolicy.Description field in an Add/Revise/Relist API call. Currently, the only eBay sites that support Return Policy descriptions are Germany, Austria, France, Italy, and Spain. Note: To discover if a Return Policy desciption is supported by a particular category, call GetCategoryFeatures and include ReturnPolicyDescriptionEnabled as a FeatureID value to see if the category supports the use of a Return Policy description.
Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails .DetailVersion |
string | Always |
Deprecated as of version 1077. Returns the latest version number for the Return Policy Details metadata set. The version can be used to determine if and when to refresh cached client data. Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails.Refund | RefundDetailsType | Conditionally,
repeatable: [0..*] |
Deprecated as of version 1077. This container consists of the supported refund/exchange/replacement item options that the seller may make available to the buyer in case the buyer wants to return the original item. Enumeration value(s) returned in RefundOption field(s) can be used in the ReturnPolicy.RefundOption field in an Add/Revise/Relist API call. Note: To discover what refund options that a particular category supports, call GetCategoryFeatures and include DomesticRefundMethodValues and/or InternationalRefundMethodValues as FeatureID values to see the refund options available for domestic and international returns, respectively.
Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails.Refund .Description |
string | Conditionally |
Deprecated as of version 1077. Display string that applications can use to present RefundOption in a more user-friendly format (such as in a drop-down list). Not applicable as input to the AddItem family of calls. (Use RefundOption instead.) Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails.Refund .RefundOption |
token | Conditionally |
Deprecated as of version 1077. Indicates how the seller will compensate the buyer for a returned item. This value can be passed in the Add/Revise/Relist/VerifyAdd API calls. Currently, on the US site (and many other sites), the seller must offer either a MoneyBack or a MoneyBackOrExchange refund option. Consider using the MoneyBackOrExchange option when you have the depth of inventory to support replacement of the original item. Otherwise, use the MoneyBack option if you have limited inventory. Applicable values: See RefundOptionsCodeType Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails .ReturnsAccepted |
ReturnsAcceptedDetailsType | Conditionally,
repeatable: [0..*] |
Deprecated as of version 1077. This container consists of the enumeration values that can be passed into the ReturnPolicy.ReturnsAcceptedOption field when using an Add/Revise/Relist API call. This value will indicate whether or not the seller allows the buyer to return the item. Note: To discover the enumeration values that a particular category supports, call GetCategoryFeatures and include DomesticReturnsAcceptedValues and/or InternationalReturnsAcceptedValues as FeatureID values to see the ReturnPolicy.ReturnsAcceptedOption and ReturnPolicy.InternationalReturnsAcceptedOption values supported for domestic and international returns, respectively.
Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails .ReturnsAccepted.Description |
string | Conditionally |
Deprecated as of version 1077. Display string that applications can use to present ReturnsAcceptedOption in a more user-friendly format (such as in a drop-down list). Not applicable as input to the AddItem family of calls. (Use ReturnsAcceptedOption instead.) Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails .ReturnsAccepted .ReturnsAcceptedOption |
token | Conditionally |
Deprecated as of version 1077. Whether the seller allows the buyer to return the item. This value can be passed in the AddItem family of calls. Applicable values: See ReturnsAcceptedOptionsCodeType Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails .ReturnsWithin |
ReturnsWithinDetailsType | Conditionally,
repeatable: [0..*] |
Deprecated as of version 1077. This container consists of the supported time periods within which the buyer can return the item, starting from the day they receive the item. Enumeration value(s) returned in ReturnsWithinOption field(s) can be used in the ReturnPolicy.ReturnsWithinOption field in an Add/Revise/Relist API call. Note: To discover what return durations that a particular category supports, call GetCategoryFeatures and include DomesticReturnsDurationValues and/or InternationalReturnsDurationValues as FeatureID values to see the return durations available for domestic and international returns, respectively.
Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails .ReturnsWithin.Description |
string | Conditionally |
Deprecated as of version 1077. Display string that applications can use to present ReturnsWithinOption in a more user-friendly format (such as in a drop-down list). Not applicable as input to the AddItem family of calls. (Use ReturnsWithinOption instead.) Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails .ReturnsWithin .ReturnsWithinOption |
token | Conditionally |
Deprecated as of version 1077. Value indicates the number of days that a buyer has to return an item from the day they receive the item. This value can be passed in the Add/Revise/Relist family of API calls. Supported values can vary by eBay site. Applicable values: See ReturnsWithinOptionsCodeType Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails .ShippingCostPaidBy |
ShippingCostPaidByDetailsType | Conditionally,
repeatable: [0..*] |
Deprecated as of version 1077. This container consists of the enumeration values that can be passed into the ReturnPolicy.ShippingCostPaidByOption or ReturnPolicy.InternationalShippingCostPaidByOption field when using an Add/Revise/Relist API call. This value will indicate whether the buyer or seller is responsible for return shipping cost. The enumeration value(s) returned in ShippingCostPaidByOption field(s) can be used in the ReturnPolicy.ShippingCostPaidByOption field in an Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails .ShippingCostPaidBy .Description |
string | Conditionally |
Deprecated as of version 1077. Display string that applications can use to present ShippingCostPaidByOption in a more user-friendly format (such as in a drop-down list). Not applicable as input to the Add/Revise/Relist calls. (Use ShippingCostPaidBy instead.) Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails .ShippingCostPaidBy .ShippingCostPaidByOption |
token | Conditionally |
Deprecated as of version 1077. The party who pays the shipping cost for a returned item. This value can be passed in the Add/Revise/Relist calls. Applicable values: See ShippingCostPaidByOptionsCodeType Deprecation version: 1077. See also Deprecated Objects. |
ReturnPolicyDetails.UpdateTime | dateTime | Always |
Deprecated as of version 1077. This timestamp in GMT indicate when the Return Policy Details metadata were last updated. This timestamp can be used to determine if and when to refresh cached client data. Deprecation version: 1077. See also Deprecated Objects. |
ShippingCarrierDetails | ShippingCarrierDetailsType | Conditionally,
repeatable: [0..*] |
Lists the shipping carriers supported by the specified site. Note: This container is only returned if ShippingCarrierDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
ShippingCarrierDetails .Description |
string | Conditionally | Display string that applications can use to present a list of shipping carriers in a more user-friendly format (such as in a drop-down list). |
ShippingCarrierDetails .DetailVersion |
string | Always | Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. |
ShippingCarrierDetails .ShippingCarrier |
ShippingCarrierCodeType | Conditionally |
The code for the shipping carrier. Note: Commonly used shipping carriers can also be found by calling GeteBayDetails with DetailName set to ShippingCarrierDetails and examining the returned ShippingCarrierDetails.ShippingCarrier field.
Applicable values: See ShippingCarrier. Code so that your app gracefully handles any future changes to this list. |
ShippingCarrierDetails .ShippingCarrierID |
int | Conditionally | Numeric identifier. Some applications use this ID to look up shipping Carriers more efficiently. |
ShippingCarrierDetails .UpdateTime |
dateTime | Always | Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. |
ShippingCategoryDetails | ShippingCategoryDetailsType | Conditionally,
repeatable: [0..*] |
A shipping service category supported for the site. Note: This container is only returned if ShippingCategoryDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. Each shipping service supported for a site is automatically categorized by eBay into one of the shipping categories available for that site depending on how the shipping service shipping time aligns with the shipping times specified by eBay for each category. Notice that you cannot specify a ShippingCategory as an input to any API call - eBay does this categorizing automatically. ShippingCategory is read-only data that is returned in the ShippingServiceDetails container. One possible use of this data is to segregate shipping services by ShippingCategory in a pick list. (For an example of this, see the Services pulldown menu in the Give buyers shipping details form in the eBay Sell Your Item flow.) One way to populate the picklist would be to call GeteBayDetails with DetailName set to ShippingServiceDetails. Then sort these results by ShippingCategory and populate the picklist. |
ShippingCategoryDetails .Description |
string | Conditionally | Display string that applications can use to present a list of shipping categories in a more user-friendly format (such as in a drop-down list). This field is localized per site. |
ShippingCategoryDetails .DetailVersion |
string | Always | The current version number for shipping categories. Sellers can compare this version number to their version number to determine if and when to refresh cached client data. |
ShippingCategoryDetails .ShippingCategory |
token | Conditionally |
Indicates the shipping category. Shipping categories include the following: ECONOMY, STANDARD, EXPEDITED, ONE_DAY, PICKUP, OTHER, and NONE. International shipping services are generally grouped into the NONE category. For more information on these shipping categories, and which services fall into which category, see the Shipping Basics page on the eBay Shipping Center site. Note: This field is returned only for those sites that support shipping categories: US (0), CA (2), CAFR (210), UK (3), AU (15), FR (71), DE (77), IT (101) and ES (186). |
ShippingCategoryDetails .UpdateTime |
dateTime | Always | Indicates the time of the last version update. |
ShippingLocationDetails | ShippingLocationDetailsType | Conditionally,
repeatable: [0..*] |
Lists the worldwide regions that can be set as shipping locations from the specified eBay site. Note: This container is only returned if ShippingLocationDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
ShippingLocationDetails .Description |
string | Conditionally | Display string that applications can use to present a list of shipping locations in a more user-friendly format (such as in a drop-down list). This field is localized in the language of the site. |
ShippingLocationDetails .DetailVersion |
string | Always | Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. |
ShippingLocationDetails .ShippingLocation |
string | Conditionally |
Short name or abbreviation for a region (e.g., Asia) or location (e.g. Japan).
See ShippingDetails.InternationalShippingServiceOption in AddItem. |
ShippingLocationDetails .UpdateTime |
dateTime | Always | Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. |
ShippingPackageDetails | ShippingPackageDetailsType | Conditionally,
repeatable: [0..*] |
Lists the various shipping packages supported by the specified site. Note: This container is only returned if ShippingPackageDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
ShippingPackageDetails .DefaultValue |
boolean | Conditionally | Indicates if the package type is the default for the specified site. |
ShippingPackageDetails .Description |
string | Conditionally | Display string that applications can use to present a list of shipping package options in a more user-friendly format (such as in a drop-down list). |
ShippingPackageDetails .DetailVersion |
string | Always | Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. |
ShippingPackageDetails .DimensionsSupported |
boolean | Conditionally |
This field is returned as 'true' if the shipping package supports the use of package dimensions. Default: false. |
ShippingPackageDetails .PackageID |
int | Conditionally | Numeric identifier. Some applications use this ID to look up shipping packages more efficiently. |
ShippingPackageDetails .ShippingPackage |
ShippingPackageCodeType | Conditionally |
A supported value for the site that can be used in the Item.ShippingPackageDetails.ShippingPackage or Item.ShippingDetails.CalculatedShippingRate.ShippingPackage fields of an Add/Revise/Relist API call.
Applicable values: See ShippingPackage. Code so that your app gracefully handles any future changes to this list. |
ShippingPackageDetails .UpdateTime |
dateTime | Always | Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. |
ShippingServiceDetails | ShippingServiceDetailsType | Conditionally,
repeatable: [0..*] |
Lists the shipping services supported by the specified eBay site. Returns only the shipping services that are applicable to the site specified in the request. Note: This container is only returned if ShippingServiceDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
ShippingServiceDetails .CostGroupFlat |
token | Conditionally |
If returned, this is the shipping service group to which the shipping service belongs. Valid values are found in CostGroupFlatCodeType. Applicable values: See CostGroupFlatCodeType |
ShippingServiceDetails .DeprecationDetails |
AnnouncementMessageType | Conditionally,
repeatable: [0..*] |
A mechanism by which details about deprecation of a shipping service is announced. See also MappedToShippingServiceID. If this container is empty, it means that there is no mapping for this shipping service and that the shipping service will be dropped from the listing without an accompanying warning message from the eBay API.
See Deprecated services. |
ShippingServiceDetails .DeprecationDetails .AnnouncementStartTime |
dateTime | Conditionally | The date on which an upcoming event can start to be announced. |
ShippingServiceDetails .DeprecationDetails.EventTime |
dateTime | Conditionally | The date on which the event occurs. This is also the ending date of the announcement that lead up to the event (see AnnouncementStartTime). |
ShippingServiceDetails .DeprecationDetails .MessageType |
AnnouncementMessageCodeType | Conditionally |
Control of what messages to display.
Applicable values: Code so that your app gracefully handles any future changes to this list. |
ShippingServiceDetails .Description |
string | Always | Display string that applications can use to present a list of shipping service options in a more user-friendly format (such as in a drop-down list). |
ShippingServiceDetails .DetailVersion |
string | Always | Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. |
ShippingServiceDetails .DimensionsRequired |
boolean | Conditionally | This field is only returned if the shipping service option requires that package dimensions are provided by the seller. This field is only returned if 'true'. |
ShippingServiceDetails .ExpeditedService |
boolean | Conditionally |
Indicates whether a domestic shipping service option is an expedited shipping service. This field is only returned under a ShippingServiceDetails if true . Expedited generally means that the shipment of the order can arrive at the buyer's location within one or two business days.
|
ShippingServiceDetails .InternationalService |
boolean | Conditionally |
Indicates whether the shipping service is an international shipping service. An international shipping service option is required if an item is being shipped from one country (origin) to another (destination).
See Item.ShippingDetails.InternationalShippingServiceOption in AddItem. |
ShippingServiceDetails .MappedToShippingServiceID |
int | Conditionally |
The ID of another shipping service that will be used when a shipping service is deprecated. See also DeprecationDetails.
See Deprecated services. |
ShippingServiceDetails .ServiceType |
ShippingTypeCodeType | Conditionally,
repeatable: [0..*] |
The shipping cost types that this shipping service option supports, such as flat-rate or calculated. A ServiceType field is returned for each shipping cost type supported by the shipping service option.
Applicable values: Note: This shipping type includes an option for a Flat Rate Freight shipping service. For details about freight shipping, see Specifying Freight Shipping in the eBay Features Guide. (Not all values in ShippingTypeCodeType apply to this field.) Code so that your app gracefully handles any future changes to this list. |
ShippingServiceDetails .ShippingCarrier |
ShippingCarrierCodeType | Conditionally,
repeatable: [0..*] |
The enumeration value for the shipping carrier associated with the shipping service option. Note: Commonly used shipping carriers can also be found by calling GeteBayDetails with DetailName set to ShippingCarrierDetails and examining the returned ShippingCarrierDetails.ShippingCarrier field.
Applicable values: See ShippingCarrier. Code so that your app gracefully handles any future changes to this list. |
ShippingServiceDetails .ShippingCategory |
token | Conditionally |
Indicates the shipping category. Shipping categories include the following: ECONOMY , STANDARD , EXPEDITED , ONE_DAY , PICKUP , OTHER , and NONE . International shipping services are generally grouped into the NONE category. For more information about these shipping categories, see the Shipping Basics page on the eBay Shipping Center site. Note: This field is returned only for those sites that support shipping categories: US (0), CA (2), CAFR (210), UK (3), AU (15), FR (71), DE (77), IT (101) and ES (186). |
ShippingServiceDetails .ShippingPackage |
ShippingPackageCodeType | Conditionally,
repeatable: [0..*] |
The shipping packages that can be used for this shipping service option. A ShippingPackage field is returned for each shipping package supported by the shipping service option.
Applicable values: See ShippingPackage. Code so that your app gracefully handles any future changes to this list. |
ShippingServiceDetails .ShippingService |
token | Conditionally |
The name of shipping service option. The ShippingServiceDetails.ValidForSellingFlow flag must also be present and true . Otherwise, that particular shipping service option is no longer valid and cannot be offered to buyers through a listing. This token value is the text that a seller will provide in the ShippingDetails.ShippingServiceOptions.ShippingService field when creating a listing. |
ShippingServiceDetails .ShippingServiceID |
int | Conditionally | Numeric identifier. A value greater than 50000 represents an international shipping service (confirmed by InternationalShippingService being true). Some applications use this ID to look up shipping services more efficiently. |
ShippingServiceDetails .ShippingServicePackageDetails |
ShippingServicePackageDetailsType | Conditionally,
repeatable: [0..*] |
Shipping Package level details for the enclosing shipping service, this complex type replaces the existing ShippingPackage type. |
ShippingServiceDetails .ShippingServicePackageDetails .DimensionsRequired |
boolean | Conditionally | This field is only returned if package dimensions are required for the corresponding package type (ShippingServicePackageDetails.Name value) supported by the corresponding shipping service option (ShippingServiceDetails.ShippingService value). |
ShippingServiceDetails .ShippingServicePackageDetails .Name |
ShippingPackageCodeType | Conditionally |
The name of the package type.
Applicable values: See Name. Code so that your app gracefully handles any future changes to this list. |
ShippingServiceDetails .ShippingTimeMax |
int | Conditionally |
The integer value returned here indicates the maximum number of business days that the shipping carrier (indicated in the corresponding ShippingCarrier field) will take to ship an item using the corresponding shipping service option (indicated in the ShippingService field). This maximum shipping time does not include the seller's handling time, and the clock starts on the shipping time only after the seller has delivered the item to the shipping carrier for shipment to the buyer. 'Business days' can vary by shipping carrier and by country, but 'business days' are generally Monday through Friday, excluding holidays. This field is returned if defined for that particular shipping service option. For sellers opted into and using eBay Guaranteed Delivery, they should be looking at this value, and this value plus their handling time stated in the listing cannot be greater than 4 business days in order for that listing to be eligible for eBay Guaranteed Delivery. |
ShippingServiceDetails .ShippingTimeMin |
int | Conditionally |
The integer value returned here indicates the minimum number of business days that the shipping carrier (indicated in the corresponding ShippingCarrier field) will take to ship an item using the corresponding shipping service option (indicated in the ShippingService field). This minimum shipping time does not include the seller's handling time, and the clock starts on the shipping time only after the seller has delivered the item to the shipping carrier for shipment to the buyer. 'Business days' can vary by shipping carrier and by country, but 'business days' are generally Monday through Friday, excluding holidays. This field is returned if defined for that particular shipping service option. |
ShippingServiceDetails .SurchargeApplicable |
boolean | Conditionally | This field is only returned if 'true', and indicates that a shipping surcharge is applicable for this shipping service option. |
ShippingServiceDetails .UpdateTime |
dateTime | Always | Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. |
ShippingServiceDetails .ValidForSellingFlow |
boolean | Conditionally | If this field is returned as 'true', the shipping service option can be used in a Add/Revise/Relist API call. If this field is returned as 'false', the shipping service option is not currently supported and cannot be used in a Add/Revise/Relist API call. |
ShippingServiceDetails .WeightRequired |
boolean | Conditionally |
If true, a seller who selects this package type for the listing and then offers this shipping service must specify WeightMajor and WeightMinor in the item definition. If not returned, WeightRequired is false. Default: false. |
SiteDetails | SiteDetailsType | Conditionally,
repeatable: [0..*] |
Lists all available eBay sites and their associated SiteID numbers. Note: This container is only returned if SiteDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
SiteDetails.DetailVersion | string | Always | Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. |
SiteDetails.Site | SiteCodeType | Conditionally |
Short name that identifies an eBay site. Usually, an eBay site is associated with a particular country or region (e.g., US or Belgium_French). Specialty sites (e.g., eBay Stores) use the same site ID as their associated main eBay site. The US eBay Motors site is an exception to this convention.
Applicable values: See Site. Code so that your app gracefully handles any future changes to this list. |
SiteDetails.SiteID | int | Conditionally | Numeric identifier for an eBay site. If you are using the SOAP API, you use numeric site IDs in the request URL. If you are using the XML API, you use numeric site IDs in the X-EBAY-API-SITEID header. |
SiteDetails.UpdateTime | dateTime | Always | Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. |
TaxJurisdiction | TaxJurisdictionType | Conditionally,
repeatable: [0..*] |
Details the different tax jurisdictions or tax regions applicable to the site specified in the request. Note that tax jurisdictions are only applicable to the following eBay sites: eBay US (Site ID 0), eBay Canada (Site ID 2), eBay Canada (French) (Site ID 210), and eBay India (Site ID 203). An empty response will be returned for any other Site ID that is passed in the HTTP header. Note: This container is only returned if TaxJurisdiction is included as a DetailName filter in the request, or if no DetailName filters are used in the request. See:
|
TaxJurisdiction.DetailVersion | string | Conditionally | Returns the latest version number for this feature. Use the version to determine if and when to refresh your cached client data. |
TaxJurisdiction.JurisdictionID | string | Conditionally |
This is the unique, two-digit identifier of the tax jurisdiction (such as 'CA' for California). To retrieve all JurisdictionID values for a site, a seller can either use a GetTaxTable call with DetailLevel set to ReturnAll , or they can use the GeteBayDetails call with DetailLevel name set to TaxJurisdiction . The JurisdictionID field is always required in a SetTaxTable call, and always returned with each TaxJurisdiction container to identify the tax jurisdiction. |
TaxJurisdiction .JurisdictionName |
string | Conditionally | Full name for the jurisdiction or region for display purposes. |
TaxJurisdiction.UpdateTime | dateTime | Conditionally | The time in GMT when the details for this feature were last updated. Use this timestamp to determine if and when to refresh your cached client data. |
TimeZoneDetails | TimeZoneDetailsType | Conditionally,
repeatable: [0..*] |
Lists the details of the time zones supported by the eBay system. Note: This container is only returned if TimeZoneDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
TimeZoneDetails .DaylightSavingsInEffect |
boolean | Conditionally | Indicates whether or not the time zone is currently on daylight saving time. A value of true indicates that the time zone is on daylights savings time. This element is emitted for time zones that support daylight saving time only. |
TimeZoneDetails .DaylightSavingsLabel |
string | Conditionally | Display name of a time zone in its daylight saving time representation. This element is emitted for time zones that support daylight saving time only. The value is localized and returned in the language for the site specified in the request. |
TimeZoneDetails .DaylightSavingsOffset |
string | Conditionally | The offset in hours from GMT for a time zone when it is on daylight saving time. This element is emitted for time zones that support daylight saving time only. |
TimeZoneDetails.DetailVersion | string | Always | Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. |
TimeZoneDetails.StandardLabel | string | Conditionally | Display name of a time zone in its standard (non-daylight saving) time representation. This value is localized and returned in the language for the site specified in the request (i.e., 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). |
TimeZoneDetails.StandardOffset | string | Conditionally | The offset in hours from GMT for a time zone when it is not adjusted for daylight saving time. |
TimeZoneDetails.TimeZoneID | string | Conditionally | A unique identifier for a given time zone. This ID does not change for a given time zone, even if the time zone supports both standard and daylight saving time variants. Valid values for TimeZoneID correspond to OLSON IDs. These IDs provide not only the information as to the offset from GMT (UTC), but also daylight saving time information. Thus, for example, America/Phoenix is distinct from America/Denver because they have different daylight saving time behavior. This value is not localized. |
TimeZoneDetails.UpdateTime | dateTime | Always | Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. |
UpdateTime | dateTime | Always | The time of the most recent modification to any feature detail. If specific feature details are passed in the request, gives the most recent modification time of those feature details. |
URLDetails | URLDetailsType | Conditionally,
repeatable: [0..*] |
Lists eBay URLs that are applicable to the site specified in the request. Note: This container is only returned if URLDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. |
URLDetails.DetailVersion | string | Always | Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. |
URLDetails.UpdateTime | dateTime | Always | Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. |
URLDetails.URL | anyURI | Conditionally |
A commonly used eBay URL. Applications use some of these URLs (such as the View Item URL) to launch eBay Web site pages in a browser. Logo URLs are required to be used in certain types of applications. See your API license agreement. Also see this page for logo usage rules: https://developer.ebay.com/join/licenses/apilogousage |
URLDetails.URLType | URLTypeCodeType | Conditionally |
This enumeration value indicates the type of eBay page.
Applicable values: See URLType. Code so that your app gracefully handles any future changes to this list. |
VariationDetails | VariationDetailsType | Conditionally |
Site-level validation rules for multiple-variation listings (for example, the maximum number of variations per listing). Use GetCategoryFeatures to determine which categories on a site support variations. Note: This container is only returned if VariationDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. See GetCategoryFeatures. |
VariationDetails.DetailVersion | string | Always | Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. |
VariationDetails .MaxNamesPerVariationSpecificsSet |
int | Conditionally | This value indicates the maximum number of variation specific sets that the site will allow per listing. Typical variation specific sets for clothing may be 'Color', 'Size', 'Long Sleeve', etc. |
VariationDetails .MaxValuesPerVariationSpecificsSetName |
int | Conditionally | This value indicates the maximum number of values that the site will allow within one variation specific set. For example, if the variation specific set was 'Color', the seller could specify as many colors that are available up to this maximum value. |
VariationDetails .MaxVariationsPerItem |
int | Conditionally | This value indicates the maximum number of item variations that the site will allow within one multi-variation listing. |
VariationDetails.UpdateTime | dateTime | Always | Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. |
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: (Not all values in AckCodeType apply to this field.) Code so that your app gracefully handles any future changes to this list. |
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. |
Errors.ErrorClassification | ErrorClassificationCodeType | Conditionally |
API errors are divided between two classes: system errors and request errors.
Applicable values: Code so that your app gracefully handles any future changes to this list. |
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 Errors By Number. |
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 | This is the value of the request parameter noted in the ParamID attribute. So, if the ParamID value was ItemID, the value in this field would be the actual value of that ItemID. |
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: If the source of the problem is within the application (such as a missing required element), change the application before you retry the request.
See the Error handling section of the Making a Trading API call guide for more information. 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. Code so that your app gracefully handles any future changes to this list. |
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. |
Input Output Samples Change History |
Detail Controls
DetailLevel
This call does not support varying Detail Levels. You do not need to pass DetailLevel in the request.
Input Output Detail Controls Change History |
Samples
New to making API calls? Please see Making a Call.
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:
- Basic Call ↓ - Retrieves the current set of meta-data for all eBay sites.
- Shipping Services ↓ - Details the shipping services available through eBay.
- Finding the eBay Logo and Other eBay URLs ↓ - Returns the current set of eBay URLs, including the URLs where you can find the eBay logos.
- Determining the Return Policy ↓ - Returns the return-policy options for the site.
Retrieves the current set of meta-data for all eBay sites.
Description
The basic call uses no input fields and returns the complete set of eBay meta-data for all sites. If you want to retrieve specific sets of meta-data, use the major headings in the response as values for the DetailName field.
Input
XML format.
<?xml version="1.0" encoding="utf-8"?>
<GeteBayDetailsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<RequesterCredentials>
<eBayAuthToken>A*******3</eBayAuthToken>
</RequesterCredentials>
</GeteBayDetailsRequest>
Output
XML format.<?xml version="1.0" encoding="UTF-8"?> <GeteBayDetailsResponse xmlns="urn:ebay:apis:eBLBaseComponents"> <Timestamp>2019-11-04T20:37:51.033Z</Timestamp> <Ack>Success</Ack> <Version>1131</Version> <Build>E1131_CORE_API6_19105226_R1</Build> <CountryDetails> <Country>AL</Country> <Description>Albania</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:51:09.000Z</UpdateTime> </CountryDetails> <CountryDetails> <Country>DZ</Country> <Description>Algeria</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:51:09.000Z</UpdateTime> </CountryDetails> <CountryDetails> <Country>AG</Country> <Description>Antigua and Barbuda</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:51:09.000Z</UpdateTime> </CountryDetails> <CountryDetails> <Country>AW</Country> <Description>Aruba</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:51:09.000Z</UpdateTime> </CountryDetails> <CountryDetails> <Country>AU</Country> <Description>Australia</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:51:09.000Z</UpdateTime> </CountryDetails> ... <CountryDetails> <Country>US</Country> <Description>United States</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:51:09.000Z</UpdateTime> </CountryDetails> <CountryDetails> <Country>PW</Country> <Description>Palau</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:51:09.000Z</UpdateTime> </CountryDetails> <CountryDetails> <Country>ME</Country> <Description>Montenegro</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:51:09.000Z</UpdateTime> </CountryDetails> <CountryDetails> <Country>RS</Country> <Description>Serbia</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:51:09.000Z</UpdateTime> </CountryDetails> <CurrencyDetails> <Currency>USD</Currency> <Description>US Dollar</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </CurrencyDetails> <CurrencyDetails> <Currency>CAD</Currency> <Description>Canadian Dollar</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </CurrencyDetails> <CurrencyDetails> <Currency>GBP</Currency> <Description>British Pound</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </CurrencyDetails> <CurrencyDetails> <Currency>AUD</Currency> <Description>Australian Dollar</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </CurrencyDetails> <CurrencyDetails> <Currency>EUR</Currency> <Description>Euro</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </CurrencyDetails> ... <CurrencyDetails> <Currency>MYR</Currency> <Description>Malaysian Ringgit</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </CurrencyDetails> <DispatchTimeMaxDetails> <DispatchTimeMax>0</DispatchTimeMax> <Description>0 Days</Description> <DetailVersion>5</DetailVersion> <UpdateTime>2015-06-04T00:10:01.000Z</UpdateTime> <ExtendedHandling>false</ExtendedHandling> </DispatchTimeMaxDetails> <DispatchTimeMaxDetails> <DispatchTimeMax>1</DispatchTimeMax> <Description>1 Day</Description> <DetailVersion>5</DetailVersion> <UpdateTime>2015-06-04T00:10:01.000Z</UpdateTime> <ExtendedHandling>false</ExtendedHandling> </DispatchTimeMaxDetails> <DispatchTimeMaxDetails> <DispatchTimeMax>2</DispatchTimeMax> <Description>2 Days</Description> <DetailVersion>5</DetailVersion> <UpdateTime>2015-06-04T00:10:01.000Z</UpdateTime> <ExtendedHandling>false</ExtendedHandling> </DispatchTimeMaxDetails> <DispatchTimeMaxDetails> <DispatchTimeMax>3</DispatchTimeMax> <Description>3 Days</Description> <DetailVersion>5</DetailVersion> <UpdateTime>2015-06-04T00:10:01.000Z</UpdateTime> <ExtendedHandling>false</ExtendedHandling> </DispatchTimeMaxDetails> <DispatchTimeMaxDetails> <DispatchTimeMax>20</DispatchTimeMax> <Description>20 Days</Description> <DetailVersion>5</DetailVersion> <UpdateTime>2015-06-04T00:10:01.000Z</UpdateTime> <ExtendedHandling>true</ExtendedHandling> </DispatchTimeMaxDetails> <DispatchTimeMaxDetails> <DispatchTimeMax>4</DispatchTimeMax> <Description>4 Days</Description> <DetailVersion>5</DetailVersion> <UpdateTime>2015-06-04T00:10:01.000Z</UpdateTime> <ExtendedHandling>true</ExtendedHandling> </DispatchTimeMaxDetails> <DispatchTimeMaxDetails> <DispatchTimeMax>5</DispatchTimeMax> <Description>5 Days</Description> <DetailVersion>5</DetailVersion> <UpdateTime>2015-06-04T00:10:01.000Z</UpdateTime> <ExtendedHandling>true</ExtendedHandling> </DispatchTimeMaxDetails> <DispatchTimeMaxDetails> <DispatchTimeMax>40</DispatchTimeMax> <Description>40 Days</Description> <DetailVersion>5</DetailVersion> <UpdateTime>2015-06-04T00:10:01.000Z</UpdateTime> <ExtendedHandling>true</ExtendedHandling> </DispatchTimeMaxDetails> <DispatchTimeMaxDetails> <DispatchTimeMax>10</DispatchTimeMax> <Description>10 Days</Description> <DetailVersion>5</DetailVersion> <UpdateTime>2015-06-04T00:10:01.000Z</UpdateTime> <ExtendedHandling>true</ExtendedHandling> </DispatchTimeMaxDetails> <DispatchTimeMaxDetails> <DispatchTimeMax>30</DispatchTimeMax> <Description>30 Days</Description> <DetailVersion>5</DetailVersion> <UpdateTime>2015-06-04T00:10:01.000Z</UpdateTime> <ExtendedHandling>true</ExtendedHandling> </DispatchTimeMaxDetails> <DispatchTimeMaxDetails> <DispatchTimeMax>15</DispatchTimeMax> <Description>15 Days</Description> <DetailVersion>5</DetailVersion> <UpdateTime>2015-06-04T00:10:01.000Z</UpdateTime> <ExtendedHandling>true</ExtendedHandling> </DispatchTimeMaxDetails> <PaymentOptionDetails> <PaymentOption>MOCC</PaymentOption> <Description>Money order / Cashier's check</Description> <DetailVersion>3</DetailVersion> <UpdateTime>2010-06-11T06:51:58.000Z</UpdateTime> </PaymentOptionDetails> <PaymentOptionDetails> <PaymentOption>PersonalCheck</PaymentOption> <Description>Personal check</Description> <DetailVersion>3</DetailVersion> <UpdateTime>2010-06-11T06:51:58.000Z</UpdateTime> </PaymentOptionDetails> <PaymentOptionDetails> <PaymentOption>VisaMC</PaymentOption> <Description>Visa or Master Card</Description> <DetailVersion>3</DetailVersion> <UpdateTime>2010-06-11T06:51:58.000Z</UpdateTime> </PaymentOptionDetails> <PaymentOptionDetails> <PaymentOption>AmEx</PaymentOption> <Description>American Express</Description> <DetailVersion>3</DetailVersion> <UpdateTime>2010-06-11T06:51:58.000Z</UpdateTime> </PaymentOptionDetails> <PaymentOptionDetails> <PaymentOption>Discover</PaymentOption> <Description>Discover Card</Description> <DetailVersion>3</DetailVersion> <UpdateTime>2010-06-11T06:51:58.000Z</UpdateTime> </PaymentOptionDetails> <PaymentOptionDetails> <PaymentOption>PaymentSeeDescription</PaymentOption> <Description>Other - See item description</Description> <DetailVersion>3</DetailVersion> <UpdateTime>2010-06-11T06:51:58.000Z</UpdateTime> </PaymentOptionDetails> <PaymentOptionDetails> <PaymentOption>PayPal</PaymentOption> <Description>PayPal</Description> <DetailVersion>3</DetailVersion> <UpdateTime>2010-06-11T06:51:58.000Z</UpdateTime> </PaymentOptionDetails> <PaymentOptionDetails> <PaymentOption>IntegratedMerchantCreditCard</PaymentOption> <Description>Integrated Merchant Credit Card</Description> <DetailVersion>3</DetailVersion> <UpdateTime>2010-06-11T06:51:58.000Z</UpdateTime> </PaymentOptionDetails> <PaymentOptionDetails> <PaymentOption>CashOnPickup</PaymentOption> <Description>Cash On Pickup Accepted</Description> <DetailVersion>3</DetailVersion> <UpdateTime>2010-06-11T06:51:58.000Z</UpdateTime> </PaymentOptionDetails> <RegionDetails> <RegionID>39</RegionID> <Description>AZ-Phoenix</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionDetails> <RegionDetails> <RegionID>1</RegionID> <Description>CA-Los Angeles</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionDetails> <RegionDetails> <RegionID>57</RegionID> <Description>CA-Oakland</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionDetails> <RegionDetails> <RegionID>58</RegionID> <Description>CA-Orange County</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionDetails> <RegionDetails> <RegionID>45</RegionID> <Description>CA-Sacramento</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionDetails> <RegionDetails> <RegionID>48</RegionID> <Description>CA-San Diego</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionDetails> <RegionDetails> <RegionID>49</RegionID> <Description>CA-San Francisco</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionDetails> <RegionDetails> <RegionID>60</RegionID> <Description>CA-San Jose</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionDetails> ... <RegionDetails> <RegionID>50</RegionID> <Description>WA-Seattle-Tacoma</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionDetails> <RegionDetails> <RegionID>30</RegionID> <Description>WI-Milwaukee</Description> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionDetails> <ShippingLocationDetails> <ShippingLocation>CN</ShippingLocation> <Description>China</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingLocationDetails> <ShippingLocation>RU</ShippingLocation> <Description>Russian Federation</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingLocationDetails> <ShippingLocation>CA</ShippingLocation> <Description>Canada</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingLocationDetails> <ShippingLocation>BR</ShippingLocation> <Description>Brazil</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingLocationDetails> <ShippingLocation>DE</ShippingLocation> <Description>Germany</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingLocationDetails> <ShippingLocation>FR</ShippingLocation> <Description>France</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingLocationDetails> <ShippingLocation>Europe</ShippingLocation> <Description>Europe</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingLocationDetails> <ShippingLocation>GB</ShippingLocation> <Description>United Kingdom</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingLocationDetails> <ShippingLocation>Americas</ShippingLocation> <Description>N. and S. America</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingLocationDetails> <ShippingLocation>Asia</ShippingLocation> <Description>Asia</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingLocationDetails> <ShippingLocation>AU</ShippingLocation> <Description>Australia</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingLocationDetails> <ShippingLocation>MX</ShippingLocation> <Description>Mexico</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingLocationDetails> <ShippingLocation>Worldwide</ShippingLocation> <Description>Worldwide</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingLocationDetails> <ShippingLocation>JP</ShippingLocation> <Description>Japan</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingLocationDetails> <ShippingLocation>None</ShippingLocation> <Description>None</Description> <DetailVersion>2</DetailVersion> <UpdateTime>2014-09-19T03:46:18.000Z</UpdateTime> </ShippingLocationDetails> <ShippingServiceDetails> <Description>International Priority Shipping</Description> <InternationalService>true</InternationalService> <ShippingService>InternationalPriorityShipping</ShippingService> <ShippingServiceID>50100</ShippingServiceID> <ShippingTimeMax>8</ShippingTimeMax> <ShippingTimeMin>6</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ServiceType>Calculated</ServiceType> <ShippingPackage>Letter</ShippingPackage> <ShippingPackage>LargeEnvelope</ShippingPackage> <ShippingPackage>PackageThickEnvelope</ShippingPackage> <ShippingPackage>USPSLargePack</ShippingPackage> <ValidForSellingFlow>false</ValidForSellingFlow> <ShippingCarrier>MondialRelay</ShippingCarrier> <ShippingServicePackageDetails> <Name>Letter</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>LargeEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>PackageThickEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>USPSLargePack</Name> </ShippingServicePackageDetails> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>EXPEDITED</ShippingCategory> </ShippingServiceDetails> <ShippingServiceDetails> <Description>USPS Global Express Mail</Description> <InternationalService>true</InternationalService> <ShippingService>USPSGlobalExpress</ShippingService> <ShippingServiceID>50003</ShippingServiceID> <ShippingTimeMax>5</ShippingTimeMax> <ShippingTimeMin>3</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ServiceType>Calculated</ServiceType> <ShippingPackage>Letter</ShippingPackage> <ShippingPackage>LargeEnvelope</ShippingPackage> <ShippingPackage>PackageThickEnvelope</ShippingPackage> <ValidForSellingFlow>false</ValidForSellingFlow> <ShippingCarrier>USPS</ShippingCarrier> <ShippingServicePackageDetails> <Name>Letter</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>LargeEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>PackageThickEnvelope</Name> </ShippingServicePackageDetails> <WeightRequired>true</WeightRequired> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>NONE</ShippingCategory> </ShippingServiceDetails> <ShippingServiceDetails> <Description>USPS Global Priority Mail</Description> <InternationalService>true</InternationalService> <ShippingService>USPSGlobalPriority</ShippingService> <ShippingServiceID>50005</ShippingServiceID> <ShippingTimeMax>6</ShippingTimeMax> <ShippingTimeMin>4</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ServiceType>Calculated</ServiceType> <ShippingPackage>Letter</ShippingPackage> <ShippingPackage>LargeEnvelope</ShippingPackage> <ShippingPackage>PackageThickEnvelope</ShippingPackage> <ValidForSellingFlow>false</ValidForSellingFlow> <ShippingCarrier>USPS</ShippingCarrier> <ShippingServicePackageDetails> <Name>Letter</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>LargeEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>PackageThickEnvelope</Name> </ShippingServicePackageDetails> <WeightRequired>true</WeightRequired> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>NONE</ShippingCategory> </ShippingServiceDetails> <ShippingServiceDetails> <Description>USPS Economy Letter Post</Description> <InternationalService>true</InternationalService> <ShippingService>USPSEconomyLetter</ShippingService> <ShippingServiceID>50007</ShippingServiceID> <ShippingTimeMax>42</ShippingTimeMax> <ShippingTimeMin>28</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ServiceType>Calculated</ServiceType> <ShippingPackage>Letter</ShippingPackage> <ShippingPackage>LargeEnvelope</ShippingPackage> <ShippingPackage>PackageThickEnvelope</ShippingPackage> <ValidForSellingFlow>false</ValidForSellingFlow> <ShippingCarrier>USPS</ShippingCarrier> <ShippingServicePackageDetails> <Name>Letter</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>LargeEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>PackageThickEnvelope</Name> </ShippingServicePackageDetails> <WeightRequired>true</WeightRequired> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>NONE</ShippingCategory> </ShippingServiceDetails> ... <ShippingServiceDetails> <Description>Standard Shipping from India</Description> <ShippingService>US_StandardShippingFromIN</ShippingService> <ShippingServiceID>50051</ShippingServiceID> <ShippingTimeMax>12</ShippingTimeMax> <ShippingTimeMin>5</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ValidForSellingFlow>true</ValidForSellingFlow> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>OTHER</ShippingCategory> </ShippingServiceDetails> <ShippingServiceDetails> <Description>Expedited Shipping from China/Hong Kong/Taiwan to worldwide</Description> <ShippingService>US_ExpeditedShippingFromGC</ShippingService> <ShippingServiceID>50046</ShippingServiceID> <ShippingTimeMax>7</ShippingTimeMax> <ShippingTimeMin>2</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ValidForSellingFlow>true</ValidForSellingFlow> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>OTHER</ShippingCategory> </ShippingServiceDetails> <ShippingServiceDetails> <Description>Expedited Shipping from India</Description> <ShippingService>US_ExpeditedShippingFromIN</ShippingService> <ShippingServiceID>50050</ShippingServiceID> <ShippingTimeMax>9</ShippingTimeMax> <ShippingTimeMin>3</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ValidForSellingFlow>true</ValidForSellingFlow> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>OTHER</ShippingCategory> </ShippingServiceDetails> <SiteDetails> <Site>US</Site> <SiteID>0</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Canada</Site> <SiteID>2</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>UK</Site> <SiteID>3</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Germany</Site> <SiteID>77</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Australia</Site> <SiteID>15</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>France</Site> <SiteID>71</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>eBayMotors</Site> <SiteID>100</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Italy</Site> <SiteID>101</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Netherlands</Site> <SiteID>146</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Spain</Site> <SiteID>186</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>India</Site> <SiteID>203</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>HongKong</Site> <SiteID>201</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Singapore</Site> <SiteID>216</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Malaysia</Site> <SiteID>207</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Philippines</Site> <SiteID>211</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>CanadaFrench</Site> <SiteID>210</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Poland</Site> <SiteID>212</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Belgium_Dutch</Site> <SiteID>123</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Belgium_French</Site> <SiteID>23</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Austria</Site> <SiteID>16</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Switzerland</Site> <SiteID>193</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <SiteDetails> <Site>Ireland</Site> <SiteID>205</SiteID> <DetailVersion>1</DetailVersion> <UpdateTime>2011-12-25T16:02:16.000Z</UpdateTime> </SiteDetails> <TaxJurisdiction> <JurisdictionID>PW</JurisdictionID> <JurisdictionName>Palau</JurisdictionName> <DetailVersion>2</DetailVersion> <UpdateTime>2011-01-18T03:27:37.000Z</UpdateTime> </TaxJurisdiction> <TaxJurisdiction> <JurisdictionID>AS</JurisdictionID> <JurisdictionName>American Samoa</JurisdictionName> <DetailVersion>2</DetailVersion> <UpdateTime>2011-01-18T03:27:37.000Z</UpdateTime> </TaxJurisdiction> <TaxJurisdiction> <JurisdictionID>GU</JurisdictionID> <JurisdictionName>Guam</JurisdictionName> <DetailVersion>2</DetailVersion> <UpdateTime>2011-01-18T03:27:37.000Z</UpdateTime> </TaxJurisdiction> <TaxJurisdiction> <JurisdictionID>MP</JurisdictionID> <JurisdictionName>Northern Mariana Islands</JurisdictionName> <DetailVersion>2</DetailVersion> <UpdateTime>2011-01-18T03:27:37.000Z</UpdateTime> </TaxJurisdiction> <TaxJurisdiction> <JurisdictionID>VI</JurisdictionID> <JurisdictionName>Virgin Islands</JurisdictionName> <DetailVersion>2</DetailVersion> <UpdateTime>2011-01-18T03:27:37.000Z</UpdateTime> </TaxJurisdiction> <TaxJurisdiction> <JurisdictionID>PR</JurisdictionID> <JurisdictionName>Puerto Rico</JurisdictionName> <DetailVersion>2</DetailVersion> <UpdateTime>2011-01-18T03:27:37.000Z</UpdateTime> </TaxJurisdiction> <TaxJurisdiction> <JurisdictionID>WY</JurisdictionID> <JurisdictionName>Wyoming</JurisdictionName> <DetailVersion>2</DetailVersion> <UpdateTime>2011-01-18T03:27:37.000Z</UpdateTime> </TaxJurisdiction> <TaxJurisdiction> <JurisdictionID>WI</JurisdictionID> <JurisdictionName>Wisconsin</JurisdictionName> <DetailVersion>2</DetailVersion> <UpdateTime>2011-01-18T03:27:37.000Z</UpdateTime> </TaxJurisdiction> <TaxJurisdiction> <JurisdictionID>WV</JurisdictionID> <JurisdictionName>West Virginia</JurisdictionName> <DetailVersion>2</DetailVersion> <UpdateTime>2011-01-18T03:27:37.000Z</UpdateTime> </TaxJurisdiction> <TaxJurisdiction> <JurisdictionID>WA</JurisdictionID> <JurisdictionName>Washington</JurisdictionName> <DetailVersion>2</DetailVersion> <UpdateTime>2011-01-18T03:27:37.000Z</UpdateTime> </TaxJurisdiction> ... <TaxJurisdiction> <JurisdictionID>AZ</JurisdictionID> <JurisdictionName>Arizona</JurisdictionName> <DetailVersion>2</DetailVersion> <UpdateTime>2011-01-18T03:27:37.000Z</UpdateTime> </TaxJurisdiction> <TaxJurisdiction> <JurisdictionID>AK</JurisdictionID> <JurisdictionName>Alaska</JurisdictionName> <DetailVersion>2</DetailVersion> <UpdateTime>2011-01-18T03:27:37.000Z</UpdateTime> </TaxJurisdiction> <TaxJurisdiction> <JurisdictionID>AL</JurisdictionID> <JurisdictionName>Alabama</JurisdictionName> <DetailVersion>2</DetailVersion> <UpdateTime>2011-01-18T03:27:37.000Z</UpdateTime> </TaxJurisdiction> <URLDetails> <URLType>ViewItemURL</URLType> <URL>http://cgi.ebay.com/ws/eBayISAPI.dll?ViewItem&item=</URL> <DetailVersion>3</DetailVersion> <UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime> </URLDetails> <URLDetails> <URLType>ViewUserURL</URLType> <URL>http://feedback.ebay.com/ws/eBayISAPI.dll?ViewFeedback&userid=</URL> <DetailVersion>3</DetailVersion> <UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime> </URLDetails> <URLDetails> <URLType>MyeBayURL</URLType> <URL>http://my.ebay.com/ws/eBayISAPI.dll?MyEbayBeta</URL> <DetailVersion>3</DetailVersion> <UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime> </URLDetails> <URLDetails> <URLType>MyeBayBiddingURL</URLType> <URL>http://my.ebay.com/ws/eBayISAPI.dll?MyEbayBeta&CurrentPage=MyeBayNextBidding</URL> <DetailVersion>3</DetailVersion> <UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime> </URLDetails> <URLDetails> <URLType>MyeBayNotWonURL</URLType> <URL>http://my.ebay.com/ws/eBayISAPI.dll?MyEbayBeta&CurrentPage=MyeBayNextLost</URL> <DetailVersion>3</DetailVersion> <UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime> </URLDetails> <URLDetails> <URLType>MyeBayWonURL</URLType> <URL>http://my.ebay.com/ws/eBayISAPI.dll?MyEbayBeta&CurrentPage=MyeBayNextWon</URL> <DetailVersion>3</DetailVersion> <UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime> </URLDetails> <URLDetails> <URLType>MyeBayWatchingURL</URLType> <URL>http://my.ebay.com/ws/eBayISAPI.dll?MyEbayBeta&CurrentPage=MyeBayNextWatching</URL> <DetailVersion>3</DetailVersion> <UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime> </URLDetails> <URLDetails> <URLType>eBayStoreURL</URLType> <URL>http://www.stores.ebay.com/</URL> <DetailVersion>3</DetailVersion> <UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime> </URLDetails> <URLDetails> <URLType>SmallLogoURL</URLType> <URL>https://securepics.ebaystatic.com/api/ebay_market_108x45.gif</URL> <DetailVersion>3</DetailVersion> <UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime> </URLDetails> <URLDetails> <URLType>MediumLogoURL</URLType> <URL>https://securepics.ebaystatic.com/api/ebay_market_144x59.gif</URL> <DetailVersion>3</DetailVersion> <UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime> </URLDetails> <URLDetails> <URLType>LargeLogoURL</URLType> <URL>https://securepics.ebaystatic.com/api/ebay_market_182x76.gif</URL> <DetailVersion>3</DetailVersion> <UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime> </URLDetails> <TimeZoneDetails> <TimeZoneID>Pacific/Niue</TimeZoneID> <StandardLabel>Niue Time</StandardLabel> <StandardOffset>-11:00</StandardOffset> <DetailVersion>76</DetailVersion> <UpdateTime>2018-03-31T14:57:07.000Z</UpdateTime> </TimeZoneDetails> <TimeZoneDetails> <TimeZoneID>Pacific/Pago_Pago</TimeZoneID> <StandardLabel>Samoa Standard Time</StandardLabel> <StandardOffset>-11:00</StandardOffset> <DetailVersion>76</DetailVersion> <UpdateTime>2018-03-31T14:57:07.000Z</UpdateTime> </TimeZoneDetails> <TimeZoneDetails> <TimeZoneID>HST</TimeZoneID> <StandardLabel>Hawaii Standard Time</StandardLabel> <StandardOffset>-10:00</StandardOffset> <DetailVersion>76</DetailVersion> <UpdateTime>2018-03-31T14:57:07.000Z</UpdateTime> </TimeZoneDetails> <TimeZoneDetails> <TimeZoneID>Pacific/Rarotonga</TimeZoneID> <StandardLabel>Cook Is. Time</StandardLabel> <StandardOffset>-10:00</StandardOffset> <DetailVersion>76</DetailVersion> <UpdateTime>2018-03-31T14:57:07.000Z</UpdateTime> </TimeZoneDetails> ... <TimeZoneDetails> <TimeZoneID>MIT</TimeZoneID> <StandardLabel>West Samoa Time</StandardLabel> <StandardOffset>+13:00</StandardOffset> <DaylightSavingsLabel>West Samoa Daylight Time</DaylightSavingsLabel> <DaylightSavingsOffset>+14:00</DaylightSavingsOffset> <DaylightSavingsInEffect>true</DaylightSavingsInEffect> <DetailVersion>76</DetailVersion> <UpdateTime>2018-03-31T14:57:07.000Z</UpdateTime> </TimeZoneDetails> <TimeZoneDetails> <TimeZoneID>Pacific/Kiritimati</TimeZoneID> <StandardLabel>Line Is. Time</StandardLabel> <StandardOffset>+14:00</StandardOffset> <DetailVersion>76</DetailVersion> <UpdateTime>2018-03-31T14:57:07.000Z</UpdateTime> </TimeZoneDetails> <ItemSpecificDetails> <MaxItemSpecificsPerItem>15</MaxItemSpecificsPerItem> <MaxValuesPerName>10</MaxValuesPerName> <MaxCharactersPerValue>50</MaxCharactersPerValue> <MaxCharactersPerName>40</MaxCharactersPerName> <DetailVersion>2</DetailVersion> <UpdateTime>2010-07-13T13:09:36.000Z</UpdateTime> </ItemSpecificDetails> <RegionOfOriginDetails> <RegionOfOrigin>Africa</RegionOfOrigin> <Description>Africa</Description> <Status>Active</Status> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionOfOriginDetails> <RegionOfOriginDetails> <RegionOfOrigin>Asia</RegionOfOrigin> <Description>Asia</Description> <Status>Active</Status> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionOfOriginDetails> <RegionOfOriginDetails> <RegionOfOrigin>Caribbean</RegionOfOrigin> <Description>Caribbean</Description> <Status>Active</Status> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionOfOriginDetails> <RegionOfOriginDetails> <RegionOfOrigin>Europe</RegionOfOrigin> <Description>Europe</Description> <Status>Active</Status> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionOfOriginDetails> ... <RegionOfOriginDetails> <RegionOfOrigin>TL</RegionOfOrigin> <Description>Timor-Leste</Description> <Status>Active</Status> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionOfOriginDetails> <RegionOfOriginDetails> <RegionOfOrigin>UM</RegionOfOrigin> <Description>United States Minor Outlying Islands</Description> <Status>Active</Status> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </RegionOfOriginDetails> <ShippingPackageDetails> <PackageID>1</PackageID> <Description>Letter</Description> <ShippingPackage>Letter</ShippingPackage> <DefaultValue>true</DefaultValue> <DetailVersion>4</DetailVersion> <UpdateTime>2015-06-04T22:36:29.000Z</UpdateTime> </ShippingPackageDetails> <ShippingPackageDetails> <PackageID>2</PackageID> <Description>Large Envelope</Description> <ShippingPackage>LargeEnvelope</ShippingPackage> <DimensionsSupported>true</DimensionsSupported> <DetailVersion>4</DetailVersion> <UpdateTime>2015-06-04T22:36:29.000Z</UpdateTime> </ShippingPackageDetails> <ShippingPackageDetails> <PackageID>4</PackageID> <Description>Package</Description> <ShippingPackage>PackageThickEnvelope</ShippingPackage> <DimensionsSupported>true</DimensionsSupported> <DetailVersion>4</DetailVersion> <UpdateTime>2015-06-04T22:36:29.000Z</UpdateTime> </ShippingPackageDetails> <ShippingPackageDetails> <PackageID>5</PackageID> <Description>LargePackage</Description> <ShippingPackage>USPSLargePack</ShippingPackage> <DimensionsSupported>true</DimensionsSupported> <DetailVersion>4</DetailVersion> <UpdateTime>2015-06-04T22:36:29.000Z</UpdateTime> </ShippingPackageDetails> <ShippingCarrierDetails> <ShippingCarrierID>1</ShippingCarrierID> <Description>UPS</Description> <ShippingCarrier>UPS</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> <ShippingCarrierDetails> <ShippingCarrierID>2</ShippingCarrierID> <Description>USPS</Description> <ShippingCarrier>USPS</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> <ShippingCarrierDetails> <ShippingCarrierID>12</ShippingCarrierID> <Description>FedEx</Description> <ShippingCarrier>FedEx</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> <ShippingCarrierDetails> <ShippingCarrierID>21</ShippingCarrierID> <Description>4PX</Description> <ShippingCarrier>FourPX</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> <ShippingCarrierDetails> <ShippingCarrierID>22</ShippingCarrierID> <Description>4PX CHINA</Description> <ShippingCarrier>FourPXCHINA</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> ... <ShippingCarrierDetails> <ShippingCarrierID>169</ShippingCarrierID> <Description>WPX</Description> <ShippingCarrier>WPX</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> <ShippingCarrierDetails> <ShippingCarrierID>170</ShippingCarrierID> <Description>YANWEN</Description> <ShippingCarrier>YANWEN</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> <ShippingCarrierDetails> <ShippingCarrierID>172</ShippingCarrierID> <Description>YRC</Description> <ShippingCarrier>YRC</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> <ReturnPolicyDetails> <Refund> <RefundOption>MoneyBack</RefundOption> <Description>Money Back</Description> </Refund> <Refund> <RefundOption>MoneyBackOrReplacement</RefundOption> <Description>Money back or replacement (buyer's choice)</Description> </Refund> <Refund> <RefundOption>MoneyBackOrExchange</RefundOption> <Description>Money back or exchange (buyer's choice)</Description> </Refund> <ReturnsWithin> <ReturnsWithinOption>Days_14</ReturnsWithinOption> <Description>14 Days</Description> </ReturnsWithin> <ReturnsWithin> <ReturnsWithinOption>Days_30</ReturnsWithinOption> <Description>30 Days</Description> </ReturnsWithin> <ReturnsWithin> <ReturnsWithinOption>Days_60</ReturnsWithinOption> <Description>60 Days</Description> </ReturnsWithin> <ReturnsAccepted> <ReturnsAcceptedOption>ReturnsAccepted</ReturnsAcceptedOption> <Description>Returns Accepted</Description> </ReturnsAccepted> <ReturnsAccepted> <ReturnsAcceptedOption>ReturnsNotAccepted</ReturnsAcceptedOption> <Description>No returns accepted</Description> </ReturnsAccepted> <Description>true</Description> <ShippingCostPaidBy> <ShippingCostPaidByOption>Buyer</ShippingCostPaidByOption> <Description>Buyer</Description> </ShippingCostPaidBy> <ShippingCostPaidBy> <ShippingCostPaidByOption>Seller</ShippingCostPaidByOption> <Description>Seller</Description> </ShippingCostPaidBy> <RestockingFeeValue> <RestockingFeeValueOption>NoRestockingFee</RestockingFeeValueOption> <Description>No</Description> </RestockingFeeValue> <RestockingFeeValue> <RestockingFeeValueOption>Percent_10</RestockingFeeValueOption> <Description>10%</Description> </RestockingFeeValue> <RestockingFeeValue> <RestockingFeeValueOption>Percent_15</RestockingFeeValueOption> <Description>15%</Description> </RestockingFeeValue> <RestockingFeeValue> <RestockingFeeValueOption>Percent_20</RestockingFeeValueOption> <Description>20%</Description> </RestockingFeeValue> <DetailVersion>6</DetailVersion> <UpdateTime>2013-07-02T12:17:09.000Z</UpdateTime> </ReturnPolicyDetails> <ListingStartPriceDetails> <Description>Pricing for the auction-like listings</Description> <ListingType>Chinese</ListingType> <StartPrice currencyID="USD">0.01</StartPrice> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> <MinBuyItNowPricePercent>30.0</MinBuyItNowPricePercent> </ListingStartPriceDetails> <ListingStartPriceDetails> <Description>Pricing for multiple item listings</Description> <ListingType>Dutch</ListingType> <StartPrice currencyID="USD">0.99</StartPrice> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </ListingStartPriceDetails> <ListingStartPriceDetails> <Description>Pricing for fixed price listings</Description> <ListingType>FixedPriceItem</ListingType> <StartPrice currencyID="USD">0.99</StartPrice> <DetailVersion>1</DetailVersion> <UpdateTime>2009-07-01T23:43:58.000Z</UpdateTime> </ListingStartPriceDetails> <BuyerRequirementDetails> <LinkedPayPalAccount>false</LinkedPayPalAccount> <MaximumBuyerPolicyViolations> <NumberOfPolicyViolations> <Count>4</Count> <Count>5</Count> <Count>6</Count> <Count>7</Count> </NumberOfPolicyViolations> <PolicyViolationDuration> <Period>Days_30</Period> <Description>1 month</Description> </PolicyViolationDuration> <PolicyViolationDuration> <Period>Days_180</Period> <Description>6 months</Description> </PolicyViolationDuration> </MaximumBuyerPolicyViolations> <MaximumItemRequirements> <MaximumItemCount>1</MaximumItemCount> <MaximumItemCount>2</MaximumItemCount> <MaximumItemCount>3</MaximumItemCount> <MaximumItemCount>4</MaximumItemCount> <MaximumItemCount>5</MaximumItemCount> <MaximumItemCount>6</MaximumItemCount> <MaximumItemCount>7</MaximumItemCount> <MaximumItemCount>8</MaximumItemCount> <MaximumItemCount>9</MaximumItemCount> <MaximumItemCount>10</MaximumItemCount> <MaximumItemCount>25</MaximumItemCount> <MaximumItemCount>50</MaximumItemCount> <MaximumItemCount>75</MaximumItemCount> <MaximumItemCount>100</MaximumItemCount> <MinimumFeedbackScore>5</MinimumFeedbackScore> <MinimumFeedbackScore>4</MinimumFeedbackScore> <MinimumFeedbackScore>3</MinimumFeedbackScore> <MinimumFeedbackScore>2</MinimumFeedbackScore> <MinimumFeedbackScore>1</MinimumFeedbackScore> <MinimumFeedbackScore>0</MinimumFeedbackScore> </MaximumItemRequirements> <MaximumUnpaidItemStrikesInfo> <MaximumUnpaidItemStrikesCount> <Count>2</Count> <Count>3</Count> <Count>4</Count> <Count>5</Count> </MaximumUnpaidItemStrikesCount> <MaximumUnpaidItemStrikesDuration> <Period>Days_30</Period> <Description>1 month</Description> </MaximumUnpaidItemStrikesDuration> <MaximumUnpaidItemStrikesDuration> <Period>Days_180</Period> <Description>6 months</Description> </MaximumUnpaidItemStrikesDuration> <MaximumUnpaidItemStrikesDuration> <Period>Days_360</Period> <Description>12 months</Description> </MaximumUnpaidItemStrikesDuration> </MaximumUnpaidItemStrikesInfo> <MinimumFeedbackScore> <FeedbackScore>-1</FeedbackScore> <FeedbackScore>-2</FeedbackScore> <FeedbackScore>-3</FeedbackScore> </MinimumFeedbackScore> <ShipToRegistrationCountry>true</ShipToRegistrationCountry> <DetailVersion>2</DetailVersion> <UpdateTime>2018-04-05T21:46:03.000Z</UpdateTime> </BuyerRequirementDetails> <ListingFeatureDetails> <BoldTitle>Enabled</BoldTitle> <Border>Disabled</Border> <Highlight>Disabled</Highlight> <GiftIcon>Disabled</GiftIcon> <HomePageFeatured>Disabled</HomePageFeatured> <FeaturedFirst>Disabled</FeaturedFirst> <FeaturedPlus>Disabled</FeaturedPlus> <ProPack>Disabled</ProPack> <DetailVersion>3</DetailVersion> <UpdateTime>2010-07-01T06:44:55.000Z</UpdateTime> </ListingFeatureDetails> <VariationDetails> <MaxVariationsPerItem>250</MaxVariationsPerItem> <MaxNamesPerVariationSpecificsSet>5</MaxNamesPerVariationSpecificsSet> <MaxValuesPerVariationSpecificsSetName>60</MaxValuesPerVariationSpecificsSetName> <DetailVersion>3</DetailVersion> <UpdateTime>2013-03-21T11:55:05.000Z</UpdateTime> </VariationDetails> <ExcludeShippingLocationDetails> <Description>Africa</Description> <Location>Africa</Location> <Region>Worldwide</Region> <DetailVersion>16</DetailVersion> <UpdateTime>2011-05-18T02:21:15.000Z</UpdateTime> </ExcludeShippingLocationDetails> <ExcludeShippingLocationDetails> <Description>Asia</Description> <Location>Asia</Location> <Region>Worldwide</Region> <DetailVersion>16</DetailVersion> <UpdateTime>2011-05-18T02:21:15.000Z</UpdateTime> </ExcludeShippingLocationDetails> <ExcludeShippingLocationDetails> <Description>Central America and Caribbean</Description> <Location>Central America and Caribbean</Location> <Region>Worldwide</Region> <DetailVersion>16</DetailVersion> <UpdateTime>2011-05-18T02:21:15.000Z</UpdateTime> </ExcludeShippingLocationDetails> <ExcludeShippingLocationDetails> <Description>Europe</Description> <Location>Europe</Location> <Region>Worldwide</Region> <DetailVersion>16</DetailVersion> <UpdateTime>2011-05-18T02:21:15.000Z</UpdateTime> </ExcludeShippingLocationDetails> ... <ExcludeShippingLocationDetails> <Description>Brazil</Description> <Location>BR</Location> <Region>South America</Region> <DetailVersion>16</DetailVersion> <UpdateTime>2011-05-18T02:21:15.000Z</UpdateTime> </ExcludeShippingLocationDetails> <ExcludeShippingLocationDetails> <Description>Colombia</Description> <Location>CO</Location> <Region>South America</Region> <DetailVersion>16</DetailVersion> <UpdateTime>2011-05-18T02:21:15.000Z</UpdateTime> </ExcludeShippingLocationDetails> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <RecoupmentPolicyDetails> <EnforcedOnListingSite>true</EnforcedOnListingSite> <EnforcedOnRegistrationSite>true</EnforcedOnRegistrationSite> <DetailVersion>3</DetailVersion> <UpdateTime>2011-07-07T21:55:22.000Z</UpdateTime> </RecoupmentPolicyDetails> <ShippingCategoryDetails> <ShippingCategory>OTHER</ShippingCategory> <Description>Other services</Description> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>STANDARD</ShippingCategory> <Description>Standard services</Description> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>ECONOMY</ShippingCategory> <Description>Economy services</Description> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>PROMOTIONAL_ECONOMY</ShippingCategory> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>PROMOTIONAL_OVERNIGHT</ShippingCategory> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>EXPEDITED</ShippingCategory> <Description>Expedited services</Description> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>PROMOTIONAL</ShippingCategory> <Description>Promotional services</Description> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>NONE</ShippingCategory> <Description>None</Description> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>DIGITAL</ShippingCategory> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>PROMOTIONAL_VARIES</ShippingCategory> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>ONE_DAY</ShippingCategory> <Description>One-day services</Description> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>PROMOTIONAL_EXPEDITED</ShippingCategory> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>SAME_DAY</ShippingCategory> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>FREIGHT</ShippingCategory> <Description>Freight</Description> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>PICKUP</ShippingCategory> <Description>Pickup</Description> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>PROMOTIONAL_TWO_DAY</ShippingCategory> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>IN_STORE_PICKUP</ShippingCategory> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>PROMOTIONAL_STANDARD</ShippingCategory> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ShippingCategoryDetails> <ShippingCategory>EBAY_SHIPPING</ShippingCategory> <Description>eBay shipping services</Description> <DetailVersion>141</DetailVersion> <UpdateTime>2016-12-13T18:35:15.000Z</UpdateTime> </ShippingCategoryDetails> <ProductDetails> <ProductIdentifierUnavailableText>Does not apply</ProductIdentifierUnavailableText> </ProductDetails> </GeteBayDetailsResponse>
Details the shipping services available through eBay.
Description
Returns the shipping services that are currently available through the eBay interface for the specified site.
Input
Specify ShippingServiceDetails
in the DetailName field to return the current list of shipping services supported by the indicated site.
XML format.
<?xml version="1.0" encoding="utf-8"?>
<GeteBayDetailsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<RequesterCredentials>
<eBayAuthToken>A*******3</eBayAuthToken>
</RequesterCredentials>
<DetailName>ShippingCarrierDetails</DetailName>
<DetailName>ShippingServiceDetails</DetailName>
</GeteBayDetailsRequest>
Output
The output contains all the shipping services supported by the eBay interface (note the output here has been abbreviated).
If you use any of the supported shipping services, eBay calcualtes the actual cost of shipping the item to the buyer. Although you can use a shipping service not directly offered by eBay, using an eBay-supported shipping service has the benefit of letting users know they are paying the current rate for the item shipping.
XML format.<?xml version="1.0" encoding="UTF-8"?> <GeteBayDetailsResponse xmlns="urn:ebay:apis:eBLBaseComponents"> <Timestamp>2019-11-04T20:40:38.424Z</Timestamp> <Ack>Success</Ack> <Version>1131</Version> <Build>E1131_CORE_API6_19105226_R1</Build> <ShippingServiceDetails> <Description>International Priority Shipping</Description> <InternationalService>true</InternationalService> <ShippingService>InternationalPriorityShipping</ShippingService> <ShippingServiceID>50100</ShippingServiceID> <ShippingTimeMax>8</ShippingTimeMax> <ShippingTimeMin>6</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ServiceType>Calculated</ServiceType> <ShippingPackage>Letter</ShippingPackage> <ShippingPackage>LargeEnvelope</ShippingPackage> <ShippingPackage>PackageThickEnvelope</ShippingPackage> <ShippingPackage>USPSLargePack</ShippingPackage> <ValidForSellingFlow>false</ValidForSellingFlow> <ShippingCarrier>MondialRelay</ShippingCarrier> <ShippingServicePackageDetails> <Name>Letter</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>LargeEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>PackageThickEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>USPSLargePack</Name> </ShippingServicePackageDetails> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>EXPEDITED</ShippingCategory> </ShippingServiceDetails> <ShippingServiceDetails> <Description>USPS Global Express Mail</Description> <InternationalService>true</InternationalService> <ShippingService>USPSGlobalExpress</ShippingService> <ShippingServiceID>50003</ShippingServiceID> <ShippingTimeMax>5</ShippingTimeMax> <ShippingTimeMin>3</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ServiceType>Calculated</ServiceType> <ShippingPackage>Letter</ShippingPackage> <ShippingPackage>LargeEnvelope</ShippingPackage> <ShippingPackage>PackageThickEnvelope</ShippingPackage> <ValidForSellingFlow>false</ValidForSellingFlow> <ShippingCarrier>USPS</ShippingCarrier> <ShippingServicePackageDetails> <Name>Letter</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>LargeEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>PackageThickEnvelope</Name> </ShippingServicePackageDetails> <WeightRequired>true</WeightRequired> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>NONE</ShippingCategory> </ShippingServiceDetails> <ShippingServiceDetails> <Description>USPS Global Priority Mail</Description> <InternationalService>true</InternationalService> <ShippingService>USPSGlobalPriority</ShippingService> <ShippingServiceID>50005</ShippingServiceID> <ShippingTimeMax>6</ShippingTimeMax> <ShippingTimeMin>4</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ServiceType>Calculated</ServiceType> <ShippingPackage>Letter</ShippingPackage> <ShippingPackage>LargeEnvelope</ShippingPackage> <ShippingPackage>PackageThickEnvelope</ShippingPackage> <ValidForSellingFlow>false</ValidForSellingFlow> <ShippingCarrier>USPS</ShippingCarrier> <ShippingServicePackageDetails> <Name>Letter</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>LargeEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>PackageThickEnvelope</Name> </ShippingServicePackageDetails> <WeightRequired>true</WeightRequired> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>NONE</ShippingCategory> </ShippingServiceDetails> <ShippingServiceDetails> <Description>USPS Economy Letter Post</Description> <InternationalService>true</InternationalService> <ShippingService>USPSEconomyLetter</ShippingService> <ShippingServiceID>50007</ShippingServiceID> <ShippingTimeMax>42</ShippingTimeMax> <ShippingTimeMin>28</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ServiceType>Calculated</ServiceType> <ShippingPackage>Letter</ShippingPackage> <ShippingPackage>LargeEnvelope</ShippingPackage> <ShippingPackage>PackageThickEnvelope</ShippingPackage> <ValidForSellingFlow>false</ValidForSellingFlow> <ShippingCarrier>USPS</ShippingCarrier> <ShippingServicePackageDetails> <Name>Letter</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>LargeEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>PackageThickEnvelope</Name> </ShippingServicePackageDetails> <WeightRequired>true</WeightRequired> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>NONE</ShippingCategory> </ShippingServiceDetails> <ShippingServiceDetails> <Description>USPS Economy Parcel Post</Description> <InternationalService>true</InternationalService> <ShippingService>USPSEconomyParcel</ShippingService> <ShippingServiceID>50006</ShippingServiceID> <ShippingTimeMax>42</ShippingTimeMax> <ShippingTimeMin>28</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ServiceType>Calculated</ServiceType> <ShippingPackage>PackageThickEnvelope</ShippingPackage> <ShippingPackage>USPSLargePack</ShippingPackage> <ValidForSellingFlow>false</ValidForSellingFlow> <ShippingCarrier>USPS</ShippingCarrier> <ShippingServicePackageDetails> <Name>PackageThickEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>USPSLargePack</Name> </ShippingServicePackageDetails> <WeightRequired>true</WeightRequired> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>NONE</ShippingCategory> </ShippingServiceDetails> <ShippingServiceDetails> <Description>USPS Airmail Letter Post</Description> <InternationalService>true</InternationalService> <ShippingService>USPSAirmailLetter</ShippingService> <ShippingServiceID>50008</ShippingServiceID> <ShippingTimeMax>10</ShippingTimeMax> <ShippingTimeMin>4</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ServiceType>Calculated</ServiceType> <ShippingPackage>Letter</ShippingPackage> <ShippingPackage>LargeEnvelope</ShippingPackage> <ShippingPackage>PackageThickEnvelope</ShippingPackage> <ValidForSellingFlow>false</ValidForSellingFlow> <ShippingCarrier>USPS</ShippingCarrier> <ShippingServicePackageDetails> <Name>Letter</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>LargeEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>PackageThickEnvelope</Name> </ShippingServicePackageDetails> <WeightRequired>true</WeightRequired> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>NONE</ShippingCategory> </ShippingServiceDetails> <ShippingServiceDetails> <Description>USPS Airmail Parcel Post</Description> <InternationalService>true</InternationalService> <ShippingService>USPSAirmailParcel</ShippingService> <ShippingServiceID>50009</ShippingServiceID> <ShippingTimeMax>10</ShippingTimeMax> <ShippingTimeMin>4</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ServiceType>Calculated</ServiceType> <ShippingPackage>PackageThickEnvelope</ShippingPackage> <ShippingPackage>USPSLargePack</ShippingPackage> <ValidForSellingFlow>false</ValidForSellingFlow> <ShippingCarrier>USPS</ShippingCarrier> <ShippingServicePackageDetails> <Name>PackageThickEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>USPSLargePack</Name> </ShippingServicePackageDetails> <WeightRequired>true</WeightRequired> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>NONE</ShippingCategory> </ShippingServiceDetails> <ShippingServiceDetails> <Description>USPS First Class Mail Intl / First Class Package Intl Service</Description> <InternationalService>true</InternationalService> <ShippingService>USPSFirstClassMailInternational</ShippingService> <ShippingServiceID>50022</ShippingServiceID> <ServiceType>Flat</ServiceType> <ServiceType>Calculated</ServiceType> <ShippingPackage>Letter</ShippingPackage> <ShippingPackage>LargeEnvelope</ShippingPackage> <ShippingPackage>PackageThickEnvelope</ShippingPackage> <ValidForSellingFlow>true</ValidForSellingFlow> <ShippingCarrier>USPS</ShippingCarrier> <ShippingServicePackageDetails> <Name>Letter</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>LargeEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>PackageThickEnvelope</Name> </ShippingServicePackageDetails> <WeightRequired>true</WeightRequired> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>NONE</ShippingCategory> </ShippingServiceDetails> <ShippingServiceDetails> <Description>USPS Priority Mail International</Description> <InternationalService>true</InternationalService> <ShippingService>USPSPriorityMailInternational</ShippingService> <ShippingServiceID>50023</ShippingServiceID> <ShippingTimeMax>10</ShippingTimeMax> <ShippingTimeMin>6</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ServiceType>Calculated</ServiceType> <ShippingPackage>Letter</ShippingPackage> <ShippingPackage>LargeEnvelope</ShippingPackage> <ShippingPackage>PackageThickEnvelope</ShippingPackage> <ShippingPackage>USPSLargePack</ShippingPackage> <ValidForSellingFlow>true</ValidForSellingFlow> <ShippingCarrier>USPS</ShippingCarrier> <ShippingServicePackageDetails> <Name>Letter</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>LargeEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>PackageThickEnvelope</Name> </ShippingServicePackageDetails> <ShippingServicePackageDetails> <Name>USPSLargePack</Name> </ShippingServicePackageDetails> <WeightRequired>true</WeightRequired> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>NONE</ShippingCategory> </ShippingServiceDetails> ... <ShippingServiceDetails> <Description>Expedited Shipping from China/Hong Kong/Taiwan to worldwide</Description> <ShippingService>US_ExpeditedShippingFromGC</ShippingService> <ShippingServiceID>50046</ShippingServiceID> <ShippingTimeMax>7</ShippingTimeMax> <ShippingTimeMin>2</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ValidForSellingFlow>true</ValidForSellingFlow> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>OTHER</ShippingCategory> </ShippingServiceDetails> <ShippingServiceDetails> <Description>Expedited Shipping from India</Description> <ShippingService>US_ExpeditedShippingFromIN</ShippingService> <ShippingServiceID>50050</ShippingServiceID> <ShippingTimeMax>9</ShippingTimeMax> <ShippingTimeMin>3</ShippingTimeMin> <ServiceType>Flat</ServiceType> <ValidForSellingFlow>true</ValidForSellingFlow> <DetailVersion>702</DetailVersion> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> <ShippingCategory>OTHER</ShippingCategory> </ShippingServiceDetails> <ShippingCarrierDetails> <ShippingCarrierID>1</ShippingCarrierID> <Description>UPS</Description> <ShippingCarrier>UPS</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> <ShippingCarrierDetails> <ShippingCarrierID>2</ShippingCarrierID> <Description>USPS</Description> <ShippingCarrier>USPS</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> <ShippingCarrierDetails> <ShippingCarrierID>12</ShippingCarrierID> <Description>FedEx</Description> <ShippingCarrier>FedEx</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> <ShippingCarrierDetails> <ShippingCarrierID>21</ShippingCarrierID> <Description>4PX</Description> <ShippingCarrier>FourPX</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> <ShippingCarrierDetails> <ShippingCarrierID>22</ShippingCarrierID> <Description>4PX CHINA</Description> <ShippingCarrier>FourPXCHINA</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> ... <ShippingCarrierDetails> <ShippingCarrierID>169</ShippingCarrierID> <Description>WPX</Description> <ShippingCarrier>WPX</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> <ShippingCarrierDetails> <ShippingCarrierID>170</ShippingCarrierID> <Description>YANWEN</Description> <ShippingCarrier>YANWEN</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> <ShippingCarrierDetails> <ShippingCarrierID>172</ShippingCarrierID> <Description>YRC</Description> <ShippingCarrier>YRC</ShippingCarrier> <DetailVersion>5</DetailVersion> <UpdateTime>2016-12-12T01:11:09.000Z</UpdateTime> </ShippingCarrierDetails> <UpdateTime>2018-09-16T01:19:25.000Z</UpdateTime> </GeteBayDetailsResponse>
Returns the current set of eBay URLs, including the URLs where you can find the eBay logos.
Description
As an eBay developer, you are required to display the eBay logo on your eBay web application. You can use this call to determine the URL for the eBay logo.
Input
Set DetailName to URLDetails
.
XML format.
<?xml version="1.0" encoding="utf-8"?>
<GeteBayDetailsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<RequesterCredentials>
<eBayAuthToken>A*******3</eBayAuthToken>
</RequesterCredentials>
<DetailName>URLDetails</DetailName>
</GeteBayDetailsRequest>
Output
Among other eBay URLs, the response includes the several URLs for eBay logos, with each hosting logos of different sizes.
XML format.
<?xml version="1.0" encoding="UTF-8"?>
<GeteBayDetailsResponse
xmlns="urn:ebay:apis:eBLBaseComponents">
<Timestamp>2019-11-04T20:46:43.016Z</Timestamp>
<Ack>Success</Ack>
<Version>1131</Version>
<Build>E1131_CORE_API6_19105226_R1</Build>
<URLDetails>
<URLType>ViewItemURL</URLType>
<URL>http://cgi.ebay.com/ws/eBayISAPI.dll?ViewItem&item=</URL>
<DetailVersion>3</DetailVersion>
<UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime>
</URLDetails>
<URLDetails>
<URLType>ViewUserURL</URLType>
<URL>http://feedback.ebay.com/ws/eBayISAPI.dll?ViewFeedback&userid=</URL>
<DetailVersion>3</DetailVersion>
<UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime>
</URLDetails>
<URLDetails>
<URLType>MyeBayURL</URLType>
<URL>http://my.ebay.com/ws/eBayISAPI.dll?MyEbayBeta</URL>
<DetailVersion>3</DetailVersion>
<UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime>
</URLDetails>
<URLDetails>
<URLType>MyeBayBiddingURL</URLType>
<URL>http://my.ebay.com/ws/eBayISAPI.dll?MyEbayBeta&CurrentPage=MyeBayNextBidding</URL>
<DetailVersion>3</DetailVersion>
<UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime>
</URLDetails>
<URLDetails>
<URLType>MyeBayNotWonURL</URLType>
<URL>http://my.ebay.com/ws/eBayISAPI.dll?MyEbayBeta&CurrentPage=MyeBayNextLost</URL>
<DetailVersion>3</DetailVersion>
<UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime>
</URLDetails>
<URLDetails>
<URLType>MyeBayWonURL</URLType>
<URL>http://my.ebay.com/ws/eBayISAPI.dll?MyEbayBeta&CurrentPage=MyeBayNextWon</URL>
<DetailVersion>3</DetailVersion>
<UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime>
</URLDetails>
<URLDetails>
<URLType>MyeBayWatchingURL</URLType>
<URL>http://my.ebay.com/ws/eBayISAPI.dll?MyEbayBeta&CurrentPage=MyeBayNextWatching</URL>
<DetailVersion>3</DetailVersion>
<UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime>
</URLDetails>
<URLDetails>
<URLType>eBayStoreURL</URLType>
<URL>http://www.stores.ebay.com/</URL>
<DetailVersion>3</DetailVersion>
<UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime>
</URLDetails>
<URLDetails>
<URLType>SmallLogoURL</URLType>
<URL>https://securepics.ebaystatic.com/api/ebay_market_108x45.gif</URL>
<DetailVersion>3</DetailVersion>
<UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime>
</URLDetails>
<URLDetails>
<URLType>MediumLogoURL</URLType>
<URL>https://securepics.ebaystatic.com/api/ebay_market_144x59.gif</URL>
<DetailVersion>3</DetailVersion>
<UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime>
</URLDetails>
<URLDetails>
<URLType>LargeLogoURL</URLType>
<URL>https://securepics.ebaystatic.com/api/ebay_market_182x76.gif</URL>
<DetailVersion>3</DetailVersion>
<UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime>
</URLDetails>
<UpdateTime>2018-04-06T17:40:50.000Z</UpdateTime>
</GeteBayDetailsResponse>
Returns the return-policy options for the site.
Description
Seller m***************r wants to know the return-policy options for the item she is planning on listing.
Input
To review a site's return-policy options, set the DetailName field to ReturnPolicyDetails
. Specify the site ID where you are listing your item in the HTTP headers of the request.
XML format.
<?xml version="1.0" encoding="utf-8"?>
<GeteBayDetailsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<RequesterCredentials>
<eBayAuthToken>A*******3</eBayAuthToken>
</RequesterCredentials>
<DetailName>ReturnPolicyDetails</DetailName>
</GeteBayDetailsRequest>
Output
Because the Site ID is set to 0 in the HTTP headers, the response is specific to the eBay US site. The payload returns the return policy options that you can use in your item listings.
XML format.
<?xml version="1.0" encoding="UTF-8"?>
<GeteBayDetailsResponse
xmlns="urn:ebay:apis:eBLBaseComponents">
<Timestamp>2019-11-04T20:39:50.016Z</Timestamp>
<Ack>Success</Ack>
<Version>1131</Version>
<Build>E1131_CORE_API6_19105226_R1</Build>
<ReturnPolicyDetails>
<Refund>
<RefundOption>MoneyBack</RefundOption>
<Description>Money Back</Description>
</Refund>
<Refund>
<RefundOption>MoneyBackOrReplacement</RefundOption>
<Description>Money back or replacement (buyer's choice)</Description>
</Refund>
<Refund>
<RefundOption>MoneyBackOrExchange</RefundOption>
<Description>Money back or exchange (buyer's choice)</Description>
</Refund>
<ReturnsWithin>
<ReturnsWithinOption>Days_14</ReturnsWithinOption>
<Description>14 Days</Description>
</ReturnsWithin>
<ReturnsWithin>
<ReturnsWithinOption>Days_30</ReturnsWithinOption>
<Description>30 Days</Description>
</ReturnsWithin>
<ReturnsWithin>
<ReturnsWithinOption>Days_60</ReturnsWithinOption>
<Description>60 Days</Description>
</ReturnsWithin>
<ReturnsAccepted>
<ReturnsAcceptedOption>ReturnsAccepted</ReturnsAcceptedOption>
<Description>Returns Accepted</Description>
</ReturnsAccepted>
<ReturnsAccepted>
<ReturnsAcceptedOption>ReturnsNotAccepted</ReturnsAcceptedOption>
<Description>No returns accepted</Description>
</ReturnsAccepted>
<Description>true</Description>
<ShippingCostPaidBy>
<ShippingCostPaidByOption>Buyer</ShippingCostPaidByOption>
<Description>Buyer</Description>
</ShippingCostPaidBy>
<ShippingCostPaidBy>
<ShippingCostPaidByOption>Seller</ShippingCostPaidByOption>
<Description>Seller</Description>
</ShippingCostPaidBy>
<RestockingFeeValue>
<RestockingFeeValueOption>NoRestockingFee</RestockingFeeValueOption>
<Description>No</Description>
</RestockingFeeValue>
<RestockingFeeValue>
<RestockingFeeValueOption>Percent_10</RestockingFeeValueOption>
<Description>10%</Description>
</RestockingFeeValue>
<RestockingFeeValue>
<RestockingFeeValueOption>Percent_15</RestockingFeeValueOption>
<Description>15%</Description>
</RestockingFeeValue>
<RestockingFeeValue>
<RestockingFeeValueOption>Percent_20</RestockingFeeValueOption>
<Description>20%</Description>
</RestockingFeeValue>
<DetailVersion>6</DetailVersion>
<UpdateTime>2013-07-02T12:17:09.000Z</UpdateTime>
</ReturnPolicyDetails>
<UpdateTime>2013-07-02T12:17:09.000Z</UpdateTime>
</GeteBayDetailsResponse>
Input Output Detail Controls Samples |
Change History
Change Date | Description |
---|---|
1323 2023-08-25 |
|
1101 2019-03-29 |
|
1073 2018-08-03 |
|
1055 2018-03-30 |
|
1039 2017-10-17 |
|
1027 2017-08-04 |
|
0959 2016-03-11 |
|
0921 2015-05-01 |
|
0907 2015-01-23 |
|
0897 2014-10-21 |
|
0849 2013-11-05 |
|
0829 2013-06-19 |
|
0825 2013-05-22 |
|
0819 2013-04-10 |
|
0817 2013-03-27 |
|
0809 2013-02-06 |
|
0807 2013-01-23 |
|
0805 2013-01-09 |
|
0793 2012-09-26 |
|
0791 2012-09-12 |
|
0783 2012-07-18 |
|
0735 2011-08-17 |
|
0719 2011-04-27 |
|
0679 2010-07-20 |
|
0643 2010-02-03 |
|
0635 2009-09-16 |
|
0629 2009-08-05 |
|
0623 2009-06-24 |
|
0617 2009-05-13 |
|
0613 2009-04-15 |
|
0603 2009-02-04 |
|
0601 2009-01-21 |
|
0587 2008-10-15 |
|
0585 2008-10-01 |
|
0581 2008-09-03 |
|
0573 2008-07-09 |
|
0555 2008-03-05 |
|
0537 2007-10-31 |
|
0523 2007-07-25 |
|
0521 2007-07-11 |
|
0499 2007-02-07 |
|
0437 2005-11-30 |
|