---
title: Customer resource now includes tax exemptions - 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-resource-now-includes-tax-exemptions'
  md: >-
    https://shopify.dev/changelog/customer-resource-now-includes-tax-exemptions.md
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2019-06-16T11:57:56-04:00'
  postedAt: '2019-06-19T00:00:00-04:00'
  updatedAt: '2024-02-02T10:04:54-05:00'
  effectiveAt: '2019-06-19T00:00:00-04:00'
---

June 19, 2019

Tags:

* API

# Customer resource now includes tax exemptions

The new tax exemptions property is available on the customer resource in the `2019-07` release candidate. This allows app developers to specify which taxes a customer is exempt from paying on their orders. Tax exemption related UI changes to the admin are also exposed in the Unite developer preview on development stores.

***

**Tax Exemptions**

Tax Exemptions is a new feature which allows merchants to specify exactly which taxes customers are exempt from paying. Initially this feature is only available for customers with a Canadian address but is coming soon to further regions.

**Tax Exemptions API**

In order to empower app developers to set tax exemptions for customer accounts we have exposed a tax\_exemptions array on the customer resource in both our REST Admin and GraphQL APIs.

Currently this feature is available in the `2019-07` release candidate and can be tested in combination with a development store using the Unite developer preview by specifying this version in your API request.

**Examples:**

`/admin/api/2019-07/graphql.json`

Request

```
query customers {
  customers(first: 5) {
    edges {
      node {
        id
        taxExempt
	  taxExemptions
        email
      }
    }
  }
}
```

Response

```
{
  "data": {
    "customers": {
      "edges": [
        {
          "node": {
            "id": "gid://shopify/Customer/6029170178",
            "taxExempt": false,
		"taxExemptions": [
          		"CA_STATUS_CARD_EXEMPTION",
          		"CA_BC_RESELLER_EXEMPTION"
        	],
            "email": "bob@example.com"
          }
        },
        ...
        }
      }
    }
```

REST

`GET /admin/api/2019-07/customers/{customer_id}.json`

Response

```
{
    "customer": {
        "id": 6046307842,
        "email": "bob@example.com",
        "accepts_marketing": true,
        "created_at": "2017-05-11T13:53:07+01:00",
        "updated_at": "2019-03-13T15:01:33+00:00",
        "tax_exempt": false,
        "tax_exemptions": [
          "CA_STATUS_CARD_EXEMPTION",
          "CA_BC_RESELLER_EXEMPTION"
        ],
        ...
      }
    }
```

Note that this additional feature does not impact the behaviour of the tax\_exempt boolean, which still makes the customer entirely tax exempt at the checkout.

You can read more about Tax Exemptions and find all valid exemption values in our [API reference documentation](https://help.shopify.com/en/api/reference/customers).

**Get started in the Unite developer preview** Tax exemption is exclusively available in the Unite developer preview. To get started with the developer preview, [create a new development store with the Unite 2019 developer preview enabled](https://help.shopify.com/en/partners/dashboard/development-stores#create-a-development-store).