# Retrieve a paginated list of all tax codes

Fetch a paginated list of all tax codes configured in the Property Management System (PMS). Tax codes represent different tax rates and classifications that can be applied to invoice line items, such as standard VAT (e.g., 20%), reduced VAT (e.g., 5%), zero-rated (0%), or tax-exempt items. This endpoint is useful for retrieving the complete tax code catalog to understand available tax classifications, populate dropdown selections in invoice creation and product configuration interfaces, ensure accurate tax calculations on invoices, or integrate with external accounting systems. The response includes paginated results with tax code details including ID, code identifier, name, tax rate percentage (stored with 2 decimal precision), type (SALES or PURCHASE), Xero tax type mapping for external system integration, and export name for accounting purposes. Tax codes are returned in the order specified by the pageable parameter. Tax rates are stored as decimal values (e.g., 20.00 for 20% VAT) and should be rounded to 2 decimal places when used in calculations to maintain consistency with database precision. If no tax codes exist in the system, an empty list will be returned. In case of an unexpected system error, a 500 Internal Server Error will be triggered.

Endpoint: GET /api/v3/taxCodes
Version: 3.0.12
Security: X-Auth-Token

## Response 200 fields (application/json):

  - `content` (array)

  - `content.id` (integer)
    The unique identifier of the tax code
    Example: 1

  - `content.type` (string, required)
    Type of the tax code
    Enum: "SALES", "PURCHASE"

  - `content.code` (string, required)
    Code of the tax code

  - `content.name` (string, required)
    Name of the tax code

  - `content.rate` (number, required)
    Rate of the tax code

  - `content.xeroTaxType` (string)
    Xero tax type of the tax code

  - `content.exportName` (string)
    Export name of the tax code

  - `page` (object)

  - `page.size` (integer)

  - `page.totalElements` (integer)

  - `page.totalPages` (integer)

  - `page.number` (integer)