Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation
Amazon MWS Documentation

ReportType enumeration

An enumeration of the types of reports that can be requested from Amazon MWS.

Description

The ReportType enumeration is used by operations in the Reports API section to indicate a particular report. For example, the RequestReport operation uses the ReportType value to indicate the type of report requested.

The following report categories are supported:

ReportType enumeration by report category

The following tables show the report title, enumeration value, and description of the report. Note that the enumeration value may be broken into two lines for readability, but when you use the value as a string, there should be no spaces or hyphens in the value.

In the report Description, note that Seller Central refers to sellers who have registered to sell on Amazon in the past few years; Marketplace refers to legacy sellers who registered to sell on Amazon prior to the last few years. Some reports are only available for Marketplace or Seller Central sellers.

Listings Reports

Report Description
Open Listings Report ("Inventory Report")

Enumeration value: _GET_FLAT_FILE_OPEN_LISTINGS_DATA_

API operation: RequestReport

Tab-delimited flat file open listings report that contains the SKU, ASIN, Price, and Quantity fields. For Marketplace and Seller Central sellers.
Open Listings Report

Enumeration value: _GET_MERCHANT_LISTINGS_DATA_BACK_COMPAT_

API operation: RequestReport

Tab-delimited flat file open listings report.
Merchant Listings Report ("Active Listings Report")

Enumeration value: _GET_MERCHANT_LISTINGS_DATA_

API operation: RequestReport

Tab-delimited flat file detailed active listings report. For Marketplace and Seller Central sellers.
Merchant Listings Lite Report ("Open Listings Lite Report")

Enumeration value: _GET_MERCHANT_LISTINGS_DATA_LITE_

API operation: RequestReport

Tab-delimited flat file active listings report that contains only the SKU, ASIN, Price, and Quantity fields for items that have a quantity greater than zero. For Marketplace and Seller Central sellers.
Merchant Listings Liter Report ("Open Listings Liter Report")

Enumeration value: _GET_MERCHANT_LISTINGS_DATA_LITER_

API operation: RequestReport

Tab-delimited flat file active listings report that contains only the SKU and Quantity fields for items that have a quantity greater than zero. For Marketplace and Seller Central sellers.
Sold Listings Report

Enumeration value: _GET_CONVERGED_FLAT_FILE_SOLD_LISTINGS_DATA_

API operation: RequestReport

Tab-delimited flat file sold listings report that contains items sold on Amazon's retail website. For Marketplace and Seller Central sellers.
Canceled Listings Report

Enumeration value: _GET_MERCHANT_CANCELLED_LISTINGS_DATA_

API operation: RequestReport

Tab-delimited flat file canceled listings report. For Marketplace and Seller Central sellers.
Quality Listing Report ("Listing Quality and Suppressed Listing Report")

Enumeration value: _GET_MERCHANT_LISTINGS_DEFECT_DATA_

API operation: RequestReport

Tab-delimited flat file quality listing report that contains the following fields: sku, product-name, asin, field-name, alert-type, current-value, last-updated, alert-name, and status. For Marketplace and Seller Central sellers.

Order Reports

Note that the date range that you specify when requesting an order report indicates when the orders became eligible for fulfillment (no longer in a "pending" state), not when the orders were created.

Report Description
Unshipped Orders Report

Enumeration value: _GET_FLAT_FILE_ACTIONABLE_ORDER_DATA_

API operation: RequestReport

API operation: ManageReportSchedule

Tab-delimited flat file report that contains only orders that are not confirmed as shipped. Can be requested or scheduled. For Marketplace and Seller Central sellers.
This report accepts the following ReportOptions values:
  • ShowSalesChannel – A Boolean value that indicates whether an additional column is added to the report that shows the sales channel. Default: false. URL-encoded example: ReportOptions=ShowSalesChannel%3Dtrue
Scheduled XML Order Report

Enumeration value: _GET_ORDERS_DATA_

API operation: ManageReportSchedule

Scheduled XML order report. For Seller Central sellers only.

You can only schedule one _GET_ORDERS_DATA_ or _GET_FLAT_FILE_ORDERS_DATA_ report at a time. If you have one of these reports scheduled and you schedule a new report, the existing report will be canceled.

Requested or Scheduled Flat File Order Report

Enumeration value: _GET_FLAT_FILE_ORDERS_DATA_

API operation: RequestReport

API operation: ManageReportSchedule

Tab-delimited flat file order report that can be requested or scheduled. The report shows orders from the previous 60 days. For Marketplace and Seller Central sellers.

Seller Central sellers can only schedule one _GET_ORDERS_DATA_ or _GET_FLAT_FILE_ORDERS_DATA_ report at a time. If you have one of these reports scheduled and you schedule a new report, the existing report will be canceled.

Marketplace sellers can only schedule one _GET_FLAT_FILE_ORDERS_DATA_ or _GET_CONVERGED_FLAT_FILE_ORDER_REPORT_DATA_ report at a time. If you have one of these reports scheduled and you schedule a new report, the existing report will be canceled.

Note: The format of this report will differ slightly depending on whether it is scheduled or requested.
This report accepts the following ReportOptions values:
  • ShowSalesChannel – A Boolean value that indicates whether an additional column is added to the report that shows the sales channel. Default: false. URL-encoded example: ReportOptions=ShowSalesChannel%3Dtrue
Flat File Order Report

Enumeration value: _GET_CONVERGED_FLAT_FILE_ORDER_REPORT_DATA_

API operation: RequestReport

API operation: ManageReportSchedule

Tab-delimited flat file order report that can be requested or scheduled. For Marketplace sellers only.

You can only schedule one _GET_FLAT_FILE_ORDERS_DATA_ or _GET_CONVERGED_FLAT_FILE_ORDER_REPORT_DATA_ report at a time. If you have one of these reports scheduled and you schedule a new report, the existing report will be canceled.

Note: The format of this report will differ slightly depending on whether it is scheduled or requested. For example, the format for the dates will differ, and the ship-method column is only returned when the report is requested.
This report accepts the following ReportOptions values:
  • ShowSalesChannel – A Boolean value that indicates whether an additional column is added to the report that shows the sales channel. Default: false. URL-encoded example: ReportOptions=ShowSalesChannel%3Dtrue

Order Tracking Reports

These order tracking reports are available in North America (NA) and Europe (EU), and can be used by all Amazon sellers. These reports return all orders, regardless of fulfillment channel or shipment status. These reports are intended for order tracking, not to drive your fulfillment process, as the reports do not include customer-identifying information and scheduling is not supported. Also note that for MFN orders, item price is not shown for orders in a "pending" state.

Report Description
Flat File Orders By Last Update Report

Enumeration value: _GET_FLAT_FILE_ALL_ORDERS_DATA_BY_LAST_UPDATE_

API operation: RequestReport

Tab-delimited flat file report that shows all orders updated in the specified period. Cannot be scheduled. For all sellers.
Flat File Orders By Order Date Report

Enumeration value: _GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_

API operation: RequestReport

Tab-delimited flat file report that shows all orders that were placed in the specified period. Cannot be scheduled. For all sellers.
XML Orders By Last Update Report

Enumeration value: _GET_XML_ALL_ORDERS_DATA_BY_LAST_UPDATE_

API operation: RequestReport

XML report that shows all orders updated in the specified period. Cannot be scheduled. For all sellers.
XML Orders By Order Date Report

Enumeration value: _GET_XML_ALL_ORDERS_DATA_BY_ORDER_DATE_

API operation: RequestReport

XML report that shows all orders that were placed in the specified period. Cannot be scheduled. For all sellers.

Pending Order Reports

These pending order reports are available in Japan and China. These reports can be both scheduled and requested where noted.

Report Description
Flat File Pending Orders Report

Enumeration value: _GET_FLAT_FILE_PENDING_ORDERS_DATA_

API operation: ManageReportSchedule

API operation: RequestReport

Tab-delimited flat file report that can be requested or scheduled that shows all pending orders. For all sellers.
XML Pending Orders Report

Enumeration value: _GET_PENDING_ORDERS_DATA_

API operation: ManageReportSchedule

API operation: RequestReport

XML report that can be requested or scheduled that shows all pending orders. Can only be scheduled using Amazon MWS.
Converged Flat File Pending Orders Report

Enumeration value: _GET_CONVERGED_FLAT_FILE_PENDING_ORDERS_DATA_

API operation: ManageReportSchedule

API operation: RequestReport

Flat file report that can be requested or scheduled that shows all pending orders. For Marketplace sellers.

Performance Reports

Report Description
Flat File Feedback Report

Enumeration value: _GET_SELLER_FEEDBACK_DATA_

API operation: RequestReport

Tab-delimited flat file that returns negative and neutral feedback (one to three stars) from buyers who rated your seller performance. For all sellers.

Settlement Reports

Note that settlement reports cannot be requested or scheduled. They are automatically scheduled by Amazon.

Report Description
Flat File Settlement Report

Enumeration value: _GET_FLAT_FILE_PAYMENT_SETTLEMENT_DATA_

API operation: GetReportList

API operation: GetReport

Tab-delimited flat file settlement report that is automatically scheduled by Amazon; it cannot be requested through RequestReport. For all sellers.
XML Settlement Report

Enumeration value: _GET_PAYMENT_SETTLEMENT_DATA_

API operation: GetReportList

API operation: GetReport

XML file settlement report that is automatically scheduled by Amazon; it cannot be requested through RequestReport. For Seller Central sellers only.
Flat File V2 Settlement Report

Enumeration value: _GET_ALT_FLAT_FILE_PAYMENT_SETTLEMENT_DATA_

API operation: GetReportList

API operation: GetReport

Tab-delimited flat file alternate version of the Flat File Settlement Report. Price columns are condensed into three general purpose columns: amounttype, amountdescription, and amount. This report is automatically scheduled by Amazon for FBA sellers; it cannot be requested through RequestReport. For Seller Central sellers only.

Fulfillment By Amazon (FBA) Reports

There are limits to how often Amazon will generate FBA reports. These limits depend on whether an FBA report is a near real-time report or a daily report. See the following table to see which FBA reports are near real-time and which are daily.

A near real-time FBA report is generated no more than once every 30 minutes. This means that after a near real-time FBA report is generated following your report request, a 30-minute waiting period must pass before Amazon will generate an updated version of that report. Note that the four "All Orders" reports are not subject to this limitation.

A daily FBA report is generated no more than once every four hours. This means that after a daily FBA report is generated following your report request, a four-hour waiting period must pass before Amazon will generate an updated version of that report.

For more information, see the "Do not request FBA reports more frequently than they are generated" section of the MWS for FBA Sellers Guide.

Report Description
FBA Sales Reports
FBA Amazon Fulfilled Shipments Report

Enumeration value: _GET_AMAZON_FULFILLED_SHIPMENTS_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains detailed order/shipment/item information including price, address, and tracking data. You can request up to one month of data in a single report. Content updated near real-time in Japan and North America (NA). Elsewhere, content updated daily. For FBA sellers only. For Marketplace and Seller Central sellers.
Note: In Japan and NA, in most cases, there will be a delay of approximately one to three hours from the time a fulfillment order ships and the time the items in the fulfillment order appear in the report. In some rare cases there could be a delay of up to 24 hours.
Flat File All Orders Report by Last Update

Enumeration value: _GET_FLAT_FILE_ALL_ORDERS_DATA_BY_LAST_UPDATE_

API operation: RequestReport

Tab-delimited flat file. Returns all orders updated in the specified date range regardless of fulfillment channel or shipment status. This report is intended for order tracking, not to drive your fulfillment process; it does not include customer identifying information and scheduling is not supported. For all sellers.
Flat File All Orders Report by Order Date

Enumeration value: _GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_

API operation: RequestReport

Tab-delimited flat file. Returns all orders placed in the specified date range regardless of fulfillment channel or shipment status. This report is intended for order tracking, not to drive your fulfillment process; it does not include customer identifying information and scheduling is not supported. For all sellers.
XML All Orders Report by Last Update

Enumeration value: _GET_XML_ALL_ORDERS_DATA_BY_LAST_UPDATE_

API operation: RequestReport

XML file order report that returns all orders updated in the specified date range regardless of fulfillment channel or shipment status. This report is intended for order tracking, not to drive your fulfillment process; it does not include customer identifying information and scheduling is not supported. For all sellers.
XML All Orders Report by Order Date

Enumeration value: _GET_XML_ALL_ORDERS_DATA_BY_ORDER_DATE_

API operation: RequestReport

XML file order report that returns all orders placed in the specified date range regardless of fulfillment channel or shipment status. This report is intended for order tracking, not to drive your fulfillment process; it does not include customer identifying information and scheduling is not supported. For all sellers.
FBA Customer Shipment Sales Report

Enumeration value: _GET_FBA_FULFILLMENT_CUSTOMER_SHIPMENT_SALES_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains condensed item level data on shipped FBA customer orders including price, quantity, and ship to location. Content updated near real-time in Japan and North America (NA). Elsewhere, content updated daily. For FBA sellers only. For Marketplace and Seller Central sellers.
Note: In Japan and NA, in most cases, there will be a delay of approximately one to three hours from the time a fulfillment order ships and the time the items in the fulfillment order appear in the report. In some rare cases there could be a delay of up to 24 hours.
FBA Promotions Report

Enumeration value: _GET_FBA_FULFILLMENT_CUSTOMER_SHIPMENT_PROMOTION_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains promotions applied to FBA customer orders sold through Amazon; e.g. Super Saver Shipping. Content updated daily. For FBA sellers only. For Marketplace and Seller Central sellers.
FBA Customer Taxes

Enumeration value: _GET_FBA_FULFILLMENT_CUSTOMER_TAXES_DATA_

API operation: RequestReport

Tab-delimited flat file for tax-enabled US sellers. This report contains data through February 28, 2013. All new transaction data can be found in the Sales Tax Report. For FBA sellers only. For Marketplace and Seller Central sellers.
FBA Inventory Reports
FBA Amazon Fulfilled Inventory Report

Enumeration value: _GET_AFN_INVENTORY_DATA_

API operation: RequestReport

Tab-delimited flat file. Content updated in near real-time. For FBA sellers only. For Marketplace and Seller Central sellers.
FBA Daily Inventory History Report

Enumeration value: _GET_FBA_FULFILLMENT_CURRENT_INVENTORY_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains historical daily snapshots of your available inventory in Amazon’s fulfillment centers including quantity, location and disposition. Content updated daily. For FBA sellers only. For Marketplace and Seller Central sellers.
FBA Monthly Inventory History Report

Enumeration value: _GET_FBA_FULFILLMENT_MONTHLY_INVENTORY_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains historical monthly snapshots of your available inventory in Amazon’s fulfillment centers including average and end-of-month quantity, location and disposition. Content updated daily. For FBA sellers only. For Marketplace and Seller Central sellers.
FBA Received Inventory Report

Enumeration value: _GET_FBA_FULFILLMENT_INVENTORY_RECEIPTS_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains inventory that has completed the receive process at Amazon’s fulfillment centers. Content updated daily. For FBA sellers only. For Marketplace and Seller Central sellers.
FBA Inventory Event Detail Report

Enumeration value: _GET_FBA_FULFILLMENT_INVENTORY_SUMMARY_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains history of inventory events (e.g. receipts, shipments, adjustments etc.) by SKU and Fulfillment Center. Content updated daily. For FBA sellers only. For Marketplace and Seller Central sellers.
FBA Inventory Adjustments Report

Enumeration value: _GET_FBA_FULFILLMENT_INVENTORY_ADJUSTMENTS_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains corrections and updates to your inventory in response to issues such as damage, loss, receiving discrepancies, etc. Content updated daily. For FBA sellers only. For Marketplace and Seller Central sellers.
FBA Inventory Health Report

Enumeration value: _GET_FBA_FULFILLMENT_INVENTORY_HEALTH_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains information about inventory age, condition, sales volume, weeks of cover, and price. Content updated daily. For FBA Sellers only. For Marketplace and Seller Central sellers.
FBA Manage Inventory

Enumeration value: _GET_FBA_MYI_UNSUPPRESSED_INVENTORY_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains current details of active (not archived) inventory including condition, quantity and volume. Content updated in near real-time. For FBA sellers only. For Marketplace and Seller Central sellers.
FBA Manage Inventory - Archived

Enumeration value: _GET_FBA_MYI_ALL_INVENTORY_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains current details of all (including archived) inventory including condition, quantity and volume. Content updated in near real-time. For FBA sellers only. For Marketplace and Seller Central sellers.
FBA Cross-Border Inventory Movement Report

Enumeration value: _GET_FBA_FULFILLMENT_CROSS_BORDER_INVENTORY_MOVEMENT_DATA_

API operation: RequestReport

Tab delimited flat file. Contains historical data of shipments that crossed country borders. These could be export shipments or shipments using Amazon's European Fulfillment Network (note that Amazon's European Fulfillment Network is for Seller Central sellers only). Content updated daily. For Marketplace and Seller Central sellers.
FBA Inbound Performance Report

Enumeration value: _GET_FBA_FULFILLMENT_INBOUND_NONCOMPLIANCE_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains inbound shipment problems by product and shipment. Content updated daily. For FBA sellers only. For Marketplace and Seller Central.
FBA Hazmat Status Change Report

Enumeration value: _GET_FBA_HAZMAT_STATUS_CHANGE_DATA_

API operation: RequestReport

Tab-delimited flat file. Indicates the current hazmat status of items in your inventory, which determines whether or not an item can be shipped to an Amazon fulfillment center. Content updated daily. For FBA sellers in NA only. For Marketplace and Seller Central sellers.
FBA Payments Reports
FBA Fee Preview Report

Enumeration value: _GET_FBA_ESTIMATED_FBA_FEES_TXT_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains the estimated Amazon Selling and Fulfillment Fees for your current FBA inventory. The data in the report may be up to 72 hours old. Content updated daily. For FBA sellers in the US and EU only. For Marketplace and Seller Central sellers.
FBA Reimbursements Report

Enumeration value: _GET_FBA_REIMBURSEMENTS_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains itemized details of your inventory reimbursements including the reason for the reimbursement. Content updated daily. For FBA sellers only. For Marketplace and Seller Central sellers.
FBA Customer Concessions Reports
FBA Returns Report

Enumeration value: _GET_FBA_FULFILLMENT_CUSTOMER_RETURNS_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains customer returned items received at an Amazon fulfillment center, including Return Reason and Disposition. Content updated daily. For FBA sellers only. For Marketplace and Seller Central sellers.
FBA Replacements Report

Enumeration value: _GET_FBA_FULFILLMENT_CUSTOMER_SHIPMENT_REPLACEMENT_DATA_

API operation: RequestReport

Tab-delimited flat file. Contains replacements that have been issued to customers for completed orders. Content updated daily. For FBA sellers only. For Marketplace and Seller Central sellers.
FBA Removals Reports
FBA Recommended Removal Report

Enumeration value: _GET_FBA_RECOMMENDED_REMOVAL_DATA_

API operation: RequestReport

Tab-delimited flat file. The report identifies sellable items that will be 365 days or older during the next Long-Term Storage cleanup event, if the report is generated within six weeks of the cleanup event date. The report includes both sellable and unsellable items. Content updated daily. For FBA sellers. For Marketplace and Seller Central sellers.
FBA Removal Order Detail Report

Enumeration value: _GET_FBA_FULFILLMENT_REMOVAL_ORDER_DETAIL_DATA_

API operation: RequestReport

Tab-delimited flat file. This report contains all the removal orders, including the items in each removal order, placed during any given time period. This can be used to help reconcile the total number of items requested to be removed from an Amazon fulfillment center with the actual number of items removed along with the status of each item in the removal order. Content updated in near real-time. For FBA sellers. For Marketplace and Seller Central sellers.
FBA Removal Shipment Detail Report

Enumeration value: _GET_FBA_FULFILLMENT_REMOVAL_SHIPMENT_DETAIL_DATA_

API operation: RequestReport

Tab-delimited flat file. This report provides shipment tracking information for all removal orders and includes the items that have been removed from an Amazon fulfillment center for either a single removal order or for a date range. This report will not include canceled returns or disposed items; it is only for shipment information. Content updated in near real-time. For FBA sellers. For Marketplace and Seller Central sellers.

Amazon Product Ads Reports

Report Description
Product Ads Listings Report

Enumeration value: _GET_NEMO_MERCHANT_LISTINGS_DATA_

API operation: RequestReport

Tab-delimited flat file detailed active listings report. For Amazon Product Ads sellers only.
Product Ads Daily Performance by SKU Report, flat file

Enumeration value: _GET_PADS_PRODUCT_PERFORMANCE_OVER_TIME_DAILY_DATA_TSV_

API operation: ManageReportSchedule

API operation: RequestReport

Currently available only in the U.S. Tab-delimited flat file containing impression and click counts for every SKU that received traffic. SKUs not seen by customers are not shown. This can result in a blank report if no SKUs received traffic for the specified day.
Note: Requesting more than one day of reports will return results for only the StartDate parameter. The EndDate parameter is ignored for this report.

Reports are available by 4am (Pacific Time) the following day and can be requested for dates within the last 90 days. For Amazon Product Ads sellers only.

Product Ads Daily Performance by SKU Report, XML

Enumeration value: _GET_PADS_PRODUCT_PERFORMANCE_OVER_TIME_DAILY_DATA_XML_

API operation: ManageReportSchedule

API operation: RequestReport

Currently available only in the U.S. XML file containing impression and click counts for every SKU that received traffic. SKUs not seen by customers are not shown. This can result in a blank report if no SKUs received traffic for the specified day.
Note: Requesting more than one day of reports will return results for only the StartDate parameter. The EndDate parameter is ignored for this report.

Reports are available by 4am (Pacific Time) the following day and can be requested for dates within the last 90 days. For Amazon Product Ads sellers only.

Product Ads Weekly Performance by SKU Report, flat file

Enumeration value: _GET_PADS_PRODUCT_PERFORMANCE_OVER_TIME_WEEKLY_DATA_TSV_

API operation: ManageReportSchedule

API operation: RequestReport

Currently available only in the U.S. Tab delimited flat file containing impression and click counts for every SKU that received traffic. SKUs not seen by customers are not shown. This can result in a blank report if no SKUs received traffic for the specified week.
Note: The weekly reports run from Sunday to Saturday. Requesting more than one week of reports will return results for only the first week specified. The StartDate parameter must be a Sunday or the operation will return an empty report. Therefore, it is necessary to set the optional StartDate parameter if the report is requested on any day of the week other than Sunday, because the StartDate parameter defaults to the current date.

Reports are available by 4am (Pacific Time) the following Monday and can be requested for dates within the last 90 days. For Amazon Product Ads sellers only.

Product Ads Weekly Performance by SKU Report, XML

Enumeration value: _GET_PADS_PRODUCT_PERFORMANCE_OVER_TIME_WEEKLY_DATA_XML_

API operation: ManageReportSchedule

API operation: RequestReport

Currently available only in the U.S. XML file containing impression and click counts for every SKU that received traffic. SKUs not seen by customers are not shown. This can result in a blank report if no SKUs received traffic for the specified week.
Note: The weekly reports run from Sunday to Saturday. Requesting more than one week of reports will return results for only the first week specified. The StartDate parameter must be a Sunday or the operation will return an empty report. Therefore, it is necessary to set the optional StartDate parameter if the report is requested on any day of the week other than Sunday, because the StartDate parameter defaults to the current date.

Reports are available by 4am (Pacific Time) the following Monday and can be requested for dates within the last 90 days. For Amazon Product Ads sellers only.

Product Ads Monthly Performance by SKU Report, flat file

Enumeration value: _GET_PADS_PRODUCT_PERFORMANCE_OVER_TIME_MONTHLY_DATA_TSV_

API operation: ManageReportSchedule

API operation: RequestReport

Currently available only in the U.S. Tab-delimited flat file containing impression and click counts for every SKU that received traffic. SKUs not seen by customers are not shown. This can result in a blank report if no SKUs received traffic for the specified month. The monthly reports run from the 1st day of the month to the last.
Note: The monthly reports run from the first day of the month to the last. Requesting more than one month of reports will return results for only the first month specified. The StartDate parameter must be the first day of the month or the operation will return an empty report. Therefore, it is necessary to set the optional StartDate parameter if the report is requested on any day of the month other than the first day, because the StartDate parameter defaults to the current date.

Reports are available by 4am (Pacific Time) on the 5th day of the following month and can be requested for dates within the last 90 days. For Amazon Product Ads sellers only.

Product Ads Monthly Performance by SKU Report, XML

Enumeration value: _GET_PADS_PRODUCT_PERFORMANCE_OVER_TIME_MONTHLY_DATA_XML_

API operation: ManageReportSchedule

API operation: RequestReport

Currently available only in the U.S. XML flat file containing impression and click counts for every SKU that received traffic. SKUs not seen by customers are not shown. This can result in a blank report if no SKUs received traffic for the specified month.
Note: The monthly reports run from the first day of the month to the last. Requesting more than one month of reports will return results for only the first month specified. The StartDate parameter must be the first day of the month or the operation will return an empty report. Therefore, it is necessary to set the optional StartDate parameter if the report is requested on any day of the month other than the first day, because the StartDate parameter defaults to the current date.

Reports are available by 4am (Pacific Time) on the 5th day of the following month and can be requested for dates within the last 90 days. For Amazon Product Ads sellers only.

Sales Tax Reports

Report Description
Sales Tax Report

Enumeration value: _GET_FLAT_FILE_SALES_TAX_DATA_

API operation: GetReportList

API operation: GetReport

Tab-delimited flat file for tax-enabled US sellers. Content updated daily. This report cannot be requested or scheduled. You must generate the report from the Tax Document Library in Seller Central. After the report has been generated, you can download the report using the GetReportList and GetReport operations. For Marketplace and Seller Central sellers.

Amazon Webstore Reports

Report Description
Webstore Product Catalog Report

Enumeration value: _GET_WEBSTORE_PRODUCT_CATALOG_

API operation: RequestReport

Tab-delimited flat file report that contains your product catalog data in your preferred format which you can use to upload to the comparison shopping engine of your choice.

This report requires the following ReportOptions value:

  • format - Indicates your preferred format for receiving your product catalog data.

    URL-encoded example: ReportOptions=format%3DproductAds

    format values:

    • productAds - The Amazon Product Ads Feed includes all products in your inventory, including out-of-stock products. You can request this report even if your site is not enabled for Amazon Product Ads. You can also request this report if your site is not launched. If you have multiple marketplaces, you can use the MarketplaceIdList request parameter to specify the product feeds that you want. Currently, the report does not return all data fields for this format.
    • comparisonshoppingenginefeed - The Comparison Shopping Engine Feed includes all in-stock products in your inventory. You can use this report to upload your product catalog to comparison shopping engines of your choice. You can also download this report directly from Seller Central. To retrieve this report, verify that your site is launched, your products are in stock, and that you have chosen to have your feeds generated. If your site does not meet the above requirements, you will receive an error.

      For more information about automating or manually generating your feeds, see Amazon Webstore: Setting Up Comparison Shopping Engines (US) (Europe).

    • googlemerchantcenterproductfeed - The Google Merchant Center Product Feed is supported by Google Shopping, and includes all in-stock products in your inventory that meet Google Shopping’s data requirements. You can use this report to upload your product catalog to your Google Merchant Center account. You can also download this report directly from Seller Central. To retrieve this report, verify that your site is launched, your products are in stock and meet Google Shopping data requirements, and that you have chosen to have your feeds generated. If your site does not meet the above requirements, you will receive an error.

      For more information about automating or manually generating your feeds for Google Shopping, see Amazon Webstore: Listing Products on Google Shopping (US) (Europe).

Note: If you have multiple marketplaces, the Comparison Shopping Engine and Google Merchant Center Product feeds are only generated for the primary marketplace associated with your account. You must include the primary marketplace identifier in the MarketplaceIdList request parameter when you specify either the comparisonshoppingenginefeed or googlemerchantcenterproductfeed format. If you submit a non-primary marketplace identifier or more than one marketplace identifier in the MarketplaceIdList request parameter for these format types, you will receive an error.

For Amazon Webstore sellers in the US and UK only. For more information about this report, see MWS Reports for Amazon Webstore (US) (Europe).

Browse Tree Reports

Report Description
Browse Tree Report

Enumeration value: _GET_XML_BROWSE_TREE_DATA_

API operation: ManageReportSchedule

API operation: RequestReport

XML report that provides browse tree hierarchy information and node refinement information for the Amazon retail website in any marketplace.

Can be requested or scheduled. For Marketplace and Seller Central sellers.

This report accepts the following ReportOptions values:

  • MarketplaceId – Specifies the marketplace from which you want browse tree information. Optional. If MarketplaceId is not included in the ReportOptions parameter, the report contains browse tree information from your default marketplace.
    Note: You must be registered as a seller in any marketplace that you specify using the MarketplaceId value. Also, your request must be sent to an endpoint that corresponds to the MarketplaceId that you specify. Otherwise the service returns an error. You can find a list of MarketplaceId values and endpoints in the "Amazon MWS endpoints and MarketplaceId values" section of the Amazon MWS Developer Guide.
  • RootNodesOnly - Type: xs:boolean. Optional. If true, then the report contains only the root nodes from the marketplace specified using MarketplaceId (or from your default marketplace, if MarketplaceId is not specified). If false, or if RootNodesOnly is not included in the ReportOptions parameter, then the content of the report depends on the value of BrowseNodeId.
  • BrowseNodeId – Specifies the top node of the browse tree hierarchy in the report. Optional. If BrowseNodeId is not included in the ReportOptions parameter, and if RootNodesOnly is false or is not included in the ReportOptions parameter, then the report contains the entire browse node hierarchy from the marketplace specified using MarketplaceId (or from your default marketplace, if MarketplaceId is not specified). Note that if you include an invalid BrowseNodeId in your request, the service returns a report that contains no data.
Note: If RootNodesOnly and BrowseNodeId are both included in the ReportOptions parameter, RootNodesOnly takes precedence.
Note: Amazon recommends that you do not include the MarketplaceIdList parameter with calls to the RequestReport operation that request the Browse Tree Report. If there is ever a conflict between a MarketplaceIdList parameter value and the MarketplaceId value of the ReportOptions parameter, the MarketplaceId value takes precedence.

To keep track of which browse nodes change over time, Amazon recommends that each time you request this report you compare it to the last report you requested using the same ReportOptions values.

URL-encoded example: ReportOptions=MarketplaceId=ATVPDKIKX0DER;BrowseNodeId%3D15706661

The Browse Tree Report is described by the following XSD: https://images-na.ssl-images-amazon.com/images/G/01/mwsportal/doc/en_US/Reports/XSDs/BrowseTreeReport.xsd.

Note: As Amazon updates the Amazon MWS Reports API section, we may update the BrowseTreeReport.xsd schema. Keep this in mind if you choose to use this schema for validation. Monitor an Amazon MWS discussion forum for announcements of updates to the BrowseTreeReport.xsd schema. You can find the Amazon MWS discussion forums here: