---
title: "🔒 List Tax Entries"
method: GET
path: "/api/v1/tax"
tags: ["Tax"]
---

# 🔒 List Tax Entries

`GET /api/v1/tax`

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

Retrieves a list of tax entries.

## Query parameters

- `filter` object[]
  - `key` 'name' | 'taxType' | 'taxRate' | 'countryCode' | 'zipCode' | 'isDefault' | 'isStandard' | 'defaultRevenueAccountNumber' | 'validFrom' | 'validUntil' | 'createdAt' | 'updatedAt'
  - `op` 'equals' | 'notEquals' | 'in' | 'notIn' | 'exactlyIn' | 'allIn' | 'allNotIn' | 'contains' | 'notContains' | 'startsWith' | 'endsWith' | 'greaterThan' | 'lessThan' | 'is' | 'lessThanOrEquals' | 'greaterThanOrEquals'
  - `value` union
    - string — Used for the operations 'equals', 'notEquals', 'contains', 'notContains', 'startsWith', 'endsWith' and 'is'.
    - string[] — Used for the operations 'in', 'notIn', 'exactlyIn', 'allIn' and 'allNotIn'.
- `page` object
  - `number` string, required — Page number should be an integer greater than or equal to 1
  - `size` string, required — Page size should usually be an integer between 10 and 50.
- `order` object[]
  - `field` 'id' | 'name' | 'taxType' | 'taxRate' | 'countryCode' | 'zipCode' | 'isDefault' | 'isStandard' | 'defaultRevenueAccountNumber' | 'validFrom' | 'validUntil' | 'createdAt' | 'updatedAt'
  - `dir` 'asc' | 'desc'

## Response `200`

Successful operation

- object
  - `data` object[]
    - `id` string — Tax ID
    - `name` string — Tax name
    - `taxType` string — Tax type
    - `taxRate` number, float — Tax rate
    - `countryCode` string — Country code in ISO 3166-1 alpha-2 format
    - `zipCode` string — ZIP code
    - `isDefault` boolean — Is default tax
    - `isStandard` boolean — Is standard tax
    - `defaultRevenueAccountNumber` string — Default revenue account number
    - `defaultDebitTaxAccountNumber` string, nullable — Default debit tax account number
    - `defaultCreditTaxAccountNumber` string, nullable — Default credit tax account number
    - `defaultCostAccountNumber` string, nullable — Default cost account number
    - `validFrom` string, date-time — Valid from date
    - `validUntil` string, date-time, nullable — Valid until date
    - `createdAt` string, date-time — Created at timestamp
    - `updatedAt` string, date-time — Updated at timestamp

## Other responses

- `400` — XGL Problem
- `401` — Unable to authenticate the client
- `403` — Unable to authorize the client
- `404` — XGL Problem
- `429` — Too many API calls made.
- `500` — XGL Problem

---

[API](https://skmtc.net/xentral/apis/xentral-api.md) · [All operations](https://skmtc.net/xentral/apis/xentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xentral/xentral-api/revisions/8a27ba392442/schema)