Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation
Amazon MWS Documentation

GetEligibleShippingServices

Returns a list of shipping service offers.

Description

The GetEligibleShippingServices operation returns a list of shipping service offers that satisfy the shipment request details that you specify. Use this operation to find a shipping service offer that meets your requirements, then specify the ShippingServiceId value and the optional ShippingServiceOfferId value associated with this shipping service offer in a subsequent call to the CreateShipment operation. For definitions, see Terminology. For more information, see How to fulfill Seller Fulfilled Prime orders.

Availability

This operation is only available in the Mexico, US, Germany, and UK marketplaces.

Throttling

This operation has a maximum request quota of 10 and a restore rate of five requests every second. For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.

Request parameters

Name Description Required Values
ShipmentRequestDetails Shipment information required for requesting shipping service offers. Yes Type: ShipmentRequestDetails

Response elements

Name Description
ShippingServiceList A list of shipping services offers.

Type: List of ShippingService

TemporarilyUnavailableCarrierList A list of carriers who are temporarily unavailable, most likely due to a service outage experienced by the carrier. To use a carrier that is on this list, retry at a later time.

Type: List of TemporarilyUnavailableCarrier

TermsAndConditionsNotAcceptedCarrierList A list of carriers whose terms and conditions have not been accepted by the seller. The seller must accept Amazon's terms and conditions and the terms and conditions of any carrier from which they want to purchase shipping labels. The seller can do this on Seller Central (Europe) (US).

Type: List of TemporarilyUnavailableCarrier

Examples

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

https://mws.amazonservices.com/MerchantFulfillment/2015-06-01
  &Action=GetEligibleShippingServices
  &SellerId=A09087172RPFTMV0PGAN2
  &SignatureVersion=2
  &Timestamp=2015-09-23T18%3A36%3A26Z
  &Version=2015-06-01
  &Signature=vMf6thsqGxfVy2EZBsH5sBPJxQe6VzKL9jli8eS7tvM%3D
  &SignatureMethod=HmacSHA256
  &ShipmentRequestDetails.AmazonOrderId=903-9939455-1336669
  &ShipmentRequestDetails.MustArriveByDate=2015-09-28T07%3A00%3A00Z
  &ShipmentRequestDetails.PackageDimensions.Length=5
  &ShipmentRequestDetails.PackageDimensions.Width=5
  &ShipmentRequestDetails.PackageDimensions.Height=5
  &ShipmentRequestDetails.PackageDimensions.Unit=inches
  &ShipmentRequestDetails.Weight.Value=10
  &ShipmentRequestDetails.Weight.Unit=ounces
  &ShipmentRequestDetails.ShipDate=2015-09-23T19%3A32%3A08.727Z
  &ShipmentRequestDetails.ShipFromAddress.Name=John%20Doe
  &ShipmentRequestDetails.ShipFromAddress.AddressLine1=1234%20Westlake%20Ave%20N
  &ShipmentRequestDetails.ShipFromAddress.City=Seattle
  &ShipmentRequestDetails.ShipFromAddress.StateOrProvinceCode=WA
  &ShipmentRequestDetails.ShipFromAddress.PostalCode=98121
  &ShipmentRequestDetails.ShipFromAddress.CountryCode=US
  &ShipmentRequestDetails.ShipFromAddress.Email=example%40example.com
  &ShipmentRequestDetails.ShipFromAddress.Phone=2061234567
  &ShipmentRequestDetails.ShippingServiceOptions.DeliveryExperience
=DeliveryConfirmationWithoutSignature
  &ShipmentRequestDetails.ShippingServiceOptions.CarrierWillPickUp=false
  &ShipmentRequestDetails.ShippingServiceOptions.DeclaredValue.CurrencyCode
=USD
  &ShipmentRequestDetails.ShippingServiceOptions.DeclaredValue.Amount=10.00
  &ShipmentRequestDetails.ItemList.Item.1.OrderItemId=28207139993814
  &ShipmentRequestDetails.ItemList.Item.1.Quantity=1

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<GetEligibleShippingServicesResponse xmlns="https://mws.amazonservices.com
    /MerchantFulfillment/2015-06-01">
    <GetEligibleShippingServicesResult>
        <ShippingServiceList>
            <ShippingService>
                <AvailableLabelFormats>
                  <LabelFormat>PDF</LabelFormat>
                  <LabelFormat>ShippingServiceDefault</LabelFormat>
                  <LabelFormat>ZPL203</LabelFormat>
                </AvailableLabelFormats>
                <CarrierName>FEDEX</CarrierName>
                <ShippingServiceOptions>
                    <CarrierWillPickUp>false</CarrierWillPickUp>
                    <DeclaredValue>
                        <CurrencyCode>USD</CurrencyCode>
                        <Amount>10.00</Amount>
                    </DeclaredValue>
                    <DeliveryExperience>DeliveryConfirmationWithoutSignature
                    </DeliveryExperience>
                </ShippingServiceOptions>
                <ShippingServiceId>FEDEX_PTP_PRIORITY_OVERNIGHT</ShippingServiceId>
                <Rate>
                    <CurrencyCode>USD</CurrencyCode>
                    <Amount>27.81</Amount>
                </Rate>
                <LatestEstimatedDeliveryDate>2015-09-24T10:30:00Z
                </LatestEstimatedDeliveryDate>
                <EarliestEstimatedDeliveryDate>2015-09-24T10:30:00Z
                </EarliestEstimatedDeliveryDate>
                <ShippingServiceOfferId>HDDUKqtQVFetpBZAqx5c1yaCZ9vuFfND0kudyw3lLWCa3
mN2+zUOsRCAZS2oYt0ey6fXKdOAucmYVXR9LAkU9P8hOWw6qYvxYfGr3QxB6dif9iACvBG7fTm0y3
x5aKoyyj7mlrrOUEutSK4PbpMepC3deb5GjoVHIIdeKhVZYRU=</ShippingServiceOfferId>
                <ShipDate>2015-09-23T19:32:08.727Z</ShipDate>
                <ShippingServiceName>FedEx Priority Overnight</ShippingServiceName>
            </ShippingService>
            <ShippingService>
                <AvailableLabelFormats>
                  <LabelFormat>PDF</LabelFormat>
                  <LabelFormat>ShippingServiceDefault</LabelFormat>
                  <LabelFormat>ZPL203</LabelFormat>
                </AvailableLabelFormats>
                <CarrierName>FEDEX</CarrierName>
                <ShippingServiceOptions>
                    <CarrierWillPickUp>false</CarrierWillPickUp>
                    <DeclaredValue>
                        <CurrencyCode>USD</CurrencyCode>
                        <Amount>10.00</Amount>
                    </DeclaredValue>
                    <DeliveryExperience>DeliveryConfirmationWithoutSignature
                    </DeliveryExperience>
                </ShippingServiceOptions>
                <ShippingServiceId>FEDEX_PTP_STANDARD_OVERNIGHT</ShippingServiceId>
                <Rate>
                    <CurrencyCode>USD</CurrencyCode>
                    <Amount>26.57</Amount>
                </Rate>
                <LatestEstimatedDeliveryDate>2015-09-24T20:00:00Z
                </LatestEstimatedDeliveryDate>
                <EarliestEstimatedDeliveryDate>2015-09-24T20:00:00Z
                </EarliestEstimatedDeliveryDate>
                <ShippingServiceOfferId>HDDUKqtQVFetpBZAqx5c1yaCZ9vuFfND0kudyw3lLWCa3
mN2+zUOsRCAZS2oYt0elYmXI8AA2YaB4Q0etqj8XeAkNr4oeJBer1ZX9y4YQN+jHo37NejjUkmDTD
TxHRbtUIKRYtC9pDb7UCg/VJRff5NpQHcMmBbY/Q/tFdxYM5c=</ShippingServiceOfferId>
                <ShipDate>2015-09-23T19:32:08.727Z</ShipDate>
                <ShippingServiceName>FedEx Standard Overnight</ShippingServiceName>
            </ShippingService>
            <ShippingService>
                <AvailableLabelFormats>
                  <LabelFormat>PNG</LabelFormat>
                  <LabelFormat>ShippingServiceDefault</LabelFormat>
                </AvailableLabelFormats>
                <CarrierName>UPS</CarrierName>
                <ShippingServiceOptions>
                    <CarrierWillPickUp>false</CarrierWillPickUp>
                    <DeclaredValue>
                        <CurrencyCode>USD</CurrencyCode>
                        <Amount>10.00</Amount>
                    </DeclaredValue>
                    <DeliveryExperience>DeliveryConfirmationWithoutSignature
                    </DeliveryExperience>
                </ShippingServiceOptions>
                <ShippingServiceId>UPS_PTP_GND</ShippingServiceId>
                <Rate>
                    <CurrencyCode>USD</CurrencyCode>
                    <Amount>6.89</Amount>
                </Rate>
                <LatestEstimatedDeliveryDate>2015-09-25T06:00:00Z
                </LatestEstimatedDeliveryDate>
                <EarliestEstimatedDeliveryDate>2015-09-25T06:00:00Z
                </EarliestEstimatedDeliveryDate>
                <ShippingServiceOfferId>HDDUKqtQVFetpBZAqx5c12nyrBg+Utzz6zmIwjhbP5DEb
C2ZiP0hJRCyAda4ne5EiFGyivXnPjg4kMabInnyVrqdSXRj9TCk88N3BHctTV4lY+0YW647Dm0ahK
hTc4vU9OqMqYLWbnESwE/V/iydXw==</ShippingServiceOfferId>
                <ShipDate>2015-09-23T19:32:08.727Z</ShipDate>
                <ShippingServiceName>UPS Ground</ShippingServiceName>
            </ShippingService>
            <ShippingService>
                <AvailableLabelFormats>
                  <LabelFormat>PNG</LabelFormat>
                  <LabelFormat>ShippingServiceDefault</LabelFormat>
                </AvailableLabelFormats>
                <CarrierName>UPS</CarrierName>
                <ShippingServiceOptions>
                    <CarrierWillPickUp>false</CarrierWillPickUp>
                    <DeclaredValue>
                        <CurrencyCode>USD</CurrencyCode>
                        <Amount>10.00</Amount>
                    </DeclaredValue>
                    <DeliveryExperience>DeliveryConfirmationWithoutSignature
                    </DeliveryExperience>
                </ShippingServiceOptions>
                <ShippingServiceId>UPS_PTP_NEXT_DAY_AIR_SAVER</ShippingServiceId>
                <Rate>
                    <CurrencyCode>USD</CurrencyCode>
                    <Amount>22.91</Amount>
                </Rate>
                <LatestEstimatedDeliveryDate>2015-09-25T06:00:00Z
                </LatestEstimatedDeliveryDate>
                <EarliestEstimatedDeliveryDate>2015-09-25T06:00:00Z
                </EarliestEstimatedDeliveryDate>
                <ShippingServiceOfferId>HDDUKqtQVFetpBZAqx5c12nyrBg+Utzz6zmIwjhbP5AI
OD5oqRXbXz/IF3ZW5Q10AweW6+i5eN09ZqJR1mzQzFPPfKibDD4Rp4AgmbgfThY8CFviXQhKSKsU
aEdmFUlijYAwbgH9yJ7QHoA7K6+C2Qv6VrhsAhuOJWrI87rqSTA=</ShippingServiceOfferId>
                <ShipDate>2015-09-23T19:32:08.727Z</ShipDate>
                <ShippingServiceName>UPS Next Day Air Saver</ShippingServiceName>
            </ShippingService>
        </ShippingServiceList>
        <TemporarilyUnavailableCarrierList>
            <TemporarilyUnavailableCarrier>
                <CarrierName>USPS</CarrierName>
            </TemporarilyUnavailableCarrier>
        </TemporarilyUnavailableCarrierList>
    </GetEligibleShippingServicesResult>
    <ResponseMetadata>
        <RequestId>5b7997fb-efd1-495b-b7db-03ecfa691038</RequestId>
    </ResponseMetadata>
</GetEligibleShippingServicesResponse>

↑ Top