---
title: >-
  Tax calculation requests now include merchant business entity information -
  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/tax-calculation-requests-now-include-merchant-business-entity-information
  md: >-
    https://shopify.dev/changelog/tax-calculation-requests-now-include-merchant-business-entity-information.md
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-12-23T16:46:22-05:00'
  postedAt: '2026-04-01T12:00:00-04:00'
  updatedAt: '2026-08-14T16:25:59-04:00'
  effectiveAt: '2025-12-24T12:00:00-05:00'
---

# Tax calculation requests now include merchant business entity information

DateApril 1, 2026

Version[2026-04](https://shopify.dev/changelog?api_version=2026-04)

FlagsNew

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)

As of API version 2026-04, tax calculation requests sent to Tax Partner Apps include merchant business entity information. This provides details about the business entity responsible for a transaction, enabling tax partners to apply the appropriate tax rules.

## What's new

Tax calculation requests now feature a new `merchant_business_entity` field at the root level of the request. This field includes the following details:

* `id`: The business entity Global ID, in the format `gid://shopify/BusinessEntity/{id}`

* `company_name`: The legal name of the business entity

* `display_name`: The display name of the business entity

* `address`: The business entity's address, including:

  * `country`
  * `province`
  * Address lines (`address1`, `address2`)
  * `city`
  * `zip`

The field is present only when the merchant has configured a business entity for the shop.

## Versions before 2026-04

```json
{
  "shop": { "...": "..." },
  "cart": { "...": "..." },
  "currency_code": "USD",
  "session_id": "session_123"
}
```

## Version 2026-04 and later

```json
{
  "shop": { "...": "..." },
  "cart": { "...": "..." },
  "currency_code": "USD",
  "session_id": "session_123",
  "merchant_business_entity": {
    "id": "gid://shopify/BusinessEntity/456",
    "company_name": "Test Company",
    "display_name": "Test Display",
    "address": {
      "country": "US",
      "province": "CA",
      "address1": "123 Main St",
      "address2": "Suite 100",
      "city": "San Francisco",
      "zip": "94102"
    }
  }
}
```