Customer tax settings now available in Admin API
Source: Shopify Dev Changelog
Customer Tax Settings Now Available in Admin API
Shopify has made the taxSettings field on the Customer object publicly accessible in the Admin GraphQL API starting with API version 2026-07. Apps with read_customers or read_taxes access scopes can now query customer tax IDs, including VAT numbers that are collected and validated during checkout.
What This Means for App Developers
This update provides direct access to customer tax information through the Admin API, which was previously unavailable for standard customer records. The change brings customer tax data access in line with B2B functionality, where CompanyLocation.taxSettings.taxRegistrationId has been available since API version 2025-01.
Developers building tax compliance tools, invoicing systems, or financial reporting apps can now retrieve validated tax IDs directly from customer records. This eliminates the need for workarounds or separate data storage for tax information that Shopify already collects at checkout.
Implementation Considerations
Apps will need to update to API version 2026-07 to access this field. The tax settings data includes information validated during the checkout process, which means the quality and format of tax IDs should be consistent with Shopify’s validation rules.
Developers should verify their apps have the appropriate access scopes (read_customers or read_taxes) before implementing queries for the taxSettings field. Apps serving both B2C and B2B merchants can now use a unified approach to accessing tax registration data across both customer types.
Stay in the loop
Get Shopify ecosystem news and positioning insights for app founders.