Stay up to date

Developer changelog

Developer preview

Customer resource now includes tax exemptions

Effective June 19, 2019

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.

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.