---
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
---

[Back to Developer changelog](https://shopify.dev/changelog)

December 24, 2025

Tags:

* Admin GraphQL API

# Tax calculation requests now include merchant business entity information

As of API version 2026-01, tax calculation requests sent to Tax Partner Apps now include merchant business entity information. This addition provides details about the legal entity responsible for transactions, enabling tax partners to apply accurate tax rules based on the specific business entity involved in the transaction.

What's New

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

`id`: The global ID of the business entity (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 code

\*\*Structure \*\* \*\*Before (2026-01): \*\*

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

\*\*After (2026-01): \*\*

```
{
  "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"
    }
  }
}
```