Release Notes 2025
Amazon Business API new features, bug fixes, and change log.
Get updates. Subscribe to our RSS feed.
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
orderId
Supported 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
isBundledAsin
Supported 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 anaccounting
object and acharge
object.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
shippingOptions
Supported 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
customerReviewsSummary
Supported 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
}
]
}