retrieve amazon orders including buyer pii using sp-api restricted data tokens

domain: amazon-sp-api · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Obtain a standard SP-API access token via LWA as usual, then call the Tokens API `createRestrictedDataToken` endpoint, specifying the `restrictedResources` array with the path and dataElements (e.g., `buyerInfo`, `shippingAddress`) you need.
  2. Use the returned `restrictedDataToken` (RDT) in place of the regular access token in the `x-amz-access-token` header for any API calls that return PII.
  3. Call the Orders API `getOrders` endpoint to retrieve a list of orders; then call `getOrder` with a specific `orderId` using the RDT to get buyer PII fields like `BuyerEmail` and `ShippingAddress`.
  4. RDTs are short-lived (one hour); for batch processing many orders, request a single RDT scoped to the orders resource path and reuse it for all calls within its validity window.
  5. Store buyer PII only as long as necessary to fulfill the order and in accordance with Amazon's data protection policies and your Data Protection Policy agreement.
  6. Log all RDT creation events for audit purposes without logging the token value or the PII it grants access to.

Known gotchas

Related routes

Configure an Amazon SP-API Restricted Data Token (RDT) to access PII fields in order reports and decrypt buyer address data
docs.aws.amazon.com · 5 steps · unrated
query product and inventory data from epicor prophet 21 via its read-only odata api
github.com/mrwuss/p21-api-documentation · 5 steps · unrated
update price and inventory on amazon via sp-api listings feeds
amazon-sp-api · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans