Practice Manager API
Taxes
Create, read, update and delete the tax codes (tax rates) of the authenticated workspace, and look up a US sales tax rate for an address. Send the tax UUIDs on transactions, invoice and bill lines, products, and accounts.
Last updated 2026-11-18
Some fields work differently in US and NZ workspaces
Showing US sales tax and NZ GST rules.
Overview
Every route that takes a tax code — `taxes` or `taxUuids` on transactions, invoice lines, products, and accounts, and `taxUuid` on bill lines — expects the tax UUID. GET /firm-partners/workspace/taxes is where those UUIDs come from. Numeric tax ids are never accepted.
Tax codes can be created, renamed, re-rated, switched off and deleted through the Partner API, with the same rules as the COUNT app: two codes cannot share a name and rate, system codes cannot be renamed, re-rated or deleted, and a code that has been posted to the ledger keeps its rate.
Each new code gets its own liability account, `Tax: <name>`. In a US workspace that account sits under a shared Sales Tax Payable parent account.
Key concepts
US· Sales taxSales tax codes
Sales tax codes are created by the workspace, each with its jurisdiction in `country`, `state`, `county`, `city`, `zipCode` and `locationCode`. Look up a rate for an address with GET /firm-partners/workspace/taxes/sales-tax-rate. Invoice lines charge the codes in `taxes`; `nonTaxable: true` keeps the code and reports the sale as Non-Taxable under it. Bills carry no tax: a bill line's `taxUuid` is ignored.
NZ· GSTGST codes
Every NZ workspace has five GST codes COUNT creates: `15% GST on Income` (15%), `15% GST on Expenses` (15%), `Zero Rated` (0%), `No GST` (0%), and `GST on Imports` (100% — the line amount is the GST itself). Use them by UUID on invoice lines (`taxes`) and bill lines (`taxUuid`). `nonTaxable: true` on an invoice line clears its code; it does not zero-rate it.
NZ· GSTWhere each GST code reports
`15% GST on Income` — sales, GST return box 5. `Zero Rated` — sales, boxes 5 and 6 (zero-rated supplies). `15% GST on Expenses` — purchases, box 11. `GST on Imports` — box 13 (credit adjustments). `No GST` — not on the return. Zero Rated and No GST are both 0%, so choose by how the supply must be reported.
NZ· GSTWhich GST code fits which account
Income accounts take `15% GST on Income` or `Zero Rated`. Expenses accounts take `15% GST on Expenses`. Assets accounts take either side. Liabilities and Equity accounts take no GST code. `GST on Imports` is valid only on the GST on Imports account, and `No GST` fits any account. Any other pairing on an invoice or bill line is refused with 400.
Tax code
Attributes
iduuidTax UUID. Send this wherever a route takes a tax code.
namestringDisplay name.
percentagestringRate as a decimal string with four places, e.g. `"15.0000"`.
typestringTax type, e.g. `"Sales Tax"`.
descriptionstringDescription, or null.
enabledbooleanWhether the code is in use.
editableboolean`false` for system codes COUNT manages.
systemCreatedbooleanWhether COUNT created the code.
countrystringJurisdiction country for US sales-tax codes; null otherwise. The same applies to `state`, `county`, `city`, `zipCode`, and `locationCode`.
{
"id": "3f6c2a1e-8b4d-4e7a-9c2f-1d5e8a7b6c40",
"name": "CA Sales Tax",
"percentage": "7.2500",
"type": "Sales Tax",
"description": "California state sales tax",
"enabled": true,
"editable": true,
"systemCreated": false,
"country": "US",
"state": "CA",
"county": null,
"city": null,
"zipCode": null,
"locationCode": null
}Scope and permissions
Reads (list, get, sales tax rate) need the `workspace:read` scope, and the connecting user needs any one of `view_accounts`, `view_invoices`, `view_bills`, `view_transactions`, or `manage_taxes`. Create, update and delete need `workspace:write` and `manage_taxes`.MCP equivalent
COUNT_list_taxes, COUNT_get_tax, COUNT_create_tax, COUNT_update_tax, COUNT_delete_tax and COUNT_get_sales_tax_rate. On a client that can show a form, COUNT_delete_tax asks the user to confirm first.Related
Endpoints
/firm-partners/workspace/taxesReturns every tax code in the workspace, optionally filtered by whether it is enabled.
/firm-partners/workspace/taxes/{uuid}Returns one tax code by UUID.
/firm-partners/workspace/taxesCreates a tax code and its liability account.
/firm-partners/workspace/taxes/{uuid}Renames, re-rates, describes, or switches a tax code on or off.
/firm-partners/workspace/taxes/{uuid}Deletes a tax code.
/firm-partners/workspace/taxes/sales-tax-rateReturns the combined US sales tax rate for an address. Nothing is saved.
