# TaxRateRule - Tax Module Data Models Reference

This documentation provides a reference to the TaxRateRule data model. It belongs to the Tax Module.

[Source code](https://github.com/medusajs/medusa/blob/f04adb17d322dd6a5e17eca2498df9d05c75f6f0/packages/modules/tax/src/models/tax-rate-rule.ts#L4)

- id: (PrimaryKeyModifier\<IdProperty\>) The ID of the tax rate rule.
- tax\_rate: (BelongsTo\<\[TaxRate]\(../tax\_models.TaxRate/page.mdx)\>) The associated tax rate.

  - id: (PrimaryKeyModifier\<IdProperty\>) The ID of the tax rate.

  - code: (\`TextProperty\`) The code the tax rate is identified by.

  - name: (\`TextProperty\`) The name of the tax rate

  - is\_default: (\`BooleanProperty\`) Whether this tax rate is the default in the tax region.

  - is\_combinable: (\`BooleanProperty\`) Whether the tax rate should be combined with parent rates. Learn more in \[this documentation]\(https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates).

  - tax\_region: (BelongsTo\<\[TaxRegion]\(../tax\_models.TaxRegion/page.mdx)\>) The associated tax region.

    - id: (PrimaryKeyModifier\<IdProperty\>) The ID of the tax region.

    - country\_code: (\`TextProperty\`) The country code of the tax region.

    - children: (HasMany\<\[TaxRegion]\(../tax\_models.TaxRegion/page.mdx)\>) The tax region's children..

    - tax\_rates: (HasMany\<\[TaxRate]\(../tax\_models.TaxRate/page.mdx)\>) The associated tax rates.

    - province\_code: (\`TextProperty\`) The province code of the tax region

    - metadata: (\`JSONProperty\`) Holds custom data in key-value pairs.

    - created\_by: (\`TextProperty\`) The ID of the user that created the tax region

    - provider: (BelongsTo\<\[TaxProvider]\(../tax\_models.TaxProvider/page.mdx)\>) The provider that calculates taxes in this region.

    - parent: (BelongsTo\<\[TaxRegion]\(../tax\_models.TaxRegion/page.mdx)\>) The tax region's parent.

  - rules: (HasMany\<\[TaxRateRule]\(./page.mdx)\>) The associated rules.

    - id: (PrimaryKeyModifier\<IdProperty\>) The ID of the tax rate rule.

    - tax\_rate: (BelongsTo\<\[TaxRate]\(../tax\_models.TaxRate/page.mdx)\>) The associated tax rate.

    - reference: (\`TextProperty\`) The name of the table this rule references.

    - reference\_id: (\`TextProperty\`) The id of a record in the table that this rule references.

    - metadata: (\`JSONProperty\`) Holds custom data in key-value pairs.

    - created\_by: (\`TextProperty\`) The ID of the user that created the tax rate rule

  - rate: (\`FloatProperty\`) The rate to charge.

  - metadata: (\`JSONProperty\`) Holds custom data in key-value pairs.

  - created\_by: (\`TextProperty\`) The ID of the user that created the tax rate
- reference: (\`TextProperty\`) The name of the table this rule references.
- reference\_id: (\`TextProperty\`) The id of a record in the table that this rule references.
- metadata: (\`JSONProperty\`) Holds custom data in key-value pairs.
- created\_by: (\`TextProperty\`) The ID of the user that created the tax rate rule


---

The best way to deploy Medusa is through Medusa Cloud where you get autoscaling production infrastructure fine tuned for Medusa. Create an account by signing up at cloud.medusajs.com/signup.