# CreateTaxRateRequest

**displayName**TaxRate-DisplayNamerequired

The name of the tax shown to the buyer.

**Possible values:** `non-empty` and `<= 50 characters`

**Example:<!-- -->&#x20;**`IVA`

**percentage**TaxRate-Percentagerequired

The rate in percent, with up to 4 decimals. It cannot change after the tax rate is created.

**Possible values:** `>= 0` and `<= 100`

**Example:<!-- -->&#x20;**`21`

**taxType**TaxRate-TaxType

The kind of tax: `VAT`, `IGIC` (Canary Islands) or `IPSI` (Ceuta and Melilla). It cannot change after the tax rate is created. Treat the set as open: more values can be added later.

**Default value:<!-- -->&#x20;**`VAT`

**Example:<!-- -->&#x20;**`VAT`

**active**TaxRate-Active

Whether the tax rate is active. Tax rates are never deleted: set `active` to `false` to archive one. An archived rate cannot be set on a product. While a product still has it, the product cannot get new prices and its prices cannot start or switch a subscription. Subscriptions that already use it keep their copy. A new tax rate is active unless created with `active: false`.

**Example:<!-- -->&#x20;**`true`

CreateTaxRateRequest

```
{

  "displayName": "IVA",

  "percentage": 21,

  "taxType": "VAT",

  "active": true

}
```
