Get all Amazon Business orders

Learn how to get all Amazon Business orders.

Prerequisites

To complete this tutorial, you need:

• Authorization from the selling partner for whom you are making calls. For more information, refer to Authorizing Selling Partner API applications.
• At least one of the following roles assigned to your developer profile and selected in the app registration page:
  • The Amazon Fulfillment role.
  • The Buyer Communication role.
  • The Buyer Solicitation role.
  • The Finance and Accounting role.
  • The Inventory and Order Tracking role.
  • The Pricing role.
  • The Product Listing role.
  • The Professional Services (Restricted) role.
  • The Selling Partner Insights role.
  • The Direct to Consumer Shipping (Restricted) role.
  • The Tax Invoicing (Restricted) role.
  • The Tax Remittance (Restricted) role.

To access Personally Identifiable Information (PII), you must have approval for the following roles:

• Direct-to-Consumer Delivery (Restricted) role is required to access shipping address information.
• The Tax Remittance (Restricted) role is required to access buyer information.
• The Tax Invoicing (Restricted) role is required to access buyer information.

You do not need a Restricted Data Token to access PII with the Orders API v2026-01-01.

Get all Amazon Business orders

Call the searchOrders operation and use the includedData parameter to specify the information you want the response to include. A successful response includes an orders array, An order is an Amazon Business order if the programs response attribute includes AMAZON_BUSINESS.

Get all Amazon Business orders with delivery preferences

Call the searchOrders operation and use the includedData parameter with the RECIPIENT value.

A successful response includes an orders array. Delivery preferences are exclusive to Amazon Business orders, identifiable by the AMAZON_BUSINESS value in the programs response attribute. The delivery preferences for an Amazon Business order can be accessed through the recipient.deliveryPreference response attribute.

If the customer did not specify delivery preferences for the address, the recipient.deliveryPreference response attribute returns the default business hours for the region.

Get order details for an Amazon Business order

Call the getOrder operation (Orders API v2026-01-01) with the orderID of the Amazon Business order and include the includedData parameter with the information you want the response to include. A successful response includes an order object, which contains information about the order. An order is an Amazon Business order if the value of the programs response attribute includes AMAZON_BUSINESS.

Get order details with delivery preferences for an Amazon Business order

Call the getOrder operation (Orders API v2026-01-01) with the orderID of the Amazon Business order and use the includedData parameter with the RECIPIENT value.

A successful response includes an order object, which contains information about the order. An order is an Amazon Business order if the value of the programs response attribute includes AMAZON_BUSINESS. The delivery preferences for an Amazon Business order can be accessed through the recipient.deliveryPreference response attribute.

If the customer did not specify delivery preferences for the address, the recipient.deliveryPreference response attribute returns the default business hours for the region.