Get order information

Learn how to use the Orders API to get order information.

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 basic order information

Call the getOrder operation. If you do not specify includedData, then the response will only include basic information about the order and order items, such as orderId, createdTime, salesChannel, programs, orderItemId, product, and other relevant details.

Get order information with custom data sets

Call the getOrder operation and include the includedData parameter with the information you want the response to include.