--- updatedAt: 2026-09-30T21:33:02.000Z agentTools: siteIndex: https://developer-docs.amazon/llms.txt projectIndex: https://developer-docs.amazon/sp-api/llms.txt --- # Access Orders PII Learn how to access Orders Personally Identifiable Information. Learn how to use the [Orders API](https://developer-docs.amazon.com/sp-api/reference/orders-v2026-01-01) 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](https://developer-docs.amazon.com/sp-api/docs/authorizing-selling-partner-api-applications). ## Get buyer’s email for orders | Required roles | Other conditions | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | [Direct-to-Consumer Shipping (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#direct-to-consumer-shipping-restricted) | The order is fulfilled by the merchant.
The order is in `UNSHIPPED`, `PARTIALLY_SHIPPED`, or `SHIPPED` status. | Call the [`searchOrders`](https://developer-docs.amazon.com/sp-api/reference/searchorders) operation or the [`getOrder`](https://developer-docs.amazon.com/sp-api/reference/getorder-3) operation [Orders API v2026-01-01](https://developer-docs.amazon.com/sp-api/reference/orders-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 | Required roles (at least one) | Other conditions | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Order is fulfilled by amazon:** [Tax Invoicing (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#tax-invoicing-restricted) or [Tax Remittance (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#tax-remittance-restricted)
**Order is fulfilled by merchant:** [Tax Invoicing (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#tax-invoicing-restricted), [Tax Remittance (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#tax-remittance-restricted), or [Direct-to-Consumer Shipping (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#direct-to-consumer-shipping-restricted) | The order is in `UNSHIPPED`, `PARTIALLY_SHIPPED`, or `SHIPPED` status.
In the US, Japan, and Singapore stores, developers with the Tax Invoicing (Restricted) role and the Tax Remittance (Restricted) role are not permitted to access buyer’s name. | Call the [`searchOrders`](https://developer-docs.amazon.com/sp-api/reference/searchorders) operation or the [`getOrder`](https://developer-docs.amazon.com/sp-api/reference/getorder-3) operation [Orders API v2026-01-01](https://developer-docs.amazon.com/sp-api/reference/orders-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 | Required role | Other conditions | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | | [Direct-to-Consumer Shipping (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#direct-to-consumer-shipping-restricted) | The order is fulfilled by the merchant. | Call the [`searchOrders`](https://developer-docs.amazon.com/sp-api/reference/searchorders) operation or the [`getOrder`](https://developer-docs.amazon.com/sp-api/reference/getorder-3) operation [Orders API v2026-01-01](https://developer-docs.amazon.com/sp-api/reference/orders-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 | Required role | Other conditions | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | | [Direct-to-Consumer Shipping (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#direct-to-consumer-shipping-restricted) | The order is fulfilled by the merchant. | Call the [`searchOrders`](https://developer-docs.amazon.com/sp-api/reference/searchorders) operation or the [`getOrder`](https://developer-docs.amazon.com/sp-api/reference/getorder-3) operation [Orders API v2026-01-01](https://developer-docs.amazon.com/sp-api/reference/orders-v2026-01-01). The buyer’s customized data is in the `orderItems.product.customization.customizedUrl` response attribute. ## Get recipient’s phone number for orders | Required role | Other conditions | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | [Direct-to-Consumer Shipping (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#direct-to-consumer-shipping-restricted) | The order is fulfilled by the merchant.
The order is in `UNSHIPPED`, `PARTIALLY_SHIPPED`, or `SHIPPED` status. | > 📘 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`](https://developer-docs.amazon.com/sp-api/reference/searchorders) operation or the [`getOrder`](https://developer-docs.amazon.com/sp-api/reference/getorder-3) operation [Orders API v2026-01-01](https://developer-docs.amazon.com/sp-api/reference/orders-v2026-01-01). The recipient’s phone number is in the `recipient.deliveryAddress.phone` response attribute. ## Get restricted portions of recipient’s delivery address | Required roles (at least one) | Other conditions | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Order is fulfilled by amazon:** [Tax Invoicing (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#tax-invoicing-restricted) or [Tax Remittance (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#tax-remittance-restricted)
**Order is fulfilled by merchant:** [Tax Invoicing (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#tax-invoicing-restricted), [Tax Remittance (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#tax-remittance-restricted), or [Direct-to-Consumer Shipping (Restricted)](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#direct-to-consumer-shipping-restricted) | The order is in `UNSHIPPED`, `PARTIALLY_SHIPPED`, or `SHIPPED` status.
In the US, Japan, and Singapore stores, developers with the Tax Invoicing (Restricted) role and the Tax Remittance (Restricted) role are not permitted to access the 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`](https://developer-docs.amazon.com/sp-api/reference/searchorders) operation or the [`getOrder`](https://developer-docs.amazon.com/sp-api/reference/getorder-3) operation [Orders API v2026-01-01](https://developer-docs.amazon.com/sp-api/reference/orders-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` ## PII Redaction logic The following tables show PII data availability by country. In the table, **Yes** means the PII data is available, and **No** means the PII data is not available. ### For US orders
Roles No Restricted roles Tax Remittance role Tax Invoice role Direct-to-Consumer Shipping (Restricted)
Fulfillment Channel FBA/FBM Orders FBA Orders FBM Orders FBA Orders FBM Orders FBA Orders FBM Orders
buyer.buyerEmail No No No No No No Yes
buyer.buyerName No No No No No No Yes
deliveryAddress.name No No No No No No Yes
deliveryAddress.addressLine1 No No No No No No Yes
deliveryAddress.addressLine2 No No No No No No Yes
deliveryAddress.addressLine3 No No No No No No Yes
deliveryAddress.phone No No No No No No Yes
deliveryAddress.postalCode No Yes Yes No No No Yes
deliveryAddress.extendedFields No No No No No No Yes
orderItem.fulfillment.packing.giftOption.giftMessage No No No No No No Yes
orderItem.product.customization.customizedUrl No No No No No No Yes
order.tax.taxRegistrations No Yes Yes Yes Yes No No
### For Japan and Singapore orders
Roles No Restricted roles Tax Remittance/Tax Invoice role Direct-to-Consumer Shipping (Restricted)
Fulfillment Channel FBA/FBM Orders FBA Orders FBM Orders FBA Orders FBM Orders
buyer.buyerEmail No No No No Yes
buyer.buyerName No No No No Yes
deliveryAddress.name No No No No Yes
deliveryAddress.addressLine1 No No No No Yes
deliveryAddress.addressLine2 No No No No Yes
deliveryAddress.addressLine3 No No No No Yes
deliveryAddress.phone No No No No Yes
deliveryAddress.postalCode Yes Yes Yes Yes Yes
deliveryAddress.extendedFields No No No No Yes
orderItem.fulfillment.packing.giftOption.giftMessage No No No No Yes
orderItem.product.customization.customizedUrl No No No No Yes
order.tax.taxRegistrations No Yes Yes No No
### For non-US/Japan/Singapore orders
Roles No Restricted roles Tax Remittance/Tax Invoice role Direct-to-Consumer Shipping (Restricted)
Fulfillment Channel FBA/FBM Orders FBA Orders FBM Orders FBA Orders FBM Orders
buyer.buyerEmail No No No No Yes
buyer.buyerName No Yes Yes No Yes
deliveryAddress.name No Yes Yes No Yes
deliveryAddress.addressLine1 No Yes Yes No Yes
deliveryAddress.addressLine2 No Yes Yes No Yes
deliveryAddress.addressLine3 No Yes Yes No Yes
deliveryAddress.phone No No No No Yes
deliveryAddress.postalCode Yes Yes Yes Yes Yes
deliveryAddress.extendedFields No Yes Yes No Yes
orderItem.fulfillment.packing.giftOption.giftMessage No No No No Yes
orderItem.product.customization.customizedUrl No No No No Yes
order.tax.taxRegistrations No Yes Yes No No