---
title: "getFulfillmentPreview"
method: POST
path: "/fba/outbound/2020-07-01/fulfillmentOrders/preview"
tags: ["Fulfillment Outbound v2020-07-01"]
---

# getFulfillmentPreview

`POST /fba/outbound/2020-07-01/fulfillmentOrders/preview`

Returns a list of fulfillment order previews based on shipping criteria that you specify.

**Usage Plan:**

| Rate (requests per second) | Burst |
| ---- | ---- |
| 2 | 30 |

The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above 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 Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).

## Request body

- GetFulfillmentPreviewRequest — The request body schema for the `getFulfillmentPreview` operation.
  - `marketplaceId` string — The marketplace the fulfillment order is placed against.
  - `address` 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.
  - `items` GetFulfillmentPreviewItem[], required — An array of fulfillment preview item information.
    - `sellerSku` string, required — The seller SKU of the item.
    - `quantity` integer, required — The item quantity.
    - `perUnitDeclaredValue` 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+)?$`.
    - `sellerFulfillmentOrderItemId` string, required — A fulfillment order item identifier that the seller creates to track items in the fulfillment preview.
  - `shippingSpeedCategories` ShippingSpeedCategory[] — List of shipping speed categories.
  - `includeCODFulfillmentPreview` boolean — When true, returns all fulfillment order previews both for COD and not for COD. Otherwise, returns only fulfillment order previews that are not for COD.
  - `includeDeliveryWindows` boolean — When true, returns the `ScheduledDeliveryInfo` response object, which contains the available delivery windows for a Scheduled Delivery. The `ScheduledDeliveryInfo` response object can only be returned for fulfillment order previews with `ShippingSpeedCategories` equal to `ScheduledDelivery`.
  - `featureConstraints` FeatureSettings[] — A list of features and their fulfillment policies to apply to the order.
    - `featureName` string — The name of the feature. Valid feature names are: - `BLOCK_AMZL`: Blocks orders from being shipped using Amazon Logistics (AMZL). - Note: Using this feature will incur additional fee surcharges on MCF orders and may increase the risk of unfulfilled or delayed deliveries if alternative carriers are unavailable. Using `BLOCK_AMZL` in an order request will take precedence over your Seller Central account setting. - `BLANK_BOX`: Ships orders in non-Amazon branded packaging (blank boxes). - `OVERBOX`: Requires items to be shipped in an overbox rather than in their original product packaging. - `PACKING_SLIP`: Requires a packing slip to be included with the order. - `SIGNATURE_CONFIRMATION`: Requires a signature from the recipient upon delivery. - Note: Using signature confirmation features will incur additional fees on MCF orders and are currently supported only in the US marketplace.
    - `featureFulfillmentPolicy` 'Required' | 'NotRequired' — Specifies the policy to use when fulfilling an order.

## Response `200`

Success.

- GetFulfillmentPreviewResponse — The response schema for the `getFulfillmentPreview` operation.
  - `payload` GetFulfillmentPreviewResult — A list of fulfillment order previews, including estimated shipping weights, estimated shipping fees, and estimated ship dates and arrival dates.
    - `fulfillmentPreviews` FulfillmentPreview[] — An array of fulfillment preview information.
      - `shippingSpeedCategory` 'Standard' | 'Expedited' | 'Priority' | 'ScheduledDelivery', required — The shipping method used for the fulfillment order. When this value is `ScheduledDelivery`, choose `Ship` for the `fulfillmentAction`. `Hold` is not a valid `fulfillmentAction` value when the `shippingSpeedCategory` value is `ScheduledDelivery`. Note: Shipping method service level agreements vary by marketplace. Sellers should refer to the [Seller Central](https://developer-docs.amazon.com/sp-api/docs/seller-central-urls) website in their marketplace for shipping method service level agreements and fulfillment fees.
      - `scheduledDeliveryInfo` ScheduledDeliveryInfo — Delivery information for a scheduled delivery. This is only available in the JP marketplace.
        - `deliveryTimeZone` string, required — The time zone of the destination address for the fulfillment order preview. Must be an IANA time zone name. Example: Asia/Tokyo.
        - `deliveryWindows` DeliveryWindow[], required — An array of delivery windows.
          - `startDate` string, date-time, required — Date-time formatted timestamp.
          - `endDate` string, date-time, required — Date-time formatted timestamp.
      - `isFulfillable` boolean, required — When true, this fulfillment order preview is fulfillable.
      - `isCODCapable` boolean, required — When true, this fulfillment order preview is for COD (Cash On Delivery).
      - `estimatedShippingWeight` Weight — 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+)?$`.
      - `estimatedFees` Fee[] — An array of fee type and cost pairs.
        - `feeId` string, required — The unique identifier assigned to the fee.
        - `feeType` 'MISCELLANEOUS_FEE' | 'TAX' | 'TRANSACTION_FEE', required — The type of fee on the transaction.
        - `feeRateValue` string, required — The value of the fee in percentage format.
        - `feeAmount` Currency, required — A currency type and amount.
          - `currencyCode` string — The three-digit currency code in ISO 4217 format.
          - `currencyAmount` number — A decimal number, such as an amount or FX rate.
      - `fulfillmentPreviewShipments` FulfillmentPreviewShipment[] — An array of fulfillment preview shipment information.
        - `earliestShipDate` string, date-time — Date-time formatted timestamp.
        - `latestShipDate` string, date-time — Date-time formatted timestamp.
        - `earliestArrivalDate` string, date-time — Date-time formatted timestamp.
        - `latestArrivalDate` string, date-time — Date-time formatted timestamp.
        - `shippingNotes` string[] — Provides additional insight into the shipment timeline when exact delivery dates are not able to be precomputed.
        - `fulfillmentPreviewItems` FulfillmentPreviewItem[], required — An array of fulfillment preview item information.
          - `sellerSku` string, required — The seller SKU of the item.
          - `quantity` integer, required — The item quantity.
          - `sellerFulfillmentOrderItemId` string, required — A fulfillment order item identifier that the seller created with a call to the `createFulfillmentOrder` operation.
          - `estimatedShippingWeight` Weight — 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+)?$`.
          - `shippingWeightCalculationMethod` 'Package' | 'Dimensional' — The method used to calculate the estimated shipping weight.
      - `unfulfillablePreviewItems` UnfulfillablePreviewItem[] — An array of unfulfillable preview item information.
        - `sellerSku` string, required — The seller SKU of the item.
        - `quantity` integer, required — The item quantity.
        - `sellerFulfillmentOrderItemId` string, required — A fulfillment order item identifier created with a call to the `getFulfillmentPreview` operation.
        - `itemUnfulfillableReasons` string[] — String list
      - `orderUnfulfillableReasons` string[] — String list
      - `marketplaceId` string, required — The marketplace the fulfillment order is placed against.
      - `featureConstraints` FeatureSettings[] — A list of features and their fulfillment policies to apply to the order.
        - `featureName` string — The name of the feature. Valid feature names are: - `BLOCK_AMZL`: Blocks orders from being shipped using Amazon Logistics (AMZL). - Note: Using this feature will incur additional fee surcharges on MCF orders and may increase the risk of unfulfilled or delayed deliveries if alternative carriers are unavailable. Using `BLOCK_AMZL` in an order request will take precedence over your Seller Central account setting. - `BLANK_BOX`: Ships orders in non-Amazon branded packaging (blank boxes). - `OVERBOX`: Requires items to be shipped in an overbox rather than in their original product packaging. - `PACKING_SLIP`: Requires a packing slip to be included with the order. - `SIGNATURE_CONFIRMATION`: Requires a signature from the recipient upon delivery. - Note: Using signature confirmation features will incur additional fees on MCF orders and are currently supported only in the US marketplace.
        - `featureFulfillmentPolicy` 'Required' | 'NotRequired' — Specifies the policy to use when fulfilling an order.
  - `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/revisions/815a5b6dbaa6/schema)