Back to Help

Amazon’s new orders API

Amazon order retrieval: what is changing and how to switch

Amazon is retiring the current method of sharing orders, Orders API v0, and replacing it with the new Orders API v2026-01-01. This change applies to the order retrieval part of the Amazon integration in Base.com.

The old API will stop working on 27 March 2027. By that date, every Amazon account in Base.com must retrieve orders using the new method.

You can switch to the new API now by changing one option in the integration settings. Until Amazon disables the old API, you can return to the previous version at any time.

 

Fetching additional data from Amazon

We recommend switching early. This gives you time to update and test automatic actions while the previous API is still available.

What changes in Amazon orders

What you gain

  • More data in orders – more complete information for the invoice and shipment.
  • VAT ID in Amazon Business orders, which is needed to issue an invoice to a business customer. You can also find information about Amazon Business orders in the Base.com Help Center.
  • Faster retrieval of this data.

Shipping method names: what to watch for

The new Amazon API no longer provides the detailed name of the shipping method. Instead, it provides the delivery speed category. As a result, new orders will contain different values in the Shipping method field.

 

Before the change (examples) After the change (examples)
Std DE Dom, MFN AD Dom, Std STANDARD
Exp UK Intl, Expedited EXPEDITED

Possible values in the new API include: STANDARD, EXPEDITED, PRIORITY, NEXT_DAY, SECOND_DAY, SAME_DAY, SCHEDULED, FREE_ECONOMY.

 

If an automatic action uses the Shipping method condition with an old Amazon value, add the new value to the condition before switching to the new API.

The change applies only to new orders. Orders that have already been downloaded keep their existing shipping method names. The old and new names do not correspond one-to-one: for example, STANDARD may replace several previous names depending on the market. The additional Fulfillment field (MFN/AFN) does not change.

Who needs to take action

Sellers using Shipping method conditions

The change affects sellers who use automatic actions with a Shipping method condition based on an Amazon shipping method name.

For example, an action may use the condition Shipping method = Std DE Dom to change the order status, issue an invoice, or create a shipment. After switching to the new API, this action will not be triggered for new orders with the value STANDARD until you update the condition.

Sellers without these conditions

If you do not use Shipping method conditions based on Amazon names, no other preparation is required. Simply enable the new order retrieval option in the Amazon integration settings.

How to switch to the new API

Step-by-step instructions

  1. Check your automatic actions. Go to Orders → Automatic actions and look for actions whose conditions contain Shipping method with an Amazon method name, for example one containing Std, Exp, Dom or Intl.  If necessary, review the available order-related system events used to trigger these actions.
  2. Prepare the conditions for the new values. For every affected action, add the new values, such as STANDARD od EXPEDITED , next to the existing values. This allows the action to work for both orders downloaded before the change and orders downloaded after the change.
  3. Enable the new order retrieval method. Go to Integrations → Amazon → Orders, where the order settings for the selected account are displayed. Select Download additional data from Amazon, then click Save.
  4. Check the first new orders. Open the order card and check which Shipping method value was assigned. Verify that the relevant automatic actions were triggered as expected.
  5. Optionally remove the old values. When everything works correctly, you can remove the old Amazon shipping method names from your automatic-action conditions.

If you have several Amazon accounts, enable the option separately for each account.

How to return to the previous version

If something does not work correctly, go to Integrations → Amazon → Orders, clear Download additional data from Amazon, and click Save. New orders will then be downloaded using the previous method again.

Report the problem to our support team so that we can investigate and fix it.

You can return to the previous version only until Amazon disables the old API on 27 March 2027.

Timeline

When What happens
Now You can switch to the new method yourself, test it, and return to the previous version if necessary.
From January 2027 Reminders about the required change will appear in the panel.
20 March 2027  The new order retrieval method will be enabled automatically for accounts that have not changed the setting.
27 March 2027 Amazon disables the old API, so returning to the previous version will no longer be possible.

We recommend switching earlier, while you still have time to check your automatic actions and the option to return to the previous version.

Frequently asked questions

  • Will my existing orders change?
    No. The change applies only to orders downloaded after you enable the new option.
  • Do I need to change anything if I do not use automatic actions?
    No. Simply enable the new order retrieval option. No other changes are required. 
  • Can I restore the previous shipping method names?
    No. The new Amazon API no longer provides these names.
  • What happens if I do nothing?
    Before Amazon disables the old API, Base.com will switch your account to the new order retrieval method automatically. Automatic actions based on the old shipping method names will then stop working for new orders, so we recommend updating their conditions in advance.

Was this helpful?

Back to Help