Orders API

You use the Orders API to retrieve order information. You can develop custom applications that facilitate order synchronization and order research.

Version migration

The Orders API v0 is deprecated. Learn how to migrate to the Orders API v2026-01-01 in the Orders API Migration Guide.

Release notes

• January 28, 2026
• October 1, 2025
• June 25, 2025
• September 25, 2024
• September 11, 2024
• April 24, 2024
• January 31, 2024
• October 11, 2023
• September 20, 2023
• August 16, 2023
• March 29, 2023
• January 25, 2023
• August 10, 2022
• May 18, 2022
• March 23, 2022
• January 19, 2022

To learn more about the terms that are used in this guide, refer to Terminology.

📘

Note

Orders more than two years old don't show in the API response, except for the SG, JP, and AU marketplaces, which support orders from 2016 onwards.

Use cases

The following use case examples are available for the Orders API:

• Access Orders PII: Learn how to access Personally Identifiable Information with the Orders API.
• Get orders with filtering criteria: The searchOrders operation of the Orders API returns orders created or updated during the time frame or other filtering criteria indicated by parameters you specify.
• Get order information: The getOrder operation of the Orders API returns order information that you specify.
• Confirm the shipment status: The confirmShipment operation of the Orders API confirms the shipment status for a specified order. You can also use this operation to edit shipment details of orders that have been shipped.
• Review if an order contains regulated information: Get the status and regulated information for an order.
• Recognize which orders contain regulated information: After you identify a regulated order, get additional status and regulated information.
• Get an order's regulated information: Get regulated information for an order.
• Approve or reject a regulated order: Approve or reject an order that contains regulated information.
• Provide additional verification details about a regulated order: Provide additional details about the verification of an order that contains regulated information.
• Get all Amazon Business orders: Get orders for a selling partner and identify Amazon Business orders.

Roles for the Orders API v0

confirmShipment

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Inventory and Order Tracking  Direct to Consumer Shipping (Restricted)

getOrder

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Amazon Fulfillment  Buyer Communication  Buyer Solicitation  Direct to Consumer Shipping (Restricted)  Finance and Accounting  Inventory and Order Tracking  Pricing  Product Listing  Professional Services (Restricted)  Selling Partner Insights  Tax Invoicing (Restricted)  Tax Remittance (Restricted)

getOrderAddress

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Amazon Fulfillment  Buyer Communication  Buyer Solicitation  Finance and Accounting  Inventory and Order Tracking  Pricing  Product Listing  Professional Services (Restricted)  Selling Partner Insights  Direct to Consumer Shipping (Restricted)  Tax Invoicing (Restricted)  Tax Remittance (Restricted)

getOrderBuyerInfo

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Amazon Fulfillment  Buyer Communication  Buyer Solicitation  Finance and Accounting  Inventory and Order Tracking  Pricing  Product Listing  Professional Services (Restricted)  Selling Partner Insights  Direct to Consumer Shipping (Restricted)  Tax Invoicing (Restricted)  Tax Remittance (Restricted)

getOrderItems

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Amazon Fulfillment  Buyer Communication  Buyer Solicitation  Finance and Accounting  Inventory and Order Tracking  Pricing  Product Listing  Professional Services (Restricted)  Selling Partner Insights  Direct to Consumer Shipping (Restricted)  Tax Invoicing (Restricted)  Tax Remittance (Restricted)

getOrderItemsBuyerInfo

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Amazon Fulfillment  Buyer Communication  Buyer Solicitation  Finance and Accounting  Inventory and Order Tracking  Pricing  Product Listing  Professional Services (Restricted)  Selling Partner Insights  Direct to Consumer Shipping (Restricted)  Tax Invoicing (Restricted)  Tax Remittance (Restricted)

getOrderRegulatedInfo

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Direct to Consumer Shipping (Restricted)

getOrders

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Amazon Fulfillment  Buyer Communication  Buyer Solicitation  Direct to Consumer Shipping (Restricted)  Finance and Accounting  Inventory and Order Tracking  Pricing  Product Listing  Professional Services (Restricted)  Selling Partner Insights  Tax Invoicing (Restricted)  Tax Remittance (Restricted)

updateShipmentStatus

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Inventory and Order Tracking

updateVerificationStatus

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Direct to Consumer Shipping (Restricted)

Roles for the Orders API v2026-01-01

searchOrders

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Amazon Fulfillment  Buyer Communication  Buyer Solicitation  Direct to Consumer Shipping (Restricted)  Finance and Accounting  Inventory and Order Tracking  Pricing  Product Listing  Professional Services (Restricted)  Selling Partner Insights  Tax Invoicing (Restricted)  Tax Remittance (Restricted)

getOrder

Attribute	Value
Regions	NA, EU, FE
Required roles (need at least one)	Amazon Fulfillment  Buyer Communication  Buyer Solicitation  Direct to Consumer Shipping (Restricted)  Finance and Accounting  Inventory and Order Tracking  Pricing  Product Listing  Professional Services (Restricted)  Selling Partner Insights  Tax Invoicing (Restricted)  Tax Remittance (Restricted)