Customer tax settings now available in Admin API

Starting in API version 2026-07, the taxSettings field on the Customer object will be publicly accessible in the Admin GraphQL API.

Apps with the read_customers or read_taxes access scopes can now query a customer's tax ID, such as a VAT number, which is collected and validated during checkout. This update aligns with the CompanyLocation.taxSettings.taxRegistrationId, which has been available since API version 2025-01 for B2B customers.

Example query:

{
  customer(id: "gid://shopify/Customer/customer_id") {
    taxSettings {
      taxId
    }
  }
}

This is a read-only change. The taxId field returns the tax ID as a string or null if the customer hasn't provided one. The taxIdValidation sub-field, which indicates the validation status, is not included in the public API. Apps that need access to this field must have approved protected customer data access.

For more information, refer to the Customer object in the Admin GraphQL API reference.