For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL.

Skip to content
Paddle Docs home

Get currency conversion settings

Returns the currency conversion settings for your account.

GET/settings/currency-conversions

Returns the currency conversion settings for your account.

When a currency is enabled, Paddle automatically converts prices into it at checkout for customers whose local currency it is. A price override for the customer's country takes precedence over the converted price. When a currency isn't enabled, those customers see the price in its base currency instead. These settings don't limit which currencies you can use for prices or price overrides.

The response is keyed by currency code and includes every supported currency, whether or not you've changed it. It isn't paginated.

Requires currency_conversion.read permission.

Response (200)

dataobjectrequired
Represents the currency conversion settings for your account, keyed by currency code. Includes every currency that Paddle supports.
metaobjectrequired
Information about this response.
request_idstringrequired
Example: b15ec92e-8688-40d4-a04d-f44cbec93355
Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.
Response
{
  "data": {
    "ARS": {
      "enabled": false
    },
    "AUD": {
      "enabled": true
    },
    "BRL": {
      "enabled": false
    },
    "CAD": {
      "enabled": true
    },
    "CHF": {
      "enabled": false
    },
    "CLP": {
      "enabled": false
    },
    "CNY": {
      "enabled": false
    },
    "COP": {
      "enabled": false
    },
    "CZK": {
      "enabled": false
    },
    "DKK": {
      "enabled": false
    },
    "EUR": {
      "enabled": true
    },
    "GBP": {
      "enabled": false
    },
    "HKD": {
      "enabled": false
    },
    "HUF": {
      "enabled": false
    },
    "ILS": {
      "enabled": false
    },
    "INR": {
      "enabled": false
    },
    "JPY": {
      "enabled": true
    },
    "KRW": {
      "enabled": false
    },
    "MXN": {
      "enabled": false
    },
    "NOK": {
      "enabled": false
    },
    "NZD": {
      "enabled": false
    },
    "PEN": {
      "enabled": false
    },
    "PLN": {
      "enabled": false
    },
    "RUB": {
      "enabled": false
    },
    "SEK": {
      "enabled": false
    },
    "SGD": {
      "enabled": false
    },
    "THB": {
      "enabled": false
    },
    "TRY": {
      "enabled": false
    },
    "TWD": {
      "enabled": false
    },
    "UAH": {
      "enabled": false
    },
    "USD": {
      "enabled": true
    },
    "VND": {
      "enabled": false
    },
    "ZAR": {
      "enabled": false
    }
  },
  "meta": {
    "request_id": "9bcdcc29-e180-4055-ad3d-d37e5dc5e56d"
  }
}

Was this page helpful?