---
title: "List tax codes · Taxes · COUNT Partner API"
description: "Returns every tax code in the workspace, optionally filtered by whether it is enabled. GET /partners/taxes"
canonical: "https://developers.getcount.com/reference/taxes/list-taxes"
source: "https://developers.getcount.com/reference/taxes/list-taxes"
---
[Taxes](https://developers.getcount.com/reference/taxes) / List tax codes

# List tax codes

GET `/partners/taxes`

Returns every tax code in the workspace, optionally filtered by whether it is enabled.

HMAC signature + Bearer access token

[Try this request](https://developers.getcount.com/tools/try-it?method=GET&path=%2Fpartners%2Ftaxes)

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

#### Query parameters

`enabled` enum optional

`true` for the codes in use, `false` for disabled ones. Omit for all codes.

One of: `true`, `false`

`updatedSince` string optional

Incremental sync. Returns only records created or changed at or after this ISO 8601 date-time (read as UTC when it has no offset), oldest change first, with `nextUpdatedSince` and `hasMore` beside the rows. Pass `nextUpdatedSince` back as `updatedSince` to read the next page; once `hasMore` is false, keep it for the next poll. Cannot be combined with `page` above 1 or a sort parameter (400).

`includeDeleted` boolean optional

Also return deleted records, each with `isDeleted: true`, so a sync can remove them. Records removed outright are listed by GET /partners/deleted-records instead.

#### Responses

`200` The workspace tax codes. `results` is the number of codes returned.

`400` `enabled` is not `true` or `false`.

`401` Missing or invalid HMAC signature, expired timestamp, or invalid Bearer token. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-401)

`403` The credential does not have access to this workspace or resource. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-403)

`429` Rate limit exceeded (100 requests per minute per user of each app, or 10,000 per minute per app). Retry after the Retry-After header. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-429)

[Next GET Get a tax code](https://developers.getcount.com/reference/taxes/get-tax)

GET `https://api.getcount.com/partners/taxes`

Request

```javascript
import crypto from 'node:crypto';

const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;
const ACCESS_TOKEN = process.env.COUNT_ACCESS_TOKEN;

const method = 'GET';
const signingPath = '/taxes';
const timestamp = Math.floor(Date.now() / 1000).toString();
const bodyString = '';

const bodyHash = '';
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');

const response = await fetch(`${BASE_URL}/partners/taxes`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
    Authorization: `Bearer ${ACCESS_TOKEN}`,
  },
});

console.log(await response.json());
```

Response · 200

```json
{
  "status": "success",
  "message": "Success on finding taxes",
  "data": {
    "taxes": [
      {
        "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
      }
    ],
    "results": 1
  }
}
```
