# Tax code lookup

Source: https://developer.avalara.com/avatax-for-ap/hpe3659742373301/

# 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.

**View example**:

```
curl
  -X GET
  -H 'Accept: application/json'
  -H 'Authorization: Basic aHR0cHdhdGNoOmY='
  '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.

**View example**:

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

Tip

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.