# AvaTax tax code mapping

Source: https://developer.avalara.com/vat-ecom/designing/tax-code-mapping/

**Element type:** Required

**Endpoints/models used:** [ListTaxCodes](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Definitions/ListTaxCodes/)

Your integration is expected to include an item list that merchants can then map to Avalara tax codes to determine the item taxability. Products are taxed differently in different jurisdictions. Finding the correct tax code will ensure that AvaTax treats your product correctly everywhere. You can find the correct Avalara tax code for your product in one of two ways:

-   Look on Avalara's [tax code search](https://taxcode.avatax.avalara.com/)

-   Call the [ListTaxCodes](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Definitions/ListTaxCodes/) API to list available tax codes

In your integration, some users will choose to enter a tax code directly into the UI. Others will want to search for or be provided with a list of tax codes. A common use case is to show a dropdown text box with all available tax codes. In this example, when a customer starts typing the word `C`, your program can call [ListTaxCodes](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Definitions/ListTaxCodes/) to find all tax codes that begin with `C`. Below is an example showing how to call [ListTaxCodes](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Definitions/ListTaxCodes/) and filter on tax codes that start with `C`.

[![Closed](https://avalara-devdocs-prod.mcoutput.com/vat-ecom/Skins/Default/Stylesheets/Images/transparent.gif)View request](javascript:void\(0\);)

```
GET /api/v2/definitions/taxcodes/$filter=description startswith C
```

[![Closed](https://avalara-devdocs-prod.mcoutput.com/vat-ecom/Skins/Default/Stylesheets/Images/transparent.gif)View response](javascript:void\(0\);)

```
{  "id": 56789,  "companyId": 12345,  "taxCode": "PF050101",  "taxCodeTypeId": "P",  "description": "Carbonated beverages",  "parentTaxCode": "PF050001",  "isPhysical": true,  "goodsServiceCode": 0,  "entityUseCode": "",  "isActive": true,  "isSSTCertified": true} 
```