Release Notes 2025
Amazon Business API new features, bug fixes, and change log.
Get updates. Subscribe to our RSS feed.
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 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: 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" } |
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 |
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 |
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
}
]
}