# Tax code lookup

Source: https://developer.avalara.com/avatax-dm-combined-erp/sales-tax-badge/designing/tax-code-lookup/

# Tax code lookup

**Element type: Suggested**

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

Your UI should include a method for users to look up tax codes. The tax code lookup should utilize the [ListTaxCodes](https://developer.avalara.com/api-reference/avatax/rest/v2/methods/Definitions/ListTaxCodes/) API. This API will return the AvaTax supported system tax codes that your integration can consume and expose to your users.

```
curl    -X GET    -H 'Accept: application/json'    -H 'Authorization: Basic ${btoa(`:`)}'    'https://sandbox-rest.avatax.com/api/v2/definitions/taxcodes'
```

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

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

**Advice:** It is possible to 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.

[Previous](/avatax-dm-combined-erp/sales-tax-badge/designing/tax-code-mapping-group)

[Next](/avatax-dm-combined-erp/sales-tax-badge/designing/non-standard-items)