Release Notes 2025
Amazon Business API new features, bug fixes, and change log.
Get updates. Subscribe to our RSS feed.
November 2025
What’s new: legalInformation
legalInformationSupported regions: FE
In the Japan (JP) marketplace, Product Search API now returns a legalInformation field in the response. This field displays legal alerts for restricted products, such as medical or adult products. For example, this field can return age verification content before displaying adult product details. All Product Search API operations return legalInformation in the response.
This field is returned in the JP marketplace only. In other regions, the
legalInformationfield is returned in the response, but contains no data.
legalInformation data is only a subset of all legal alerts or product restrictions. If you are a developer partner already using Ordering API or cXML direct ordering for a reselling use case, restricted products are already covered by the items that you are legally advised to keep from selling. In this case, no further action is required by this feature launch. Note that displaying legalInformation in your application does not guarantee the right to sell a given product.
This field and its returned value do not constitute legal advice. Please consult with appropriate professionals regarding your company's legal compliance based on your specific circumstances.
Sample response:
"numberOfPages": 13,
"products": [{
"asin": "B01DUDP3B4",
"asinType": "STANDARD",
"signedProductId": "amzn1.business.asin.Q7BWW...",
"legalInformation": [
{
"fragment": {
"title": "Warning: Professional Medical Equipment"
"message": "This page contains medical device information only allowed to be purchased by medical professionals."
"link": null
"type": MEDICAL
}
}
],
"includedDataTypes": {
"OFFERS": []
}
What’s new: getBatchInvoicePaymentDetails operation
getBatchInvoicePaymentDetails operationSupported regions: NA, EU, FE
The getBatchInvoicePaymentDetails operation is now available for Reconciliation API, allowing you to retrieve payment statuses and due dates for a batch of requested invoices. This operation can help simplify reconciliation by providing programmatic access to the latest invoice status and due dates.
In the API request, include an array of invoice IDs. You can retrieve these invoice IDs by calling the getInvoiceDetailsByOrderLineItems operation. For each invoice, the API response includes the invoice status and due date. If the request contains invalid invoice IDs, the request will still succeed. In this scenario, the API returns data for each valid invoice ID and error data for each invalid ID. This operation accepts a maximum of 25 invoice IDs per request. This batch functionality allows you to optimize your API call patterns and use your rate limit efficiently.
If any of the invoice IDs are valid but are not authorized for that customer, the whole request will fail.
This operation can only be used to retrieve invoices for Pay By Invoice (PBI) transactions. In EU, this operation only supports Invoice by Amazon (IBA) and VAT Calculation Service (VCS) transactions. VCS-Lite, Invoice Document Upload (IDU), and Seller Tax Exempted (STEP) transactions are not supported.
POST https://na.business-api.amazon.com/reconciliation/2025-06-09/invoices/batch/paymentDetails
{
"invoiceIds": [
"`1ABC-2XYZ-9939`",
"2ABC`-2XYZ-9939`"
]
}
{
"invoicePaymentDetailsResults": [
{
"invoiceId": "1ABC-2XYZ-9939",
"resultType": "SUCCESS",
"paymentDetails": {
"status": "Issued",
"dueDate": "2025-01-12T07:59:59Z"
}
},
{
"invoiceId": "2ABC-2XYZ-9939",
"resultType": "SUCCESS",
"paymentDetails": {
"status": "Closed",
"dueDate": "2025-06-30T08:00:00"
}
}
]
}
POST https://na.business-api.amazon.com/reconciliation/2021-01-08/invoices/batch/paymentDetails
{
"invoiceIds": [
"3`ABC-2XYZ-9939`",
"INVALID-INVOICE"
]
}
{
"invoicePaymentDetailsResults": [
{
"invoiceId": "3ABC-2XYZ-9939",
"resultType": "SUCCESS",
"paymentDetails": {
"status": "OVERDUE",
"dueDate": "2025-06-01T09:00:00Z"
}
},
{
"invoiceId": "INVALID-INVOICE",
"resultType": "ERROR",
"error": {
"code": "NoDataFound",
"message": "Unable to fetch details for the Invoice ID",
"details": ""
}
}
]
}
What’s new: MCP Server now available for Amazon Business API integrations
Supported regions: NA, EU, FE
The Amazon Business Integrations Model Context Protocol (MCP) Server is now available. This server empowers AI-enabled developer environments by providing direct, contextual access to Amazon Business API documentation, sample code, and troubleshooting resources. For more information, see Amazon Business Integrations MCP Server .
What's New: Reporting API v2025-06-09
Supported regions: NA, EU, FE
Reporting API v2025-06-09 is now available. This new version offers enhanced capabilities including improved API performance, API operations tailored to specific use cases, and expanded data coverage. This version provides enhanced search and filter capabilities with support for retrieving orders within a 366-day time range. With support for five new API operations, this API version can enable use cases in spend analysis, shipment reporting, and procurement insights. In addition to fields present in the previous version of the API, Reporting API v2025-06-09 provides the following new fields:
packages: The physical packages that comprise this shipment item.serialNumbers: List of serial numbers associated with the product.quantity: The quantity of items in a shipment.sustainability: Sustainability information for a line item.receivingInfo: The receiving status, date and quantity details for tracking shipment items in 3-way matching.
Reporting API v2025-06-09 is now the standard version of Reporting API. Reporting API v2021-01-08 will be decommissioned in the future. Please use v2025-06-09 for any new API integrations.
Reporting API v2025-06-09 provides the following API operations:
getOrderReports: Retrieves comprehensive order information including order status, charges, and business order details.
GET https://na.business-api.amazon.com/reports/2025-06-09/orderReports?orderStartDate=2025-01-15T10:30:00Z&orderEndDate=2025-02-15T10:30:00Z®ion=US&orderStatuses=CLOSED
{
"ordersReport": [
{
"orderMetadata": {
"orderDate": "2024-11-08T21:27:16Z",
"orderId": "D01-9529667-4499466",
"region": "US"
},
"purchaseOrderNumber": null,
"charges": [
{
"type": "SUBTOTAL",
"amount": {
"currencyCode": "USD",
"amount": 0.0
}
},
{
"type": "TAX",
"amount": {
"currencyCode": "USD",
"amount": 0.0
}
},
{
"type": "NET_TOTAL",
"amount": {
"currencyCode": "USD",
"amount": 0.0
}
}
],
"orderStatus": "CLOSED",
"buyingCustomer": {
"name": "Jane Doe",
"email": ""
},
"buyerGroup": {
"name": "Department 1"
},
"businessOrderInfo": null,
"approverDetails": null
}
],
"nextPageToken": null,
"size": 1
}
getOrderLineItemReports: Fetches detailed line item information including product details, pricing, and seller information.
GET https://na.business-api.amazon.com/reports/2025-06-09/orderLineItemReports?orderStartDate=2024-10-08T00:40:56Z&orderEndDate=2025-10-07T15:47:56Z
{
"orderLineItemsReport": [
{
"orderMetadata": {
"orderDate": "2024-11-08T21:27:16Z",
"orderId": "D01-9529667-4499466",
"region": "US"
},
"orderLineItemId": "18939811138160",
"purchaseOrderNumber": null,
"purchaseOrderLineItemNumber": null,
"productDetails": {
"productCategory": "Prime",
"asin": "B0853B5CPJ",
"title": "Business Prime Membership Fee",
"unspsc": {
"code": "64131500"
},
"productCondition": "New",
"brandCode": null,
"brandName": null,
"manufacturerName": null,
"serialNumbers": null
},
"unitPrice": {
"currencyCode": "USD",
"amount": 0.0
},
"quantity": 1,
"charges": [
{
"type": "SUBTOTAL",
"amount": {
"currencyCode": "USD",
"amount": 0.0
}
},
{
"type": "PROMOTION",
"amount": {
"currencyCode": "USD",
"amount": 0.0
}
},
{
"type": "TAX",
"amount": {
"currencyCode": "USD",
"amount": 0.0
}
},
{
"type": "NET_TOTAL",
"amount": {
"currencyCode": "USD",
"amount": 0.0
}
}
],
"taxExemption": null,
"pricingProgram": null,
"sustainability": null,
"seller": {
"name": "Amazon.com Services, Inc",
"primaryAddress": null,
"credentials": null
}
}
],
"nextPageToken": "123asda",
"size": 1
}
getOrderReportsByPurchaseOrderNumber: Retrieves order information associated with a specific purchase order number.
GET https://na.business-api.amazon.com/reports/2025-06-09/purchaseOrders/PoNumber1/orderReports?region=US
{
"ordersReport": [
{
"orderMetadata": {
"orderDate": "2024-11-08T21:29:44Z",
"orderId": "114-0575598-4117065",
"region": "US"
},
"purchaseOrderNumber": "PoNumber1",
"charges": [
{
"type": "SUBTOTAL",
"amount": {
"currencyCode": "USD",
"amount": 2.65
}
},
{
"type": "SHIPPING_AND_HANDLING",
"amount": {
"currencyCode": "USD",
"amount": 0.0
}
},
{
"type": "PROMOTION",
"amount": {
"currencyCode": "USD",
"amount": 0.0
}
},
{
"type": "TAX",
"amount": {
"currencyCode": "USD",
"amount": 0.27
}
},
{
"type": "NET_TOTAL",
"amount": {
"currencyCode": "USD",
"amount": 2.92
}
}
],
"orderStatus": "CLOSED",
"buyingCustomer": {
"name": "Test Business",
"email": "[email protected]"
},
"buyerGroup": {
"name": "Department1"
},
"businessOrderInfo": null,
"approverDetails": null
}
],
"nextPageToken": "123asda",
"size": 1
}
getShipmentReports: Provides shipment tracking information including delivery status and shipping addresses.
GET https://na.business-api.amazon.com/reports/2025-06-09/shipmentReports?orderEndDate=2025-10-15T10:30:00Z&orderStartDate=2024-10-15T10:30:00Z
{
"shipmentsReport": [
{
"orderMetadata": {
"orderDate": "2024-11-08T21:29:44Z",
"orderId": "114-0575598-4117065",
"region": "US"
},
"shipmentMetadata": {
"shipmentId": "338368514033301",
"shipmentDate": "2024-11-09T04:20:13Z"
},
"purchaseOrderNumber": "PoNumber1",
"shipmentStatus": "SHIPPED",
"shippingAddress": {
"addressLine1": "Amazon",
"addressLine2": "333 Boren Ave N",
"city": "Seattle",
"stateOrRegion": "WA",
"postalCode": "98109",
"countryCode": "US"
},
"charges": [
{
"type": "SUBTOTAL",
"amount": {
"currencyCode": "USD",
"amount": 2.65
}
},
{
"type": "SHIPPING_AND_HANDLING",
"amount": {
"currencyCode": "USD",
"amount": 0.0
}
},
{
"type": "PROMOTION",
"amount": {
"currencyCode": "USD",
"amount": 0.0
}
},
{
"type": "TAX",
"amount": {
"currencyCode": "USD",
"amount": 0.27
}
},
{
"type": "NET_TOTAL",
"amount": {
"currencyCode": "USD",
"amount": 2.92
}
}
],
"deliveryInfo": {
"expectedDeliveryDate": "2024-11-10T04:00:00Z",
"status": "DELIVERED"
}
}
],
"nextPageToken": "123asda",
"size": 1
}
getShipmentLineItemReports: Retrieves detailed shipment line item information including receiving status and package tracking.
GET https://na.business-api.amazon.com/reports/2025-06-09/shipmentLineItemReports?orderStartDate=2024-10-08T00:40:56Z&orderEndDate=2025-10-07T15:47:56Z
{
"shipmentLineItemsReport": [
{
"orderMetadata": {
"orderDate": "2024-11-08T21:29:44Z",
"orderId": "114-0575598-4117065",
"region": "US"
},
"shipmentMetadata": {
"shipmentId": "338368514033301",
"shipmentDate": "2024-11-09T04:20:13Z"
},
"purchaseOrderNumber": "PoNumber1",
"orderLineItemId": "114029717115681",
"purchaseOrderLineItemNumber": null,
"productDetails": {
"productCategory": "Health and Beauty",
"asin": "B09541P9WH",
"title": "Amazon Basics Cotton Swabs, 500 Count",
"unspsc": {
"code": "53131600"
},
"productCondition": "New",
"brandCode": "OE019",
"brandName": "Amazon Basics",
"manufacturerName": "Amazon.com Services LLC.",
"serialNumbers": null
},
"charges": [
{
"type": "SUBTOTAL",
"amount": {
"currencyCode": "USD",
"amount": 2.65
}
},
{
"type": "SHIPPING_AND_HANDLING",
"amount": {
"currencyCode": "USD",
"amount": 0.0
}
},
{
"type": "TAX",
"amount": {
"currencyCode": "USD",
"amount": 0.27
}
},
{
"type": "NET_TOTAL",
"amount": {
"currencyCode": "USD",
"amount": 2.92
}
}
],
"quantity": 1,
"carrierName": "Amazon Logistics",
"packages": [
{
"trackingId": "TBA316956097268",
"packageId": "1"
}
],
"receivingInfo": null
}
],
"nextPageToken": "123asda",
"size": 1
}
For more information, see Reporting API overview.
September 2025
Developer Documentation
What’s new: Amazon Business API Explorer
Supported regions: NA, EU, FE
The Developer Documentation now includes an API Explorer section that you can use to explore Amazon Business APIs with test data. In the API Explorer, you can make API calls using sample data and generate code snippets in your preferred programming language. For more information, see Getting started.
What’s new: Product Search API is now available in Mexico and Australia marketplaces
Supported regions: NA, EU, FE
Product Search API is now available in the Mexico and Australia marketplace regions. For information about the endpoints, marketplace IDs, marketplace URLs, and onboarding steps for each region, visit the following documents:
- Amazon Business API endpoints
- Amazon Business marketplace URLs
- Amazon Business marketplace IDs
- Onboarding Step 1
What’s changed: signedProductId and offerId field format
signedProductId and offerId field formatSupported regions: NA, EU, FE
The format and length of the signedProductId and offerId values has changed to enhance consistency across product identifiers used in Amazon Business integration products and simplify integration with external systems. With this change, these fields are standardized to the following format:
- Length: 20 characters
- Format: asid-XXXXXXXXXXXXXXX
| Field | Previous value example | Current value |
|---|---|---|
signedProductId | "signedProductId": "amzn1.business.asin.YXBW2M3EGBXFUOMBAPZWI2LRMFZG423ZORUGOZLEG5ZGMY3BONQ5IQJYZM5BUI53TSXMI2Y7Y5MIJ7C4K66HGFF7RP362BST2INWE2XWZYUJGNEZ56CCRF6EJ66VQLHQMJ2UR5L2UMR6SE7YDTN6CRCKVQRXLLV3RGNEIJ4GDKBJW7JYC3QQ" | "signedProductId":"asid-PsS5DbBHeSh3t3Q" |
offerId | "offerId": "DgSdTiYaupjiIsyO%2FZcbOoJO8bZm467TllqojojOQWaOKcJulQGSCTQOG8wpA0rS7qYm4yVMvIR7YNxPHw9UhZXDmwvYNqD2vAmhRGzkhtmgDB7gvYmeNy7F2dxCAFnZHVL1ccYSLeeYYXw4zGMb7w%3D%3D" | "offerId":"asid-QsS5DbBHeSh3tdsj" |
What’s new: Ordering API is now available in Mexico and Australia marketplaces
Supported regions: NA, EU, FE
Ordering API is now available in the Mexico and Australia marketplace regions. For information about the endpoints, marketplace IDs, marketplace URLs, and onboarding steps for each region, visit the following documents:
- Amazon Business API endpoints
- Amazon Business marketplace URLs
- Amazon Business marketplace IDs
- Onboarding Step 1
In the Mexico region, orders placed via Ordering API will generate PDF Facturas electrónicas (CFDI) . These invoices will be accessible in the Your Orders screen. For more information, see Amazon Business Mexico support .
What’s new: Bundled ASIN support
Supported regions: NA, EU, FE
Ordering API now supports ordering bundled ASINs. A bundled ASIN is a single ASIN that represents multiple products or services bundled together and sold as a single unit.
Upon placing a successful order for a bundled ASIN, the Ordering API response returns an AcceptedItemGroup object that provides details about the individual products included in the bundled ASIN. Customers can only order a single quantity of each bundled ASIN. If the quantity of a bundled ASIN is greater than 1, the item will be rejected.
{
"externalId": "{{$timestamp}}",
"lineItems": [
{
"externalId": "LINE_ITEM_LEVEL_EXTERNAL_ID",
"quantity": 1,
"attributes": [{
"attributeType": "SelectedProductReference",
"productReference": {
"productReferenceType": "ProductIdentifier",
"id": "B0CFPC8CFY"
}
}],
"expectations": [{
"expectationType": "ExpectedUnitPrice",
"amount": {
"currencyCode": "USD",
"amount": 100000
}
}, {
"expectationType": "ExpectedCharge",
"amount": {
"currencyCode": "USD",
"amount": 100001
},
"source": "SUBTOTAL"
}]
}
],
"attributes": [
{
"attributeType": "PurchaseOrderNumber",
"purchaseOrderNumber": "ORDER_LEVEL_123"
}, {
"attributeType": "BuyingGroupReference",
"groupReference": {
"groupReferenceType": "GroupIdentity",
"identifier": "TestIdentity123"
}
},
{
"attributeType": "BuyerReference",
"userReference": {
"userReferenceType": "UserEmail",
"emailAddress": "[email protected]"
}
}, {
"attributeType": "Region",
"region": "US"
}, {
"attributeType": "SelectedPaymentMethodReference",
"paymentMethodReference": {
"paymentMethodReferenceType": "StoredPaymentMethod"
}
}, {
"attributeType": "ShippingAddress",
"address": {
"addressType": "PhysicalAddress",
"fullName": "Example User",
"phoneNumber": "1234567890",
"companyName": "Example Company",
"addressLine1": "325 9th Ave N",
"addressLine2": "",
"addressLine3": null,
"city": "Seattle",
"stateOrRegion": "WA",
"postalCode": "98109",
"countryCode": "US"
}
}],
"expectations": [{
"expectationType": "ExpectedCharge",
"amount": {
"currencyCode": "USD",
"amount": 103
},
"source": "TAX"
}, {
"expectationType": "ExpectedCharge",
"amount": {
"currencyCode": "USD",
"amount": 104
},
"source": "SHIPPING"
}, {
"expectationType": "ExpectedCharge",
"amount": {
"currencyCode": "USD",
"amount": 105
},
"source": "SUBTOTAL"
}]
}
{
"lineItems": [
{
"externalId": "LINE_ITEM_LEVEL_EXTERNAL_ID",
"acceptedItems": [
{
"acceptedItemType": "AcceptedItemGroup",
"quantity": 1,
"artifacts": [
{
"acceptanceArtifactType": "DeliveryTimeRange",
"lowerBoundary": "2025-08-21T17:00:00Z",
"upperBoundary": "2025-08-21T22:00:00Z"
},
{
"acceptanceArtifactType": "UnitPrice",
"amount": {
"currencyCode": "USD",
"amount": 104.98
}
},
{
"acceptanceArtifactType": "OrderIdentifier",
"identifier": "123-2234868-1233005"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 2.99
},
"category": "SHIPPING",
"type": "PRINCIPAL"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 10.86
},
"category": "SUBTOTAL",
"type": "TAX"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": -2.99
},
"category": "SHIPPING",
"type": "DISCOUNT"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 104.98
},
"category": "SUBTOTAL",
"type": "PRINCIPAL"
}
],
"items": [
{
"acceptedItemType": "SingleAcceptedItem",
"quantity": 1,
"artifacts": [
{
"acceptanceArtifactType": "DeliveryTimeRange",
"lowerBoundary": "2025-08-21T17:00:00Z",
"upperBoundary": "2025-08-21T22:00:00Z"
},
{
"acceptanceArtifactType": "UnitPrice",
"amount": {
"currencyCode": "USD",
"amount": 32.3
}
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 1.5
},
"category": "SHIPPING",
"type": "PRINCIPAL"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 3.34
},
"category": "SUBTOTAL",
"type": "TAX"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": -1.5
},
"category": "SHIPPING",
"type": "DISCOUNT"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 32.3
},
"category": "SUBTOTAL",
"type": "PRINCIPAL"
},
{
"acceptanceArtifactType": "OrderIdentifier",
"identifier": "123-2234868-7493005"
},
{
"acceptanceArtifactType": "LineItemIdentifier",
"identifier": "123018381136961:"
}
]
},
{
"acceptedItemType": "SingleAcceptedItem",
"quantity": 1,
"artifacts": [
{
"acceptanceArtifactType": "DeliveryTimeRange",
"lowerBoundary": "2025-08-21T17:00:00Z",
"upperBoundary": "2025-08-21T22:00:00Z"
},
{
"acceptanceArtifactType": "UnitPrice",
"amount": {
"currencyCode": "USD",
"amount": 72.68
}
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 1.49
},
"category": "SHIPPING",
"type": "PRINCIPAL"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 7.52
},
"category": "SUBTOTAL",
"type": "TAX"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": -1.49
},
"category": "SHIPPING",
"type": "DISCOUNT"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 72.68
},
"category": "SUBTOTAL",
"type": "PRINCIPAL"
},
{
"acceptanceArtifactType": "OrderIdentifier",
"identifier": "113-2234868-7493005"
},
{
"acceptanceArtifactType": "LineItemIdentifier",
"identifier": "123018381136921:"
}
]
}
]
}
],
"rejectedItems": []
}
],
"acceptanceArtifacts": [
{
"acceptanceArtifactType": "Signed"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 2.99
},
"category": "SHIPPING",
"type": "PRINCIPAL"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 10.86
},
"category": "SUBTOTAL",
"type": "TAX"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": -2.99
},
"category": "SHIPPING",
"type": "DISCOUNT"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 104.98
},
"category": "SUBTOTAL",
"type": "PRINCIPAL"
}
],
"rejectionArtifacts": []
}
What’s changed: SelectedBuyingOptionReference offer ID
SelectedBuyingOptionReference offer IDSupported regions: NA, EU, FE
The format and length of the has SelectedBuyingOptionReference changed. Previously, this value contained a long ID that created truncation and reconciliation issues. Now, this field has been shortened to a standard encrypted ID, simplifying integration. This value uses the following format:
- Length: 20 characters
- Format: asid-XXXXXXXXXXXXXXX
| Field | Previous value example | Current value |
|---|---|---|
id | { "buyingOptionReference": { "buyingOptionReferenceType": "BuyingOptionIdentifier", "id": "z0uoifIfKktIuDD15geAvDlSwPpeZP0igjNvcutTtiQiNcoWBdLfRmfDE94IpP5JUt%2BIEZpQgVbGwde6od5YHpwPq4ofoc6crXuJHYk%2BOqWViKH8HK9qOYBZtbDejuK2igYLuQ6WeUxd5ZUSc3yh3dm%2FQKgY2TqO" }, "attributeType": "SelectedBuyingOptionReference" } | { "buyingOptionReference": { "buyingOptionReferenceType": "BuyingOptionIdentifier", "id": "asid-PsS5DbBHeSh3t3Q" }, "attributeType": "SelectedBuyingOptionReference" } |
These values are case-sensitive. Sending values that do not exactly match the desired ID could result in order rejection.
What’s changed: SupplierPartAuxiliaryID field format
SupplierPartAuxiliaryID field formatSupported regions: NA, EU, FE
The format and length of the SupplierPartAuxiliaryID values in Punch-in messages has changed to enhance consistency across product identifiers used in Amazon Business integration products and simplify integration with external systems. With this change, this field is standardized to the following format:
- Length: 20 characters
- Format: asid-XXXXXXXXXXXXXXX
| Message | Field | Previous value example | Current value |
|---|---|---|---|
| Punchout Order Message (POOM) | SupplierPartAuxiliaryID | 135-5032014-0581365,1 | asid-PsS5DbBHeSh3t3Q |
| Purchase Order (PO) | SupplierPartAuxiliaryID | 135-5032014-0581365,1 | asid-PsS5DbBHeSh3t3Q |
These values are case-sensitive. Sending values that do not exactly match the desired ID could result in order rejection.
What’s changed: SupplierPartAuxiliaryID field format
SupplierPartAuxiliaryID field formatSupported regions: NA, EU, FE
The format and length of the SupplierPartAuxiliaryID values in the QuoteMessage document has changed to enhance consistency across product identifiers used in Amazon Business integration products and simplify integration with external systems. With this change, this field is standardized to the following format:
- Length: 20 characters
- Format: asid-XXXXXXXXXXXXXXX
| Field | Previous value example | Current value |
|---|---|---|
SupplierPartAuxiliaryID | 135-5032014-0581365,1 | asid-PsS5DbBHeSh3t3Q |
These values are case-sensitive. Sending values that do not exactly match the desired ID could result in order rejection.
August 2025
What’s new: App listing preview
Supported regions: NA, EU, FE
You can now preview your unpublished App Center listing content. This feature allows you to preview how your app will display in App Center once published and test the authorization workflow. For more information, see List your app in Amazon Business App Center .
July 2025
Invoice and credit memo PDF download support for IDU and STEP
Supported regions: EU
Document API now supports downloading invoice and credit memo documents for Invoice Document Upload (IDU) and Seller Tax Exempted Program (STEP) transactions in EU. For more information about retrieving these documents, see For more information, see How to download invoices.
What’s new: Retrieve documents using only orderId
orderIdSupported regions: EU
The createReport operation has been updated to accept orderId as the only required input in the reportOptions object to retrieve a report ID. The existing orderlineItemId, shipmentId, and documentType fields can still be passed in the request, but are optional. For more information, see How to download invoices.
{
"reportType": "GET_AB_INVOICE_PDF",
"marketplaceIds": [
"A1PA6795UKMFR9"
],
"reportOptions": {
"orderId": "203-9277085-5441169"
}
}
{
"reportId": "ID323"
}
June 2025
What’s changed: e-Invoicing for Ordering API purchase order line numbers
Supported regions: NA, EU
To successfully generate e-Invoices for orders placed using Ordering API, purchase order line numbers must now be numeric only. These values are passed in the line item-level externalId fields. Sending alphanumeric line item numbers in these fields can result in e-Invoice errors. Spaces and empty strings are also considered alphanumeric.
{
"lineItems": [
{
"quantity": 1,
"externalId": "12345",
"attributes": [
{
"attributeType": "SelectedProductReference",
"productReference": {
"id": "B01GGKYS6E",
"productReferenceType": "ProductIdentifier"
}
},
{
"attributeType": "Auxiliary",
"values": {
"subCategory": {
"value": "GENERAL_OFFICE_SUPPLIES"
},
"category": {
"value": "OFFICE_PRODUCTS"
}
}
},
{
"charge": {
"amount": {
"amount": 109.99,
"currencyCode": "USD"
}
},
"attributeType": "Distribution",
"accounting": {
"name": "XYZ Corporation",
"segments": [
{
"description": "DeptId",
"id": "001",
"type": "DeptId"
},
{
"description": "OpUnit",
"id": "002",
"type": "OpUnit"
}
]
}
}
],
"expectations": [
{
"amount": {
"amount": 101,
"currencyCode": "USD"
},
"expectationType": "ExpectedUnitPrice"
},
{
"amount": {
"amount": 102,
"currencyCode": "USD"
},
"expectationType": "ExpectedCharge",
"source": "SUBTOTAL"
},
{
"requestedDeliveryDate": "2026-01-30T21:32:44.511301Z",
"expectationType": "ExpectedDeliveryDate"
}
]
}
],
"externalId": "",
"attributes": [
{
"attributeType": "PurchaseOrderNumber",
"purchaseOrderNumber": "US Order"
},
{
"attributeType": "BuyingGroupReference",
"groupReference": {
"identifier": "OrderingAPI1234567891",
"groupReferenceType": "GroupIdentity"
}
},
{
"attributeType": "BuyerReference",
"userReference": {
"emailAddress": "test@ amazon.com",
"userReferenceType": "UserEmail"
}
},
{
"attributeType": "Region",
"region": "US"
},
{
"address": {
"address": {
"stateOrRegion": "WA",
"phoneNumber": "",
"city": "Any Town",
"addressType": "PhysicalAddress",
"countryCode": "US",
"companyName": "AnyCompany",
"postalCode": "",
"fullName": "AnyCompany",
"addressLine1": "123 Any Street"
},
"addressType": "ExternalAddress",
"addressId": "EXTERNAL_ADDRESS_ID"
},
"attributeType": "ShippingAddress"
},
{
"address": {
"address": {
"stateOrRegion": "WA",
"phoneNumber": "",
"city": "Any Town",
"addressType": "PhysicalAddress",
"countryCode": "US",
"companyName": "AnyCompany",
"postalCode": "",
"fullName": "AnyCompany",
"addressLine1": "123 Any Street"
},
"addressType": "ExternalAddress",
"addressId": "EXTERNAL_ADDRESS_ID"
},
"attributeType": "BillingAddress"
},
{
"paymentMethodReference": {
"paymentMethodReferenceType": "StoredPaymentMethod"
},
"attributeType": "SelectedPaymentMethodReference"
}
],
"expectations": [
{
"amount": {
"amount": 103,
"currencyCode": "USD"
},
"expectationType": "ExpectedCharge",
"source": "TAX"
},
{
"amount": {
"amount": 104,
"currencyCode": "USD"
},
"expectationType": "ExpectedCharge",
"source": "SHIPPING"
},
{
"amount": {
"amount": 105,
"currencyCode": "USD"
},
"expectationType": "ExpectedCharge",
"source": "SUBTOTAL"
},
{
"requestedDeliveryDate": "2026-01-30T21:32:44.502457Z",
"expectationType": "ExpectedDeliveryDate"
}
]
}
{
"lineItems": [
{
"externalId": "12345",
"acceptedItems": [
{
"quantity": 1,
"artifacts": [
{
"acceptanceArtifactType": "DeliveryTimeRange",
"lowerBoundary": "2025-03-10T07:00:00Z",
"upperBoundary": "2025-03-11T06:59:59Z"
},
{
"acceptanceArtifactType": "UnitPrice",
"amount": {
"currencyCode": "USD",
"amount": 7.99
}
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 7.99
},
"category": "SUBTOTAL",
"type": "PRINCIPAL"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 6.99
},
"category": "SHIPPING",
"type": "PRINCIPAL"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 0.42
},
"category": "SHIPPING",
"type": "TAX"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 0.48
},
"category": "SUBTOTAL",
"type": "TAX"
},
{
"acceptanceArtifactType": "OrderIdentifier",
"identifier": "113-1746647-0749053"
}
]
}
],
"rejectedItems": []
}
],
"acceptanceArtifacts": [
{
"acceptanceArtifactType": "Signed"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 7.99
},
"category": "SUBTOTAL",
"type": "PRINCIPAL"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 6.99
},
"category": "SHIPPING",
"type": "PRINCIPAL"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 0.42
},
"category": "SHIPPING",
"type": "TAX"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 0.48
},
"category": "SUBTOTAL",
"type": "TAX"
}
],
"rejectionArtifacts": []
}
May 2025
What’s new: isBundledAsin
isBundledAsinSupported regions: NA, EU, FE
Product Search API now returns an isBundledAsin field in the products object. This field is a boolean that indicates if a product is a bundled ASIN. A bundled ASIN is a single ASIN that represents multiple products or services that are bundled together and sold as a single unit. Note that bundled ASINs cannot be purchased via direct ordering.
To return a true or false response for this field, include isBundledAsin in the inclusionsForProducts query parameter. If not specified, isBundledAsin returns null in the API response by default. This field is returned in the searchProductsRequest, productsRequest, and getProductsByAsins API responses.
https://na.business-api.amazon.com/products/2020-08-26/products?inclusionsForProducts=isBundledAsin&facets=OFFERS&productRegion=US&locale=en_US&searchRefinements=&keywords=B0BWYL8WRV
{
"matchingProductCount": 1,
"searchRefinements": [
{
"selectionType": "SingleSelect",
"displayValue": "Department",
"refinementValues": [
{
"displayName": "Alexa Skills",
"searchRefinementValue": "node#13727921011"
},
{
"displayName": "Amazon Devices & Accessories",
"searchRefinementValue": "node#16333372011"
},
{
"displayName": "Appliances",
"searchRefinementValue": "node#2619525011"
},
{
"displayName": "Apps & Games",
"searchRefinementValue": "node#2350149011"
},
{
"displayName": "Arts, Crafts & Sewing",
"searchRefinementValue": "node#2617941011"
},
{
"displayName": "Audible Books & Originals",
"searchRefinementValue": "node#18145289011"
},
{
"displayName": "Automotive",
"searchRefinementValue": "node#15684181"
},
{
"displayName": "Baby Products",
"searchRefinementValue": "node#165796011"
},
{
"displayName": "Beauty & Personal Care",
"searchRefinementValue": "node#3760911"
},
{
"displayName": "Books",
"searchRefinementValue": "node#283155"
},
{
"displayName": "CDs & Vinyl",
"searchRefinementValue": "node#5174"
},
{
"displayName": "Cell Phones & Accessories",
"searchRefinementValue": "node#2335752011"
},
{
"displayName": "Clothing, Shoes & Jewelry",
"searchRefinementValue": "node#7141123011"
},
{
"displayName": "Collectibles & Fine Art",
"searchRefinementValue": "node#4991425011"
},
{
"displayName": "Credit & Payment Cards",
"searchRefinementValue": "node#3561432011"
},
{
"displayName": "Digital Music",
"searchRefinementValue": "node#163856011"
},
{
"displayName": "Electronics",
"searchRefinementValue": "node#172282"
},
{
"displayName": "Everything Else",
"searchRefinementValue": "node#10272111"
},
{
"displayName": "Gift Cards",
"searchRefinementValue": "node#2238192011"
},
{
"displayName": "Grocery & Gourmet Food",
"searchRefinementValue": "node#16310101"
},
{
"displayName": "Handmade Products",
"searchRefinementValue": "node#11260432011"
},
{
"displayName": "Health & Household",
"searchRefinementValue": "node#3760901"
},
{
"displayName": "Home & Business Services",
"searchRefinementValue": "node#8098158011"
},
{
"displayName": "Home & Kitchen",
"searchRefinementValue": "node#1055398"
},
{
"displayName": "Industrial & Scientific",
"searchRefinementValue": "node#16310091"
},
{
"displayName": "Kindle Store",
"searchRefinementValue": "node#133140011"
},
{
"displayName": "Magazine Subscriptions",
"searchRefinementValue": "node#599858"
},
{
"displayName": "Movies & TV",
"searchRefinementValue": "node#2625373011"
},
{
"displayName": "Musical Instruments",
"searchRefinementValue": "node#11091801"
},
{
"displayName": "Office Products",
"searchRefinementValue": "node#1064954"
},
{
"displayName": "Patio, Lawn & Garden",
"searchRefinementValue": "node#2972638011"
},
{
"displayName": "Pet Supplies",
"searchRefinementValue": "node#2619533011"
},
{
"displayName": "Software",
"searchRefinementValue": "node#229534"
},
{
"displayName": "Sports & Outdoors",
"searchRefinementValue": "node#3375251"
},
{
"displayName": "Tools & Home Improvement",
"searchRefinementValue": "node#228013"
},
{
"displayName": "Toys & Games",
"searchRefinementValue": "node#165793011"
},
{
"displayName": "Video Games",
"searchRefinementValue": "node#468642"
}
]
},
{
"selectionType": "SingleSelect",
"displayValue": "Departments",
"refinementValues": []
}
],
"refinements": {
"categories": [
{
"displayName": "Alexa Skills",
"id": "ALEXA_SKILLS"
},
{
"displayName": "Amazon Devices & Accessories",
"id": "AMAZON_DEVICES_ACCESSORIES"
},
{
"displayName": "Appliances",
"id": "APPLIANCES"
},
{
"displayName": "Apps & Games",
"id": "APPS_GAMES"
},
{
"displayName": "Arts, Crafts & Sewing",
"id": "ARTS_CRAFTS_SEWING"
},
{
"displayName": "Audible Books & Originals",
"id": "AUDIBLE_BOOKS_ORIGINALS"
},
{
"displayName": "Automotive",
"id": "AUTOMOTIVE"
},
{
"displayName": "Baby Products",
"id": "BABY_PRODUCTS"
},
{
"displayName": "Beauty & Personal Care",
"id": "BEAUTY_PERSONAL_CARE"
},
{
"displayName": "Books",
"id": "BOOKS"
},
{
"displayName": "CDs & Vinyl",
"id": "CDS_VINYL"
},
{
"displayName": "Cell Phones & Accessories",
"id": "CELL_PHONES_ACCESSORIES"
},
{
"displayName": "Clothing, Shoes & Jewelry",
"id": "CLOTHING_SHOES_JEWELRY"
},
{
"displayName": "Collectibles & Fine Art",
"id": "COLLECTIBLES_FINE_ART"
},
{
"displayName": "Digital Music",
"id": "DIGITAL_MUSIC"
},
{
"displayName": "Electronics",
"id": "ELECTRONICS"
},
{
"displayName": "Everything Else",
"id": "EVERYTHING_ELSE"
},
{
"displayName": "Gift Cards",
"id": "GIFT_CARDS"
},
{
"displayName": "Grocery & Gourmet Food",
"id": "GROCERY_GOURMET_FOOD"
},
{
"displayName": "Handmade Products",
"id": "HANDMADE_PRODUCTS"
},
{
"displayName": "Health & Household",
"id": "HEALTH_HOUSEHOLD"
},
{
"displayName": "Home & Business Services",
"id": "HOME_BUSINESS_SERVICES"
},
{
"displayName": "Home & Kitchen",
"id": "HOME_KITCHEN"
},
{
"displayName": "Industrial & Scientific",
"id": "INDUSTRIAL_SCIENTIFIC"
},
{
"displayName": "Kindle Store",
"id": "KINDLE_STORE"
},
{
"displayName": "Magazine Subscriptions",
"id": "MAGAZINE_SUBSCRIPTIONS"
},
{
"displayName": "Movies & TV",
"id": "MOVIES_TV"
},
{
"displayName": "Musical Instruments",
"id": "MUSICAL_INSTRUMENTS"
},
{
"displayName": "Office Products",
"id": "OFFICE_PRODUCTS"
},
{
"displayName": "Patio, Lawn & Garden",
"id": "PATIO_LAWN_GARDEN"
},
{
"displayName": "Pet Supplies",
"id": "PET_SUPPLIES"
},
{
"displayName": "Software",
"id": "SOFTWARE"
},
{
"displayName": "Sports & Outdoors",
"id": "SPORTS_OUTDOORS"
},
{
"displayName": "Tools & Home Improvement",
"id": "TOOLS_HOME_IMPROVEMENT"
},
{
"displayName": "Toys & Games",
"id": "TOYS_GAMES"
},
{
"displayName": "Video Games",
"id": "VIDEO_GAMES"
}
],
"subCategories": [],
"availabilityOptions": [],
"deliveryDayOptions": [],
"eligibleForFreeShippingOptions": [],
"primeEligible": []
},
"numberOfPages": 1,
"products": [
{
"asin": "B0BWYL8WRV",
"asinType": "STANDARD",
"signedProductId": "amzn1.business.asin.7PDD4X7FGMA7UQ2GIQTWI2LRMFZG423ZORUGOZLEG5ZGMY3BONQQQSMYUFFS3DB4SMQWFXZT5H7F4ZTEEMGHKPHXG4IVEEWVM4DQVTOA4X3R6MUXGK7BIKP5W4WJFYV2ZMO5ZFVTXRH34NAPXXWWNNOT72QF6Z4GRLAJ6POHI7LH62UKVHHA",
"includedDataTypes": {
"OFFERS": [
{
"availability": "In Stock.",
"buyingGuidance": "UNKNOWN",
"buyingGuidanceV2": null,
"buyingRestrictions": [],
"fulfillmentType": "AMAZON_FULFILLMENT",
"merchant": {
"merchantId": null,
"name": "GRANNY SAYS",
"meanFeedbackRating": null,
"totalFeedbackCount": null,
"certificates": []
},
"fulfiller": {
"name": "Amazon",
"fulfillmentType": "AMAZON_FULFILLMENT"
},
"offerId": "RAgOfsCOmhwUly8iKo3%2BseuelrLeRNwl%2BKazSEkbuxckIqMyHgiYnC5W%2FWcxpvv7%2BElbIRrDUsz91eEp%2B0MJAUZbWa4blTVALWHH2y4pMi0fvgX9aPW%2FLFt5db%2FhGXtaWnm1USnb2EFrNU%2FjTI6WLuNBiHAUu%2BYZSD6hV34ybd0%3D",
"price": {
"value": {
"amount": 62.99,
"currencyCode": "USD"
},
"formattedPrice": null,
"priceType": "OTHER"
},
"shippingOptions": [],
"badges": [
{
"fragment": {
"title": "Business Seller",
"message": "Business Sellers: ",
"link": null,
"type": "BUSINESS_INVOICE_BADGE",
"fragments": null
}
}
],
"quantityInStock": null,
"listPrice": {
"value": {
"amount": 66.98,
"currencyCode": "USD"
},
"formattedPrice": null,
"priceType": "OTHER"
},
"productCondition": "NEW",
"productConditionNote": "",
"condition": {
"conditionValue": "NEW",
"conditionNote": "",
"subCondition": "UNKNOWN"
},
"quantityLimits": {
"maxQuantity": 30,
"minQuantity": 1
},
"quantityPrice": {
"quantityPriceTiers": []
},
"taxExclusivePrice": {
"taxExclusiveAmount": null,
"displayString": "",
"formattedPrice": "",
"label": ""
},
"deliveryInformation": ""
}
]
},
"features": null,
"editorialReviews": null,
"taxonomies": null,
"packageTypeNames": null,
"title": null,
"url": "https://www.amazon.com/dp/B0BWYL8WRV?ref_=ab_psdp",
"format": null,
"bookInformation": null,
"byLine": null,
"mediaInformation": null,
"productOverview": null,
"productDetails": null,
"productVariations": {
"dimensions": [],
"variations": []
},
"customerReviewsSummary": null,
"productDescription": null,
"upcValues": [],
"eanValues": [],
"modelNumber": null,
"manufacturerName": null,
"bundleQuantity": null,
"badges": null,
"isBundledAsin": true
}
]
}
What’s new: chargeIdentifier
chargeIdentifier Supported regions: NA, EU
Reconciliation API now returns a chargeIdentifier field in the transactions object. The charge identifier is a unique number that is generated for credit card payments. Customers can use this number to map Amazon Business purchases to purchases on their credit card statements. This field is returned in the getTransactions API response.
GET https://na.business-api.amazon.com/reconciliation/2021-01-08/transactions?feedStartDate=2025-04-16T14:54:25.155&feedEndDate=2025-04-16T14:54:25.155
{
"transactions": [
{
"marketplaceId": "A1PA6795UKMFR9",
"transactionDate": "2025-04-16T14:47:14.962Z",
"feedDate": "",
"transactionType": "REFUND",
"transactionId": "123bzrs0bnzmXzbw0AbC",
"chargeIdentifier": "RH91K52Y4",
"shipTaxRate": "0.00",
"giftWrapTaxRate": "0.00",
"legalEntityName": "AnyDepartment",
"purchasingCustomerGroupName": "TEST",
"amount": {
"currencyCode": "EUR",
"amount": "5.07"
},
"paymentInstrumentType": "Visa",
"paymentInstrumentLast4Digits": "2618",
"buyer": {
"id": "amzn1.account.X72NY5YYCYMMB7VGBFKHEMTUNF2GINLRMZYGCNTDNB2TGN32NFQW25RJQZX45W7YFI4IWWYOLY4HVQ2TGK3NLW6JQVU4R4K7UY5ZPRI",
"name": "AnyCompany DE",
"email": "[email protected]"
},
"payer": null,
"associatedTransactionDetails": [],
"transactionLineItems": [
{
"refundReason": "ShippingAddressUndeliverable",
"totalAmount": {
"currencyCode": "EUR",
"amount": "5.07"
},
"principalAmount": {
"currencyCode": "EUR",
"amount": "2.59"
},
"shippingCharge": {
"currencyCode": "EUR",
"amount": "1.67"
},
"regulatoryFee": null,
"giftWrappingCharge": null,
"discount": null,
"tax": {
"currencyCode": "EUR",
"amount": "0.81"
},
"unitPrice": {
"currencyCode": "EUR",
"amount": "2.59"
},
"taxRate": "0.00",
"orderId": "028-4166691-2177920",
"unspsc": "44121700",
"orderLineItemId": "48144077301002",
"purchaseOrderNumber": null,
"purchaseOrderLineItemId": null,
"asin": "B08FR3C8NL",
"productTitle": "Pentel SESP15-AX Brush Sign Pen Pigment mit pigmentierter Tinte, Faserschreiber, pinselähnliche Spitze, schwarz, 1 Stück",
"itemQuantity": 1,
"shipmentId": "U1F5bSZql",
"shipmentDate": null,
"merchantLegalName": "Amazon EU S.a.r.L.",
"budgetId": null,
"businessOrderInfo": null
}
]
}
],
"nextPageToken": null
}
April
What’s new: Ordering API e-Invoicing support
Supported regions: NA, EU, FE
Ordering API now supports e-Invoicing. To enable parity between cXML and API-based ordering and e-Invoice generation, these new fields have been added to the Ordering API placeOrder operation request:
Distribution: Distribution divides the cost of an item among multiple parties. Suppliers return the Distribution element on invoices to facilitate the buyer’s reconciliation process. This attribute includes anaccountingobject and achargeobject.ExternalAddress: The combination of an external address ID and a detailed address.
Additionally, the auxiliary attribute type can be used to pass data from the purchase order to the e-Invoice. This attribute contains key/value pairs that can be used to provide any additional detail you require for reconciliation. A maximum of 30 key/value pairs can be included per API request.
When the Amazon Business group used to place the order is enabled for e-Invoicing, Amazon Business generates an e-Invoice for the order. For instructions to enable this feature, see How to enable e-Invoicing for Ordering API.
POST https://na.business-api.amazon.com/ordering/2022-10-30/orders
{
"lineItems": [
{
"quantity": 1,
"externalId": "li_1",
"attributes": [
{
"attributeType": "SelectedProductReference",
"productReference": {
"id": "B01GGKYS6E",
"productReferenceType": "ProductIdentifier"
}
},
{
"attributeType": "Auxiliary",
"values": {
"subCategory": {
"value": "GENERAL_OFFICE_SUPPLIES"
},
"category": {
"value": "OFFICE_PRODUCTS"
}
}
},
{
"charge": {
"amount": {
"amount": 109.99,
"currencyCode": "USD"
}
},
"attributeType": "Distribution",
"accounting": {
"name": "XYZ Corporation",
"segments": [
{
"description": "DeptId",
"id": "001",
"type": "DeptId"
},
{
"description": "OpUnit",
"id": "002",
"type": "OpUnit"
}
]
}
}
],
"expectations": [
{
"amount": {
"amount": 101,
"currencyCode": "USD"
},
"expectationType": "ExpectedUnitPrice"
},
{
"amount": {
"amount": 102,
"currencyCode": "USD"
},
"expectationType": "ExpectedCharge",
"source": "SUBTOTAL"
},
{
"requestedDeliveryDate": "2026-01-30T21:32:44.511301Z",
"expectationType": "ExpectedDeliveryDate"
}
]
}
],
"externalId": "",
"attributes": [
{
"attributeType": "PurchaseOrderNumber",
"purchaseOrderNumber": "US Order"
},
{
"attributeType": "BuyingGroupReference",
"groupReference": {
"identifier": "OrderingAPI1234567891",
"groupReferenceType": "GroupIdentity"
}
},
{
"attributeType": "BuyerReference",
"userReference": {
"emailAddress": "[email protected]",
"userReferenceType": "UserEmail"
}
},
{
"attributeType": "Region",
"region": "US"
},
{
"address": {
"address": {
"stateOrRegion": "VA",
"phoneNumber": "",
"city": "Ashburn",
"addressType": "PhysicalAddress",
"countryCode": "US",
"companyName": "Amazon",
"postalCode": "",
"fullName": "Amazon",
"addressLine1": "** Farmwell Hunt Plaza"
},
"addressType": "ExternalAddress",
"addressId": "EXTERNAL_ADDRESS_ID"
},
"attributeType": "ShippingAddress"
},
{
"address": {
"address": {
"stateOrRegion": "VA",
"phoneNumber": "****",
"city": "Ashburn",
"addressType": "PhysicalAddress",
"countryCode": "US",
"companyName": "Amazon",
"postalCode": "",
"fullName": "Amazon",
"addressLine1": " Farmwell Hunt Plaza"
},
"addressType": "ExternalAddress",
"addressId": "EXTERNAL_ADDRESS_ID"
},
"attributeType": "BillingAddress"
},
{
"paymentMethodReference": {
"paymentMethodReferenceType": "StoredPaymentMethod"
},
"attributeType": "SelectedPaymentMethodReference"
}
],
"expectations": [
{
"amount": {
"amount": 103,
"currencyCode": "USD"
},
"expectationType": "ExpectedCharge",
"source": "TAX"
},
{
"amount": {
"amount": 104,
"currencyCode": "USD"
},
"expectationType": "ExpectedCharge",
"source": "SHIPPING"
},
{
"amount": {
"amount": 105,
"currencyCode": "USD"
},
"expectationType": "ExpectedCharge",
"source": "SUBTOTAL"
},
{
"requestedDeliveryDate": "2026-01-30T21:32:44.502457Z",
"expectationType": "ExpectedDeliveryDate"
}
]
}
{
"lineItems": [
{
"externalId": "li_1",
"acceptedItems": [
{
"quantity": 1,
"artifacts": [
{
"acceptanceArtifactType": "DeliveryTimeRange",
"lowerBoundary": "2025-03-10T07:00:00Z",
"upperBoundary": "2025-03-11T06:59:59Z"
},
{
"acceptanceArtifactType": "UnitPrice",
"amount": {
"currencyCode": "USD",
"amount": 7.99
}
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 7.99
},
"category": "SUBTOTAL",
"type": "PRINCIPAL"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 6.99
},
"category": "SHIPPING",
"type": "PRINCIPAL"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 0.42
},
"category": "SHIPPING",
"type": "TAX"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 0.48
},
"category": "SUBTOTAL",
"type": "TAX"
},
{
"acceptanceArtifactType": "OrderIdentifier",
"identifier": "113-1746647-0749053"
}
]
}
],
"rejectedItems": []
}
],
"acceptanceArtifacts": [
{
"acceptanceArtifactType": "Signed"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 7.99
},
"category": "SUBTOTAL",
"type": "PRINCIPAL"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 6.99
},
"category": "SHIPPING",
"type": "PRINCIPAL"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 0.42
},
"category": "SHIPPING",
"type": "TAX"
},
{
"acceptanceArtifactType": "Charge",
"amount": {
"currencyCode": "USD",
"amount": 0.48
},
"category": "SUBTOTAL",
"type": "TAX"
}
],
"rejectionArtifacts": []
}
March
What’s changed: Document API retention period
Supported regions: NA, EU, FE
Reports created using the Document API createReport operation are now retained for a maximum of 30 days. This means that you can access a report for up to 30 days after creating it. After 30 days have passed, you will need to request a new report by calling the createReport operation. For more information, see How to download invoices.
February 2025
Solution Provider Portal
What’s changed: Developer Central is now Solution Provider Portal
Supported regions: NA, EU, FE
Developer Central is now Solution Provider Portal (SPP), a centralized hub for managing Amazon Business API integrations. The developercentral.amazon.com URL will now redirect to https://solutionproviderportal.amazon.com. In addition to existing features from Developer Central, SPP introduces an API usage dashboard that allows you to view the number of successful API calls and errors by operation and app client.
What action is required?
- Existing Amazon Business developers: No action is required for existing developers. Any Amazon Business API integrations or App Center listings created through Developer Central will continue to function as usual.
- New Amazon Business developers: You will register directly on SPP to manage your API integrations, access the API sandbox, create and list applications, and review usage metrics.
January 2025
What’s new:shippingOptions
shippingOptionsSupported regions: NA, EU, FE
The Product Search API now returns shippingOptions in the offer object. shippingOptions conveys comprehensive information about an offer’s available shipping options, and is returned at the offer level in all Product Search API operations. This object returns the following details:
shippingCost: The cost associated with this shipping option.deliveryRange: The range of delivery dates in UTC time zone.deliveryInformation: String message containing the estimated delivery time and delivery price.thresholdCost: The threshold for free shipping. When the total cost of the order exceeds this cost, shipping is free.
"shippingOptions": [
{
"shippingCost": {
"value": {
"amount": 6.99,
"currencyCode": "USD"
}
},
"deliveryRange": {
"max": "2024-12-28T04:00:00Z",
"min": "2024-12-28T04:00:00Z"
},
"deliveryInformation": "FREE delivery Friday, December 27 on orders shipped by Amazon over $35",
"thresholdCost": {
"value": {
"amount": 35,
"currencyCode": "USD"
}
}
},
{
"shippingCost": {
"value": {
"amount": 9.99,
"currencyCode": "USD"
}
},
"deliveryRange": {
"max": "2024-12-24T04:00:00Z",
"min": "2024-12-24T04:00:00Z"
},
"deliveryInformation": "$9.99 delivery Monday, December 23. Order within 20 hrs",
"thresholdCost": null
}
]
What’s new: customerReviewsSummary
customerReviewsSummarySupported regions: NA, EU, FE
Product Search API now returns customerReviewsSummary in the productsResult object. customerReviewsSummary contains information on a product’s customer ratings and is returned in the searchProductsRequest, productsRequest, and getProductsByAsins API responses. This object contains the following fields:
numberOfRatings: The number of customer ratings for a product.starRating: The star rating for a product.
This feature is only available for products displayed in eProcurement systems.
"CustomerReviewsSummary": {
"numberOfRatings": 3448,
"starRating": 4.8
}
What’s new: Prime badge and free shipping indicators for offers and products
Supported regions: NA, EU, FE
Product Search API now returns a PRIME_BADGE for applicable products. This badge identifies when an offer is eligible for Amazon Business Prime free shipping and the customer has signed up for Business Prime. If the offer supports free shipping, a free shipping indicator is returned in the message attribute. This badge is returned in the badges field in the offers object. All four Product Search API operations return this badge: searchProductsRequest, productsRequest, searchOffersRequest, and getProductsByAsins.
Sample response:
"badges": {
"badges": [
{
"type": "PRIME_BADGE",
"title": "Amazon Prime",
"link": null,
"fragments": null,
"message": null
}
]
}