# RESTv1 to RESTv2 API mapping

Source: https://developer.avalara.com/restv1-to-restv2-refactor-guide/est7624038474071/

# RESTv1 to RESTv2 API mapping

Compare RESTv1 and RESTv2 APIs to understand their mappings, purposes, and usage details.

The table below shows a mapping between RESTv1 and RESTv2 APIs.

Service

RESTv1 API

RESTv2 API

Purpose

Comments

Estimate tax

[estimateTax](https://developer.avalara.com/api-reference/avatax/rest/v1/methods/estimateTax/)

[CreateTransaction](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/)

Used for estimating taxes in a quote

Use a document `type` of `SalesOrder` in RESTv2.

Void documents

[cancelTax](https://developer.avalara.com/api-reference/avatax/rest/v1/methods/cancelTax/)

[VoidTransaction](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/VoidTransaction/)

Voids or deletes a transaction

Use the `DocVoided` code or the `DocDeleted`, depending on the document's status (saved, posted, committed, uncommitted).

Calculate tax on a document

[getTax](https://developer.avalara.com/api-reference/avatax/rest/v1/methods/getTax/)

[CreateTransaction](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Transactions/CreateTransaction/)

Creates a new transaction document.

Test connectivity

N/A

[Ping](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Utilities/Ping/)

Test the connectivity of AvaTax and verifies authentication.

Only use once or set up a [webhook](https://en.wikipedia.org/wiki/Webhook).

Address validation

[validateAddress](https://developer.avalara.com/api-reference/avatax/rest/v1/methods/validateAddress/)

[ResolveAddress](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Addresses/ResolveAddress/)

Resolves an address against Avalara's address validation system.

Offline tax content API

N/A

[BuildTaxContentFile](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/TaxContent/BuildTaxContentFile/)

Builds a multilocation tax content file containing a matrix of taxes that would be charged in transactions when you sell items at any of your locations.

Because tax rates may change based on decisions made by various tax authorities, we recommend that users of this tax content API download new data every day.