Feeds API

You use the Feeds API to upload data to Amazon to manage your selling business. There are feeds for a wide variety of use cases, such as creating listings, managing inventory and prices, acknowledging orders, and more. Refer to Feed Type Values for a list of available feed types.

Release notes

• February 26, 2025
• May 22, 2024
• October 11, 2023
• September 20, 2023
• August 16, 2023
• June 21, 2023
• May 17, 2023
• April 19, 2023
• March 29, 2023
• February 22, 2023
• January 25, 2023

❗

Important

Feeds API support for XML and flat file product listings feeds is deprecated. For more information about the affected feeds and migration guidelines, refer to the deprecation announcement.

Workflow for submitting a feed

Here are the high-level steps for submitting a feed:

1. Call the createFeedDocument operation, specifying the content type for the feed that you are submitting.

   Amazon returns a feedDocumentId value and a URL for uploading the feed contents.

2. Upload your feed document contents to the URL from the previous step.

3. Call the createFeed operation. Use the inputFeedDocumentId parameter to pass in the feedDocumentId value from step 1. Specify the marketplaces that you want the feed to be applied to and any relevant feed options.

   Amazon returns a feedId value.

4. Periodically poll the Amazon SQS queue for the FEED_PROCESSING_FINISHED notification event, which provides information when the feed processing is CANCELLED, DONE, or FATAL.

   Amazon returns the resultFeedDocumentId value in the notification when the feed moves into the DONE state.

5. Call the getFeedDocument operation. Use the feedDocumentId parameter to pass in the resultFeedDocumentId value from the previous step.

   Amazon returns the feedDocumentId value, a URL for downloading the feed processing report, and the compression algorithm.

6. Download the feed processing report.

7. Check the feed processing report for errors generated during feed processing. If there are errors, correct them and submit the corrected feed, starting at step

8. If there are no errors, your feed submission was successful.

For more details, refer to Submit a feed.

Use cases

The following use case examples are available for the Feeds API:

• Submit a feed: Learn how to submit a feed, check the status of feed processing, and verify that your feed submission was successful.

Roles

cancelFeed

Attribute	Value
Regions	NA, EU, FE except where noted
Required roles (need at least one)	Amazon Fulfillment Brand Analytics Direct to Consumer Shipping (Restricted) Inventory and Order Tracking Payment Initiation Service Provider (EU only) Pricing Product Listing Tax Invoicing (Restricted)

createFeed

Attribute	Value
Regions	NA, EU, FE except where noted
Required roles (need at least one)	Amazon Fulfillment Brand Analytics Direct to Consumer Shipping (Restricted) Inventory and Order Tracking Payment Initiation Service Provider (EU only) Pricing Product Listing Tax Invoicing (Restricted)

createFeedDocument

Attribute	Value
Regions	NA, EU, FE except where noted
Required roles (need at least one)	Amazon Fulfillment Brand Analytics Direct to Consumer Shipping (Restricted) Inventory and Order Tracking Payment Initiation Service Provider (EU only) Pricing Product Listing Tax Invoicing (Restricted)

getFeed

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Tax Invoicing (Restricted)

getFeedDocument

Attribute	Value
Regions	NA, EU, FE except where noted
Required roles (need at least one)	Amazon Fulfillment Brand Analytics Direct to Consumer Shipping (Restricted) Inventory and Order Tracking Payment Initiation Service Provider (EU only) Pricing Product Listing Tax Invoicing (Restricted)

getFeeds

Attribute	Value
Regions	NA, EU, FE except where noted
Required roles (need at least one)	Amazon Fulfillment Brand Analytics Direct to Consumer Shipping (Restricted) Inventory and Order Tracking Payment Initiation Service Provider (EU only) Pricing Product Listing Tax Invoicing (Restricted)