---
title: "Update Tax Zone"
method: PATCH
path: "/sites/multiscreen/{site_name}/ecommerce/tax-zones/{zone_id}"
---

# Update Tax Zone

`PATCH /sites/multiscreen/{site_name}/ecommerce/tax-zones/{zone_id}`

## Path parameters

- `site_name` string, required
- `zone_id` string, required

## Request body

- object
  - `rates` object[], required — The country and region are not editable. This endpoint will replace ALL rates.
    - `name` string, required — Display name of the tax rate. This will be displayed in the merchant’s orders dashboard.
    - `rate` string, required — Decimal string of the tax applied on a given price e.g., "0.05".
    - `tax_group_overrides` object — Key/Value pair of Tax Group IDs and a Decimal String. e.g., { "tg_123": "0.05" }
    - `tax_number_for_invoice` string — String displayed alongside invoices tax line item breakdowns.

## Response `200`

200

- object
  - `country` string
  - `id` string
  - `rates` object[]
    - `id` string
    - `name` string
    - `rate` integer
    - `tax_group_overrides` object
      - `tg_1` integer
      - `tg_2` integer
      - `tg_3` integer
    - `tax_number_for_invoice` string
  - `region` string

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/duda/apis/partner-api.md) · [All operations](https://skmtc.dev/duda/apis/partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/duda/partner-api/revisions/5b9208270ed1/schema)