# Tax Rate (/en/api-reference/objects/tax-rate)

A Tax Rate is a reusable tax you apply to invoice lines, such as 14% VAT. A rate is either inclusive (already inside the price) or exclusive (added on top). The percentage and the inclusive setting are fixed once the rate is created, so issued invoices never change. To change a rate, archive it and create a new one.

## Fields

- `id` (string, required) — Tax rate ID
- `object` (enum("tax_rate"), required) — Object type
- `displayName` (string, required) — Name shown on invoices, such as VAT
- `displayNameAr` (string | null, required) — Arabic name shown on Arabic and bilingual invoices
- `percentage` (number, required) — Tax percentage
- `inclusive` (boolean, required) — Whether prices already include this tax. Cannot change after creation.
- `description` (string | null, required) — Internal note, not shown to customers
- `active` (boolean, required) — Archived rates stay on existing invoices but cannot be added
- `metadata` (object | null, required) — Custom metadata
- `merchantId` (string, required) — Merchant ID
- `createdAt` (string, required) — Created timestamp (ISO 8601)
- `updatedAt` (string, required) — Updated timestamp (ISO 8601)