eBay Shopping API901

GetShippingCosts

This call retrieves shipping costs for an item.

Usage Details

This is one of the ways a buyer or seller can obtain shipping cost information for an existing item (for which the caller is either the buyer or seller) at any point in the life of the listing, before or after a buyer has committed to purchasing the item(s). Flat rate shipping costs are established by the seller before bidding occurs. Calculated shipping costs are calculated by eBay with its shipping partners based on postal code, but note that insurance cost can only be determined once the final item price is known when the listing ends.

It is best to call GetShippingCosts only after determining via GetSingleItem or the Finding API that the item actually has shipping cost information.

Related Information

See also the reference documentation for this call:



Back to top

Input

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

See also Samples.

<?xml version="1.0" encoding="utf-8"?>
<GetShippingCostsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <DestinationCountryCode> CountryCodeType </DestinationCountryCode>
  <DestinationPostalCode> string </DestinationPostalCode>
  <IncludeDetails> boolean </IncludeDetails>
  <ItemID> string </ItemID>
  <QuantitySold> int </QuantitySold>
  <!-- Standard Input Fields -->
  <MessageID> string </MessageID>
</GetShippingCostsRequest>
Argument Type Occurrence Meaning
Call-specific Input Fields [Jump to standard fields]
DestinationCountryCode CountryCodeType Conditional Destination country code. If DestinationCountryCode is US, postal code is required and represents US zip code.
Default: US.

Applicable values: See DestinationCountryCode.
DestinationPostalCode string Conditional Destination country postal code (or zip code, for US). Ignored if no country code is provided. Optional tag for some countries. More likely to be required for large countries. Ignored for flat rate shipping.
IncludeDetails boolean Conditional Indicates whether to return the ShippingDetails container in the response.
Default: false.
ItemID string Required The item ID that uniquely identifies the item listing for which to retrieve the data.
Max length: 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits).
QuantitySold int Optional Number of items sold to a single buyer and to be shipped together.
Default: 1.
Standard Input Fields  
MessageID string Optional If you pass a value in MessageID in a request, we'll return the same value in CorrelationID in the response. If you're making a lot of calls, you can use this for tracking that a response is returned for every request and to match particular responses to particular requests. (In this case, specify a different value for each request.) You can specify any value that is useful to you.



Back to top

Output

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

See also Samples.

<?xml version="1.0" encoding="utf-8"?>
<GetShippingCostsResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <PickUpInStoreDetails> PickUpInStoreDetailsType
    <EligibleForPickupInStore> boolean </EligibleForPickupInStore>
  </PickUpInStoreDetails>
  <ShippingCostSummary> ShippingCostSummaryType
    <ImportCharge currencyID="CurrencyCodeType"> AmountType (double) </ImportCharge>
    <InsuranceCost currencyID="CurrencyCodeType"> AmountType (double) </InsuranceCost>
    <InsuranceOption> InsuranceOptionCodeType </InsuranceOption>
    <ListedShippingServiceCost currencyID="CurrencyCodeType"> AmountType (double) </ListedShippingServiceCost>
    <LogisticPlanType> string </LogisticPlanType>
    <ShippingServiceCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceCost>
    <ShippingServiceName> string </ShippingServiceName>
    <ShippingType> ShippingTypeCodeType </ShippingType>
  </ShippingCostSummary>
  <ShippingDetails> ShippingDetailsType
    <CODCost currencyID="CurrencyCodeType"> AmountType (double) </CODCost>
    <ExcludeShipToLocation> string </ExcludeShipToLocation>
    <!-- ... more ExcludeShipToLocation values allowed here ... -->
    <GetItFast> boolean </GetItFast>
    <InsuranceCost currencyID="CurrencyCodeType"> AmountType (double) </InsuranceCost>
    <InsuranceOption> InsuranceOptionCodeType </InsuranceOption>
    <InternationalInsuranceCost currencyID="CurrencyCodeType"> AmountType (double) </InternationalInsuranceCost>
    <InternationalInsuranceOption> InsuranceOptionCodeType </InternationalInsuranceOption>
    <InternationalShippingServiceOption> InternationalShippingServiceOptionType
      <EstimatedDeliveryMaxTime> dateTime </EstimatedDeliveryMaxTime>
      <EstimatedDeliveryMinTime> dateTime </EstimatedDeliveryMinTime>
      <ImportCharge currencyID="CurrencyCodeType"> AmountType (double) </ImportCharge>
      <ShippingInsuranceCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingInsuranceCost>
      <ShippingServiceAdditionalCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceAdditionalCost>
      <ShippingServiceCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceCost>
      <ShippingServiceCutOffTime> dateTime </ShippingServiceCutOffTime>
      <ShippingServiceName> token </ShippingServiceName>
      <ShippingServicePriority> int </ShippingServicePriority>
      <ShipsTo> string </ShipsTo>
      <!-- ... more ShipsTo values allowed here ... -->
    </InternationalShippingServiceOption>
    <!-- ... more InternationalShippingServiceOption nodes allowed here ... -->
    <SalesTax> SalesTaxType
      <SalesTaxAmount currencyID="CurrencyCodeType"> AmountType (double) </SalesTaxAmount>
      <SalesTaxPercent> float </SalesTaxPercent>
      <SalesTaxState> string </SalesTaxState>
      <ShippingIncludedInTax> boolean </ShippingIncludedInTax>
    </SalesTax>
    <ShippingRateErrorMessage> string </ShippingRateErrorMessage>
    <ShippingServiceOption> ShippingServiceOptionType
      <EstimatedDeliveryMaxTime> dateTime </EstimatedDeliveryMaxTime>
      <EstimatedDeliveryMinTime> dateTime </EstimatedDeliveryMinTime>
      <ExpeditedService> boolean </ExpeditedService>
      <FastAndFree> boolean </FastAndFree>
      <LogisticPlanType> string </LogisticPlanType>
      <ShippingInsuranceCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingInsuranceCost>
      <ShippingServiceAdditionalCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceAdditionalCost>
      <ShippingServiceCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceCost>
      <ShippingServiceCutOffTime> dateTime </ShippingServiceCutOffTime>
      <ShippingServiceName> token </ShippingServiceName>
      <ShippingServicePriority> int </ShippingServicePriority>
      <ShippingSurcharge currencyID="CurrencyCodeType"> AmountType (double) </ShippingSurcharge>
      <ShippingTimeMax> int </ShippingTimeMax>
      <ShippingTimeMin> int </ShippingTimeMin>
      <ShipsTo> string </ShipsTo>
      <!-- ... more ShipsTo values allowed here ... -->
    </ShippingServiceOption>
    <!-- ... more ShippingServiceOption nodes allowed here ... -->
    <TaxTable> TaxTableType
      <TaxJurisdiction> TaxJurisdictionType
        <JurisdictionID> string </JurisdictionID>
        <SalesTaxPercent> float </SalesTaxPercent>
        <ShippingIncludedInTax> boolean </ShippingIncludedInTax>
      </TaxJurisdiction>
      <!-- ... more TaxJurisdiction nodes allowed here ... -->
    </TaxTable>
  </ShippingDetails>
  <!-- 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 ... -->
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
</GetShippingCostsResponse>
Return Value Type Occurrence Meaning
Call-specific Output Fields [Jump to standard fields]
PickUpInStoreDetails PickUpInStoreDetailsType Conditionally This container is returned in GetShippingCosts if In-Store Pickup is set for the listing.

Note: At this time, the In-Store Pickup feature is generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings. This container is only returned if the version of the API is greater than or equal to 869.
PickUpInStoreDetails
  .EligibleForPickupInStore
boolean Conditionally This field is returned as 'true' if the listing is enabled for In-Store Pickup. A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings.

When a seller is successful at listing an item with the In-Store Pickup feature enabled, prospective buyers within a reasonable distance (25 miles or so) from one of the seller's stores (that has stock available) will see the "Available for In-Store Pickup" option on the listing, along with information on the closest store that has the item.
Default: false.
ShippingCostSummary ShippingCostSummaryType Always Shipping-related details for the specified item. Any error about shipping services (returned by a vendor of eBay's who calculates shipping costs) is returned in ShippingRateErrorMessage. Errors from a shipping service are likely to be related to issues with shipping specifications, such as package size and the selected shipping method not supported by a particular shipping service.
ShippingCostSummary
  .ImportCharge
AmountType (double) Conditionally The total cost of customs and taxes for the international leg of an order shipped using the Global Shipping Program. This amount is calculated and supplied for each item by the international shipping provider when a buyer views the item properties.

Note: This field provides reliable shipping cost information only when returned by the GetShippingCosts call.
Min: 0.
ShippingCostSummary
  .ImportCharge
  [ attribute currencyID ]
CurrencyCodeType Conditionally The total cost of customs and taxes for the international leg of an order shipped using the Global Shipping Program. This amount is calculated and supplied for each item by the international shipping provider when a buyer views the item properties.

Note: This field provides reliable shipping cost information only when returned by the GetShippingCosts call.

For a list of possible enumeration values, see CurrencyCodeType.
ShippingCostSummary
  .InsuranceCost
AmountType (double) Conditionally The cost of insurance. For flat rate shipping, this is the value set by the seller, if any. For calculated shipping, this is the value calculated by eBay with the shipping carrier for the particular item and can only be determined once the final item price is known when the listing ends. To determine whether a listing has ended, see EndTime or ListingStatus in GetSingleItem.

Note: This field provides reliable shipping cost information only when returned by the GetShippingCosts call.
ShippingCostSummary
  .InsuranceCost
  [ attribute currencyID ]
CurrencyCodeType Conditionally The cost of insurance. For flat rate shipping, this is the value set by the seller, if any. For calculated shipping, this is the value calculated by eBay with the shipping carrier for the particular item and can only be determined once the final item price is known when the listing ends. To determine whether a listing has ended, see EndTime or ListingStatus in GetSingleItem.

Note: This field provides reliable shipping cost information only when returned by the GetShippingCosts call.

For a list of possible enumeration values, see CurrencyCodeType.
ShippingCostSummary
  .InsuranceOption
InsuranceOptionCodeType Conditionally Whether the seller offers shipping insurance and, if so, whether the insurance is optional or required. Flat and calculated shipping.

Note: This field provides reliable shipping cost information only when returned by the GetShippingCosts call.

Applicable values:

CustomCode
(out) Placeholder value. See token.
IncludedInShippingHandling
(out) The seller is not charging separately for shipping insurance costs; any insurance is already included in the base shipping cost.
NotOffered
(out) The seller does not offer shipping insurance to the buyer.
NotOfferedOnSite
(out) Shipping insurance is not offered as a separate option on the site where the item is listed. (Some shipping services, such as DE_InsuredExpressOrCourier, include insurance as part of the service.) If another insurance option is specified in the listing request and the site does not support shipping insurance as a separate option, eBay will reset the insurance option to this value. At the time of this writing, this option is only meaningful for the eBay Germany, Austria, and Switzerland sites.
Optional
(out) The seller offers the buyer the choice of paying for shipping insurance or not.
Required
(out) The seller requires that the buyer pay for shipping insurance.

ShippingCostSummary
  .ListedShippingServiceCost
AmountType (double) Always The listed shipping cost of the item. If multiple items were purchased, this includes the listed ShippingServiceAdditionalCost.



Note: This field provides reliable shipping cost information only when returned by the GetShippingCosts call.
ShippingCostSummary
  .ListedShippingServiceCost
  [ attribute currencyID ]
CurrencyCodeType Conditionally The listed shipping cost of the item. If multiple items were purchased, this includes the listed ShippingServiceAdditionalCost.



Note: This field provides reliable shipping cost information only when returned by the GetShippingCosts call.

For a list of possible enumeration values, see CurrencyCodeType.
ShippingCostSummary
  .LogisticPlanType
string Conditionally local logistic plan type for this service
ShippingCostSummary
  .ShippingServiceCost
AmountType (double) Always The basic shipping cost of the item. This reflects the domestic shipping cost or the international shipping costs, depending on which applies (that is, whether the bidder/buyer is in the same country as the listing site of the item).

Note: This field provides reliable shipping cost information only when returned by the GetShippingCosts call. Flat shipping: single-item listing: this matches (in)ShippingServiceCost; multi-quantity listing: with a request version of 665 or greater, this is the total of (in)ShippingServiceCost plus ((in)ShippingServiceAdditionalCost times the number of items beyond the first item), and with a request version lower than 665, this is (in)ShippingServiceCost.

Promotional shipping: For a request version lower than 665, promotional shipping has no effect on shipping costs. Otherwise: if the promotional shipping option is lower than other shipping services being offered, the savings is reflected in the returned shipping cost; the shipping service named Promotional Shipping Service (or whatever is the localized name for it) is included among the shipping services; if the promotional shipping cost is lower than the cost of other shipping services being offered, it is presented first in the list (the lowest shipping service cost is always presented first, regardless of whether there is promotional shipping).

Shipping surcharge: With a request version of 665 or greater, shipping cost includes any surcharge, and surcharge is not returned as an individual tag. With a request version lower than 665, surcharge is not part of the total cost and is returned as its own tag.
ShippingCostSummary
  .ShippingServiceCost
  [ attribute currencyID ]
CurrencyCodeType Conditionally The basic shipping cost of the item. This reflects the domestic shipping cost or the international shipping costs, depending on which applies (that is, whether the bidder/buyer is in the same country as the listing site of the item).

Note: This field provides reliable shipping cost information only when returned by the GetShippingCosts call. Flat shipping: single-item listing: this matches (in)ShippingServiceCost; multi-quantity listing: with a request version of 665 or greater, this is the total of (in)ShippingServiceCost plus ((in)ShippingServiceAdditionalCost times the number of items beyond the first item), and with a request version lower than 665, this is (in)ShippingServiceCost.

Promotional shipping: For a request version lower than 665, promotional shipping has no effect on shipping costs. Otherwise: if the promotional shipping option is lower than other shipping services being offered, the savings is reflected in the returned shipping cost; the shipping service named Promotional Shipping Service (or whatever is the localized name for it) is included among the shipping services; if the promotional shipping cost is lower than the cost of other shipping services being offered, it is presented first in the list (the lowest shipping service cost is always presented first, regardless of whether there is promotional shipping).

Shipping surcharge: With a request version of 665 or greater, shipping cost includes any surcharge, and surcharge is not returned as an individual tag. With a request version lower than 665, surcharge is not part of the total cost and is returned as its own tag.

For a list of possible enumeration values, see CurrencyCodeType.
ShippingCostSummary
  .ShippingServiceName
string Always The name of a shipping service.

Note: This field provides reliable shipping cost information only when returned by the GetShippingCosts call.
ShippingCostSummary
  .ShippingType
ShippingTypeCodeType Always How the seller stated that cost of shipping is to be determined, such as flat rate or calculated.

Note: This field provides reliable shipping cost information only when returned by the GetShippingCosts call.

Applicable values:

Calculated
(out) The calculated shipping model: the posted cost of shipping is based on the seller-offered and buyer-selected shipping service, where the shipping costs are calculated by eBay and the shipping carrier based on the buyer's address, and any packaging/handling costs established by the seller are automatically rolled into the total.
CalculatedDomesticFlatInternational
(out) The seller specified one or more calculated domestic shipping services and one or more flat international shipping services.
CustomCode
(out) Placeholder value. See token.
Flat
(out) The flat rate shipping model: the seller establishes the cost of shipping and cost of shipping insurance, regardless of what any buyer-selected shipping service might charge the seller.
FlatDomesticCalculatedInternational
(out) The seller specified one or more flat domestic shipping services and one or more calculated international shipping services.
NotSpecified
(out) The seller did not specify the shipping type.

(Not all values in ShippingTypeCodeType apply to this field.)
ShippingDetails ShippingDetailsType Conditionally Shipping-related details for the specified item. This container is only returned if IncludeDetails is true on input. Any error about shipping services (returned by a vendor of eBay's who calculates shipping costs) is returned in ShippingRateErrorMessage. Errors from a shipping service are likely to be related to issues with shipping specifications, such as package size and the selected shipping method not supported by a particular shipping service.
ShippingDetails.CODCost AmountType (double) Conditionally Italy site (site ID 101) only. Contains the cost of cash-on-delivery shipping.
ShippingDetails.CODCost
  [ attribute currencyID ]
CurrencyCodeType Conditionally Italy site (site ID 101) only. Contains the cost of cash-on-delivery shipping.

For a list of possible enumeration values, see CurrencyCodeType.
ShippingDetails
  .ExcludeShipToLocation
string Conditionally,
repeatable: [0..*]
A location to which the seller will not ship. Returned only if set via Trading API. Returned only with a request version of 665 or greater.
ShippingDetails.GetItFast boolean Conditionally Indicates whether the seller has opted the listing into the Get It Fast feature. If GetItFast is true, and if at least one of the domestic shipping services offered by the seller is an expedited shipping service, every shipping service offered by the seller is considered a Get It Fast service, and the seller commits to delivering the item to the buyer-selected shipping service within one day.

See Listing an Item.

ShippingDetails.InsuranceCost AmountType (double) Conditionally The cost of insurance. For flat rate shipping, this is the value set by the seller, if any. For calculated shipping, this is the value calculated by eBay with the shipping carrier for the particular item and can only be determined once the final item price is known when the listing ends. To determine whether a listing has ended, use GetSingleItem.

Not applicable to eBay Motors vehicle listings.
Default: 0.00.
ShippingDetails.InsuranceCost
  [ attribute currencyID ]
CurrencyCodeType Conditionally The cost of insurance. For flat rate shipping, this is the value set by the seller, if any. For calculated shipping, this is the value calculated by eBay with the shipping carrier for the particular item and can only be determined once the final item price is known when the listing ends. To determine whether a listing has ended, use GetSingleItem.

Not applicable to eBay Motors vehicle listings.

For a list of possible enumeration values, see CurrencyCodeType.
ShippingDetails
  .InsuranceOption
InsuranceOptionCodeType Conditionally Whether the seller offers shipping insurance and, if so, whether the insurance is optional or required. Flat and calculated shipping.

Applicable values:

CustomCode
(out) Placeholder value. See token.
IncludedInShippingHandling
(out) The seller is not charging separately for shipping insurance costs; any insurance is already included in the base shipping cost.
NotOffered
(out) The seller does not offer shipping insurance to the buyer.
NotOfferedOnSite
(out) Shipping insurance is not offered as a separate option on the site where the item is listed. (Some shipping services, such as DE_InsuredExpressOrCourier, include insurance as part of the service.) If another insurance option is specified in the listing request and the site does not support shipping insurance as a separate option, eBay will reset the insurance option to this value. At the time of this writing, this option is only meaningful for the eBay Germany, Austria, and Switzerland sites.
Optional
(out) The seller offers the buyer the choice of paying for shipping insurance or not.
Required
(out) The seller requires that the buyer pay for shipping insurance.

ShippingDetails
  .InternationalInsuranceCost
AmountType (double) Conditionally The cost of insurance for items shipped internationally. For flat rate shipping, this is the value set by the seller, if any. For calculated shipping, this is the value calculated by eBay with the shipping carrier for the particular item and can only be determined once the final item price is known when the listing ends. To determine whether a listing has ended, use GetSingleItem.

Not applicable to eBay Motors vehicle listings.
Default: 0.00.
ShippingDetails
  .InternationalInsuranceCost
  [ attribute currencyID ]
CurrencyCodeType Conditionally The cost of insurance for items shipped internationally. For flat rate shipping, this is the value set by the seller, if any. For calculated shipping, this is the value calculated by eBay with the shipping carrier for the particular item and can only be determined once the final item price is known when the listing ends. To determine whether a listing has ended, use GetSingleItem.

Not applicable to eBay Motors vehicle listings.

For a list of possible enumeration values, see CurrencyCodeType.
ShippingDetails
  .InternationalInsuranceOption
InsuranceOptionCodeType Conditionally Whether the seller offers shipping insurance for items shipped internationally and, if so, whether the insurance is optional or required. Flat and calculated shipping.

Applicable values:

CustomCode
(out) Placeholder value. See token.
IncludedInShippingHandling
(out) The seller is not charging separately for shipping insurance costs; any insurance is already included in the base shipping cost.
NotOffered
(out) The seller does not offer shipping insurance to the buyer.
NotOfferedOnSite
(out) Shipping insurance is not offered as a separate option on the site where the item is listed. (Some shipping services, such as DE_InsuredExpressOrCourier, include insurance as part of the service.) If another insurance option is specified in the listing request and the site does not support shipping insurance as a separate option, eBay will reset the insurance option to this value. At the time of this writing, this option is only meaningful for the eBay Germany, Austria, and Switzerland sites.
Optional
(out) The seller offers the buyer the choice of paying for shipping insurance or not.
Required
(out) The seller requires that the buyer pay for shipping insurance.

ShippingDetails
  .InternationalShippingServiceOption
InternationalShippingServiceOptionType Conditionally,
repeatable: [0..*]
Shipping costs and options related to an international shipping service. For calculated shipping, postal code must be known to determine final shipping cost (and this can only be known if a transaction has been created). For GetShippingCosts, if the postal code or bidder is in the same country as the listing site for the item, it is "domestic shipping" and this container is not returned (and ShippingServiceOption is returned instead). Otherwise, it is "international shipping" and this container is returned.

For GetShippingCosts, results are filtered: if any service is not available in the buyer's region, it is removed. If no services remain after this filtering, a warning is returned.

Not applicable to Half.com or eBay Motors vehicle listings.
ShippingDetails
  .InternationalShippingServiceOption
  .EstimatedDeliveryMaxTime
dateTime Conditionally The maximum guaranteed date in which the item could reach the buyer's location. Not applicable to Half.com.
ShippingDetails
  .InternationalShippingServiceOption
  .EstimatedDeliveryMinTime
dateTime Conditionally The minimum guaranteed date in which the item could reach the buyer's location. Not applicable to Half.com.
ShippingDetails
  .InternationalShippingServiceOption
  .ImportCharge
AmountType (double) Conditionally The total cost of customs and taxes for the international leg of an order shipped using the Global Shipping Program. This amount is calculated and supplied for each item by the international shipping provider when a buyer views the item properties.
Min: 0.
ShippingDetails
  .InternationalShippingServiceOption
  .ImportCharge
  [ attribute currencyID ]
CurrencyCodeType Conditionally The total cost of customs and taxes for the international leg of an order shipped using the Global Shipping Program. This amount is calculated and supplied for each item by the international shipping provider when a buyer views the item properties.

For a list of possible enumeration values, see CurrencyCodeType.
ShippingDetails
  .InternationalShippingServiceOption
  .ShippingInsuranceCost
AmountType (double) Conditionally The insurance cost associated with shipping a single item with this shipping service. If the buyer bought more than one of this item, this proportional to QuantitySold. If the item has not yet been sold, insurance information cannot be calculated and the value is 0.00. For calculated shipping only.
ShippingDetails
  .InternationalShippingServiceOption
  .ShippingInsuranceCost
  [ attribute currencyID ]
CurrencyCodeType Conditionally The insurance cost associated with shipping a single item with this shipping service. If the buyer bought more than one of this item, this proportional to QuantitySold. If the item has not yet been sold, insurance information cannot be calculated and the value is 0.00. For calculated shipping only.

For a list of possible enumeration values, see CurrencyCodeType.
ShippingDetails
  .InternationalShippingServiceOption
  .ShippingServiceAdditionalCost
AmountType (double) Conditionally The cost of shipping each additional item beyond the first item. For single-item listings, if this is not provided, it is defaulted to zero. For multi-quantity listings, if this is not provided, it is set to the value of (in)ShippingServiceCost (unless the request version is lower than 665, in which case ShippingServiceAdditionalCost is required and is not defaulted). For flat shipping only.
ShippingDetails
  .InternationalShippingServiceOption
  .ShippingServiceAdditionalCost
  [ attribute currencyID ]
CurrencyCodeType Conditionally The cost of shipping each additional item beyond the first item. For single-item listings, if this is not provided, it is defaulted to zero. For multi-quantity listings, if this is not provided, it is set to the value of (in)ShippingServiceCost (unless the request version is lower than 665, in which case ShippingServiceAdditionalCost is required and is not defaulted). For flat shipping only.

For a list of possible enumeration values, see CurrencyCodeType.
ShippingDetails
  .InternationalShippingServiceOption
  .ShippingServiceCost
AmountType (double) Conditionally The basic shipping cost of the item.

Flat shipping: single-item listing: this matches (in)ShippingServiceCost; multi-quantity listing: with a request version of 665 or greater, this is the total of (in)ShippingServiceCost plus ((in)ShippingServiceAdditionalCost times the number of items beyond the first item), and with a request version lower than 665, this is (in)ShippingServiceCost.
Promotional shipping: For a request version lower than 665, promotional shipping has no effect on shipping costs. Otherwise: if the promotional shipping option is lower than other shipping services being offered, the savings is reflected in the returned shipping cost; the shipping service named Promotional Shipping Service (or whatever is the localized name for it) is included among the shipping services; if the promotional shipping cost is lower than the cost of other shipping services being offered, it is presented first in the list (the lowest shipping service cost is always presented first, regardless of whether there is promotional shipping).
ShippingDetails
  .InternationalShippingServiceOption
  .ShippingServiceCost
  [ attribute currencyID ]
CurrencyCodeType Conditionally The basic shipping cost of the item.

Flat shipping: single-item listing: this matches (in)ShippingServiceCost; multi-quantity listing: with a request version of 665 or greater, this is the total of (in)ShippingServiceCost plus ((in)ShippingServiceAdditionalCost times the number of items beyond the first item), and with a request version lower than 665, this is (in)ShippingServiceCost.
Promotional shipping: For a request version lower than 665, promotional shipping has no effect on shipping costs. Otherwise: if the promotional shipping option is lower than other shipping services being offered, the savings is reflected in the returned shipping cost; the shipping service named Promotional Shipping Service (or whatever is the localized name for it) is included among the shipping services; if the promotional shipping cost is lower than the cost of other shipping services being offered, it is presented first in the list (the lowest shipping service cost is always presented first, regardless of whether there is promotional shipping).

For a list of possible enumeration values, see CurrencyCodeType.
ShippingDetails
  .InternationalShippingServiceOption
  .ShippingServiceCutOffTime
dateTime Conditionally The last time of day that an order using the specified shipping service will be accepted by the seller for the current listing. The cut off time applies and is returned only when seller offers the listing with a qualifying time-sensitive shipping service, such as eBay Now delivery. The cut off time is set by eBay and determined in part by the policies and locations of the seller and the shipping carrier. Not applicable to Half.com.
ShippingDetails
  .InternationalShippingServiceOption
  .ShippingServiceName
token Conditionally An international shipping service offered for shipping the item (for example, UPS Ground). For flat and calculated shipping.
ShippingDetails
  .InternationalShippingServiceOption
  .ShippingServicePriority
int Conditionally Seller-preferred presentation order relative to other service options. Valid values are: 1, 2 and 3 (first, second and third choices). For flat and calculated shipping.
ShippingDetails
  .InternationalShippingServiceOption
  .ShipsTo
string Conditionally,
repeatable: [0..*]
An international location or region to which the item may be shipped via this particular shipping service. Associated with the shipping service by the seller. This is basically the same as SimpleItemType.ShipToLocations except that this is spelled out and the other is abbreviated. Returned with request version 665 or greater, if set via Trading API.
ShippingDetails.SalesTax SalesTaxType Conditionally Sales tax details. US site only. Flat and calculated shipping.

Not applicable to eBay Motors vehicle listings.
ShippingDetails.SalesTax
  .SalesTaxAmount
AmountType (double) Conditionally (US only) The amount of sales tax, calculated for a transaction based on the SalesTaxPercent and pricing information.
ShippingDetails.SalesTax
  .SalesTaxAmount
  [ attribute currencyID ]
CurrencyCodeType Conditionally (US only) The amount of sales tax, calculated for a transaction based on the SalesTaxPercent and pricing information.

For a list of possible enumeration values, see CurrencyCodeType.
ShippingDetails.SalesTax
  .SalesTaxPercent
float Conditionally Percent of an item's price to be charged as the sales tax for the transaction. The value passed in is stored with a precision of 3 digits after the decimal point (##.###).
ShippingDetails.SalesTax
  .SalesTaxState
string Conditionally State or jurisdiction for which the sales tax is being collected. Only returned if the seller specified a value.
ShippingDetails.SalesTax
  .ShippingIncludedInTax
boolean Conditionally (US only) Whether shipping costs were part of the base amount that was taxed. Flat or calculated shipping.
ShippingDetails
  .ShippingRateErrorMessage
string Conditionally For most applicable calls, returns the words No Error or returns an error message related to an attempt to calculate shipping rates. For calculated shipping only.

Not applicable to Half.com or eBay Motors vehicle listings.
ShippingDetails
  .ShippingServiceOption
ShippingServiceOptionType Conditionally,
repeatable: [0..*]
Shipping costs and options related to a domestic shipping service. For GetShippingCosts, if the postal code or bidder is in the same country as the listing site for the item, it is "domestic shipping" and this container is returned. Otherwise, it is "international shipping" and this container is not returned (and InternationalShippingServiceOption is returned instead, if it exists). For calculated shipping, postal code must be known to determine final shipping cost (and this can only be known if a transaction has been created). For flat shipping: if the listing has not yet ended, any domestic shipping details are returned; if the listing has ended, domestic shipping details are only returned if the buyer's location is "domestic" (that is, it is the same country as the listing site).
Not applicable to Half.com or eBay Motors vehicle listings.
ShippingDetails
  .ShippingServiceOption
  .EstimatedDeliveryMaxTime
dateTime Conditionally The maximum guaranteed date in which the item could reach the buyer's location. Not applicable to Half.com.
ShippingDetails
  .ShippingServiceOption
  .EstimatedDeliveryMinTime
dateTime Conditionally The minimum guaranteed date in which the item could reach the buyer's location. Not applicable to Half.com.
ShippingDetails
  .ShippingServiceOption
  .ExpeditedService
boolean Conditionally Indicates whether the service is an expedited shipping service. See Enabling Get It Fast. Not applicable to Half.com.
ShippingDetails
  .ShippingServiceOption
  .FastAndFree
boolean Conditionally Indicates whether the service is fast in delivery to the end user (less than 4 days) and free for buyer.
ShippingDetails
  .ShippingServiceOption
  .LogisticPlanType
string Conditionally Reserved for internal or future use.
ShippingDetails
  .ShippingServiceOption
  .ShippingInsuranceCost
AmountType (double) Conditionally The insurance cost associated with shipping a single item with this shipping service. If the buyer bought more than one of this item, this proportional to QuantitySold. If the item has not yet been sold, insurance information cannot be calculated and the value is 0.00. For calculated shipping only.
ShippingDetails
  .ShippingServiceOption
  .ShippingInsuranceCost
  [ attribute currencyID ]
CurrencyCodeType Conditionally The insurance cost associated with shipping a single item with this shipping service. If the buyer bought more than one of this item, this proportional to QuantitySold. If the item has not yet been sold, insurance information cannot be calculated and the value is 0.00. For calculated shipping only.

For a list of possible enumeration values, see CurrencyCodeType.
ShippingDetails
  .ShippingServiceOption
  .ShippingServiceAdditionalCost
AmountType (double) Conditionally The cost of shipping each additional item beyond the first item (flat shipping). For single-item listings, if this is not provided, it is defaulted to zero. For multi-quantity listings, if this is not provided, it is set to the value of (in)ShippingServiceCost (unless the request version is lower than 665, in which case ShippingServiceAdditionalCost is required and is not defaulted). Not applicable to Half.com.
ShippingDetails
  .ShippingServiceOption
  .ShippingServiceAdditionalCost
  [ attribute currencyID ]
CurrencyCodeType Conditionally The cost of shipping each additional item beyond the first item (flat shipping). For single-item listings, if this is not provided, it is defaulted to zero. For multi-quantity listings, if this is not provided, it is set to the value of (in)ShippingServiceCost (unless the request version is lower than 665, in which case ShippingServiceAdditionalCost is required and is not defaulted). Not applicable to Half.com.

For a list of possible enumeration values, see CurrencyCodeType.
ShippingDetails
  .ShippingServiceOption
  .ShippingServiceCost
AmountType (double) Conditionally The basic shipping cost of the item.

Flat shipping: single-item listing: this matches (in)ShippingServiceCost; multi-quantity listing: with a request version of 665 or greater, this is the total of (in)ShippingServiceCost plus ((in)ShippingServiceAdditionalCost times the number of items beyond the first item), and with a request version lower than 665, this is (in)ShippingServiceCost.
Promotional shipping: For a request version lower than 665, promotional shipping has no effect on shipping costs. Otherwise: if the promotional shipping option is lower than other shipping services being offered, the savings is reflected in the returned shipping cost; the shipping service named Promotional Shipping Service (or whatever is the localized name for it) is included among the shipping services; if the promotional shipping cost is lower than the cost of other shipping services being offered, it is presented first in the list (the lowest shipping service cost is always presented first, regardless of whether there is promotional shipping).
ShippingDetails
  .ShippingServiceOption
  .ShippingServiceCost
  [ attribute currencyID ]
CurrencyCodeType Conditionally The basic shipping cost of the item.

Flat shipping: single-item listing: this matches (in)ShippingServiceCost; multi-quantity listing: with a request version of 665 or greater, this is the total of (in)ShippingServiceCost plus ((in)ShippingServiceAdditionalCost times the number of items beyond the first item), and with a request version lower than 665, this is (in)ShippingServiceCost.
Promotional shipping: For a request version lower than 665, promotional shipping has no effect on shipping costs. Otherwise: if the promotional shipping option is lower than other shipping services being offered, the savings is reflected in the returned shipping cost; the shipping service named Promotional Shipping Service (or whatever is the localized name for it) is included among the shipping services; if the promotional shipping cost is lower than the cost of other shipping services being offered, it is presented first in the list (the lowest shipping service cost is always presented first, regardless of whether there is promotional shipping).

For a list of possible enumeration values, see CurrencyCodeType.
ShippingDetails
  .ShippingServiceOption
  .ShippingServiceCutOffTime
dateTime Conditionally The last time of day that an order using the specified shipping service will be accepted by the seller for the current listing. The cut off time applies and is returned only when seller offers the listing with a qualifying time-sensitive shipping service, such as eBay Now delivery. The cut off time is set by eBay and determined in part by the policies and locations of the seller and the shipping carrier. Not applicable to Half.com.
ShippingDetails
  .ShippingServiceOption
  .ShippingServiceName
token Conditionally A domestic shipping service offered for shipping the item (for example, UPS Ground). For flat and calculated shipping.
ShippingDetails
  .ShippingServiceOption
  .ShippingServicePriority
int Conditionally Seller-preferred presentation order relative to other service options. Valid values: 1 (1st choice), 2 (2nd choice), 3 (3rd choice). For flat and calculated shipping. Not applicable to Half.com.
ShippingDetails
  .ShippingServiceOption
  .ShippingSurcharge
AmountType (double) Conditionally An additional fee to charge US buyers who ship via UPS to Alaska, Hawaii or Puerto Rico. Can only be assigned a value for Parts and Accessories items on the eBay US and Motors sites. Only returned if set. If some transactions in an order have a surcharge, surcharge is added only for those transactions. Flat rate shipping only.

With a request version of 665 or greater, total shipping cost includes any surcharge, and ShippingSurcharge is no longer returned as an individual tag.
ShippingDetails
  .ShippingServiceOption
  .ShippingSurcharge
  [ attribute currencyID ]
CurrencyCodeType Conditionally An additional fee to charge US buyers who ship via UPS to Alaska, Hawaii or Puerto Rico. Can only be assigned a value for Parts and Accessories items on the eBay US and Motors sites. Only returned if set. If some transactions in an order have a surcharge, surcharge is added only for those transactions. Flat rate shipping only.

With a request version of 665 or greater, total shipping cost includes any surcharge, and ShippingSurcharge is no longer returned as an individual tag.

For a list of possible enumeration values, see CurrencyCodeType.
ShippingDetails
  .ShippingServiceOption
  .ShippingTimeMax
int Conditionally The maximum guaranteed number of business days the shipping carrier will take to ship an item (not including the time it takes the seller to deliver the item to the shipping carrier). See Enabling Get It Fast. Not applicable to Half.com.
ShippingDetails
  .ShippingServiceOption
  .ShippingTimeMin
int Conditionally The minimum guaranteed number of business days in which the shipping carrier can ship an item (not including the time it takes the seller to deliver the item to the shipping carrier). See Enabling Get It Fast. Not applicable to Half.com.
ShippingDetails
  .ShippingServiceOption.ShipsTo
string Conditionally,
repeatable: [0..*]
An international location or region to which the item may be shipped via this particular shipping service. Associated with the shipping service by the seller. Use GeteBayDetails to determine which locations are valid per site. These values are string equivalents of values found in ShippingRegionCodeType and CountryCodeType. Returned with request version 665 or greater, if set via Trading API.
ShippingDetails.TaxTable TaxTableType Conditionally Tax details for a jurisdiction such as a state or province. Returned empty in if no tax table was used.

Not applicable to Half.com.
ShippingDetails.TaxTable
  .TaxJurisdiction
TaxJurisdictionType Conditionally,
repeatable: [0..*]
Sales tax details for zero or more jurisdictions (states, provinces, etc). Information is only returned for the jurisdictions for which the user provided tax information. ShippingIncludedInTax and SalesTaxPercent are returned but are empty.
ShippingDetails.TaxTable
  .TaxJurisdiction
  .JurisdictionID
string Conditionally Representative identifier for the jurisdiction. Typically an abbreviation (e.g. CA for California).
ShippingDetails.TaxTable
  .TaxJurisdiction
  .SalesTaxPercent
float Conditionally The tax percent to apply for a listing shipped to this jurisdiction. The value passed in is stored with a precision of 3 digits after the decimal point (##.###). GetTaxTable: this tag has no value if the user's tax table has not been set.
ShippingDetails.TaxTable
  .TaxJurisdiction
  .ShippingIncludedInTax
boolean Conditionally Whether shipping costs are to be part of the base amount that is taxed. GetTaxTable: This tag is empty if the user did not previously provide information.
Standard Output Fields  
Ack AckCodeType Always Indicates whether the call was successfully processed by eBay.

Applicable values:

CustomCode
(out) Reserved for internal or future use.
Failure
(out) Request processing failed
Success
(out) Request processing succeeded
Warning
(out) Request processing completed with warning information being included in the response message

(Not all values in AckCodeType apply to this field.)
Build string Always This refers to the particular 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 If you pass a value in MessageID in a request, we will return the same value in CorrelationID in the response. You can use this for tracking that a response is returned for every request and to match particular responses to particular requests. Only returned if MessageID was used.
Errors ErrorType Conditionally,
repeatable: [0..*]
A list of application-level errors or warnings (if any) that were raised when eBay processed the request.

Application-level errors occur due to problems with business-level data on the client side or on the eBay server side. For example, an error would occur if the request contains an invalid combination of fields, or it is missing a required field, or the value of the field is not recognized. An error could also occur if eBay encountered a problem in our internal business logic while processing the request.

Only returned if there were warnings or errors.
Errors.ErrorClassification ErrorClassificationCodeType Conditionally API errors are divided between two classes: system errors and request errors.

Applicable values:

CustomCode
(out) Reserved for internal or future use.
RequestError
(out) An error has occurred either as a result of a problem in the sending application or because the application's end-user has attempted to submit invalid data (or missing data). In these cases, do not retry the request. The problem must be corrected before the request can be made again. If the problem is due to something in the application (such as a missing required field), the application must be changed. If the problem is a result of end-user data, the application must alert the end-user to the problem and provide the means for the end-user to correct the data. Once the problem in the application or data is resolved, resend the request to eBay with the corrected data.
SystemError
(out) Indicates that an error has occurred on the eBay system side, such as a database or server down. An application can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form.

See Errors by Number.

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..*]
Some warning and error messages return one or more variables that contain contextual information about the error. This is often the field or value that triggered the error. You can usually predict where these will occur by looking at the "replaceable_value" indicators in our Errors by Number page.

See Errors by Number.

Errors.ErrorParameters
  [ attribute ParamID ]
string Conditionally Some warning and error messages return one or more variables that contain contextual information about the error. This is often the field or value that triggered the error. You can usually predict where these will occur by looking at the "replaceable_value" indicators in our Errors by Number page.
Errors.ErrorParameters.Value string Conditionally The value of the variable.
Errors.LongMessage string Conditionally A more detailed description of the condition that raised the error.

See Errors by Number.

Errors.SeverityCode SeverityCodeType Conditionally Indicates whether the error caused the request to fail.

If the request fails and the source of the problem is within the application (such as a missing required element), please change the application before you retry the request. If the problem is due to end-user input data, please alert the end-user to the problem and provide the means for them to correct the data. Once the problem in the application or data is resolved, you can attempt to re-send the request to eBay.

If the source of the problem is on eBay's side, you can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form.

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.

Applicable values:

CustomCode
(out) Reserved for internal or future use
Error
(out) The request that triggered the error was not processed successfully. When a serious application-level error occurs, the error is returned instead of the business data.
Warning
(out) The request was processed successfully, but something occurred that may affect your application or the user. For example, eBay may have changed a value the user sent in. In this case, eBay returns a normal, successful response and also returns the warning.

See:
    Errors by Number
    Checklist for Going Live for more information see the eBay Features Guide.

Errors.ShortMessage string Conditionally A brief description of the condition that raised the error.

See Errors by Number.

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 "dateTime" type for information about this time format and converting to and from the GMT time zone.
Version string Always The release version that eBay used to process the request.

Note: This is usually the latest release version, as specified in the release notes. (eBay releases the API to international sites about a week after we release it to the US site.)

If a field in the response returns the token "CustomCode", it usually means that the field is a code type (a token or enumeration), and that in your request URL (or HTTP header) you specified a version that is older than the version in which the token was added to the call.

See Schema Versioning Strategy.



Back to top

Detail Controls


DetailLevel

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

Back to top

Samples

New to making API calls? Please see Making an API 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.

Sample: Basic Call

Retrieves both summary and detailed shipping cost information associated with a specific ItemID.

Input

To see item details in addition to a summary of shipping costs, set IncludeDetails to true. Doing so returns the ShippingDetails container in addition to the default ShippingSummary container. Note that if QuantitySold were omitted, it would default to 1.

URL format (HTTP GET). See also the non-wrapped version of this URL. For results in a format other than XML, 
specify a different value for responseencoding.
http://open.api.ebay.com/shopping?
   callname=GetShippingCosts&
   responseencoding=XML&
   appid=YourAppIDHere&
   siteid=0&
   version=517&
   ItemID=180126682091&
   DestinationCountryCode=US&
   DestinationPostalCode=95128&
   IncludeDetails=true&
   QuantitySold=1

   Here is the same input in XML format (HTTP POST). Note that this does not include standard values.

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

<?xml version="1.0" encoding="utf-8"?>
<GetShippingCostsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <ItemID>180126682091</ItemID>
  <DestinationCountryCode>US</DestinationCountryCode>
  <DestinationPostalCode>95128</DestinationPostalCode>
  <IncludeDetails>true</IncludeDetails>
  <QuantitySold>1</QuantitySold>
</GetShippingCostsRequest>

Output

The result shows that the item was listed with the flat rate shipping cost model, as seen in value for ShippingCostSummary.ShippingType.

XML format. Also available are the .txt version of this XML and the JSON and SOAP equivalent.

<?xml version="1.0" encoding="utf-8"?>
<GetShippingCostsResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2007-06-11T01:29:36.765Z</Timestamp>
  <Ack>Success</Ack>
  <Build>e517_core_APILW_4693054_R1</Build>
  <Version>517/Version>
  <ShippingDetails>
    <InsuranceOption>NotOffered</InsuranceOption>
    <ShippingRateErrorMessage>No Error</ShippingRateErrorMessage>
    <ShippingServiceOption>
      <ShippingServiceName>Standard Flat Rate Shipping Service</ShippingServiceName>
      <ShippingServiceCost currencyID="USD">2.45</ShippingServiceCost>
      <ShippingTimeMin>0</ShippingTimeMin>
      <ShippingTimeMax>0</ShippingTimeMax>
    </ShippingServiceOption>
    <TaxTable/>
  </ShippingDetails>
  <ShippingCostSummary>
    <ShippingServiceName>Standard Flat Rate Shipping Service</ShippingServiceName>
    <ShippingServiceCost currencyID="USD">2.45</ShippingServiceCost>
    <ShippingType>Flat</ShippingType>
  </ShippingCostSummary>
</GetShippingCostsResponse>



Back to top

Change History

Version Description
869
2014-04-08
  • PickupInStoreDetails (added): A new container that is returned if the listing is enabled for the In-Store Pickup option.
861
2014-02-11
  • ShippingServiceCutOffTime (added): The last time of day that an order using the specified shipping service will be accepted by the seller for the current listing. The cut off time applies and is returned only when seller offers the listing with a qualifying time-sensitive shipping service, such as eBay Now delivery.
781
2012-07-04
  • ShippingServiceOption.FastAndFree (added): This field will appear as 'true' if the shipping service is fast (less than four days) and free for the buyer.
777
2012-06-06
  • ImportCharge (added): The total cost of customs and taxes that will be applied to a item shipped internationally using the Global Exchange Program. ImportCharge is returned in ShippingDetails.InternationalShippingServiceOption and in ShippingCostSummary. This amount is calculated and supplied for each item by the international shipping provider when a buyer views the item properties.
665
2010-04-14
  • ShippingCostSummary.ListedShippingServiceCost (modified): This is now returned as documented (bug fix).
  • ExcludeShipToLocation, ShipTo (added): With a request version of 665 or greater, ExcludeShipToLocation and ShipTo are returned if they were set via Trading API.
  • ShippingSurcharge (modified): With a request version of 665 or greater, the total shipping cost includes any surcharge, and surcharge is no longer returned as an individual tag.
  • Shipping services (modified): Prior to request version 665, services are not filtered out. With a request version of 665 or greater, the buyer is presented with services only if they are valid for the buyer's country.
  • ShippingServiceAdditionalCost (both Summary and non-Summary uses, domestic and international) (modified): The cost of shipping each additional item beyond the first item (flat shipping). For single-item listings, if this is not provided, it is defaulted to zero. For multi-quantity listings, if this is not provided, it is set to the value of (in)ShippingServiceCost (unless the request version is lower than 665, in which case ShippingServiceAdditionalCost is required and is not defaulted).
  • ShippingServiceCost (both Summary and non-Summary uses, domestic and international) (modified): If flat shipping: if only one item is being shipped, this matches (in)ShippingServiceCost; if more than one item is being shipped, this is the total of (in)ShippingServiceCost plus ((in)ShippingServiceAdditionalCost times the number of items beyond the first item). (Flat shipping behavior prior to version 665: (out)ShippingServiceCost matches (in)ShippingServiceCost even for multi-quantity listings for which multiple items are shipped.)
637
2009-09-30
  • ShippingCostSummaryType.ListedShippingServiceCost (added): The listed shipping cost for an item.
555
2008-03-05
  • ShippingDetails.CODCost (added): Italy site (site ID 101) only. Contains the cost of cash-on-delivery shipping.
517
2007-06-13
  • InternationalShippingServiceOption.ShipsTo, ShippingCostSummaryType.InsuranceOption, ShippingDetailsType.InternationalInsuranceCost, and ShippingDetailsType.InternationalInsuranceOption (added): Fixed a bug so that now these elements are returned.
515
2007-06-10
  • (added) New call.

Back to top

User-Contributed Notes