---
search:
  tags:
    - Tax Groups
    - DELETE
seo:
  description: >-
    A price list that loses its tax group keeps quoting at the default…
    Reference for the DELETE /api/v1/tax-groups/{id} endpoint in the Bloomcount
    Public API API.
sidebar:
  label: Delete a tax group
  badge: DELETE
title: Delete a tax group
type: openapi-operation
---
A price list that loses its tax group keeps quoting at the default rate, so the change is invisible in the
response. This refuses with `409 tax_group_in_use:<count>` while any list still points at the group;
`?force=true` deletes it, which is what the app does.

**Errors**

- `409 tax_group_in_use:<count>` — that many price lists still reference the group. Retry with `?force=true`,
  or repoint those lists first.
- `404 tax_group_not_found` — unknown ID, or one belonging to another tenant.
- `422 wrong_id_type:expected_tax_groups_got_<table>` — the ID's prefix isn't `tax_`.

<Operation source="reference" id="delete-api-v1-tax-groups-id" />