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
Get a tax groupManagement API
List all tax groupsManagement API

Create or attach

OperationAPI
Add a market to a tax groupManagement API
Create 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 | | --- | --- | | [Get a tax group](/reference/taxgroups/get-a-tax-group) | Management API | | [List all tax groups](/reference/taxgroups/list-all-tax-groups) | Management API | ## Create or attach | Operation | API | | --- | --- | | [Add a market to a tax group](/reference/taxgroups/add-a-market-to-a-tax-group) | Management API | | [Create a tax group](/reference/taxgroups/create-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 |