Release Notes 2026

Amazon Business API new features, bug fixes, and change log.

Get updates. Subscribe to our RSS feed.

June 2026

Product Search API

What's new: variationImages, dimensionSymbol, and metadata

Supported regions: NA, EU, FE

The Product Search API searchProducts, productsRequest, and getProductsByAsins operations now support additional attributes for variation image data and color code metadata. With these attributes, you can retrieve and display images for specific product variations, such as color options, and access associated color code metadata to build richer product detail pages in your application.

variationImages: An attribute in ProductsResult that returns images associated with product variations, organized by dimension (typically color). Each entry contains a dimensionSymbol identifier and an array of variation images with thumbnail and large image URLs.
dimensionSymbol: An attribute in both the Dimension and VariationImageDimension schemas that provides the symbolic identifier for a dimension (for example, color_name, size_name). This attribute serves as the linking key between productVariations and variationImages.
metadata: An attribute in DimensionValue that provides optional metadata for dimension values, such as color code information. The metadata contains a colorCode object with a primary attribute representing the hex color value (for example, #F231212).

variationImages is not returned by default. To retrieve variation images in the response, you must explicitly include variationImages in the inclusionsForProducts query parameter. The metadata and dimensionSymbol attributes are returned as part of productVariationswhen included in the response.

GET https://na.api.business.amazon.com/products/2020-08-26/products/B07VDJ5RVF?productRegion=US&locale=en_US&inclusionsForProducts=productVariations,variationImages

{
  "asin": "B07VDJ5RVF",
  "productVariations": {
    "dimensions": [
      {
        "index": 0,
        "displayString": "Color",
        "dimensionSymbol": "color_name",
        "dimensionValues": [
          {
            "index": 0,
            "displayString": "Blue",
            "metadata": {
              "colorCode": {
                "primary": "#0000FF"
              }
            }
          },
          {
            "index": 1,
            "displayString": "Red",
            "metadata": {
              "colorCode": {
                "primary": "#FF0000"
              }
            }
          }
        ]
      }
    ],
    "variations": [
      {
        "asin": "B07J3G6312",
        "variationValues": [
          {
            "index": 0,
            "value": 0
          }
        ]
      }
    ]
  },
  "variationImages": [
    {
      "dimensionSymbol": "color_name",
      "variationImages": [
        {
          "displayString": "Blue",
          "thumbnail": {
            "height": 40,
            "url": "https://images-na.ssl-images-amazon.com/images/I/example-blue-thumb.jpg",
            "width": 40
          },
          "large": {
            "height": 500,
            "url": "https://images-na.ssl-images-amazon.com/images/I/example-blue-large.jpg",
            "width": 500
          }
        },
        {
          "displayString": "Red",
          "thumbnail": {
            "height": 40,
            "url": "https://images-na.ssl-images-amazon.com/images/I/example-red-thumb.jpg",
            "width": 40
          },
          "large": {
            "height": 500,
            "url": "https://images-na.ssl-images-amazon.com/images/I/example-red-large.jpg",
            "width": 500
          }
        }
      ]
    }
  ]
}

May 2026

Developer Guide

What’s new: Onboarding overview process

Supported regions: NA, EU, FE

The Amazon Business API onboarding process now requires you to receive approval from the Amazon Business team before you register as a developer.

To request access, send an email to [email protected] with your details and intended use case. The Amazon Business team reviews your request to determine the appropriate API access and contacts you if they require additional information to proceed.

After the Amazon Business team approves your request, you receive registration instructions over email. The Amazon Business team now assigns Amazon Business API roles after they review your access request. For more information, see Onboarding overview.

Reporting API

What's new: Updated static sandbox responses

Supported regions: NA, EU, FE

The Reporting API static sandbox responses now return date fields as flat strings (for example, "orderDate": "2025-04-11T00:00:00Z") instead of nested objects. This update affects the following operations:

getOrderReports
getOrderLineItemReports
getOrderReportsByPurchaseOrderNumber
getShipmentReports
getShipmentLineItemReports

For more information, see Reporting API static sandbox guide.

April 2026

Ordering API

What's new: `DeliveryPreference` attribute

Supported regions: NA, EU, FE

The Ordering API now supports the DeliveryPreference attribute in the placeOrder operation. Using this option, you can specify your customer's preferred shipping option at the order level. Amazon Business will prioritize the preferred option when possible, but may use an alternative shipping method if the preference cannot be fulfilled. The attribute accepts three values:

FAST_FREE : Customer prefers the fastest free shipping option.
CONSOLIDATED: Customer prefers multiple items consolidated in a single shipment. This option can delay the delivery.
EXPEDITED_PAID: Customer prefers the fastest shipping option whether it is free or paid.

To apply the shipping preference to the entire order, include the DeliveryPreference attribute in the attributes array of your order request.

POST https://na.business-api.amazon.com/ordering/2022-10-30/orders

{
  "externalId": "ORDER-12345",
  "attributes": [
    {
      "attributeType": "DeliveryPreference",
      "shipPreference": "FAST_FREE"
    },
    {
      "attributeType": "Region",
      "region": "EU"
    }
  ],
  "expectations": [],
  "lineItems": [
    {
      "externalId": "1",
      "quantity": 2,
      "attributes": [
        {
          "attributeType": "SelectedProductReference",
          "productReference": {
            "productReferenceType": "ProductIdentifier",
            "id": "B08N5WRWNW"
          }
        }
      ],
      "expectations": []
    }
  ]
}

{
  "lineItems": [
    {
      "externalId": "1",
      "acceptedItems": [
        {
          "acceptedItemType": "SingleAcceptedItem",
          "quantity": 2,
          "artifacts": [
            {
              "acceptanceArtifactType": "LineItemIdentifier",
              "identifier": "12345678901234"
            },
            {
              "acceptanceArtifactType": "DeliveryTimeRange",
              "lowerBoundary": {
                "date": "2024-12-08T00:00:00.000Z"
              },
              "upperBoundary": {
                "date": "2024-12-10T00:00:00.000Z"
              }
            }
          ]
        }
      ],
      "rejectedItems": []
    }
  ],
  "acceptanceArtifacts": [
    {
      "acceptanceArtifactType": "OrderIdentifier",
      "identifier": "112-1234567-1234567"
    },
    {
      "acceptanceArtifactType": "Signed"
    }
  ],
  "rejectionArtifacts": []
}

Package Tracking API

What's new: `trackingStatus` values

Supported regions: NA, EU, FE

The Package Tracking API getPackageTrackingDetail operation now supports additional values for the trackingStatus field. With these new values, you can track post-delivery and exception scenarios for your customers. These statuses align with the tracking information already displayed to Amazon Business customers. This update adds new values to the trackingStatus field description. No new fields or endpoints are added. For more information about this API, see Package Tracking API overview .

New trackingStatus values:

DELAYED : The package delivery has been delayed beyond the original estimated delivery date.
UNDELIVERABLE : The package could not be delivered to the recipient and will be returned to the seller or fulfillment center.
RETURNED : The package has been returned to the seller or fulfillment center.
REFUND_ISSUED : A refund has been issued for the package.
AVAILABLE_FOR_PICKUP : The package is available for pickup at a designated location.
CUSTOMER_ACTION : The package requires action from the customer, such as providing delivery instructions or scheduling a redelivery.


GET https:https://na.api.business.amazon.com/ab-tracking/2025-07-02/orders/{orderId}/shipments/{shipmentId}/packages/{packageId}?region=US&locale=en_US

{
  "packageTrackingDetails": {
    "trackingStatus": "UNDELIVERABLE",
    "localizedDeliveryPromise": "Undeliverable - Package being returned",
    "carrierDetails": {
      "localizedCarrierName": "Delivery by Amazon",
      "carrierTrackingId": "TBA987654321098"
    },
    "packageTrackingEvents": [
      {
        "localizedDescription": "Package could not be delivered. It will be returned to the seller.",
        "localizedEventDate": "Thursday, April 10",
        "localizedEventTime": "2:30 PM",
        "location": {
          "city": "Seattle",
          "country": "US"
        }
      },
      {
        "localizedDescription": "Delivery attempted. No access to delivery location.",
        "localizedEventDate": "Wednesday, April 9",
        "localizedEventTime": "11:15 AM",
        "location": {
          "city": "Seattle",
          "country": "US"
        }
      }
    ],
    "packageMilestones": [
      {
        "milestoneType": "SHIPPED",
        "milestoneWindow": {
          "endDate": "2026-04-07T08:00:00-07:00"
        }
      },
      {
        "milestoneType": "ORDERED",
        "milestoneWindow": {
          "endDate": "2026-04-06T14:30:00-07:00"
        }
      }
    ]
  }
}

March 2026

Cart API

What's new: Cart API is now available

Supported regions: NA, EU

The Amazon Business Cart API is now available. This API allows you to manage Amazon Business shopping carts programmatically by listing and retrieving cart details, adding, modifying, and removing items from carts, and estimating the total purchase cost of a cart before purchase, including tax and shipping charges. You can use this API along with Product Search API and Ordering API to design a full end-to-end purchasing experience in your application. For more information about this API, see Cart API overview .

This API provides the following operations:

listCarts: Retrieves a paginated list of cart summaries for a customer in the specified region.


GET https://na.business-api.amazon.com/cart/2025-04-30/carts?region=US
{  
  X-Amz-User-Email: [email protected]
}

{
  "cartDetailsList": [
    {
      "id": "cart-456",
      "cartType": "DEFAULT",
      "region": "US"
    }
  ]
}

getCart: Retrieves a summary of the cart's overall information, providing aggregate-level data for the entire cart without including individual item details.


GET https://na.business-api.amazon.com/cart/2025-04-30/carts/cart-123?region=US

{
  "id": "cart-456",
  "cartType": "DEFAULT",
  "region": "US",
  "attributes": [
    {
      "attributeType": "SubTotal",
      "amount": {
        "currencyCode": "USD",
        "amount": 70
      }
    }
  ]
}

getItems: Retrieves the items in the cart.

GET https://na.business-api.amazon.com/cart/2025-04-30/carts/cart-123/items?region=US

{
  "items": [
    {
      "productIdentifier": "Asin1",
      "itemId": "Id1",
      "buyingOptionIdentifier": "OId1",
      "quantity": 2,
      "isItemAvailable": true,
      "price": {
        "currencyCode": "USD",
        "amount": 30
      },
      "addedToCartDate": "2024-07-10T15:00:00.000Z",
      "modifiedDate": "2024-07-10T15:00:00.000Z"
    },
    {
      "productIdentifier": "Asin2",
      "itemId": "Id2",
      "buyingOptionIdentifier": "OId2",
      "quantity": 2,
      "isItemAvailable": true,
      "price": {
        "currencyCode": "USD",
        "amount": 40
      },
      "addedToCartDate": "2024-07-10T15:00:00.000Z",
      "modifiedDate": "2024-07-15T20:00:00.000Z"
    }
  ]
}

addItems: Adds items to the cart.

POST https://na.business-api.amazon.com/cart/2025-04-30/carts/cart-123/items?region=US

{
  "items": [
    {
      "productIdentifier": "Asin1",
      "buyingOptionIdentifier": "OId1",
      "quantity": 1,
      "externalId": "client-item-001"
    }
  ]
}

{
  "items": [
    {
      "productIdentifier": "Asin1",
      "itemId": "Id1",
      "buyingOptionIdentifier": "OId1",
      "quantity": 1,
      "isItemAvailable": true,
      "price": {
        "currencyCode": "USD",
        "amount": 30
      },
      "addedToCartDate": "2024-07-10T15:00:00.000Z",
      "modifiedDate": "2024-07-10T15:00:00.000Z"
    }
  ],
  "rejectedItems": []
}

modifyItems: Modifies items in the cart.


PATCH https://na.business-api.amazon.com/cart/2025-04-30/carts/cart-123/items?region=US

{
  "items": [
    {
      "itemId": "cId1",
      "quantity": 3
    }
  ]
}

{
  "items": [
    {
      "productIdentifier": "Asin1",
      "itemId": "cId1",
      "buyingOptionIdentifier": "OId1",
      "quantity": 3,
      "isItemAvailable": true,
      "price": {
        "currencyCode": "USD",
        "amount": 30
      },
      "addedToCartDate": "2024-07-10T15:00:00.000Z",
      "modifiedDate": "2024-07-10T15:00:00.000Z"
    }
  ],
  "rejectedItems": []
}

getEstimatedTotalPurchaseCost: Computes estimated total purchase cost for the cart against a delivery address.


POST https://na.business-api.amazon.com/cart/2025-04-30/carts/cart-123/totalPurchaseCostEstimations?region=US

{
  "address": {
    "addressType": "PhysicalAddress",
    "fullName": "cart user",
    "addressLine1": "307 Boren Ave",
    "city": "Seattle",
    "stateOrRegion": "WA",
    "postalCode": "98101",
    "countryCode": "US"
  }
}


{
  "charges": [
    {
      "type": "PRINCIPAL",
      "category": "SUBTOTAL",
      "amount": {
        "currencyCode": "USD",
        "amount": 123
      }
    },
    {
      "type": "PRINCIPAL",
      "category": "SHIPPING",
      "amount": {
        "currencyCode": "USD",
        "amount": 10
      }
    },
    {
      "type": "TAX",
      "category": "SUBTOTAL",
      "amount": {
        "currencyCode": "USD",
        "amount": 12.3
      }
    },
    {
      "type": "TAX",
      "category": "SHIPPING",
      "amount": {
        "currencyCode": "USD",
        "amount": 1.2
      }
    }
  ],
  "rejectionArtifacts": []
}

deleteItems: Deletes all items in the cart.

DELETE https://na.business-api.amazon.com/cart/2025-04-30/carts/cart-123/items?region=US

HTTP 204 (No Content)

February 2026

Product Search API

What's new: `sortKey`

Supported regions: NA, EU, FE

The Product Search API searchProductsRequest operation now supports the sortKey query parameter, allowing you to control the order in which search results are returned. Use this parameter to sort products by relevance, price, popularity, customer ratings, and other criteria to better match your business needs.

📘
If the sortKey parameter is not provided or contains an invalid value, the API defaults to sorting by RELEVANCE.

The API response returns the applied sortKey value, allowing you to confirm which sort order was applied to the search.

GET https://na.business-api.amazon.com/products/2020-08-26/products?keywords=laptop&pageNumber=0&locale=en_US&productRegion=US&inclusionsForProducts:ALL,isBundledAsin&sortKey=PRICE_LOW_TO_HIGH&facets=OFFERS

{
  "numberOfPages": 13,
  "products": [ 
    "..."
],
  "legalInformation": [],
  "sortKey": "PRICE_LOW_TO_HIGH"
 }

What's new: `minPrice` and `maxPrice` filters

Supported regions: NA, EU, FE

The Product Search API searchProductsRequest operation now supports filtering search results by price range using two new optional query parameters:

minPrice: Minimum price used to filter search results. When specified, only products with prices greater than or equal to this value are returned.
maxPrice: Maximum price used to filter search results. When specified, only products with prices less than or equal to this value are returned.

📘
Both parameters represent prices in the marketplace's default currency without decimal points. For example, to filter products between $10.00 and $50.00 in the US marketplace, you would use minPrice=10 and maxPrice=50.

The API response now includes these parameters in the API response, showing which price filters were applied to the search.

GET https://na.business-api.amazon.com/products/2020-08-26/products?keywords=laptop&pageNumber=0&locale=en_US&productRegion=US&minPrice=50&maxPrice=100&inclusionsForProducts:ALL,isBundledAsin&facets=OFFERS

{
  "numberOfPages": 13,
  "products": [ 
    "..."
],
  "legalInformation": [],
  "minPrice": 50,
  "maxPrice": 100
 }

Document API

What's new: Rate limit increases

Supported regions: NA, EU, FE

The default rate limits have been increased for the following Document API operations:

Operation	Previous rate limit	New rate limit
`createReport`	0.0167	0.1
`getReports`	0.0222	0.1
`cancelReport`	0.0222	0.1
`getReportDocument`	0.0167	0.1

Burst limits for each operation remain unchanged.

Package Tracking

What's new: Package Tracking API and push notification are now available in MX

Supported regions: NA

Package Tracking API and the package tracking push notification are now available in the Mexico marketplace region. For information about the endpoint, marketplace ID, marketplace URL, and onboarding steps for this region, visit the following documents:

Reporting API

What’s new: Reporting API v2025-06-09 is now available in Mexico and India marketplaces

Supported regions: NA, EU

Reporting API v2025-06-09 is now available in the Mexico and India marketplace regions. For information about the endpoints, marketplace IDs, marketplace URLs, and onboarding steps for each region, visit the following documents:

January 2026

Document API

What’s new: Order summary document support

Supported regions: NA

Document API now supports downloading order summary documents in the NA region. An order summary is a document that summarizes an order with details such as item, shipment, charge, and address information. You can download order summaries by calling the CreateReport operation, providing the orderId, and setting documentType to OrderSummary. For more information, see Downloading invoices in NA region.

https://na.business-api.amazon.com/reports/2021-09-30/reports
{
    "reportOptions": 
    { 
        "orderId":"123-9277085-5441169", 
        "documentType": "OrderSummary"
    }, 
    "reportType": "GET_AB_INVOICE_PDF", 
    "marketplaceIds": ["ATVPDKIKX0DER"] 
}

Reconciliation API

What’s new: `invoiceType` in `getInvoiceDetailsByOrderLineItems` response

Supported regions: NA, EU

The Reconciliation API getInvoiceDetailsByOrderLineItems operation now includes an invoiceType parameter in the response. This field indicates whether the data returned is an invoice or credit memo.

POST https://na.business-api.amazon.com/reconciliation/2021-01-08/invoices

{
    "orderLineItems": [
        {
            "orderId": "123-1087441-1234567",
            "orderLineItemId": "12358882544123",
            "shipmentId": "ABcjNjAbC"
        }
    ]
}

{
    "invoiceDetailsByOrderLineItems": [
        {
            "orderLineItem": {
                "orderId": "123-1087441-1234567",
                "orderLineItemId": "12358882544123",
                "shipmentId": "ABcjNjAbC"
            },
            "invoiceDetails": [
                {
                    "invoiceNumber": "123T-QYMJ-FTXL",
                    "invoiceDate": "2025-09-22T21:49:30.296Z",
                    "invoiceType": "STANDARD"
                },
                {
                    "invoiceNumber": "123J-NHTN-FFXF",
                    "invoiceDate": "2025-10-23T19:20:12.646Z",
                    "invoiceType": "CREDIT_MEMO"
                }
            ]
        }
    ]
}

Release Notes 2026

June 2026

Product Search API

What's new: variationImages, dimensionSymbol, and metadata

May 2026

Developer Guide

What’s new: Onboarding overview process

Reporting API

What's new: Updated static sandbox responses

April 2026

Ordering API

What's new: `DeliveryPreference` attribute

Package Tracking API

What's new: `trackingStatus` values

March 2026

Cart API

What's new: Cart API is now available

February 2026

Product Search API

What's new: `sortKey`

📘

What's new: `minPrice` and `maxPrice` filters

📘

Document API

What's new: Rate limit increases

Package Tracking

What's new: Package Tracking API and push notification are now available in MX

Reporting API

What’s new: Reporting API v2025-06-09 is now available in Mexico and India marketplaces

January 2026

Document API

What’s new: Order summary document support

Reconciliation API

What’s new: `invoiceType` in `getInvoiceDetailsByOrderLineItems` response

Previous releases:

Release Notes 2025

Release Notes 2024

Release Notes 2023

Release Notes 2022

June 2026

What's new: variationImages, dimensionSymbol, and metadata

May 2026

What’s new: Onboarding overview process

What's new: Updated static sandbox responses

April 2026

What's new: DeliveryPreference attribute

What's new: trackingStatus values

March 2026

What's new: Cart API is now available

February 2026

What's new: sortKey

📘

What's new: minPrice and maxPrice filters

📘

What's new: Rate limit increases

What's new: Package Tracking API and push notification are now available in MX

What’s new: Reporting API v2025-06-09 is now available in Mexico and India marketplaces

January 2026

What’s new: Order summary document support

What’s new: invoiceType in getInvoiceDetailsByOrderLineItems response

Previous releases:

What's new: `DeliveryPreference` attribute

What's new: `trackingStatus` values

What's new: `sortKey`

What's new: `minPrice` and `maxPrice` filters

What’s new: `invoiceType` in `getInvoiceDetailsByOrderLineItems` response