The Selling Partner API for Notifications provides an Amazon seller with a broad collection of near-real-time datasets. Unlike traditional reports that Openbridge will request, we receive data "pushed" directly from Amazon when a given event occurs.
Notifications offer one of the most comprehensive collections of account-level data available. Below are the primary categories of data provided.
Note: We also cover each dataset under the section "Detailed Dataset Definitions" further down in this document. Also, see the SPAPI docs for Notification API Event Types
Offer Changes Data
Any Offer Changed: Sent when there is a listing change for any of the top 20 offers, by condition (new or used), or if the external price (the price from other retailers) changes for an item listed by the seller.
B2B Any Offer Changed: Sent when there is a change in any of the top 20 B2B offers, in the form of any price change (either single unit or quantity discount tier prices) for an item listed by the seller.
Inventory Data
FBA Inventory Availability Changes: Sent when there is a change in the Fulfillment By Amazon (FBA) inventory quantities. This notification includes a snapshot of the FBA inventory in all eligible marketplaces in a particular region.
FBA Outbound Shipment Status: Sent when we create or cancel a Fulfillment by Amazon shipment for a seller.
Fees Data
Fee Promotion: Sent when a promotion becomes active.
Fulfillment Data
Fulfillment Order Status: Sent when there is a change in the status of a Multi-Channel Fulfillment order.
Orders Data
Order Change: Sent when there is an important change in the order. Important changes include order status changes and buyer requested cancellations. Note that marketplaceIds is not a supported filter for Order Change. If you want to include marketplaceIds, you must use Any Offer Changed.
Pricing Data
Pricing Health: Sent when a seller offer is ineligible to be the Featured Offer (Buy Box offer) because of an uncompetitive price.
Near-Real-Time Sales, Traffic, and Inventory Data
Detail Page Traffic Event: Sent at the beginning of every hour. This notification shares traffic data at an ASIN level and includes data for the previous hour, as well as any delayed data from up to 24 hours earlier. Each notification can include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour.
Item Inventory Event Change: Sent at the beginning of every hour. This notification shares inventory data at an ASIN level, and includes data for the previous hour, as well as any delayed data from up to 24 hours earlier. Each notification can include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour.
Item Sales Event Change: Sent at the beginning of every hour. This notification shares sales data at an ASIN level and includes data for the previous hour, as well as any delayed data from up to 24 hours earlier. Each notification can include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour.
Detailed Dataset Definitions
Any Offer Changed
Dataset: sp_nt_any_offer_changed_buy_box_prices
This dataset contains information about changes in the buy box prices for specific offers on Amazon. The buy box price is the lowest price that a customer can purchase the product for, often used for products with multiple sellers.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
condition (string): The condition of the item (e.g., "new", "used").
landed_price_amount (float): The total price including the listing price and any shipping charges.
landed_price_currency_code (string): The currency code for the landed price (e.g., "USD").
listing_price_amount (float): The price of the product without shipping.
listing_price_currency_code (string): The currency code for the listing price (e.g., "USD").
shipping_amount (float): The cost of shipping the product.
shipping_currency_code (string): The currency code for the shipping amount.
points_number (float, optional): The number of reward points available for the product, if applicable.
Dataset: sp_nt_any_offer_changed_eligible_offers
This dataset provides details about the number of eligible offers for a product based on specific conditions and fulfillment channels. Eligible offers are those that meet Amazon's requirements for being displayed to customers.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
condition (string): The condition of the item (e.g., "new", "used").
fulfillment_channel (string): The fulfillment method (e.g., "Merchant", "Amazon").
offer_count (int): The total number of eligible offers for the product in the given condition and fulfillment channel.
Dataset: sp_nt_any_offer_changed_lowest_prices
This dataset contains information on the lowest prices available for products based on specific conditions and fulfillment channels. It provides detailed pricing breakdowns, including listing prices, shipping charges, and reward points.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
condition (string): The condition of the item (e.g., "new", "used").
fulfillment_channel (string): The fulfillment method (e.g., "Merchant", "Amazon").
landed_price_amount (float): The total price, including shipping.
landed_price_currency_code (string): The currency code for the landed price.
listing_price_amount (float): The price of the product without shipping.
listing_price_currency_code (string): The currency code for the listing price.
shipping_amount (float): The cost of shipping the product.
shipping_currency_code (string): The currency code for the shipping amount.
points_number (float, optional): The number of reward points available, if applicable.
Dataset: sp_nt_any_offer_changed_number_of_offers
This dataset provides information on the total number of offers available for a product under specific conditions and fulfillment channels. It helps track the number of competing offers.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
condition (string): The condition of the item (e.g., "new", "used").
fulfillment_channel (string): The fulfillment method (e.g., "Merchant", "Amazon").
offer_count (int): The total number of offers available for the product in the given condition and fulfillment channel.
Dataset: sp_nt_any_offer_changed_offers
This dataset provides detailed information on individual offers for a product, including seller information, pricing, shipping details, and conditions. It captures comprehensive data for tracking the attributes of each offer.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
is_expedited_shipping_available (boolean): Whether expedited shipping is available for the offer.
is_featured_merchant (boolean): Whether the seller is a featured merchant.
is_fulfilled_by_amazon (boolean): Whether the offer is fulfilled by Amazon (FBA).
listing_price_amount (float): The price of the product excluding shipping.
listing_price_currency_code (string): The currency code for the listing price.
points_points_number (int): The number of reward points available, if applicable.
is_offer_prime (boolean): Whether the offer is eligible for Amazon Prime.
is_offer_national_prime (boolean): Whether the offer qualifies for national Prime benefits.
seller_feedback_rating_feedback_count (int): The total number of feedback ratings for the seller.
seller_feedback_rating_seller_positive_feedback_rating (int): The positive feedback rating percentage of the seller.
seller_id (int): A unique identifier for the seller.
shipping_amount (float): The cost of shipping the product.
shipping_currency_code (string): The currency code for the shipping cost.
shipping_time_availability_type (string): The type of shipping time availability (e.g., "available").
shipping_time_available_date (string): The date and time when the product will be available for shipping.
shipping_time_maximum_hours (int): The maximum number of hours for delivery.
shipping_time_minimum_hours (int): The minimum number of hours for delivery.
ships_domestically (boolean): Whether the product ships domestically.
ships_from_country (string): The country from which the product is shipped.
ships_from_state (string): The state from which the product is shipped.
ships_internationally (boolean): Whether the product ships internationally.
sub_condition (string): The sub-condition of the product (e.g., "New", "Used").
Dataset: sp_nt_any_offer_changed_sales_rankings
This dataset contains information about the sales rankings of products in specific categories. The sales ranking reflects how well a product is selling in comparison to others within the same category.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
product_category_id (int): The identifier of the product category.
rank (int): The sales rank of the product within the specified category.
Dataset: sp_nt_any_offer_changed.csv
This is the main dataset that tracks changes in offers for specific products on Amazon. It captures essential information about the conditions under which an offer change occurred, including the marketplace, ASIN, seller, and time of the change.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
offer_change_trigger_asin (int): The Amazon Standard Identification Number (ASIN) of the product that triggered the offer change.
offer_change_trigger_item_condition (string): The condition of the item that triggered the offer change (e.g., "New", "Used").
offer_change_trigger_marketplace_id (string): The ID of the marketplace where the offer change occurred.
offer_change_trigger_offer_change_type (string): The type of offer change that occurred (e.g., "New", "Deleted").
offer_change_trigger_time_of_offer_change (string): The date and time when the offer change occurred.
seller_id (string): The unique identifier of the seller involved in the offer change.
B2B Any Offer Changed
Dataset: sp_nt_b2b_any_offer_changed_buy_box_prices
This dataset tracks changes to buy box prices for business-to-business (B2B) offers. It includes details about the landed price, listing price, shipping charges, and associated currencies. The buy box price is a critical component in Amazon's pricing and offer competitiveness.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
condition (string): The condition of the product (e.g., "new").
landed_price_amount (float, optional): The total price the buyer will pay, including shipping.
landed_price_currency_code (string, optional): The currency code for the landed price.
listing_price_amount (float): The price of the product without shipping.
listing_price_currency_code (string): The currency code for the listing price.
shipping_amount (float, optional): The cost of shipping the product.
shipping_currency_code (string, optional): The currency code for the shipping cost.
points_number (float, optional): The number of reward points available, if applicable.
Dataset: sp_nt_b2b_any_offer_changed_lowest_prices
This dataset tracks changes to the lowest prices available for business-to-business (B2B) offers. It provides information about the lowest landed prices, listing prices, and shipping costs, as well as the fulfillment channels associated with these offers.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
condition (string): The condition of the product (e.g., "new").
fulfillment_channel (string): The fulfillment method used (e.g., "Merchant").
landed_price_amount (float, optional): The total price the buyer will pay, including shipping.
landed_price_currency_code (string, optional): The currency code for the landed price.
listing_price_amount (float): The price of the product before shipping.
listing_price_currency_code (string): The currency code for the listing price.
shipping_amount (float, optional): The cost of shipping the product.
shipping_currency_code (string, optional): The currency code for the shipping cost.
points_number (float, optional): The number of reward points available, if applicable.
Dataset: sp_nt_b2b_any_offer_changed_number_of_offers
This dataset tracks changes to the number of offers available for business-to-business (B2B) products. It provides information on the condition of the product and the fulfillment channel, along with the number of offers available in each category.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
condition (string): The condition of the product (e.g., "new").
fulfillment_channel (string): The method of fulfillment (e.g., "Merchant").
offer_count (int): The number of offers available in the given condition and fulfillment method.
Dataset: sp_nt_b2b_any_offer_changed_offers
This dataset provides detailed information about individual business-to-business (B2B) offers. It includes pricing, shipping details, seller feedback, fulfillment methods, and whether the offer qualifies for Prime or national Prime shipping.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
is_expedited_shipping_available (boolean, optional): Whether expedited shipping is available.
is_featured_merchant (boolean): Whether the seller is a featured merchant.
is_fulfilled_by_amazon (boolean): Whether the offer is fulfilled by Amazon (FBA).
listing_price_amount (float): The price of the product before shipping.
listing_price_currency_code (string): The currency code for the listing price.
points_points_number (float, optional): The number of reward points available, if applicable.
is_offer_prime (boolean, optional): Whether the offer is eligible for Amazon Prime.
is_offer_national_prime (boolean, optional): Whether the offer qualifies for national Prime shipping.
seller_feedback_rating_feedback_count (int): The number of feedback ratings for the seller.
seller_feedback_rating_seller_positive_feedback_rating (int): The positive feedback percentage for the seller.
seller_id (string): The unique identifier for the seller.
shipping_amount (float): The cost of shipping.
shipping_currency_code (string): The currency code for the shipping cost.
shipping_time_availability_type (string): The type of shipping time availability (e.g., "available").
shipping_time_available_date (string): The date when the product will be available for shipping.
shipping_time_maximum_hours (int): The maximum number of hours for delivery.
shipping_time_minimum_hours (int): The minimum number of hours for delivery.
ships_domestically (boolean, optional): Whether the product ships domestically.
ships_from_country (string): The country from which the product is shipped.
ships_from_state (string, optional): The state from which the product is shipped.
ships_internationally (boolean, optional): Whether the product ships internationally.
sub_condition (string): The sub-condition of the product (e.g., "new").
Dataset: sp_nt_b2b_any_offer_changed
This dataset tracks changes in offers for business-to-business (B2B) products on Amazon. It includes information on the ASIN, the condition of the item, the marketplace, and the seller responsible for the offer change.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
offer_change_trigger_asin (string): The Amazon Standard Identification Number (ASIN) of the product that triggered the offer change.
offer_change_trigger_item_condition (string): The condition of the item that triggered the offer change (e.g., "new").
offer_change_trigger_marketplace_id (string): The marketplace ID where the offer change occurred (e.g., "ATVPDKIKX0DER").
offer_change_trigger_offer_change_type (float, optional): The type of offer change (not available in this dataset sample).
offer_change_trigger_time_of_offer_change (string): The timestamp when the offer change occurred.
seller_id (string): The unique identifier for the seller responsible for the offer.
Listings
Dataset: sp_nt_listings_item_issues_change_enforcement_actions
This dataset provides information about enforcement actions taken on listings due to item issues. Enforcement actions, such as "SEARCH_SUPPRESSED," indicate that a listing has been suppressed from search results or has had other actions taken due to issues.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
ob_value (string): The type of enforcement action taken (e.g., "SEARCH_SUPPRESSED").
Dataset: sp_nt_listings_item_issues_change_severities
This dataset provides information about the severity of item issues that have occurred on listings. The severity indicates the level of urgency or impact (e.g., "ERROR" or "WARNING").
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
ob_value (string): The severity of the issue (e.g., "ERROR", "WARNING").
Dataset: sp_nt_listings_item_issues_change
This dataset tracks item issues on specific listings, identified by the ASIN, SKU, and marketplace. It provides information about sellers and the marketplace where the issue occurred.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
asin (string): The Amazon Standard Identification Number (ASIN) for the product.
marketplace_id (string): The marketplace where the issue occurred (e.g., "ATVPDKIKX0DER").
seller_id (string): The unique identifier for the seller associated with the product.
sku (string): The Stock Keeping Unit (SKU) of the product.
Dataset: sp_nt_listings_item_mfn_quantity_change
This dataset tracks changes in the Merchant Fulfilled Network (MFN) inventory quantities for specific items. It provides details on the fulfillment channel, the updated quantity, and the associated seller and SKU.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
fulfillment_channel_code (string): The fulfillment method (e.g., "DEFAULT" for Merchant Fulfilled Network).
quantity (int): The updated quantity of the item available for fulfillment.
seller_id (string): The unique identifier for the seller.
sku (string): The Stock Keeping Unit (SKU) of the product.
Dataset: sp_nt_listings_item_status_change_status
This dataset provides information about status changes for listings, indicating whether they are buyable or discoverable. The status reflects the availability of the product to customers.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
ob_value (string): The status of the listing (e.g., "BUYABLE", "DISCOVERABLE").
Dataset: sp_nt_listings_item_status_change
This dataset tracks status changes for specific listings. It records the ASIN, SKU, marketplace, and the date when the status change occurred. This dataset is used to track changes in the availability and visibility of products.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
asin (string): The Amazon Standard Identification Number (ASIN) for the product.
created_date (string): The date and time when the status change occurred.
marketplace_id (string): The marketplace where the product is listed (e.g., "ATVPDKIKX0DER").
seller_id (string): The unique identifier for the seller.
sku (string): The Stock Keeping Unit (SKU) of the product.
Pricing
Dataset: sp_nt_pricing_health_buy_box_offers
This dataset provides information about the number of offers competing for the buy box for a specific product. It tracks the condition of the product and the fulfillment method used by the sellers.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
condition (string): The condition of the product (e.g., "new", "used").
fulfillment_type (string): The fulfillment method (e.g., "MFN" for Merchant Fulfilled Network, "FBA" for Fulfilled by Amazon).
offer_count (int): The number of offers competing for the buy box.
Dataset: sp_nt_pricing_health_buy_box_prices
This dataset contains information about the prices competing for the buy box, including landed price, listing price, shipping charges, and any reward points associated with the product.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
condition (string): The condition of the product (e.g., "new", "used").
landed_price_amount (float): The total price the buyer will pay, including shipping.
landed_price_currency_code (string): The currency code for the landed price.
listing_price_amount (float): The price of the product before shipping.
listing_price_currency_code (string): The currency code for the listing price.
shipping_amount (float): The cost of shipping the product.
shipping_currency_code (string): The currency code for the shipping cost.
points_number (int): The number of reward points available for the product.
Dataset: sp_nt_pricing_health_number_of_offers
This dataset provides information about the total number of offers available for a product under specific conditions and fulfillment methods. It helps track how many offers are available for the product in a given condition (e.g., new, used).
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
condition (string): The condition of the product (e.g., "new", "used").
fulfillment_type (string): The fulfillment method (e.g., "MFN" for Merchant Fulfilled Network, "FBA" for Fulfilled by Amazon).
offer_count (int): The number of offers available for the product in the given condition and fulfillment type.
Dataset: sp_nt_pricing_health_sales_rankings
This dataset provides information about the sales rankings of products in specific categories. It tracks the position of the product within its category based on sales performance.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
product_category_id (string): The category of the product (e.g., "lawn_and_garden", "home_garden").
rank (int): The sales rank of the product within its category.
Dataset: sp_nt_pricing_health
This dataset provides detailed information about pricing health issues, including buy box disqualifications, reference pricing, and other pricing metrics. It captures data about the seller's offer, such as listing price, shipping cost, and conditions for the product.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
issue_type (string): The type of issue affecting the pricing health (e.g., "BuyBoxDisqualification").
merchant_offer_condition (string): The condition of the merchant's offer (e.g., "new", "used").
merchant_offer_fulfillment_type (string): The fulfillment method (e.g., "MFN" for Merchant Fulfilled Network).
merchant_offer_listing_price_amount (float): The listing price of the merchant's offer.
merchant_offer_listing_price_currency_code (string): The currency code for the listing price.
merchant_offer_shipping_amount (float): The shipping cost of the merchant's offer.
merchant_offer_shipping_currency_code (string): The currency code for the shipping cost.
merchant_offer_landed_price_amount (float): The total price (listing price + shipping) for the offer.
merchant_offer_landed_price_currency_code (string): The currency code for the landed price.
merchant_offer_points_number (int): The number of reward points available.
offer_change_trigger_asin (string): The ASIN for the product triggering the offer change.
offer_change_trigger_item_condition (string): The condition of the item that triggered the change.
offer_change_trigger_marketplace_id (string): The marketplace where the offer change occurred.
offer_change_trigger_time_of_offer_change (string): The time when the offer change occurred.
seller_id (string): The unique identifier for the seller.
reference_price_average_selling_price_amount (int): The average selling price for the reference price.
reference_price_average_selling_price_currency_code (string): The currency code for the average selling price.
reference_price_competitive_price_threshold_amount (int): The competitive price threshold.
reference_price_competitive_price_threshold_currency_code (string): The currency code for the competitive price threshold.
reference_price_msrp_price_amount (int): The Manufacturer's Suggested Retail Price (MSRP).
reference_price_msrp_price_currency_code (string): The currency code for the MSRP.
reference_price_retail_offer_price_amount (int): The retail offer price.
reference_price_retail_offer_price_currency_code (string): The currency code for the retail offer price.
Order Changes
Dataset: sp_nt_order_change_order_items
This dataset provides details on the items within an order that have changed, including quantity, shipment status, delivery dates, and whether the buyer has requested a cancellation.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
is_buyer_requested_cancel (boolean): Whether the buyer has requested to cancel the item.
item_earliest_delivery_date (string): The earliest possible delivery date for the item.
item_latest_delivery_date (string): The latest possible delivery date for the item.
order_item_id (string): A unique identifier for the order item.
order_item_status (string): The current status of the order item (e.g., "Unshipped").
quantity (int): The total quantity of the item ordered.
quantity_shipped (int): The quantity of the item that has been shipped so far.
seller_sku (string): The Stock Keeping Unit (SKU) assigned to the item by the seller.
supply_source_id (string): A unique identifier for the source of supply for the item.
Dataset: sp_nt_order_change_order_programs
This dataset tracks the specific programs under which an order falls, such as special business programs or promotions. These programs may influence order handling, pricing, or fulfillment.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
ob_value (string): The program under which the order falls (e.g., "Business").
Dataset: sp_nt_order_change_shipping_programs
This dataset provides information about the shipping programs associated with an order. Shipping programs, such as "EasyShip," define how the shipping is managed and may include special services or handling.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
ob_value (string): The shipping program used for the order (e.g., "EasyShip").
Dataset: sp_nt_order_change
This dataset captures detailed information about order changes, including the reason for the change, the type of order, fulfillment details, shipping and delivery dates, and status updates. It tracks changes at both the order level and the item level.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
amazon_order_id (string): The Amazon order ID associated with the change.
notification_level (string): The level at which the notification applies (e.g., "OrderLevel").
order_change_trigger_change_reason (string): The reason for the order change (e.g., "Buyer Requested Cancel").
order_change_trigger_time_of_order_change (string): The timestamp when the order change was triggered.
order_change_type (string): The type of change applied to the order (e.g., "BuyerRequestedChange").
seller_id (string): The unique identifier for the seller.
cancel_notify_date (string): The date when the cancellation notification was sent.
destination_postal_code (int): The postal code for the delivery address.
earliest_delivery_date (string): The earliest expected delivery date.
earliest_ship_date (string): The earliest expected shipment date.
easy_ship_shipment_status (string): The status of the EasyShip program, if applicable.
electronic_invoice_status (string): The status of the electronic invoice for the order.
fulfillment_type (string): The fulfillment method (e.g., "MFN" for Merchant Fulfilled Network).
latest_delivery_date (string): The latest expected delivery date.
latest_ship_date (string): The latest expected shipment date.
marketplace_id (string): The marketplace where the order was placed (e.g., "ATVPDKIKX0DER").
number_of_items_shipped (int): The number of items that have been shipped in the order.
number_of_items_unshipped (int): The number of items that remain unshipped in the order.
order_status (string): The current status of the order (e.g., "Unshipped").
order_type (string): The type of order (e.g., "StandardOrder").
purchase_date (string): The date when the order was placed.
Near Real-Time Sales, Inventory, and Traffic
Dataset: sp_nt_detail_page_traffic_event.csv
This dataset tracks traffic events for detail pages on Amazon, providing information about the number of views ("glance views") a product's detail page receives over a specified period.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
account_id (string): The unique identifier for the merchant's account.
asin (string): The Amazon Standard Identification Number (ASIN) for the product.
end_time (string): The end time of the traffic event measurement period.
glance_views (int): The number of "glance views" or page views received during the specified period.
marketplace_id (string): The marketplace where the traffic event occurred (e.g., "ATVPDKIKX0DER").
start_time (string): The start time of the traffic event measurement period.
Dataset: sp_nt_item_sales_event_change
This dataset captures changes in sales events for specific products. It includes information about ordered units, ordered revenue, and the time period during which the sales event occurred.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
account_id (string): The unique identifier for the merchant's account.
asin (string): The Amazon Standard Identification Number (ASIN) for the product.
currency_code (string): The currency used for the sales event (e.g., "USD").
end_time (string): The end time of the sales event measurement period.
marketplace_id (string): The marketplace where the sales event occurred (e.g., "ATVPDKIKX0DER").
ordered_revenue (float): The total revenue generated from orders during the specified period.
ordered_units (int): The number of units ordered during the specified period.
start_time (string): The start time of the sales event measurement period.
Dataset: sp_nt_item_inventory_event_change
This dataset tracks changes in the highly available inventory for specific products over a defined time period. It helps monitor inventory levels for items in a given marketplace.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
account_id (string): The unique identifier for the merchant's account.
asin (string): The Amazon Standard Identification Number (ASIN) for the product.
end_time (string): The end time of the inventory measurement period.
highly_available_inventory (int): The quantity of highly available inventory during the specified time period.
marketplace_id (string): The marketplace where the inventory event occurred (e.g., "ATVPDKIKX0DER").
start_time (string): The start time of the inventory measurement period.
Fees
Dataset: sp_nt_fee_promotion_information
This dataset provides detailed information about fee promotions, including fee discounts, estimated fees, and the details of various fee components such as final amounts, promotion values, and currency codes.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
fee_discount_type (string): The type of fee discount (e.g., "Percentage points off").
fee_discount_value (int): The value of the discount.
fees_estimate_time_of_fees_estimated (string): The timestamp when the fee estimate was calculated.
fees_estimate_total_fees_estimate_amount (int): The total estimated fee amount.
fees_estimate_total_fees_estimate_currency_code (string): The currency code for the estimated fee.
fees_estimate_fee_details_0_fee_amount_amount (int): The initial amount of the first fee detail.
fees_estimate_fee_details_0_fee_amount_currency_code (string): The currency code for the first fee detail.
fees_estimate_fee_details_0_fee_promotion_amount (float): The promotion amount applied to the first fee detail.
fees_estimate_fee_details_0_fee_promotion_currency_code (string): The currency code for the promotion amount on the first fee detail.
fees_estimate_fee_details_0_fee_type (string): The type of the first fee (e.g., "ReferralFee").
fees_estimate_fee_details_0_final_fee_amount (float): The final fee amount after applying the promotion for the first fee.
fees_estimate_fee_details_0_final_fee_currency_code (string): The currency code for the final fee of the first fee detail.
price_threshold_amount (int): The price threshold associated with the promotion.
price_threshold_currency_code (string): The currency code for the price threshold.
Dataset: sp_nt_fee_promotion_identifiers
This dataset provides information about various identifiers (such as ASINs or other product-related identifiers) associated with fee promotions. These identifiers help identify specific products or categories that the promotions apply to.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
identifier_type (string): The type of identifier (e.g., "ASIN").
identifier_values_0_identifier_value_friendly_name (int): A friendly name associated with the first identifier.
identifier_values_0_identifier_value_id (string): The ID for the first identifier.
identifier_values_1_identifier_value_friendly_name to identifier_values_4_identifier_value_friendly_name (optional): Friendly names for additional identifiers.
identifier_values_1_identifier_value_id to identifier_values_4_identifier_value_id (optional): IDs for additional identifiers.
Dataset: sp_nt_fee_promotion
This dataset captures information about fee promotions, including the type of promotion, its description, and the time range during which the promotion is valid. It helps track active promotions related to seller fees.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
fee_promotion_type (string): The type of fee promotion (e.g., "Pricing").
fee_promotion_type_description (string): A detailed description of the fee promotion (e.g., "To help you offer a lower price to customers...").
marketplace_id (string): The ID of the marketplace where the promotion applies.
merchant_id (string): The unique identifier for the merchant participating in the promotion.
promotion_active_time_range_effective_from_date (string): The start date when the promotion becomes active.
promotion_active_time_range_effective_through_date (string): The end date when the promotion expires.
Branded Content Change
Dataset: sp_nt_branded_item_content_change_attributes_changed
This dataset contains information about the specific attributes that have changed for branded items. The attributes could include item names, bullet points, product descriptions, or images.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
ob_value (string): The attribute that has changed (e.g., "bullet_point", "item_name", "product_description", "main_product_image_locator").
Dataset: sp_nt_branded_item_content_change
This dataset provides information about content changes to branded items on Amazon. It includes details about the marketplace, brand, and specific ASINs (Amazon Standard Identification Numbers) where content changes have occurred.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
marketplace_id (string): The marketplace where the content change occurred (e.g., "ATVPDKIKX0DER").
brand_name (string): The name of the brand associated with the item.
asin (string): The Amazon Standard Identification Number (ASIN) for the item whose content has changed.
Inventory
Dataset: sp_nt_fba_inventory_availability_changes_by_marketplace
This dataset tracks changes in FBA (Fulfillment by Amazon) inventory availability across different marketplaces. It provides details on various inventory states, such as fulfillable units, inbound shipments, reserved quantities, and unfulfillable units, for each product.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
fulfillable (int): The number of units that are available and fulfillable.
future_supply_buyable (int): The number of units that will be available for future purchase.
inbound_quantity_breakdown_receiving (int): The number of units currently being received into the warehouse.
inbound_quantity_breakdown_shipped (int): The number of units that have been shipped to the warehouse.
inbound_quantity_breakdown_working (int): The number of units being processed at the warehouse.
pending_customer_order_in_transit (int): The number of units in transit for customer orders.
researching (int): The number of units being researched for potential issues.
reserved_quantity_breakdown_pending_customer_order (int): The number of units reserved for pending customer orders.
reserved_quantity_breakdown_warehouse_processing (int): The number of units reserved for warehouse processing.
reserved_quantity_breakdown_warehouse_transfer (int): The number of units reserved for warehouse transfer.
unfulfillable (int): The number of units that are unfulfillable.
item_name (string): The name of the product.
marketplace_id (string): The identifier for the marketplace where the inventory status applies.
Dataset: sp_nt_fba_inventory_availability_changes
This dataset tracks general inventory availability changes for FBA (Fulfillment by Amazon) products. It captures key identifiers like ASIN, FNSKU, seller ID, and SKU, providing a basic view of which products have undergone inventory changes.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
asin (string): The Amazon Standard Identification Number (ASIN) for the product.
fnsku (string): The Fulfillment Network Stock Keeping Unit (FNSKU) identifier used by Amazon.
seller_id (string): The unique identifier for the seller.
sku (string): The Stock Keeping Unit (SKU) for the product, assigned by the seller.
Dataset: sp_nt_fba_outbound_shipment_status
This dataset tracks the status of FBA (Fulfillment by Amazon) outbound shipments. It includes information about shipment statuses, the related Amazon order ID, shipment ID, and seller details.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
amazon_order_id (string): The Amazon order ID associated with the shipment.
amazon_shipment_id (string): The unique ID assigned to the outbound shipment.
seller_id (string): The unique identifier for the seller.
shipment_status (string): The current status of the shipment (e.g., "Created").
Product Changes
Dataset: sp_nt_product_type_definitions_change
This dataset contains information about changes to product type definitions on Amazon. It captures details such as the account making the changes, the affected marketplace, and the version of the product type definition being updated.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
account_id (string): The unique identifier for the account associated with the product type change.
marketplace_id (string): The marketplace where the product type definition change occurred (e.g., "ATVPDKIKX0DER").
product_type_version (string): The updated version of the product type definition.
Dataset: sp_nt_product_type_definitions_change_new_product_types
This dataset provides information about new product types that have been defined or added to Amazon's catalog. These product types can be used to categorize items for more accurate product management and listings.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
ob_value (string): The new product type that has been defined (e.g., "LUGGAGE", "SHOES").
Fulfillment
Dataset: sp_nt_fulfillment_order_status_packages
This dataset contains information about the packages associated with a fulfillment order, including carrier details and tracking numbers. It helps track the progress of each package within a fulfillment order.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
carrier_code (string): The code for the shipping carrier handling the package (e.g., "HERMESIT").
package_number (int): The number assigned to the package within the fulfillment order.
tracking_number (string): The tracking number for the package, which can be used to track its shipping status.
Dataset: sp_nt_fulfillment_order_status
This dataset provides information about the status of fulfillment orders, including shipment details, estimated arrival times, and status updates. It helps track a fulfillment order's lifecycle from creation until completion.
Schema:
ob_notification_id (string): A unique identifier for the notification event.
ob_subscription_id (string): A unique identifier for the subscription tied to the notification.
event_type (string): The type of event that triggered the notification (e.g., "Shipment").
fulfillment_order_status (string): The current status of the fulfillment order (e.g., "Complete").
amazon_shipment_id (string): The ID assigned to the Amazon shipment.
estimated_arrival_date_time (string): The estimated arrival time for the shipment.
fulfillment_shipment_status (string): The current status of the shipment (e.g., "Shipped").
seller_fullfillment_order_id (float, optional): The fulfillment order ID assigned by the seller (may be null).
seller_id (string): The unique identifier for the seller.
status_updated_date_time (string): The timestamp when the fulfillment order status was last updated.