Guides
My Account

Buy Box event

The Buy Box webhook sends a notification when the Buy Box winner changes, the Buy Box price changes, or when the price changes for any of the top five offers on an item. The top five offers are grouped by item condition and ranked by landed price, where landed price equals offer price plus shipping price. Sellers only receive these notifications for items where they currently have an active offer.

Event details

  • Event Type: BUY_BOX_CHANGED
  • Event Version: V1
  • Resource Name: PRICE

Response parameters

Source (object)

Metadata about the event notification

source (object) — Metadata about the event notification.
  • eventType (string) — Type of event for which the notification is generated.
  • eventTime (string) — Timestamp when the event occurred.
  • eventId (string) — Unique identifier of the event.
  • eventFilters (object) — Additional filters applicable to the event.

Payload (object)

Event details

partnerID partnerId (string) — Seller’s partner ID.
offer (object) — Offer information.
  • currentOffer (object) — Seller’s current offer details.
  • sellerName (string) — Name of the seller.
  • sellerOfferPrice (double) — Seller’s offer price for the item.
  • sellerShippingSpeed (string) — Seller’s shipping speed.
  • sellerShippingPrice (double) — Seller’s shipping price.
  • proSellerBadge (boolean) — Indicates whether the seller has a Pro Seller badge.
  • isWFS (boolean) — Indicates whether fulfillment method is WFS.
  • isSuppressed (boolean) — Indicates whether Buy Box suppression is enabled.
  • itemConditionName (string) — Condition of the item.
winningOffer (object) — Buy Box winning offer information.
  • sellerName (string) — Name of the Buy Box winning seller.
  • sellerOfferPrice (double) — Buy Box winning seller’s offer price.
  • sellerShippingSpeed (string) — Buy Box winning seller’s shipping speed.
  • sellerShippingPrice (double) — Buy Box winning seller’s shipping price.
  • proSellerBadge (boolean) — Indicates whether the winning seller has a Pro Seller badge.
  • isWFS (boolean) — Indicates whether the winning seller uses WFS.
  • isSuppressed (boolean) — Indicates whether Buy Box suppression applies.
  • itemConditionName (string) — Condition of the item.
offers (array) — Array of the top five offers for the item.
  • offers[].sellerName (string) — Name of the seller.
  • offers[].sellerOfferPrice (double) — Seller’s offer price.
  • offers[].sellerShippingSpeed (string) — Seller’s shipping speed.
  • offers[].sellerShippingPrice (double) — Seller’s shipping price.
  • offers[].proSellerBadge (boolean) — Indicates whether the seller has a Pro Seller badge.
  • offers[].isWFS (boolean) — Indicates whether fulfillment method is WFS.
  • offers[].isSuppressed (boolean) — Indicates whether Buy Box suppression is enabled.
  • offers[].itemConditionName (string) — Condition of the item.
priceDifference priceDifference (double) — Difference between the seller’s offer price and the Buy Box winning offer price.

Sample payload: Buy Box event

{ "source": { "eventType": "BUY_BOX_CHANGED", "eventFilters": {}, "eventTime": "2026-02-26T17:02:00.448Z", "eventId": "ddbb9000-1334-11f1-8348-ade50743062f" }, "payload": { "partnerId": "11234567890", "itemInfo": { "itemId": "543208714", "itemName": "Bump Patrol Sensitive Formula Aftershave Razor Burn Treatment (2 oz) 2 Pack", "category": "Beauty, Personal Care, & Hygiene", "productType": "Aftershave Treatments", "brand": "Bump Patrol", "sku": "2209-2", "totalNumberOffers": 2 }, "offer": { "currentOffer": { "sellerName": "Seller name", "sellerOfferPrice": 12.09, "sellerShippingSpeed": "STANDARD", "sellerShippingPrice": 6.99, "isSuppressed": false, "proSellerBadge": false, "isWFS": false, "itemConditionName": "New" }, "winningOffer": { "sellerName": "Seller name", "sellerOfferPrice": 12.09, "sellerShippingSpeed": "STANDARD", "sellerShippingPrice": 6.99, "isSuppressed": false, "proSellerBadge": false, "isWFS": false, "itemConditionName": "New" }, "offers": [ { "sellerName": "Seller name", "sellerOfferPrice": 12.09, "sellerShippingSpeed": "STANDARD", "sellerShippingPrice": 6.99, "isSuppressed": false, "proSellerBadge": false, "isWFS": false, "itemConditionName": "New" }, { "sellerName": "Seller name", "sellerOfferPrice": 23.43, "sellerShippingSpeed": "STANDARD", "sellerShippingPrice": 6.99, "isSuppressed": false, "proSellerBadge": true, "isWFS": true, "itemConditionName": "New" } ], "priceDifference": 0 } }
}

Updated 1 day ago