Create Delivery Previews

📘

Buy with Prime API is now available for early access

Sign up for early access to the Buy with Prime API using the 'Sign Up' button below. The API may change as Amazon receives feedback and iterates on it.

The Buy with Prime Delivery Preview interface enables you to display estimated delivery information to shoppers throughout their journey across product detail pages, the shopping cart, and checkout.

A delivery preview is a set of delivery options that include an estimated delivery date. To create a delivery preview, Amazon's fulfillment systems optimize combinations of requested products in requested quantities with the amount of inventory available across Amazon's fulfillment network.

Each delivery preview contains delivery groups, which are collections of items that will be packed and delivered together in a shipment, along with the delivery offers available for the group, which are delivery options such as delivery date range and messaging.

For delivery previews for authenticated shoppers who have provided a complete address, you can get the offer expiry. Offery expiry doesn't apply to unauthenticated shoppers. If a delivery offer expires, you can generate a new offer.

You provide the following delivery terms when you call the deliveryPreview query. The more precise shopper context you provide, the more accurate the result.

  • Location: The delivery location, allowing for granularity in options such as IP address, zip code, and shipping address.
  • Shopper identity: The shopper's identity token, which enables more personalized delivery offers based on their Amazon account information. You can use Login with Amazon (LWA) access tokens and Amazon Pay checkout session tokens.

The shopper typically sees a delivery preview as a message that appears with the Prime badge in purchase and checkout experiences.

Buy with Prime Delivery Preview

Buy with Prime Delivery Preview

For example requests and responses, see:

API operations

You use the following mutations, queries, and events to create delivery previews.

Mutations

None.

Queries

NameDescription
deliveryPreviewReturns the delivery offers for a list of items.
shopperBwPEligibilityReturns the Prime membership status for the shopper.

Events

None.

Where to start

To display a delivery preview, call the deliveryPreview query. For example requests and responses, see:

Related topics