Get taxes
List the taxes configured for the authenticated company. A tax is a named, reusable tax rate (percentage) that gets applied to order and invoice line totals. Use this to enumerate the taxes you can reference elsewhere and to read their current rates, codes, and QuickBooks Online mappings.
Results are ordered oldest-first (by creation time) and paginated. Soft-deleted taxes are never returned. This endpoint is read-only — taxes cannot be created, edited, or deleted through the public API — so it has no effect on inventory, compliance, or any other entity.
Required permission: settings_permissions_taxes.
BearerAuthorizationBearer <token>API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.
ids[]?array<string>Restrict the result to specific taxes by ID (the same ID returned as each tax's id). Repeat the bracketed key once per ID. Unknown IDs simply match nothing; an empty list is treated as no filter. At most 200 IDs may be given.
inserted_datetime?stringFilter to taxes by their creation datetime, given as a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted for an open-ended range: 2022-07-10T00:00:00Z, matches on or after that instant, ,2022-07-10T00:00:00Z matches on or before it.
updated_datetime?stringFilter to taxes by their last-updated datetime, given as a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted for an open-ended range.
page?stringPage selector. Page size is fixed by the server; paginate by following the next_page URL in each response rather than building page selectors yourself — it is null on the last page. next_page uses page[after]=<cursor>, an opaque token marking where the next page resumes; pass it back exactly as given, and only to the endpoint that issued it. This is seek-based, so every page stays fast no matter how deep you page.
A list of taxes
*/*- response
A collection of taxes
data?array<>Taxes
next_page?stringURL for the next page of results; null when there is no next page
curl -X GET 'https://app.distru.com/public/v1/taxes'{ "data": [ { "description": null, "id": "00000000-0000-0000-0000-000000000001", "inserted_datetime": "2026-10-08T09:10:07.493665Z", "name": "T1", "qb_account_id": null, "qb_product_id": null, "tags": [ { "id": "00000000-0000-0000-0000-00000000001b", "name": "Cannabis" } ], "tax_applied_after_charges": false, "tax_applied_after_price_tiers": true, "tax_code": "Tax Code 1", "tax_rate_percent": 15, "updated_datetime": "2026-10-08T09:10:07.493665Z" }, { "description": null, "id": "00000000-0000-0000-0000-000000000002", "inserted_datetime": "2026-10-08T09:10:07.500184Z", "name": "T2", "qb_account_id": null, "qb_product_id": null, "tags": [], "tax_applied_after_charges": false, "tax_applied_after_price_tiers": true, "tax_code": "Tax Code 3", "tax_rate_percent": 15, "updated_datetime": "2026-10-08T09:10:07.500184Z" }, { "description": null, "id": "00000000-0000-0000-0000-000000000003", "inserted_datetime": "2026-10-08T09:10:07.507987Z", "name": "T3", "qb_account_id": null, "qb_product_id": null, "tags": [], "tax_applied_after_charges": false, "tax_applied_after_price_tiers": true, "tax_code": "Tax Code 5", "tax_rate_percent": 15, "updated_datetime": "2026-10-08T09:10:07.507987Z" } ], "next_page": "https://www.example.com/public/v1/taxes?page[after]=ZHwyMDI2LTEwLTA4VDA5OjEwOjA3LjUwNzk4N1p8aXwwMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDM"}