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.
Query parameters
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.
Filter 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.
Filter 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 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.
Response
A list of taxes
Changes
No recorded changes to this endpoint across all 1 revision of this API.