Access Orders PII

Learn how to use the Orders API to access a customer's Personally Identifiable Information (PII). In the Orders API v2026-01-01, customer PII includes the following:

• buyer.buyerEmail
• buyer.buyerName
• orderItems.fulfillment.packing.giftOption.giftMessage
• orderItems.product.customization.customizedUrl
• recipient.deliveryAddress.name
• recipient.deliveryAddress.addressLine1
• recipient.deliveryAddress.addressLine2
• recipient.deliveryAddress.addressLine3
• recipient.deliveryAddress.postalCode
• recipient.deliveryAddress.phone
• recipient.deliveryAddress.extendedFields

📘

Note

Accessing PII with the Orders API v2026-01-01 does not require a Restricted Data Token (RDT).

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.

Get buyer’s email for orders

Call the searchOrders operation or the getOrder operation Orders API v2026-01-01. Include the includedData parameter with the BUYER value, along with any other desired data sets. The buyer’s email is in the buyer.buyerEmail response attribute.

Get buyer’s name for orders

Call the searchOrders operation or the getOrder operation Orders API v2026-01-01. Include the includedData parameter with the BUYER value, along with any other desired data sets. The buyer’s name is in the buyer.buyerName response attribute.

Get gift message for orders

Call the searchOrders operation or the getOrder operation Orders API v2026-01-01. Include the includedData parameter with the FULFILLMENT value, along with any other desired data sets. The buyer’s gift message is in the orderItems.fulfillment.packing.giftOption.giftMessage response attribute.

Get buyer customized data for orders

Call the searchOrders operation or the getOrder operation Orders API v2026-01-01. The buyer’s customized data is in the orderItems.product.customization.customizedUrl response attribute.

Get recipient’s phone number for orders

📘

Note

The recipient’s phone number may be suppressed even when the above conditions are met if the phone number is no longer needed for fulfillment. For example, the recipient’s phone number is suppressed for a shipped FBM order when the current date is after the latest delivery date.

Call the searchOrders operation or the getOrder operation Orders API v2026-01-01. The recipient’s phone number is in the recipient.deliveryAddress.phone response attribute.

Get restricted portions of recipient’s delivery address

📘

Note

The recipient's delivery address includes both restricted data and non-restricted data. This tutorial only applies to restricted data. You do not need to meet the preceding conditions to retrieve attributes such as city, districtOrCounty, or countryCode.

Call the searchOrders operation or the getOrder operation Orders API v2026-01-01. Include the includedData parameter with the RECIPIENT value, along with any other desired data sets. The recipient’s delivery address is in the recipient.deliveryAddress response attribute, and includes the following restricted values:

• recipient.deliveryAddress.name
• recipient.deliveryAddress.addressLine1
• recipient.deliveryAddress.addressLine2
• recipient.deliveryAddress.addressLine3
• recipient.deliveryAddress.extendedFields