> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# GET /currencies

**List Paddle currencies**

Returns a list of currencies that Paddle supports, including the number of decimal places
used and the minimum amount that Paddle can process.

The response is not paginated.

## Response (200)

- `data`: array (required)
  - `code`: string (required) — Three-letter ISO 4217 code for the currency.
    - `USD` — United States Dollar
    - `EUR` — Euro
    - `GBP` — Pound Sterling
    - `JPY` — Japanese Yen
    - `AUD` — Australian Dollar
    - `CAD` — Canadian Dollar
    - `CHF` — Swiss Franc
    - `HKD` — Hong Kong Dollar
    - `SGD` — Singapore Dollar
    - `SEK` — Swedish Krona
    - `ARS` — Argentine Peso
    - `BRL` — Brazilian Real
    - `CLP` — Chilean Peso
    - `CNY` — Chinese Yuan
    - `COP` — Colombian Peso
    - `CZK` — Czech Koruna
    - `DKK` — Danish Krone
    - `HUF` — Hungarian Forint
    - `ILS` — Israeli Shekel
    - `INR` — Indian Rupee
    - `KRW` — South Korean Won
    - `MXN` — Mexican Peso
    - `NOK` — Norwegian Krone
    - `NZD` — New Zealand Dollar
    - `PEN` — Peruvian Sol
    - `PLN` — Polish Zloty
    - `RUB` — Russian Ruble
    - `THB` — Thai Baht
    - `TRY` — Turkish Lira
    - `TWD` — New Taiwan Dollar
    - `UAH` — Ukrainian Hryvnia
    - `VND` — Vietnamese Dong
    - `ZAR` — South African Rand
  - `name`: string (required) — Full name of the currency.
  - `decimal_places`: integer (required) — The number of decimal places in the common notation of the currency.
  - `can_be_balance`: boolean (required) — Whether you can hold your balance in this currency. You can set your balance currency in the dashboard.
  - `applicable_countries`: array (required) — Countries where this currency is used for automatic price conversion. Only includes countries that Paddle supports sales to. You can set up automatic currency conversion in the dashboard.
    - `AD` — Andorra
    - `AE` — United Arab Emirates
    - `AG` — Antigua and Barbuda
    - `AI` — Anguilla
    - `AL` — Albania
    - `AM` — Armenia
    - `AO` — Angola
    - `AR` — Argentina
    - `AS` — American Samoa
    - `AT` — Austria
    - `AU` — Australia
    - `AW` — Aruba
    - `AX` — Åland Islands
    - `AZ` — Azerbaijan
    - `BA` — Bosnia and Herzegovina
    - `BB` — Barbados
    - `BD` — Bangladesh
    - `BE` — Belgium
    - `BF` — Burkina Faso
    - `BG` — Bulgaria
    - `BH` — Bahrain
    - `BI` — Burundi
    - `BJ` — Benin
    - `BL` — Saint Barthélemy
    - `BM` — Bermuda
    - `BN` — Brunei
    - `BO` — Bolivia
    - `BQ` — Caribbean Netherlands (Bonaire, Sint Eustatius, and Saba)
    - `BR` — Brazil
    - `BS` — Bahamas
    - `BT` — Bhutan
    - `BV` — Bouvet Island
    - `BW` — Botswana
    - `BZ` — Belize
    - `CA` — Canada
    - `CC` — Cocos Islands
    - `CG` — Republic of Congo
    - `CH` — Switzerland
    - `CI` — Côte d'Ivoire (Ivory Coast)
    - `CK` — Cook Islands
    - `CL` — Chile
    - `CM` — Cameroon
    - `CN` — China
    - `CO` — Colombia
    - `CR` — Costa Rica
    - `CV` — Cape Verde
    - `CW` — Curaçao
    - `CX` — Christmas Island
    - `CY` — Cyprus
    - `CZ` — Czechia (Czech Republic)
    - `DE` — Germany
    - `DJ` — Djibouti
    - `DK` — Denmark
    - `DM` — Dominica
    - `DO` — Dominican Republic
    - `DZ` — Algeria
    - `EC` — Ecuador
    - `EE` — Estonia
    - `EG` — Egypt
    - `EH` — Western Sahara
    - `ER` — Eritrea
    - `ES` — Spain
    - `ET` — Ethiopia
    - `FI` — Finland
    - `FJ` — Fiji
    - `FK` — Falkland Islands
    - `FM` — Micronesia
    - `FO` — Faroe Islands
    - `FR` — France
    - `GA` — Gabon
    - `GB` — United Kingdom
    - `GD` — Grenada
    - `GE` — Georgia
    - `GF` — French Guiana
    - `GG` — Guernsey
    - `GH` — Ghana
    - `GI` — Gibraltar
    - `GL` — Greenland
    - `GM` — Gambia
    - `GN` — Guinea
    - `GP` — Guadeloupe
    - `GQ` — Equatorial Guinea
    - `GR` — Greece
    - `GS` — South Georgia and the South Sandwich Islands
    - `GT` — Guatemala
    - `GU` — Guam
    - `GW` — Guinea-Bissau
    - `GY` — Guyana
    - `HK` — Hong Kong
    - `HM` — Heard Island and McDonald Islands
    - `HN` — Honduras
    - `HR` — Croatia
    - `HU` — Hungary
    - `ID` — Indonesia
    - `IE` — Ireland
    - `IL` — Israel
    - `IM` — Isle of Man
    - `IN` — India
    - `IO` — British Indian Ocean Territory
    - `IQ` — Iraq
    - `IS` — Iceland
    - `IT` — Italy
    - `JE` — Jersey
    - `JM` — Jamaica
    - `JO` — Jordan
    - `JP` — Japan
    - `KE` — Kenya
    - `KG` — Kyrgyzstan
    - `KH` — Cambodia
    - `KI` — Kiribati
    - `KM` — Comoros
    - `KN` — Saint Kitts and Nevis
    - `KR` — South Korea
    - `KW` — Kuwait
    - `KY` — Cayman Islands
    - `KZ` — Kazakhstan
    - `LA` — Lao People's Democratic Republic (Laos)
    - `LB` — Lebanon
    - `LC` — Saint Lucia
    - `LI` — Liechtenstein
    - `LK` — Sri Lanka
    - `LR` — Liberia
    - `LS` — Lesotho
    - `LT` — Lithuania
    - `LU` — Luxembourg
    - `LV` — Latvia
    - `MA` — Morocco
    - `MC` — Monaco
    - `MD` — Moldova
    - `ME` — Montenegro
    - `MF` — Saint Martin
    - `MG` — Madagascar
    - `MH` — Marshall Islands
    - `MK` — Macedonia
    - `MN` — Mongolia
    - `MO` — Macao
    - `MP` — Northern Mariana Islands
    - `MQ` — Martinique
    - `MR` — Mauritania
    - `MS` — Montserrat
    - `MT` — Malta
    - `MU` — Mauritius
    - `MV` — Maldives
    - `MW` — Malawi
    - `MX` — Mexico
    - `MY` — Malaysia
    - `MZ` — Mozambique
    - `NA` — Namibia
    - `NC` — New Caledonia
    - `NE` — Niger
    - `NF` — Norfolk Island
    - `NG` — Nigeria
    - `NL` — Netherlands
    - `NO` — Norway
    - `NP` — Nepal
    - `NR` — Nauru
    - `NU` — Niue
    - `NZ` — New Zealand
    - `OM` — Oman
    - `PA` — Panama
    - `PE` — Peru
    - `PF` — French Polynesia
    - `PG` — Papua New Guinea
    - `PH` — Philippines
    - `PK` — Pakistan
    - `PL` — Poland
    - `PM` — Saint Pierre and Miquelon
    - `PN` — Pitcairn
    - `PR` — Puerto Rico
    - `PS` — Palestinian territories
    - `PT` — Portugal
    - `PW` — Palau
    - `PY` — Paraguay
    - `QA` — Qatar
    - `RE` — Reunion
    - `RO` — Romania
    - `RS` — Republic of Serbia
    - `RW` — Rwanda
    - `SA` — Saudi Arabia
    - `SB` — Solomon Islands
    - `SC` — Seychelles
    - `SE` — Sweden
    - `SG` — Singapore
    - `SH` — Saint Helena
    - `SI` — Slovenia
    - `SJ` — Svalbard and Jan Mayen
    - `SK` — Slovakia
    - `SL` — Sierra Leone
    - `SM` — San Marino
    - `SN` — Senegal
    - `SR` — Suriname
    - `ST` — São Tomé and Príncipe
    - `SV` — El Salvador
    - `SX` — Sint Maarten
    - `SZ` — Swaziland
    - `TC` — Turks and Caicos Islands
    - `TD` — Chad
    - `TF` — French Southern and Antarctic Lands
    - `TG` — Togo
    - `TH` — Thailand
    - `TJ` — Tajikistan
    - `TK` — Tokelau
    - `TL` — Timor-Leste
    - `TM` — Turkmenistan
    - `TN` — Tunisia
    - `TO` — Tonga
    - `TR` — Turkey
    - `TT` — Trinidad and Tobago
    - `TV` — Tuvalu
    - `TW` — Taiwan
    - `TZ` — Tanzania
    - `UA` — Ukraine
    - `UG` — Uganda
    - `UM` — United States Minor Outlying Islands
    - `US` — United States
    - `UY` — Uruguay
    - `UZ` — Uzbekistan
    - `VA` — Holy See (Vatican City)
    - `VC` — Saint Vincent and the Grenadines
    - `VG` — British Virgin Islands
    - `VI` — U.S. Virgin Islands
    - `VN` — Vietnam
    - `VU` — Vanuatu
    - `WF` — Wallis and Futuna
    - `WS` — Samoa
    - `XK` — Kosovo
    - `YT` — Mayotte
    - `ZA` — South Africa
    - `ZM` — Zambia
  - `minimum_payment_amount`: string (required) — Minimum charge for this currency in the lowest denomination for this currency, for example 10 USD = 1000 (cents). Payment can't be attempted for a transaction or checkout below this amount.
- `meta`: object (required) — Information about this response.
  - `request_id`: string (required) — Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.

### Response example

```json
{
  "data": [
    {
      "code": "USD",
      "name": "US Dollar",
      "decimal_places": 2,
      "can_be_balance": true,
      "applicable_countries": [
        "AE",
        "AG",
        "AI",
        "AM",
        "AO",
        "AS",
        "AW",
        "AZ",
        "BB",
        "BD",
        "BF",
        "BH",
        "BI",
        "BJ",
        "BM",
        "BN",
        "BO",
        "BQ",
        "BS",
        "BT",
        "BW",
        "BZ",
        "CG",
        "CI",
        "CM",
        "CR",
        "CV",
        "CW",
        "DJ",
        "DM",
        "DO",
        "DZ",
        "EC",
        "EG",
        "EH",
        "ER",
        "ET",
        "FJ",
        "FM",
        "GA",
        "GD",
        "GE",
        "GH",
        "GM",
        "GN",
        "GQ",
        "GT",
        "GU",
        "GW",
        "GY",
        "HN",
        "ID",
        "IQ",
        "JM",
        "JO",
        "KE",
        "KG",
        "KH",
        "KM",
        "KN",
        "KW",
        "KY",
        "KZ",
        "LA",
        "LB",
        "LC",
        "LK",
        "LR",
        "LS",
        "MA",
        "MG",
        "MH",
        "MN",
        "MP",
        "MR",
        "MS",
        "MU",
        "MV",
        "MW",
        "MY",
        "MZ",
        "NA",
        "NC",
        "NE",
        "NG",
        "NP",
        "OM",
        "PA",
        "PG",
        "PH",
        "PK",
        "PR",
        "PW",
        "PY",
        "QA",
        "RW",
        "SA",
        "SB",
        "SC",
        "SL",
        "SN",
        "SR",
        "ST",
        "SV",
        "SZ",
        "TC",
        "TD",
        "TG",
        "TJ",
        "TL",
        "TM",
        "TN",
        "TO",
        "TT",
        "TZ",
        "UG",
        "UM",
        "US",
        "UY",
        "UZ",
        "VC",
        "VG",
        "VI",
        "VU",
        "WF",
        "WS",
        "ZM"
      ],
      "minimum_payment_amount": "70"
    },
    {
      "code": "GBP",
      "name": "Pound Sterling",
      "decimal_places": 2,
      "can_be_balance": true,
      "applicable_countries": [
        "FK",
        "GB",
        "GG",
        "GI",
        "GS",
        "IM",
        "IO",
        "JE",
        "SH"
      ],
      "minimum_payment_amount": "55"
    },
    {
      "code": "EUR",
      "name": "Euro",
      "decimal_places": 2,
      "can_be_balance": true,
      "applicable_countries": [
        "AD",
        "AL",
        "AT",
        "AX",
        "BA",
        "BE",
        "BG",
        "BL",
        "CY",
        "DE",
        "EE",
        "ES",
        "FI",
        "FR",
        "GF",
        "GL",
        "GP",
        "GR",
        "HR",
        "IE",
        "IS",
        "IT",
        "LT",
        "LU",
        "LV",
        "MC",
        "MD",
        "ME",
        "MF",
        "MK",
        "MQ",
        "MT",
        "NL",
        "PF",
        "PM",
        "PT",
        "RE",
        "RO",
        "RS",
        "SI",
        "SK",
        "SM",
        "SX",
        "TF",
        "VA",
        "XK",
        "YT"
      ],
      "minimum_payment_amount": "65"
    },
    {
      "code": "RUB",
      "name": "Ruble",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [],
      "minimum_payment_amount": "5900"
    },
    {
      "code": "AUD",
      "name": "Australian Dollar",
      "decimal_places": 2,
      "can_be_balance": true,
      "applicable_countries": [
        "AU",
        "CC",
        "CX",
        "HM",
        "KI",
        "NF",
        "NR",
        "TV"
      ],
      "minimum_payment_amount": "110"
    },
    {
      "code": "BRL",
      "name": "Brazilian Real",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "BR"
      ],
      "minimum_payment_amount": "400"
    },
    {
      "code": "CAD",
      "name": "Canadian Dollar",
      "decimal_places": 2,
      "can_be_balance": true,
      "applicable_countries": [
        "CA"
      ],
      "minimum_payment_amount": "100"
    },
    {
      "code": "CHF",
      "name": "Swiss Franc",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "CH",
        "LI"
      ],
      "minimum_payment_amount": "60"
    },
    {
      "code": "CNY",
      "name": "Chinese Yuan",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "CN"
      ],
      "minimum_payment_amount": "510"
    },
    {
      "code": "PLN",
      "name": "Polish Zloty",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "PL"
      ],
      "minimum_payment_amount": "265"
    },
    {
      "code": "SEK",
      "name": "Swedish Krona",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "SE"
      ],
      "minimum_payment_amount": "680"
    },
    {
      "code": "ZAR",
      "name": "South African Rand",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "ZA"
      ],
      "minimum_payment_amount": "1275"
    },
    {
      "code": "CZK",
      "name": "Czech Koruna",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "CZ"
      ],
      "minimum_payment_amount": "1550"
    },
    {
      "code": "HUF",
      "name": "Hungarian Forint",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "HU"
      ],
      "minimum_payment_amount": "25200"
    },
    {
      "code": "DKK",
      "name": "Danish Krone",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "DK",
        "FO"
      ],
      "minimum_payment_amount": "470"
    },
    {
      "code": "NZD",
      "name": "New Zealand Dollar",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "CK",
        "NU",
        "NZ",
        "PN",
        "TK"
      ],
      "minimum_payment_amount": "120"
    },
    {
      "code": "SGD",
      "name": "Singapore Dollar",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "SG"
      ],
      "minimum_payment_amount": "90"
    },
    {
      "code": "HKD",
      "name": "Hong Kong Dollar",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "HK",
        "MO"
      ],
      "minimum_payment_amount": "550"
    },
    {
      "code": "INR",
      "name": "Indian Rupee",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "IN"
      ],
      "minimum_payment_amount": "6000"
    },
    {
      "code": "JPY",
      "name": "Japanese Yen",
      "decimal_places": 0,
      "can_be_balance": false,
      "applicable_countries": [
        "JP"
      ],
      "minimum_payment_amount": "100"
    },
    {
      "code": "KRW",
      "name": "South Korean Won",
      "decimal_places": 0,
      "can_be_balance": false,
      "applicable_countries": [
        "KR"
      ],
      "minimum_payment_amount": "980"
    },
    {
      "code": "MXN",
      "name": "Mexican Pesos",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "MX"
      ],
      "minimum_payment_amount": "1370"
    },
    {
      "code": "ARS",
      "name": "Argentine Peso",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "AR"
      ],
      "minimum_payment_amount": "78000"
    },
    {
      "code": "TWD",
      "name": "New Taiwan Dollar",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "TW"
      ],
      "minimum_payment_amount": "2500"
    },
    {
      "code": "NOK",
      "name": "Norwegian Krone",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "BV",
        "NO",
        "SJ"
      ],
      "minimum_payment_amount": "725"
    },
    {
      "code": "THB",
      "name": "Thai Baht",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "TH"
      ],
      "minimum_payment_amount": "2300"
    },
    {
      "code": "TRY",
      "name": "Turkish Lira",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "TR"
      ],
      "minimum_payment_amount": "2700"
    },
    {
      "code": "ILS",
      "name": "Israeli Shekels",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "IL",
        "PS"
      ],
      "minimum_payment_amount": "250"
    },
    {
      "code": "UAH",
      "name": "Ukraine Hryvnia",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "UA"
      ],
      "minimum_payment_amount": "2900"
    },
    {
      "code": "COP",
      "name": "Colombian Peso",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "CO"
      ],
      "minimum_payment_amount": "298000"
    },
    {
      "code": "VND",
      "name": "Vietnamese Dong",
      "decimal_places": 0,
      "can_be_balance": false,
      "applicable_countries": [
        "VN"
      ],
      "minimum_payment_amount": "20276"
    },
    {
      "code": "CLP",
      "name": "Chilean Peso",
      "decimal_places": 0,
      "can_be_balance": false,
      "applicable_countries": [
        "CL"
      ],
      "minimum_payment_amount": "800"
    },
    {
      "code": "PEN",
      "name": "Peruvian Sol",
      "decimal_places": 2,
      "can_be_balance": false,
      "applicable_countries": [
        "PE"
      ],
      "minimum_payment_amount": "250"
    }
  ],
  "meta": {
    "request_id": "7f3c1d95-2a48-4e6b-9c07-5b8e2f4a1d63"
  }
}
```
