> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: queryTaxRegions()

# Method package: wixBillingV2

# Method menu location: wixBillingV2 --> taxRegions --> queryTaxRegions

# Method Link: https://dev.wix.com/docs/velo/apis/wix-billing-v2/tax-regions/query-tax-regions.md

# Method Description:

Creates a query to retrieve a list of tax regions.  

The `queryTaxRegions()` function builds a query to retrieve a list of tax regions and returns a `TaxRegionsQueryBuilder` object.

The returned object contains the query definition, which is typically used to run the query using the `find()` function.

You can refine the query by chaining `TaxRegionsQueryBuilder` functions onto the query. `TaxRegionsQueryBuilder` functions enable you to sort, filter, and control the results that `queryTaxRegions()` returns.

`queryTaxRegions()` runs with the following `TaxRegionsQueryBuilder` default that you can override:
+ `ascending("_id")` 

The functions that are chained to `queryTaxRegions()` are applied in the order they are called. For example, if you apply `ascending("country")` and then `ascending("subdivision")`, the results are sorted first by the `"country"`, and then, if there are multiple results with the same `"country"`, the items are sorted by `"subdivision"`.  

The following `TaxRegionsQueryBuilder` functions are supported for the `queryTaxRegions()` function. For a full description of the tax region object, see the object returned for the `items` property in `TaxRegionsQueryResult`.


|PROPERTY	|SUPPORTED FILTERS & SORTING	
|:---:|:---:|
|`_id`|[`eq()`](/tax-regions-query-builder/eq),[`ne()`](/tax-regions-query-builder/ne),[`exists()`](/tax-regions-query-builder/exists),[`in()`](/tax-regions-query-builder/in),[`hasSome()`](/tax-regions-query-builder/has-some),[`startsWith()`](/tax-regions-query-builder/starts-with),[`ascending()`](/tax-regions-query-builder/ascending),[`descending()`](/tax-regions-query-builder/descending)|
|`country`|[`eq()`](/tax-regions-query-builder/eq),[`ne()`](/tax-regions-query-builder/ne),[`exists()`](/tax-regions-query-builder/exists),[`in()`](/tax-regions-query-builder/in),[`hasSome()`](/tax-regions-query-builder/has-some),[`startsWith()`](/tax-regions-query-builder/starts-with),[`ascending()`](/tax-regions-query-builder/ascending),[`descending()`](/tax-regions-query-builder/descending)|
|`subdivision`|[`eq()`](/tax-regions-query-builder/eq),[`ne()`](/tax-regions-query-builder/ne),[`exists()`](/tax-regions-query-builder/exists),[`in()`](/tax-regions-query-builder/in),[`hasSome()`](/tax-regions-query-builder/has-some),[`startsWith()`](/tax-regions-query-builder/starts-with),[`ascending()`](/tax-regions-query-builder/ascending),[`descending()`](/tax-regions-query-builder/descending)|
|`appId`|[`eq()`](/tax-regions-query-builder/eq),[`ne()`](/tax-regions-query-builder/ne),[`exists()`](/tax-regions-query-builder/exists),[`in()`](/tax-regions-query-builder/in),[`hasSome()`](/tax-regions-query-builder/has-some),[`startsWith()`](/tax-regions-query-builder/starts-with),[`ascending()`](/tax-regions-query-builder/ascending),[`descending()`](/tax-regions-query-builder/descending)|
|`_createdDate`|[`eq()`](/tax-regions-query-builder/eq),[`ne()`](/tax-regions-query-builder/ne),[`exists()`](/tax-regions-query-builder/exists),[`in()`](/tax-regions-query-builder/in),[`hasSome()`](/tax-regions-query-builder/has-some),[`lt()`](/tax-regions-query-builder/lt),[`le()`](/tax-regions-query-builder/le),[`gt()`](/tax-regions-query-builder/gt),[`ge()`](/tax-regions-query-builder/ge),[`ascending()`](/tax-regions-query-builder/ascending),[`descending()`](/tax-regions-query-builder/descending)|
|`_updatedDate`|[`eq()`](/tax-regions-query-builder/eq),[`ne()`](/tax-regions-query-builder/ne),[`exists()`](/tax-regions-query-builder/exists),[`in()`](/tax-regions-query-builder/in),[`hasSome()`](/tax-regions-query-builder/has-some),[`lt()`](/tax-regions-query-builder/lt),[`le()`](/tax-regions-query-builder/le),[`gt()`](/tax-regions-query-builder/gt),[`ge()`](/tax-regions-query-builder/ge),[`ascending()`](/tax-regions-query-builder/ascending),[`descending()`](/tax-regions-query-builder/descending)|



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## queryTaxRegions example

```javascript
import { taxRegions } from 'wix-billing.v2';

async function queryTaxRegions() {
  const { items } = taxRegions.queryTaxRegions().find();
}

```

## queryTaxRegions example for exporting from backend code

```javascript
import { taxRegions } from 'wix-billing.v2';
import { webMethod, Permissions } from 'wix-web-module';

export const queryTaxRegions = webMethod(
  Permissions.Anyone,
  async (options) => {
    try {
      const result = await taxRegions.queryTaxRegions(options);
      return result;
    } catch (error) {
      console.error(error);
      // Handle the error
    }
  }
);

```

---