---
title: "getEligibleShipmentServices"
method: POST
path: "/mfn/v0/eligibleShippingServices"
tags: ["Merchant Fulfillment v0"]
---

# getEligibleShipmentServices

`POST /mfn/v0/eligibleShippingServices`

Returns a list of shipping service offers that satisfy the specified shipment request details.

**Usage Plan:**

| Rate (requests per second) | Burst |
| ---- | ---- |
| 6 | 12 |

The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that are applied to the requested operation when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the SP-API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).

## Request body

- GetEligibleShipmentServicesRequest — Request schema.
  - `ShipmentRequestDetails` ShipmentRequestDetails, required — Shipment information required for requesting shipping service offers or for creating a shipment.
    - `AmazonOrderId` string, required — An Amazon-defined order identifier, in 3-7-7 format.
    - `SellerOrderId` string — A seller-defined order identifier.
    - `ItemList` Item[], required — The list of items you want to include in a shipment.
      - `itemSequenceNumber` string, required — Item sequence number for the item. The first item will be 001, the second 002, and so on. This number is used as a reference to refer to this item from the carton or pallet level.
      - `amazonProductIdentifier` string — Buyer Standard Identification Number (ASIN) of an item.
      - `vendorProductIdentifier` string — The vendor selected product identification of the item. Should be the same as was sent in the purchase order.
      - `shippedQuantity` ItemQuantity, required — Details of item quantity.
        - `amount` integer, required — Amount of units shipped for a specific item at a shipment level. If the item is present only in certain cartons or pallets within the shipment, please provide this at the appropriate carton or pallet level.
        - `unitOfMeasure` 'Cases' | 'Eaches', required — Unit of measure for the shipped quantity.
        - `unitSize` integer — The case size, in the event that we ordered using cases. Otherwise, 1.
        - `totalWeight` TotalWeight — The total weight of units that are sold by weight in a shipment.
          - `unitOfMeasure` 'POUNDS' | 'OUNCES' | 'GRAMS' | 'KILOGRAMS', required — The unit of measure for the weight of items that are ordered by cases and support pricing by weight.
          - `amount` string, required — A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation. <br>**Pattern** : `^-?(0|([1-9]\d*))(\.\d+)?([eE][+-]?\d+)?$`.
      - `itemDetails` ItemDetails — Item details for be provided for every item in shipment at either the item or carton or pallet level, whichever is appropriate.
        - `purchaseOrderNumber` string — The purchase order number for the shipment being confirmed. If the items in this shipment belong to multiple purchase order numbers that are in particular carton or pallet within the shipment, then provide the purchaseOrderNumber at the appropriate carton or pallet level. Formatting Notes: 8-character alpha-numeric code.
        - `lotNumber` string — The batch or lot number associates an item with information the manufacturer considers relevant for traceability of the trade item to which the Element String is applied. The data may refer to the trade item itself or to items contained. This field is mandatory for all perishable items.
        - `lotNumberSourceReference` string — The location identifier where the product receives a traceability lot number. Provide this field for products subject to the FDA Food Safety Modernization Act (FSMA) Section 204. When you provide `lotNumberSourceReference`, you must also specify the corresponding `lotNumberSourceType` field.
        - `lotNumberSourceType` 'GLN' | 'FFRN' | 'USDA_E' | 'URL' — The identifier type used for the lot number source. Provide this field when you specify `lotNumberSourceReference`.
        - `countryOfOrigin` string — The two-character country code for the country where the product was manufactured or originates. Use ISO 3166-1 alpha-2 format.
        - `regulationReferences` RegulationReferences — Regulatory requirements and compliance information for the item, including reference numbers, verification codes, and exemption codes. Use this field to specify applicable regulations such as EU Deforestation Regulation (EUDR).
          - `dueDiligenceReference` string — The reference number from the vendor's EUDR Due Diligence Statement (DDS) submitted to the EU Commission portal or provided to Amazon through ONIX feed.
          - `dueDiligenceVerification` string — The EUDR Due Diligence verification number provided by the EU Commission for the submitted DDS.
          - `dueDiligenceInformation` string — The EUDR Due Diligence information pre-loaded in Vendor Central.
          - `dueDiligenceExemptionCode` string — The exemption code for EUDR products exempt from due diligence requirements.
        - `expiry` Expiry — Expiry refers to the collection of dates required for certain items. These could be either expiryDate or mfgDate and expiryAfterDuration. These are mandatory for perishable items.
          - `manufacturerDate` string, date-time — Production, packaging or assembly date determined by the manufacturer. Its meaning is determined based on the trade item context.
          - `expiryDate` string, date-time — The date that determines the limit of consumption or use of a product. Its meaning is determined based on the trade item context.
          - `expiryAfterDuration` Duration — Duration after manufacturing date during which the product is valid for consumption.
            - `durationUnit` 'Days' | 'Months', required — Unit for duration.
            - `durationValue` integer, required — Value for the duration in terms of the durationUnit.
        - `maximumRetailPrice` Money — An amount of money, including units in the form of currency.
          - `currencyCode` string, required — Three digit currency code in ISO 4217 format.
          - `amount` string, required — A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation. <br>**Pattern** : `^-?(0|([1-9]\d*))(\.\d+)?([eE][+-]?\d+)?$`.
        - `handlingCode` 'Oversized' | 'Fragile' | 'Food' | 'HandleWithCare' — Identification of the instructions on how specified item/carton/pallet should be handled.
    - `ShipFromAddress` Address, required — Address of the party.
      - `name` string, required — The name of the person, business or institution at that address.
      - `addressLine1` string, required — First line of the address.
      - `addressLine2` string — Additional street address information, if required.
      - `addressLine3` string — Additional street address information, if required.
      - `city` string — The city where the person, business or institution is located.
      - `county` string — The county where person, business or institution is located.
      - `district` string — The district where person, business or institution is located.
      - `stateOrRegion` string — The state or region where person, business or institution is located.
      - `postalCode` string — The postal code of that address. It contains a series of letters or digits or both, sometimes including spaces or punctuation.
      - `countryCode` string, required — The two digit country code in ISO 3166-1 alpha-2 format.
      - `phone` string — The phone number of the person, business or institution located at that address.
    - `PackageDimensions` PackageDimensions, required — The dimensions of a package contained in a shipment.
      - `Length` number, double — A number that represents the given package dimension.
      - `Width` number, double — A number that represents the given package dimension.
      - `Height` number, double — A number that represents the given package dimension.
      - `Unit` 'inches' | 'centimeters' — The unit of length.
      - `PredefinedPackageDimensions` 'FedEx_Box_10kg' | 'FedEx_Box_25kg' | 'FedEx_Box_Extra_Large_1' | 'FedEx_Box_Extra_Large_2' | 'FedEx_Box_Large_1' | 'FedEx_Box_Large_2' | 'FedEx_Box_Medium_1' | 'FedEx_Box_Medium_2' | 'FedEx_Box_Small_1' | 'FedEx_Box_Small_2' | 'FedEx_Envelope' | 'FedEx_Padded_Pak' | 'FedEx_Pak_1' | 'FedEx_Pak_2' | 'FedEx_Tube' | 'FedEx_XL_Pak' | 'UPS_Box_10kg' | 'UPS_Box_25kg' | 'UPS_Express_Box' | 'UPS_Express_Box_Large' | 'UPS_Express_Box_Medium' | 'UPS_Express_Box_Small' | 'UPS_Express_Envelope' | 'UPS_Express_Hard_Pak' | 'UPS_Express_Legal_Envelope' | 'UPS_Express_Pak' | 'UPS_Express_Tube' | 'UPS_Laboratory_Pak' | 'UPS_Pad_Pak' | 'UPS_Pallet' | 'USPS_Card' | 'USPS_Flat' | 'USPS_FlatRateCardboardEnvelope' | 'USPS_FlatRateEnvelope' | 'USPS_FlatRateGiftCardEnvelope' | 'USPS_FlatRateLegalEnvelope' | 'USPS_FlatRatePaddedEnvelope' | 'USPS_FlatRateWindowEnvelope' | 'USPS_LargeFlatRateBoardGameBox' | 'USPS_LargeFlatRateBox' | 'USPS_Letter' | 'USPS_MediumFlatRateBox1' | 'USPS_MediumFlatRateBox2' | 'USPS_RegionalRateBoxA1' | 'USPS_RegionalRateBoxA2' | 'USPS_RegionalRateBoxB1' | 'USPS_RegionalRateBoxB2' | 'USPS_RegionalRateBoxC' | 'USPS_SmallFlatRateBox' | 'USPS_SmallFlatRateEnvelope' — An enumeration of predefined parcel tokens. If you specify a `PredefinedPackageDimensions` token, you are not obligated to use a branded package from a carrier. For example, if you specify the `FedEx_Box_10kg` token, you do not have to use that particular package from FedEx. You are only obligated to use a box that matches the dimensions specified by the token. Note: Carriers can have restrictions on the type of package allowed for certain ship methods. Check the carrier website for details. Example: Flat rate pricing is available when materials are sent by USPS in a USPS-produced Flat Rate envelope or box.
    - `Weight` Weight, required — The weight of the shipment.
      - `unitOfMeasure` 'G' | 'Kg' | 'Oz' | 'Lb', required — The unit of measurement.
      - `value` string, required — A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation. <br>**Pattern** : `^-?(0|([1-9]\d*))(\.\d+)?([eE][+-]?\d+)?$`.
    - `MustArriveByDate` string, date-time — Date-time formatted timestamp.
    - `ShipDate` string, date-time — Date-time formatted timestamp.
    - `ShippingServiceOptions` ShippingServiceOptions, required — Extra services provided by a carrier.
      - `DeliveryExperience` 'DeliveryConfirmationWithAdultSignature' | 'DeliveryConfirmationWithSignature' | 'DeliveryConfirmationWithoutSignature' | 'NoTracking', required — The delivery confirmation level.
      - `DeclaredValue` CurrencyAmount — Currency type and amount.
        - `CurrencyCode` string, required — Three-digit currency code in ISO 4217 format.
        - `Amount` number, double, required — The currency amount.
      - `CarrierWillPickUp` boolean, required — When true, the carrier will pick up the package. Note: Scheduled carrier pickup is available only using Dynamex (US), DPD (UK), and Royal Mail (UK).
      - `CarrierWillPickUpOption` 'CarrierWillPickUp' | 'ShipperWillDropOff' | 'NoPreference' — Carrier will pick up option.
      - `LabelFormat` 'PDF' | 'PNG' | 'ZPL203' | 'ZPL300' | 'ShippingServiceDefault' — The label format.
    - `LabelCustomization` LabelCustomization — Custom text for shipping labels.
      - `CustomTextForLabel` string — Custom text to print on the label. Note: Custom text is only included on labels that are in ZPL format (ZPL203). FedEx does not support `CustomTextForLabel`.
      - `StandardIdForLabel` 'AmazonOrderId' — The type of standard identifier to print on the label.
  - `ShippingOfferingFilter` ShippingOfferingFilter — Filter for use when requesting eligible shipping services.
    - `IncludePackingSlipWithLabel` boolean — When true, include a packing slip with the label.
    - `IncludeComplexShippingOptions` boolean — When true, include complex shipping options.
    - `CarrierWillPickUp` 'CarrierWillPickUp' | 'ShipperWillDropOff' | 'NoPreference' — Carrier will pick up option.
    - `DeliveryExperience` 'DeliveryConfirmationWithAdultSignature' | 'DeliveryConfirmationWithSignature' | 'DeliveryConfirmationWithoutSignature' | 'NoTracking' | 'NoPreference' — The delivery confirmation level.

## Response `200`

Success.

- GetEligibleShipmentServicesResponse — Response schema.
  - `payload` GetEligibleShipmentServicesResult — The payload for the `getEligibleShipmentServices` operation.
    - `ShippingServiceList` ShippingService[], required — A list of shipping services offers.
      - `ShippingServiceName` string, required — A plain text representation of a carrier's shipping service. For example, "UPS Ground" or "FedEx Standard Overnight".
      - `CarrierName` string, required — The name of the carrier.
      - `ShippingServiceId` string, required — An Amazon-defined shipping service identifier.
      - `ShippingServiceOfferId` string, required — An Amazon-defined shipping service offer identifier.
      - `ShipDate` string, date-time, required — Date-time formatted timestamp.
      - `EarliestEstimatedDeliveryDate` string, date-time — Date-time formatted timestamp.
      - `LatestEstimatedDeliveryDate` string, date-time — Date-time formatted timestamp.
      - `Rate` CurrencyAmount, required — Currency type and amount.
        - `CurrencyCode` string, required — Three-digit currency code in ISO 4217 format.
        - `Amount` number, double, required — The currency amount.
      - `RateWithAdjustments` CurrencyAmount, required — Currency type and amount.
        - `CurrencyCode` string, required — Three-digit currency code in ISO 4217 format.
        - `Amount` number, double, required — The currency amount.
      - `AdjustmentItemList` RateItem[] — List of adjustments.
        - `RateItemID` 'FBM_SHIP_PLUS_CREDIT', required — Unique identifier for the RateItem.
        - `RateItemType` 'INCLUDED' — Type for the RateItem.
        - `RateItemCharge` CurrencyAmount — Currency type and amount.
          - `CurrencyCode` string, required — Three-digit currency code in ISO 4217 format.
          - `Amount` number, double, required — The currency amount.
        - `RateItemNameLocalization` string — Localized name for the RateItem.
      - `ShippingServiceOptions` ShippingServiceOptions, required — Extra services provided by a carrier.
        - `DeliveryExperience` 'DeliveryConfirmationWithAdultSignature' | 'DeliveryConfirmationWithSignature' | 'DeliveryConfirmationWithoutSignature' | 'NoTracking', required — The delivery confirmation level.
        - `DeclaredValue` CurrencyAmount — Currency type and amount.
          - `CurrencyCode` string, required — Three-digit currency code in ISO 4217 format.
          - `Amount` number, double, required — The currency amount.
        - `CarrierWillPickUp` boolean, required — When true, the carrier will pick up the package. Note: Scheduled carrier pickup is available only using Dynamex (US), DPD (UK), and Royal Mail (UK).
        - `CarrierWillPickUpOption` 'CarrierWillPickUp' | 'ShipperWillDropOff' | 'NoPreference' — Carrier will pick up option.
        - `LabelFormat` 'PDF' | 'PNG' | 'ZPL203' | 'ZPL300' | 'ShippingServiceDefault' — The label format.
      - `AvailableShippingServiceOptions` AvailableShippingServiceOptions — The available shipping service options.
        - `AvailableCarrierWillPickUpOptions` AvailableCarrierWillPickUpOption[], required — List of available carrier pickup options.
          - `CarrierWillPickUpOption` 'CarrierWillPickUp' | 'ShipperWillDropOff' | 'NoPreference', required — Carrier will pick up option.
          - `Charge` CurrencyAmount, required — Currency type and amount.
            - `CurrencyCode` string, required — Three-digit currency code in ISO 4217 format.
            - `Amount` number, double, required — The currency amount.
        - `AvailableDeliveryExperienceOptions` AvailableDeliveryExperienceOption[], required — List of available delivery experience options.
          - `DeliveryExperienceOption` 'DeliveryConfirmationWithAdultSignature' | 'DeliveryConfirmationWithSignature' | 'DeliveryConfirmationWithoutSignature' | 'NoTracking' | 'NoPreference', required — The delivery confirmation level.
          - `Charge` CurrencyAmount, required — Currency type and amount.
            - `CurrencyCode` string, required — Three-digit currency code in ISO 4217 format.
            - `Amount` number, double, required — The currency amount.
      - `AvailableLabelFormats` LabelFormat[] — List of label formats.
      - `AvailableFormatOptionsForLabel` LabelFormatOption[] — The available label formats.
        - `IncludePackingSlipWithLabel` boolean — When true, include a packing slip with the label.
        - `LabelFormat` 'PDF' | 'PNG' | 'ZPL203' | 'ZPL300' | 'ShippingServiceDefault' — The label format.
      - `RequiresAdditionalSellerInputs` boolean, required — When true, additional seller inputs are required.
      - `Benefits` Benefits — Benefits that are included and excluded for each shipping offer. Benefits represents services provided by Amazon (for example, `CLAIMS_PROTECTED`) when sellers purchase shipping through Amazon. Benefit details are made available for any shipment placed on or after January 1st 2024 00:00 UTC.
        - `IncludedBenefits` string[] — A list of included benefits.
        - `ExcludedBenefits` ExcludedBenefit[] — A list of excluded benefits. Refer to the `ExcludeBenefit` object for further documentation.
          - `Benefit` string — A benefit that is being excluded from a shipment.
          - `ReasonCodes` string[] — List of reasons why a benefit is excluded for a shipping offer (for example, `LATE_DELIVERY_RISK`).
    - `RejectedShippingServiceList` RejectedShippingService[] — List of services that are for some reason unavailable for this request
      - `CarrierName` string, required — The rejected shipping carrier name. For example, USPS.
      - `ShippingServiceName` string, required — The rejected shipping service localized name. For example, FedEx Standard Overnight.
      - `ShippingServiceId` string, required — An Amazon-defined shipping service identifier.
      - `RejectionReasonCode` string, required — A reason code meant to be consumed programatically. For example, `CARRIER_CANNOT_SHIP_TO_POBOX`.
      - `RejectionReasonMessage` string — A localized human readable description of the rejected reason.
    - `TemporarilyUnavailableCarrierList` TemporarilyUnavailableCarrier[] — A list of temporarily unavailable carriers.
      - `CarrierName` string, required — The name of the carrier.
    - `TermsAndConditionsNotAcceptedCarrierList` TermsAndConditionsNotAcceptedCarrier[] — List of carriers whose terms and conditions were not accepted by the seller.
      - `CarrierName` string, required — The name of the carrier.
  - `errors` Error[] — A list of error responses returned when a request is unsuccessful.
    - `code` string, required — An error code that identifies the type of error that occurred.
    - `message` string, required — A message that describes the error condition.
    - `details` string — Additional details that can help the caller understand or fix the issue.

## Other responses

- `400` — Request has missing or invalid parameters and cannot be parsed.
- `401` — The request's authorization header is not formatted correctly or does not contain a valid token.
- `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404` — The specified resource does not exist.
- `429` — The frequency of requests was greater than allowed.
- `500` — An unexpected condition occurred that prevented the server from fulfilling the request.
- `503` — Temporary overloading or maintenance of the server.

---

[API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/versions/815a5b6dbaa6/schema)