---
title: "List Paddle currencies"
method: GET
path: "/currencies"
tags: ["Currencies"]
---

# List Paddle currencies

`GET /currencies`

## Request

- Base URL: `https://sandbox-api.paddle.com`
- URL: `https://sandbox-api.paddle.com/currencies`
- Auth: none required

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`

The request has succeeded.

- object
  - `data` CurrencyDefinition[], required
    - `code` 'USD' | 'EUR' | 'GBP' | 'JPY' | 'AUD' | 'CAD' | 'CHF' | 'HKD' | 'SGD' | 'SEK' | 'ARS' | 'BRL' | 'CLP' | 'CNY' | 'COP' | 'CZK' | 'DKK' | 'HUF' | 'ILS' | 'INR' | 'KRW' | 'MXN' | 'NOK' | 'NZD' | 'PEN' | 'PLN' | 'RUB' | 'THB' | 'TRY' | 'TWD' | 'UAH' | 'VND' | 'ZAR', required: Supported three-letter ISO 4217 currency code.
    - `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` CountryCodeSupported[], 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.
    - `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` Meta, 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.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-10-19** (v1) `4f35a8c6ea4d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paddlehq/apis/paddle-api/changes/currencies/get.md)

---

[API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [All operations](https://skmtc.dev/paddlehq/apis/paddle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paddlehq/apis/paddle-api/revisions/bbc0c72039c8?raw)
