---
title: "List tax rates"
description: "Retrieve the tax rates available for calculating VAT on Qashio spend."
source: https://developers.qashio.com/v2/reference/get-public-v1-erp-tax-rates/
---

# List tax rates

`GET /public/v1/erp/tax_rates`

Requires a Bearer access token.

**Purpose.** Retrieve the tax rates available for calculating VAT on Qashio spend.

**Description.** Returns a paginated list of tax rates synced from your accounting system, newest
first. Transactions and line items reference these records so VAT is applied using the same rate
definitions your ledger uses.

**Input (query).** `page`, `page_size`, `remote_id`, `remote_name`, `status`
(`draft` / `active` / `inactive`), `is_deleted` (`true` / `false`),
`created_at_from` / `created_at_to`, `updated_at_from` / `updated_at_to`.

**Output.** Array of tax rates, plus `pagination`.

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | Qashio identifier (UUID) |
| `remote_id` | string | Identifier in your accounting system |
| `remote_name` | string | Tax rate name, e.g. `VAT 5%` |
| `tax_rate_code` | string | Code used in your accounting system |
| `total_tax_rate` | number | Effective percentage |
| `country_code` | string | Country the rate applies to |
| `status` | string | `draft`, `active` or `inactive` |
| `is_deleted` | boolean | Marked deleted upstream |
| `created_at` / `updated_at` | string | ISO 8601 timestamps |

**Errors.** `400`, `401`, `403`.

### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | no |  |
| `page_size` | integer | no |  |
| `remote_id` | string | no |  |
| `remote_name` | string | no |  |
| `status` | string | no | One of `draft`, `active`, `inactive`. |
| `is_deleted` | string | no | One of `true`, `false`. |
| `created_at_from` | string | no |  |
| `created_at_to` | string | no |  |
| `updated_at_from` | string | no |  |
| `updated_at_to` | string | no |  |

### Example request

```bash
curl -X GET 'https://api.qashio.com/public/v1/erp/tax_rates?page=1&page_size=20' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <access_token>'
```

### Example response (200)

```json
{
  "status_code": 200,
  "success": true,
  "data": [
    {
      "id": "2d3117fb-bb15-4260-8064-261984d34086",
      "remote_name": "Tax Rate - 1",
      "remote_id": "295",
      "tax_rate_code": "EXEMPT",
      "total_tax_rate": 0,
      "status": "inactive",
      "country_code": "SAU",
      "is_deleted": false,
      "updated_at": "2026-07-16T00:35:46.603Z",
      "created_at": "2026-07-16T00:35:46.603Z"
    }
  ],
  "meta": {
    "request_id": "3adb2d16090c7b3bdbde3b326a814b30",
    "timestamp": "2026-09-09T10:07:52.143Z"
  },
  "pagination": {
    "page": 1,
    "page_size": 20,
    "total_pages": 1,
    "total_records": 7,
    "has_next": false,
    "has_previous": false
  }
}
```

### Errors

- `401` Unauthorized - missing or invalid Bearer token