# Retrieve a paginated list of all currencies

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.

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

## Response 200 fields (application/json):

  - `content` (array)

  - `content.id` (integer)
    Unique identifier of the currency

  - `content.name` (string)
    Name of the currency

  - `content.description` (string)
    Description of the currency

  - `content.symbol` (string)
    Symbol of the currency

  - `content.exchangeRate` (number)
    Exchange rate of the currency

  - `content.baseRate` (number)
    Base rate of the currency

  - `content.unit` (string)
    Unit of the currency

  - `content.autoUpdate` (boolean)
    Indicates if the currency is auto-updated

  - `content.primaryCurrency` (boolean)
    Indicates if this is the primary currency

  - `content.htmlSafeSymbol` (string)
    HTML safe symbol of the currency

  - `page` (object)

  - `page.size` (integer)

  - `page.totalElements` (integer)

  - `page.totalPages` (integer)

  - `page.number` (integer)