# Chapter 5.1.1 - CalcTaxes Request

Source: https://developer.avalara.com/products/communications/integration-guides/dev-guide_rest_v2/reference/calc-taxes-request/

-   [Previous](/communications/dev-guide_rest_v2/reference/)
-   [Next](/communications/dev-guide_rest_v2/reference/request-config/)

### The CalcTaxes Request

`CalcTaxesRequest` supports a list of invoices and override options. Actual limit varies depending on message size and your timeout values, but the standard recommendation is to process no more than 1,000 entries per request.

At the highest level, a `CalcTaxes` request is a JSON object comprised of the following:

Key

Value

`cfg`

[`[RequestConfig]`](/communications/dev-guide_rest_v2/reference/request-config/) Request Configuration

Request configuration option properties

`cmpn`

[`[CompanyData]`](/communications/dev-guide_rest_v2/reference/company-data/) Company Data

Contains information about **your** company or the Seller

`inv`

[`[Invoice]`](/communications/dev-guide_rest_v2/reference/invoice/) Invoice

Contains information about the **transaction**, including a list of line items to be taxed.

-   Limit 1,000 invoices per request

`ovr`

[`[TaxOverride]`](/communications/dev-guide_rest_v2/reference/tax-override/) Tax Override

Contains information about **tax overrides** you want to [apply to the transaction](#note)

`sovr`

[`[SafeHarborOverride]`](/communications/dev-guide_rest_v2/reference/safe-harbor-override/) Safe Harbor Override

Contains information about **safe harbor overrides** you want to [apply to the transaction](#note)

### Example

```json
{ "cfg":{ // Request Config } "cmpn": { // Company Data  }, "inv": [ { // Invoice } ], "ovr": [ { // Override } ], "sovr": [ { // Safe Harbor Override } ]}
```

#### Note

We recommend using a [client profile](/communications/dev-guide_rest_v2/customizing-transactions/client-profiles/) with an override file or configuration update included were possible. Using a client profile results in better performance from the Tax Engine because your override settings are cached _before_ tax calculation begins.

-   [Previous](/communications/dev-guide_rest_v2/reference/)
-   [Next](/communications/dev-guide_rest_v2/reference/request-config/)