The REST Admin API is a legacy API as of October 1, 2024. All apps and integrations should be built with the GraphQL Admin API. For details and migration steps, visit our migration guide.

Merchants who use Shopify Payments can allow customers to pay in their local currency on the online store. When a customer selects a currency, all prices on the online store and checkout are automatically converted to that currency. Merchants enable the currencies that they want to offer to customers from their Shopify Payments settings.

The Currency resource represents a currency that the merchant has enabled. For each enabled currency, the Currency resource returns the currency code and the time when its conversion rate was last updated.

Was this section helpful?
#Endpoints

Properties

currency
The three-letter code (ISO 4217 format) for the currency associated with this setting.

rate_updated_at
The date and time (ISO 8601 format) when the conversion rate associated with this currency was last updated. If manual FX rates are active on a shop, then the updated date of these rates will replace the automatic conversion rates. Conversion rates are checked every 15 minutes, but typically updated only a few times a day. Manual FX rates are updated at the merchant's request.

Was this section helpful?
{}The Currency resource
{
  "currency": "JPY",
  "rate_updated_at": "2018-10-03T14:44:08-04:00"
}

Retrieves a list of currencies enabled on a shop

api_version
string
required

Was this section helpful?
Was this section helpful?
get
/admin/api/2024-10/currencies.json
Copy
curl -X GET "https://your-development-store.myshopify.com/admin/api/2024-10/currencies.json" \
-H "X-Shopify-Access-Token: {access_token}"
{}Response
JSON
HTTP/1.1 200 OK
{
  "currencies": [
    {
      "currency": "CAD",
      "rate_updated_at": "2018-01-23T19:01:01-05:00",
      "enabled": true
    },
    {
      "currency": "EUR",
      "rate_updated_at": "2018-01-23T19:01:01-05:00",
      "enabled": true
    },
    {
      "currency": "JPY",
      "rate_updated_at": "2018-01-23T19:01:01-05:00",
      "enabled": true
    }
  ]
}