# Currencies

Operations related to Currency entities from the Property Management System (PMS), including retrieval and management of currencies used in financial transactions. Currencies define the monetary units used for invoices, payments, rates, and financial reporting across the system. This API provides endpoints to list and retrieve currency information, which is essential for multi-currency operations, international bookings, accurate exchange rate conversions, and financial reporting in different currencies. Currency data includes the currency code (e.g., GBP, EUR, USD), symbol, exchange rate relative to the base reporting currency, and primary currency designation. Exchange rates are stored with 4 decimal precision and use RoundingMode.HALF_UP for conversions. These functionalities support accurate multi-currency financial tracking and international business operations within the PMS.

## Retrieve a paginated list of all currencies

 - [GET /api/v3/currencies](https://apidocs.resharmonics.com/apis/resharmonics-pms/currencies/listallcurrencies.md): Fetch a paginated list of all currencies configured in the Property Management System (PMS). Currencies represent the monetary units supported for financial transactions, including invoicing, payments, room rates, and financial reporting. This endpoint is essential for systems handling international bookings or operating across multiple countries with different currencies. This endpoint is useful for retrieving the complete currency catalog to understand available monetary units, populate currency selection dropdowns in booking and invoice interfaces, display exchange rates to users, or integrate with external payment gateways and accounting systems that require currency information. The response includes paginated results with currency details including ID, currency code (ISO 4217 format like GBP, EUR, USD), currency name, symbol (e.g., £, €, $), exchange rate relative to the base reporting currency, and a flag indicating if this is the primary/base currency for the organization. Exchange rates are stored with 4 decimal precision (e.g., 1.2345) to ensure accurate conversions. When performing currency conversions in calculations, the system uses RoundingMode.HALF_UP to maintain consistency and accuracy across all financial operations. Currencies are returned in the order specified by the pageable parameter. The system supports both transactional currency (used for guest-facing amounts) and base currency (used for internal reporting) to accommodate international operations. If no currencies 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.