---
title: Customer tax settings now available in Admin API - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/customer-tax-settings-now-available-in-admin-api
  md: >-
    https://shopify.dev/changelog/customer-tax-settings-now-available-in-admin-api.md
metadata:
  effectiveApiVersion: 2026-07
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2026-04-09T09:55:37-04:00'
  postedAt: '2026-04-24T12:00:00-04:00'
  updatedAt: '2026-04-13T10:23:39-04:00'
  effectiveAt: '2026-04-24T12:00:00-04:00'
---

April 24, 2026

Tags:

* Admin GraphQL API
* 2026-07

# Customer tax settings now available in Admin API

Starting in API version 2026-07, the [`taxSettings` field on the `Customer` object](https://shopify.dev/docs/api/admin-graphql/2026-07/objects/Customer) 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:

```json
{
  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](https://shopify.dev/docs/api/admin-graphql/2026-07/objects/Customer) in the Admin GraphQL API reference.