# Tax Codes

Operations related to Tax Code entities from the Property Management System (PMS), including retrieval and management of tax codes used in financial transactions. Tax codes define the tax rates and types applied to invoice line items, such as standard VAT, reduced VAT, zero-rated, or exempt. This API provides endpoints to list and retrieve tax code information, which is essential for creating accurate invoices, ensuring proper tax calculations, maintaining compliance with tax regulations, and integrating with external accounting systems. Tax codes include details such as the tax rate percentage, tax code identifier, name, type (sales/purchase), and mappings to external systems like Xero. These functionalities support accurate tax reporting and financial integrity within the PMS.

## Retrieve a paginated list of all tax codes

 - [GET /api/v3/taxCodes](https://apidocs.resharmonics.com/apis/resharmonics-pms/tax-codes/listalltaxcodes.md): 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.