# REST Resource: accounttax

- [Resource: AccountTax](https://developers.google.com/shopping-content/reference/rest/v2.1/accounttax#AccountTax)
  - [JSON representation](https://developers.google.com/shopping-content/reference/rest/v2.1/accounttax#AccountTax.SCHEMA_REPRESENTATION)
- [AccountTaxTaxRule](https://developers.google.com/shopping-content/reference/rest/v2.1/accounttax#AccountTaxTaxRule)
  - [JSON representation](https://developers.google.com/shopping-content/reference/rest/v2.1/accounttax#AccountTaxTaxRule.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/shopping-content/reference/rest/v2.1/accounttax#METHODS_SUMMARY)

## Resource: AccountTax

The tax settings of a merchant account. All methods require the admin role.

| JSON representation |
|---|
| ``` { "accountId": string, "rules": [ { object (`https://developers.google.com/shopping-content/reference/rest/v2.1/accounttax#AccountTaxTaxRule`) } ], "kind": string } ``` |

| Fields ||
|---|---|
| `accountId` | `string` Required. The ID of the account to which these account tax settings belong. |
| `rules[]` | ``object (`https://developers.google.com/shopping-content/reference/rest/v2.1/accounttax#AccountTaxTaxRule`)`` Tax rules. Updating the tax rules will enable "US" taxes (not reversible). Defining no rules is equivalent to not charging tax at all. |
| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string "`content#accountTax`". |

## AccountTaxTaxRule

Tax calculation rule to apply in a state or province (US only).

| JSON representation |
|---|
| ``` { "country": string, "locationId": string, "useGlobalRate": boolean, "ratePercent": string, "shippingTaxed": boolean } ``` |

| Fields ||
|---|---|
| `country` | `string` Country code in which tax is applicable. |
| `locationId` | `string` Required. State (or province) is which the tax is applicable, described by its [location ID](https://developers.google.com/adwords/api/docs/appendix/geotargeting) (also called criteria ID). |
| `useGlobalRate` | `boolean` Whether the tax rate is taken from a global tax table or specified explicitly. |
| `ratePercent` | `string` Explicit tax rate in percent, represented as a floating point number without the percentage character. Must not be negative. |
| `shippingTaxed` | `boolean` If true, shipping charges are also taxed. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/shopping-content/reference/rest/v2.1/accounttax/custombatch` | Retrieves and updates tax settings of multiple accounts in a single request. |
| ### `https://developers.google.com/shopping-content/reference/rest/v2.1/accounttax/get` | Retrieves the tax settings of the account. |
| ### `https://developers.google.com/shopping-content/reference/rest/v2.1/accounttax/list` | Lists the tax settings of the sub-accounts in your Merchant Center account. |
| ### `https://developers.google.com/shopping-content/reference/rest/v2.1/accounttax/update` | Updates the tax settings of the account. |