> ## Documentation Index
> Fetch the complete documentation index at: https://gobl-improv.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# RateDef

RateDef defines a single rate inside a category

## Schema ID

`https://gobl.org/draft-0/tax/regime-def#/$defs/RateDef`

## Properties

| Title       | Property | Type                                                     | Req. | Description                                                                                                                                                                                              |
| ----------- | -------- | -------------------------------------------------------- | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Key         | `key`    | [cbc.Key](/draft-0/cbc/key)                              | true | Key identifies this rate within the system                                                                                                                                                               |
| Name        | `name`   | [i18n.String](/draft-0/i18n/string)                      | true | Human name of the rate                                                                                                                                                                                   |
| Description | `desc`   | [i18n.String](/draft-0/i18n/string)                      |      | Useful description of the rate.                                                                                                                                                                          |
| Exempt      | `exempt` | boolean                                                  |      | Exempt when true implies that the rate when used in a tax Combo should not define a percent value.                                                                                                       |
| Values      | `values` | array of [tax.RateValueDef](/draft-0/tax/rate_value_def) |      | Values contains a list of Value objects that contain the current and historical percentage values for the rate and additional filters. Order is important, newer values should come before older values. |
| Extensions  | `ext`    | [tax.Extensions](/draft-0/tax/extensions)                |      | Extensions key-value pair that will be copied to the tax combo if this rate is used.                                                                                                                     |
| Meta        | `meta`   | [cbc.Meta](/draft-0/cbc/meta)                            |      | Meta contains additional information about the rate that is relevant for local frequently used implementations.                                                                                          |