> 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

# ListDefaultTaxGroups

# Package: tax

# Namespace: TaxGroups

# Method link: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-groups/list-default-tax-groups.md

## Permission Scopes:
Manage Orders: SCOPE.DC-STORES.MANAGE-ORDERS

## Introduction

Retrieves a list of default tax groups.

The default tax groups for a site are inherited by the apps installed on the site.
For example, the Wix Stores app includes a `"Products"` tax group by default.

Add additional default tax groups with the Tax Groups Integration service plugin (REST only).

---

## REST API

### Schema

```
 Method: listDefaultTaxGroups
 Description: Retrieves a list of default tax groups.  The default tax groups for a site are inherited by the apps installed on the site. For example, the Wix Stores app includes a `"Products"` tax group by default.  Add additional default tax groups with the Tax Groups Integration service plugin (REST only).
 URL: https://www.wixapis.com/billing/v1/tax-groups/default-tax-groups
 Method: GET
 Return type: ListDefaultTaxGroupsResponse
  - name: taxGroups | type: array<TaxGroup> | description: Retrieved default tax groups. 
     - name: id | type: string | description: Tax group GUID. 
     - name: name | type: string | description: Tax group name. 
     - name: revision | type: string | description: Revision number, which increments by 1 each time the tax group is updated. To prevent conflicting changes, the current revision must be passed when updating the tax group.  Ignored when creating a tax group. 
     - name: createdDate | type: string | description: Date and time the tax group was created. 
     - name: updatedDate | type: string | description: Date and time the tax group was last updated. 


```

### Examples

### List Default Tax Groups
Lists all default tax groups for a Wix site that has the Wix Stores app installed.

```curl
curl -X GET \
    'https://www.wixapis.com/billing/v1/tax-groups/default-tax-groups' \
    -H 'Authorization: <AUTH>' \
    -H 'Content-type: application/json'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.tax.TaxGroups.listDefaultTaxGroups()
 Description: Retrieves a list of default tax groups.  The default tax groups for a site are inherited by the apps installed on the site. For example, the Wix Stores app includes a `"Products"` tax group by default.  Add additional default tax groups with the Tax Groups Integration service plugin (REST only).
 Return type: PROMISE<ListDefaultTaxGroupsResponse>
  - name: taxGroups | type: array<TaxGroup> | description: Retrieved default tax groups. 
     - name: _id | type: string | description: Tax group GUID. 
     - name: name | type: string | description: Tax group name. 
     - name: revision | type: string | description: Revision number, which increments by 1 each time the tax group is updated. To prevent conflicting changes, the current revision must be passed when updating the tax group.  Ignored when creating a tax group. 
     - name: _createdDate | type: Date | description: Date and time the tax group was created. 
     - name: _updatedDate | type: Date | description: Date and time the tax group was last updated. 


```

### Examples

### listDefaultTaxGroups
```javascript
import { taxGroups } from '@wix/ecom';

async function listDefaultTaxGroups() {
  const response = await taxGroups.listDefaultTaxGroups();
};
```

### listDefaultTaxGroups (with elevated permissions)
```javascript
import { taxGroups } from '@wix/ecom';
import { auth } from '@wix/essentials';

async function myListDefaultTaxGroupsMethod() {
  const elevatedListDefaultTaxGroups = auth.elevate(taxGroups.listDefaultTaxGroups);
  const response = await elevatedListDefaultTaxGroups();
}
```

### listDefaultTaxGroups (self-hosted)
Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { taxGroups } from '@wix/ecom';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { taxGroups },
  // Include the auth strategy and host as relevant
});


async function listDefaultTaxGroups() {
  const response = await myWixClient.taxGroups.listDefaultTaxGroups();
};
```

---