Get dynamic delivery offers

Learn how to get dynamic delivery offers for a buyable product using a US ZIP Code or US IP address.

Prerequisites

To complete this tutorial, you need:

• Authorization from the selling partner for whom you are making calls. Refer to Authorizing Selling Partner API Applications for more information.
• The Amazon Fulfillment role assigned to your developer profile.
• The Amazon Fulfillment role selected in the App registration page for your application.

Get a dynamic delivery offer

Call getOffers. Use fulfillmentConfiguration.serviceLevel.serviceTiers to filter which service tiers to return. Supply either destination.ipAddress (approximate location) or destination.deliveryAddress with countryCode and postalCode for postal-code-level resolution.

The response contains one offerResult per item. Each result includes an offers array with available tiers and their deliveryInterval (earliest and latest delivery dates) and expiryTime. Items that cannot be delivered at a requested tier return an empty offers array and a constraints array explaining why (for example, DeliverySLAUnavailable, ItemQuantityNotAvailable).