Get authorization to access restricted report types with PII information

Learn how to use the Tokens API to get authorization to access restricted report types with PII information. The getReportDocument operation is considered a restricted operation only when a restricted report type is specified. When calling the createRestrictedDataToken operation to get an RDT for the getReportDocument operation, the specified restricted resource can contain only a specific path, not a generic path.

Prerequisites

To complete this tutorial, you need:

• Authorization from the selling partner for whom you are making calls. Refer to Authorizing Selling Partner API applications for more information.

• Approval for the following roles:

  • Direct-to-consumer shipping. Required to access shipping address information.
  • Tax remittance. Required to access buyer information.
  • Tax invoicing. Required to access buyer information.

  To request access to these roles, refer to Registering as a developer and update your developer profile.

Step 1. Get an RDT

1. Call the createRestrictedDataToken operation.
2. Save the restrictedDataToken value (the RDT) to provide it in the getReportDocument operation.