v9

latestOpenAPI 3.0.1Apache License 2.0raw.githubusercontent.com2026-08-01994159.4 KB
fulfillmentOutbound
fulfillmentPreviews

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

Usage Plan:

Rate (requests per second)Burst
230

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were 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 see higher rate and burst values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

post/fulfillment/outbound/2026-07-04/previews

Headers

x-amzn-fulfillment-service-idstring

The identifier of the fulfillment service used for this operation.

Request body

channelstring

The sales channel for the fulfillment request.

excludeEstimatedFeesboolean

When true, excludes estimated fees from the preview response for latency optimization. Default: false.

includePaymentOnDeliveryboolean

When true, includes payment on delivery information in the preview response. Default: false.

Example request

{
  "channel": "SHOPIFY",
  "fulfillmentConfiguration": {
    "serviceLevel": {
      "serviceTiers": [
        "STANDARD"
      ]
    },
    "services": {
      "packaging": {
        "packagingOption": "UNBRANDED"
      },
      "additional": {}
    }
  },
  "origin": {
    "countryCode": "US"
  },
  "destination": {
    "deliveryAddress": {
      "name": "Shopper Name",
      "addressLine1": "1000 Winthrop Ave N",
      "city": "Seattle",
      "countryCode": "US",
      "postalCode": "98103",
      "stateOrRegion": "WA",
      "phone": "123-456-7890",
      "email": "shopper@email.com"
    }
  },
  "lineItems": [
    {
      "product": {
        "productIdentifier": {
          "amazonSku": "someSku"
        },
        "perUnitDeclaredValue": {
          "currencyCode": "USD",
          "amount": "3.00"
        }
      },
      "amount": {
        "unit": "EACHES",
        "value": "1.0"
      }
    }
  ],
  "excludeEstimatedFees": true
}

Response

Success.

Example response

{
  "plannedShipments": [
    {
      "estimatedShippingWeight": {
        "unit": "KG",
        "value": "2.0"
      },
      "items": [
        {
          "productIdentifier": {
            "amazonSku": "someSku"
          },
          "amount": {
            "unit": "EACHES",
            "value": "1.0"
          }
        }
      ],
      "offers": [
        {
          "fulfillmentConfiguration": {
            "serviceLevel": {
              "serviceTier": "STANDARD",
              "deliveryInterval": {
                "startTime": "2025-04-21T12:34:56Z",
                "endTime": "2025-04-22T12:34:56Z"
              }
            },
            "services": {
              "packaging": {
                "packagingOption": "UNBRANDED"
              },
              "delivery": {
                "paymentOnDelivery": "ENABLED"
              },
              "additional": {}
            }
          },
          "estimatedPrice": {
            "rollupPrices": [
              {
                "type": "MCFTransportationFee",
                "value": {
                  "currencyCode": "USD",
                  "amount": "4.25"
                }
              }
            ],
            "totalPrice": {
              "currencyCode": "USD",
              "amount": "4.25"
            }
          }
        }
      ]
    }
  ],
  "constraints": [
    {
      "message": "There is not enough quantity of item xyz.",
      "type": "ValidationError",
      "code": "ItemQuantityNotAvailable",
      "details": [
        {
          "type": "someType",
          "value": "someValue"
        }
      ]
    }
  ]
}
All 9 operations