---
title: "Taxes · Practice Manager API · COUNT Partner API"
description: "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…"
canonical: "https://developers.getcount.com/practice-manager/reference/taxes"
source: "https://developers.getcount.com/practice-manager/reference/taxes"
---
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

`id` uuid

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

`name` string

Display name.

`percentage` string

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

`type` string

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

`description` string

Description, or null.

`enabled` boolean

Whether the code is in use.

`editable` boolean

`false` for system codes COUNT manages.

`systemCreated` boolean

Whether COUNT created the code.

`country` string

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

Example

```json
{
  "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

- [Transactions API](https://developers.getcount.com/practice-manager/reference/transactions)
- [Invoices API](https://developers.getcount.com/practice-manager/reference/invoices)
- [Bills API](https://developers.getcount.com/practice-manager/reference/bills)

## Endpoints

[GET List tax codes `/firm-partners/workspace/taxes` Returns every tax code in the workspace, optionally filtered by whether it is enabled.](https://developers.getcount.com/practice-manager/reference/taxes/list-taxes) [GET Get a tax code `/firm-partners/workspace/taxes/{uuid}` Returns one tax code by UUID.](https://developers.getcount.com/practice-manager/reference/taxes/get-tax) [POST Create a tax code `/firm-partners/workspace/taxes` Creates a tax code and its liability account.](https://developers.getcount.com/practice-manager/reference/taxes/create-tax) [PATCH Update a tax code `/firm-partners/workspace/taxes/{uuid}` Renames, re-rates, describes, or switches a tax code on or off.](https://developers.getcount.com/practice-manager/reference/taxes/update-tax) [DELETE Delete a tax code `/firm-partners/workspace/taxes/{uuid}` Deletes a tax code.](https://developers.getcount.com/practice-manager/reference/taxes/delete-tax) [GET Look up a US sales tax rateUS· Sales tax `/firm-partners/workspace/taxes/sales-tax-rate` Returns the combined US sales tax rate for an address. Nothing is saved.](https://developers.getcount.com/practice-manager/reference/taxes/get-sales-tax-rate)
