Get tax information

Learn how to use the Orders API to get tax-related information for orders.

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.

Step 1. Get the tax information

To get the Order.tax.taxRegistrations[] information, you must have approval for at least one of the following roles:

• Tax Remittance (Restricted)
• Tax Invoicing (Restricted)

Call the getOrder or searchOrders operation and include TAX in the includedData parameter to get the following tax-related information:

• Order.tax.taxRegistrations[] — buyer, merchant, and marketplace tax registrations
• Order.tax.taxInvoicing — electronic invoice status and buyer invoice preference
• Order.orderItems[].tax.taxCollections[] — marketplace facilitator status per item
• Order.orderItems[].tax.taxCalculationBreakdowns[] — deemed reseller reporting scheme

Step 2. Get buyer tax registrations

To get the buyer tax registration information, you must have approval for at least one of the following roles:

• Tax Remittance (Restricted)
• Tax Invoicing (Restricted)

Extract tax registrations information from Step 1 response using the Order.tax.taxRegistrations[]. Then, filter by Order.tax.taxRegistrations[].entityType == "BUYER" to get the buyer's tax registrations.

Each buyer registration can return the following fields:

• legalName — buyer's legal company name
• taxRegistrationType — registration type (such as VAT, CST, or CPF)
• taxRegistrationNumber — the registration number
• taxRegistrationAddress — buyer's business address (Türkiye only)
• taxRegistrationAttributes[] — additional attributes such as TAX_OFFICE (Türkiye only)

📘

Note

You can get buyer tax registration information for orders in the United Kingdom, France, Germany, Spain, Italy, and the United Arab Emirates.

You can get buyer tax registration information for Türkiye orders where the buyer's invoice preference is BUSINESS.

You can get the VAT and CST buyer tax registration numbers for Amazon Business FBM orders.

You can also get the buyer CPF tax registration number for Brazil orders.

Step 3. Get merchant tax registrations

To get the merchant tax registration information, you must have approval for at least one of the following roles:

• Tax Remittance (Restricted)
• Tax Invoicing (Restricted)

Extract the tax registrations information from Step 1 response using the Order.tax.taxRegistrations[]. Then, filter by Order.tax.taxRegistrations[].entityType == "MERCHANT" to get the merchant's tax registrations.

Currently, only Order.tax.taxRegistrations[].legalName is returned for merchant tax registrations. You can get merchant tax registration information only for Brazil orders that are either pending or unshipped.

Step 4. Get marketplace tax registrations

To get the marketplace tax registration information, you must have approval for at least one of the following roles:

• Tax Remittance (Restricted)
• Tax Invoicing (Restricted)

Extract the tax registrations information from Step 1 response using the Order.tax.taxRegistrations[]. Then, filter by Order.tax.taxRegistrations[].entityType == "MARKETPLACE" to get the marketplace's tax registrations.

Currently, only Order.tax.taxRegistrations[].taxRegistrationType and Order.tax.taxRegistrations[].taxRegistrationNumber are returned for marketplace tax registrations. You can get marketplace tax registration information only for Brazil orders that are either pending or unshipped.

Step 5. Get the electronic invoice status

Extract the tax invoicing information from Step 1 response using the Order.tax.taxInvoicing. The Order.tax.taxInvoicing.invoiceStatus field indicates the electronic invoice lifecycle state.

Use invoiceStatus to control Brazil EasyShip pickup scheduling. Only schedule pickup when the status is ACCEPTED.

📘

Note

This attribute applies only to Brazil EasyShip orders.

Step 6. Get the buyer invoice preference

Extract the tax invoicing information from Step 1 response using the Order.tax.taxInvoicing. The Order.tax.taxInvoicing.buyerInvoicePreference field indicates whether to issue an individual or business invoice.

Use buyerInvoicePreference in Türkiye to route between e-Fatura (BUSINESS) and e-Arsiv (INDIVIDUAL) invoice generation. When Order.tax.taxInvoicing.buyerInvoicePreference is set to BUSINESS, the seller must issue a business invoice to the buyer. To get the buyer's tax registration numbers (Order.tax.taxRegistrations[].taxRegistrationNumber), filter Order.tax.taxRegistrations[].taxRegistrationType for either BUSINESS or VAT.

📘

Note

This attribute applies only to Türkiye orders.

Step 7. Get tax collection information

Extract the tax collection information Order.orderItems[].tax.taxCollections[] from Step 1 response. This array returns who is responsible for collecting tax on each item.

Each entry includes:

• model — the tax collection model (such as MARKETPLACE_FACILITATOR)
• responsibleParty — the legal entity collecting tax (such as Amazon Services, Inc.)

Use this to determine whether Amazon remitted the tax on your behalf under a marketplace facilitator law, or whether you as the seller remain responsible for remittance.

Step 8. Get deemed reseller reporting information

Extract the tax collection information Order.orderItems[].tax.taxCalculationBreakdowns[] from Step 1 response. The Order.orderItems[].tax.taxCalculationBreakdowns[].reportingScheme field returns the reporting scheme applied when Amazon acts as the deemed reseller, with values including IOSS and UOSS.

Use this for EU VAT compliance reporting, particularly for orders where Amazon collected import VAT at checkout.