# TaxRate

**id**string\<uuid>required

Unique identifier for the tax rate.

**Example:<!-- -->&#x20;**`9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d`

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

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

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`

**createdAt**integer\<int64>required

Time at which the resource was created. Measured in seconds since the Unix epoch.

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

**updatedAt**integer\<int64>

Time at which the resource updated last time. Measured in seconds since the Unix epoch.

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

TaxRate

```
{

  "id": "9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d",

  "displayName": "IVA",

  "percentage": 21,

  "taxType": "VAT",

  "active": true,

  "createdAt": 1636366897,

  "updatedAt": 1636366897

}
```
