Tax Groups API reference

Reference map for Tax Groups API operations.

Updated
Apr 26, 2026

Tax Groups

Use this reference map to choose the operation group before opening an endpoint page for exact request and response details.

Use Tax Groups when the job is about tax context: a tax group record and the markets attached to it.

Tax group operations own listing, reads, creation, updates, deletion, adding markets, and removing markets. Tax groups include market associations and country-specific tax percentages; setting a tax group as default can affect which other tax group is default.

Use Markets when the market record itself changes, and use Store Groups when selling context, price-includes-tax behavior, or tax-exemption eligibility changes. Check delete and remove-market operations before removing tax context because the contract describes cascading market tax configuration removal.

For workflow guidance across tax context, store groups, markets, warehouses, variants, customer groups, and events, see Store groups and markets.

Read and inspect

OperationAPI
List all tax groupsManagement API
Get a tax groupManagement API

Create or attach

OperationAPI
Create a tax groupManagement API
Add a market to a tax groupManagement API

Update or repair

OperationAPI
Update a tax groupManagement API

Remove or deactivate

OperationAPI
Delete a tax groupManagement API
Remove a market from a tax groupManagement API

Tax Groups API reference

# Tax Groups Use this reference map to choose the operation group before opening an endpoint page for exact request and response details. Use Tax Groups when the job is about tax context: a tax group record and the markets attached to it. Tax group operations own listing, reads, creation, updates, deletion, adding markets, and removing markets. Tax groups include market associations and country-specific tax percentages; setting a tax group as default can affect which other tax group is default. Use Markets when the market record itself changes, and use Store Groups when selling context, price-includes-tax behavior, or tax-exemption eligibility changes. Check delete and remove-market operations before removing tax context because the contract describes cascading market tax configuration removal. For workflow guidance across tax context, store groups, markets, warehouses, variants, customer groups, and events, see [Store groups and markets](/start/concepts/store-groups-and-markets).

7 operations grouped by the job they support.

## Read and inspect | Operation | API | | --- | --- | | [List all tax groups](/reference/taxgroups/list-all-tax-groups) | Management API | | [Get a tax group](/reference/taxgroups/get-a-tax-group) | Management API | ## Create or attach | Operation | API | | --- | --- | | [Create a tax group](/reference/taxgroups/create-a-tax-group) | Management API | | [Add a market to a tax group](/reference/taxgroups/add-a-market-to-a-tax-group) | Management API | ## Update or repair | Operation | API | | --- | --- | | [Update a tax group](/reference/taxgroups/update-a-tax-group) | Management API | ## Remove or deactivate | Operation | API | | --- | --- | | [Delete a tax group](/reference/taxgroups/delete-a-tax-group) | Management API | | [Remove a market from a tax group](/reference/taxgroups/remove-a-market-from-a-tax-group) | Management API |