List Tax Categories
| Endpoint | Method |
|---|---|
/api/admin/settings/tax-categories | GET |
Returns every tax category configured in the store in the { data, meta } envelope. Each tax category is a named group of tax rates that you assign to products to determine how they are taxed.
Pagination
| Parameter | Description |
|---|---|
page | Page number, 1-based. Default 1. |
per_page | Items per page. Default 10, max 50. |
Filters
Query parameters that narrow the result. Supplying more than one narrows further — they combine with logical AND. They mirror the admin Tax Categories datagrid filters.
| Parameter | Match | Example |
|---|---|---|
code | Partial (contains). | ?code=doc |
name | Partial (contains). | ?name=Demo |
Sorting
| Parameter | Values |
|---|---|
sort | id (default), code, name |
order | asc, desc (default desc) |
Both the compound form ?sort=name-asc and the split form ?sort=name&order=asc are accepted.
Notes
taxRateslists the attached rate ids. It is detail-only — empty ([]) on the listing to keep the list query light. Fetch a single category to read its attached rates.
See the Tax Categories overview for field meanings and behaviour.