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

iduuid

Tax UUID. Send this wherever a route takes a tax code.

namestring

Display name.

percentagestring

Rate as a decimal string with four places, e.g. `"15.0000"`.

typestring

Tax type, e.g. `"Sales Tax"`.

descriptionstring

Description, or null.

enabledboolean

Whether the code is in use.

editableboolean

`false` for system codes COUNT manages.

systemCreatedboolean

Whether COUNT created the code.

countrystring

Jurisdiction country for US sales-tax codes; null otherwise. The same applies to `state`, `county`, `city`, `zipCode`, and `locationCode`.

Example
{
  "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.

Endpoints