# Tax code lookup

Source: https://developer.avalara.com/vat-erp/designing/tax-code-lookup/

**Element type:** Required

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

Your UI must include a method to pull in and surface Avalara tax codes within the application. You can do this using the [ListTaxCodes](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Definitions/ListTaxCodes/) API. This API returns the Avalara supported system tax codes that your integration can consume and expose to your users.

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

```
curl  -X GET  -H 'Accept: application/json'  -H 'Authorization: Basic aHR0cHdhdGNoOmY='  'https://sandbox-rest.avatax.com/api/v2/definitions/taxcodes' 
```

You an also apply an `isActive` [filter](https://developer.avalara.com/avatax/filtering-in-rest/) to return only active tax codes.

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

```
curl  -X GET  -H 'Accept: application/json'  -H 'Authorization: Basic aHR0cHdhdGNoOmY='  'https://sandbox-rest.avatax.com/api/v2/definitions/taxcodes$filter=isActive eq true' 
```

**Advice**:  
You can also create custom tax codes, if necessary. Refer to the [Create and update custom tax codes](https://knowledge.avalara.com/bundle/dqa1657870670369_dqa1657870670369/page/Create_and_update_custom_tax_codes.html) article in the Avalara Knowledge Center for more information.