The new Delivery Promise Suggestions API enables you to display real-time delivery promises and pickup options directly on product listing and detail pages, creating meaningful visual indicators for shoppers.

This API is in beta, and we are actively working to improve it. If you have any questions, please contact our Support.

The Delivery Promise Suggestions API provides four endpoints to help you gather and display delivery information:

Logistics Shipping:

• POST Search delivery zones: Retrieves available delivery zones based on location information (postal code, coordinates, and country).
• POST Search pickup points: For each product, retrieves the quickest delivery option and nearest pickup point, empowering merchants to display this information dynamically on store pages.

Delivery Promise Suggestions:

• POST Search delivery suggestions: Retrieves delivery and pickup suggestions for a batch of products (up to 20 products).
• GET Get delivery suggestions: Retrieves suggestions using query parameters, supporting caching and browser optimizations.

This API extends the Delivery Promise solution to headless storefronts, enabling you to:

• Display only products available for the shopper's location with valid shipping methods.
• Show customers the quickest and closest delivery and pickup options available for the storefront.
• Highlight the most relevant delivery and pickup options directly on the storefront.
• Provide accurate delivery time estimates using precomputed fulfillment contexts for better performance.
• Enhance the shopping experience with clear, contextual delivery promises.

If you manage a headless storefront and want to integrate delivery promise suggestions, follow the headless integration guide to implement the API endpoints.

For more information about Delivery Promise, see:

• Delivery Promise guide
• Setting up Delivery Promise components
• Delivery Promise for headless stores
• Delivery Promise FAQ