POST api/mws/shipment/GetEligibleShippingServices

Returns a list of shipping service offers. 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. 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.

Request Information

URI Parameters

None.

Body Parameters

MWSMerchantFulfillmentService.Model.ShipmentRequestDetails

Name	Description	Type	Additional information
AmazonOrderId	Gets and sets the AmazonOrderId property. An Amazon-defined order identifier in 3-7-7 format.	string	Required Max length: 50
SellerOrderId	Gets and sets the SellerOrderId property. A seller-defined order identifier.	string	Max length: 64
ItemList	Gets and sets the ItemList property. A list of items to be included in a shipment	Collection of MWSMerchantFulfillmentService.Model.Item	Required
ShipFromAddress	Gets and sets the ShipFromAddress property. The address from which the shipment ships	MWSMerchantFulfillmentService.Model.Address	Required
PackageDimensions	Gets and sets the PackageDimensions property. The package dimensions	MWSMerchantFulfillmentService.Model.PackageDimensions	Required
Weight	Gets and sets the Weight property. The package weight.	MWSMerchantFulfillmentService.Model.Weight	Required
MustArriveByDate	Gets and sets the MustArriveByDate property. The date by which the package must arrive to keep the promise to the customer. If MustArriveByDate is specified, only shipping service offers that can be delivered by that date are returned.	date	None.
ShipDate	Gets and sets the ShipDate property. When used in a request, this is the date that the seller wants to ship the package. When used in a response, this is the date that the package can be shipped by the indicated method.	date	None.
ShippingServiceOptions	Gets and sets the ShippingServiceOptions property. Extra services offered by the carrier	MWSMerchantFulfillmentService.Model.ShippingServiceOptions	Required
LabelCustomization	Gets and sets the LabelCustomization property. Label customization options.	MWSMerchantFulfillmentService.Model.LabelCustomization	None.

Request Formats

application/json, text/json

Sample:

{
  "AmazonOrderId": "sample string 1",
  "SellerOrderId": "sample string 2",
  "ItemList": [
    {
      "OrderItemId": "sample string 1",
      "Quantity": 2.0
    },
    {
      "OrderItemId": "sample string 1",
      "Quantity": 2.0
    }
  ],
  "ShipFromAddress": {
    "Name": "sample string 1",
    "AddressLine1": "sample string 2",
    "AddressLine2": "sample string 3",
    "AddressLine3": "sample string 4",
    "DistrictOrCounty": "sample string 5",
    "Email": "sample string 6",
    "City": "sample string 7",
    "StateOrProvinceCode": "sample string 8",
    "PostalCode": "sample string 9",
    "CountryCode": "sample string 10",
    "Phone": "sample string 11"
  },
  "PackageDimensions": {
    "Length": 1.0,
    "Width": 2.0,
    "Height": 3.0,
    "Unit": "sample string 4",
    "PredefinedPackageDimensions": "sample string 5"
  },
  "Weight": {
    "Value": 1.0,
    "Unit": "sample string 2"
  },
  "MustArriveByDate": "2026-01-12T23:55:14.3893141+00:00",
  "ShipDate": "2026-01-12T23:55:14.3893141+00:00",
  "ShippingServiceOptions": {
    "DeliveryExperience": "sample string 1",
    "DeclaredValue": {
      "CurrencyCode": "sample string 1",
      "Amount": 2.0
    },
    "CarrierWillPickUp": true,
    "LabelFormat": "sample string 3"
  },
  "LabelCustomization": {
    "CustomTextForLabel": "sample string 1",
    "StandardIdForLabel": "sample string 2"
  }
}

application/xml, text/xml

Sample:

<ShipmentRequestDetails xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <AmazonOrderId>sample string 1</AmazonOrderId>
  <SellerOrderId>sample string 2</SellerOrderId>
  <ItemList>
    <Item>
      <OrderItemId>sample string 1</OrderItemId>
      <Quantity>2</Quantity>
    </Item>
    <Item>
      <OrderItemId>sample string 1</OrderItemId>
      <Quantity>2</Quantity>
    </Item>
  </ItemList>
  <ShipFromAddress>
    <Name>sample string 1</Name>
    <AddressLine1>sample string 2</AddressLine1>
    <AddressLine2>sample string 3</AddressLine2>
    <AddressLine3>sample string 4</AddressLine3>
    <DistrictOrCounty>sample string 5</DistrictOrCounty>
    <Email>sample string 6</Email>
    <City>sample string 7</City>
    <StateOrProvinceCode>sample string 8</StateOrProvinceCode>
    <PostalCode>sample string 9</PostalCode>
    <CountryCode>sample string 10</CountryCode>
    <Phone>sample string 11</Phone>
  </ShipFromAddress>
  <PackageDimensions>
    <Length>1</Length>
    <Width>2</Width>
    <Height>3</Height>
    <Unit>sample string 4</Unit>
    <PredefinedPackageDimensions>sample string 5</PredefinedPackageDimensions>
  </PackageDimensions>
  <Weight>
    <Value>1</Value>
    <Unit>sample string 2</Unit>
  </Weight>
  <MustArriveByDate>2026-01-12T23:55:14.3893141+00:00</MustArriveByDate>
  <ShipDate>2026-01-12T23:55:14.3893141+00:00</ShipDate>
  <ShippingServiceOptions>
    <DeliveryExperience>sample string 1</DeliveryExperience>
    <DeclaredValue>
      <CurrencyCode>sample string 1</CurrencyCode>
      <Amount>2</Amount>
    </DeclaredValue>
    <CarrierWillPickUp>true</CarrierWillPickUp>
    <LabelFormat>sample string 3</LabelFormat>
  </ShippingServiceOptions>
  <LabelCustomization>
    <CustomTextForLabel>sample string 1</CustomTextForLabel>
    <StandardIdForLabel>sample string 2</StandardIdForLabel>
  </LabelCustomization>
</ShipmentRequestDetails>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Submit Feed Response

MWSMerchantFulfillmentService.Model.GetEligibleShippingServicesResponse

Name	Description	Type	Additional information
GetEligibleShippingServicesResult	Gets and sets the GetEligibleShippingServicesResult property.	MWSMerchantFulfillmentService.Model.GetEligibleShippingServicesResult	None.
ResponseMetadata	Gets and sets the ResponseMetadata property.	MWSMerchantFulfillmentService.Model.ResponseMetadata	None.
ResponseHeaderMetadata	Gets and sets the ResponseHeaderMetadata property.	MWSMerchantFulfillmentService.Model.ResponseHeaderMetadata	None.

Response Formats

application/json, text/json

Sample:

{
  "GetEligibleShippingServicesResult": {
    "ShippingServiceList": [
      {
        "ShippingServiceName": "sample string 1",
        "CarrierName": "sample string 2",
        "ShippingServiceId": "sample string 3",
        "ShippingServiceOfferId": "sample string 4",
        "ShipDate": "2026-01-12T23:55:14.3893141+00:00",
        "EarliestEstimatedDeliveryDate": "2026-01-12T23:55:14.3893141+00:00",
        "LatestEstimatedDeliveryDate": "2026-01-12T23:55:14.3893141+00:00",
        "Rate": {
          "CurrencyCode": "sample string 1",
          "Amount": 2.0
        },
        "ShippingServiceOptions": {
          "DeliveryExperience": "sample string 1",
          "DeclaredValue": {
            "CurrencyCode": "sample string 1",
            "Amount": 2.0
          },
          "CarrierWillPickUp": true,
          "LabelFormat": "sample string 3"
        },
        "AvailableLabelFormats": [
          "sample string 1",
          "sample string 2"
        ]
      },
      {
        "ShippingServiceName": "sample string 1",
        "CarrierName": "sample string 2",
        "ShippingServiceId": "sample string 3",
        "ShippingServiceOfferId": "sample string 4",
        "ShipDate": "2026-01-12T23:55:14.3893141+00:00",
        "EarliestEstimatedDeliveryDate": "2026-01-12T23:55:14.3893141+00:00",
        "LatestEstimatedDeliveryDate": "2026-01-12T23:55:14.3893141+00:00",
        "Rate": {
          "CurrencyCode": "sample string 1",
          "Amount": 2.0
        },
        "ShippingServiceOptions": {
          "DeliveryExperience": "sample string 1",
          "DeclaredValue": {
            "CurrencyCode": "sample string 1",
            "Amount": 2.0
          },
          "CarrierWillPickUp": true,
          "LabelFormat": "sample string 3"
        },
        "AvailableLabelFormats": [
          "sample string 1",
          "sample string 2"
        ]
      }
    ],
    "TemporarilyUnavailableCarrierList": [
      {
        "CarrierName": "sample string 1"
      },
      {
        "CarrierName": "sample string 1"
      }
    ],
    "TermsAndConditionsNotAcceptedCarrierList": [
      {
        "CarrierName": "sample string 1"
      },
      {
        "CarrierName": "sample string 1"
      }
    ]
  },
  "ResponseMetadata": {
    "RequestId": "sample string 1"
  },
  "ResponseHeaderMetadata": {
    "RequestId": null,
    "ResponseContext": "",
    "Timestamp": null,
    "QuotaMax": null,
    "QuotaRemaining": null,
    "QuotaResetsAt": null
  }
}

application/xml, text/xml

Sample:

<GetEligibleShippingServicesResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <GetEligibleShippingServicesResult>
    <ShippingServiceList>
      <ShippingService>
        <ShippingServiceName>sample string 1</ShippingServiceName>
        <CarrierName>sample string 2</CarrierName>
        <ShippingServiceId>sample string 3</ShippingServiceId>
        <ShippingServiceOfferId>sample string 4</ShippingServiceOfferId>
        <ShipDate>2026-01-12T23:55:14.3893141+00:00</ShipDate>
        <EarliestEstimatedDeliveryDate>2026-01-12T23:55:14.3893141+00:00</EarliestEstimatedDeliveryDate>
        <LatestEstimatedDeliveryDate>2026-01-12T23:55:14.3893141+00:00</LatestEstimatedDeliveryDate>
        <Rate>
          <CurrencyCode>sample string 1</CurrencyCode>
          <Amount>2</Amount>
        </Rate>
        <ShippingServiceOptions>
          <DeliveryExperience>sample string 1</DeliveryExperience>
          <DeclaredValue>
            <CurrencyCode>sample string 1</CurrencyCode>
            <Amount>2</Amount>
          </DeclaredValue>
          <CarrierWillPickUp>true</CarrierWillPickUp>
          <LabelFormat>sample string 3</LabelFormat>
        </ShippingServiceOptions>
        <AvailableLabelFormats>
          <string>sample string 1</string>
          <string>sample string 2</string>
        </AvailableLabelFormats>
      </ShippingService>
      <ShippingService>
        <ShippingServiceName>sample string 1</ShippingServiceName>
        <CarrierName>sample string 2</CarrierName>
        <ShippingServiceId>sample string 3</ShippingServiceId>
        <ShippingServiceOfferId>sample string 4</ShippingServiceOfferId>
        <ShipDate>2026-01-12T23:55:14.3893141+00:00</ShipDate>
        <EarliestEstimatedDeliveryDate>2026-01-12T23:55:14.3893141+00:00</EarliestEstimatedDeliveryDate>
        <LatestEstimatedDeliveryDate>2026-01-12T23:55:14.3893141+00:00</LatestEstimatedDeliveryDate>
        <Rate>
          <CurrencyCode>sample string 1</CurrencyCode>
          <Amount>2</Amount>
        </Rate>
        <ShippingServiceOptions>
          <DeliveryExperience>sample string 1</DeliveryExperience>
          <DeclaredValue>
            <CurrencyCode>sample string 1</CurrencyCode>
            <Amount>2</Amount>
          </DeclaredValue>
          <CarrierWillPickUp>true</CarrierWillPickUp>
          <LabelFormat>sample string 3</LabelFormat>
        </ShippingServiceOptions>
        <AvailableLabelFormats>
          <string>sample string 1</string>
          <string>sample string 2</string>
        </AvailableLabelFormats>
      </ShippingService>
    </ShippingServiceList>
    <TemporarilyUnavailableCarrierList>
      <TemporarilyUnavailableCarrier>
        <CarrierName>sample string 1</CarrierName>
      </TemporarilyUnavailableCarrier>
      <TemporarilyUnavailableCarrier>
        <CarrierName>sample string 1</CarrierName>
      </TemporarilyUnavailableCarrier>
    </TemporarilyUnavailableCarrierList>
    <TermsAndConditionsNotAcceptedCarrierList>
      <TermsAndConditionsNotAcceptedCarrier>
        <CarrierName>sample string 1</CarrierName>
      </TermsAndConditionsNotAcceptedCarrier>
      <TermsAndConditionsNotAcceptedCarrier>
        <CarrierName>sample string 1</CarrierName>
      </TermsAndConditionsNotAcceptedCarrier>
    </TermsAndConditionsNotAcceptedCarrierList>
  </GetEligibleShippingServicesResult>
  <ResponseMetadata>
    <RequestId>sample string 1</RequestId>
  </ResponseMetadata>
  <ResponseHeaderMetadata />
</GetEligibleShippingServicesResponse>