Skip to main content

The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the GraphQL Admin API. For details and migration steps, visit our migration guide.

Currency

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

Anchor to

The Currency resource

Anchor to

Properties

currency
->
currencyCode

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

rate_updated_at
->
rateUpdatedAt

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"
}

Anchor to GET request, Retrieves a list of currencies enabled on a shop
get
Retrieves a list of currencies enabled on a shop

shop

Retrieves a list of currencies enabled on a shop

Anchor to Parameters of Retrieves a list of currencies enabled on a shopParameters

api_version
string
required
Was this section helpful?

Anchor to get-currencies-examplesExamples

Retrieve a list of currencies enabled on a shop

Was this section helpful?
get

/admin/api/2025-07/currencies.json

curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-07/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
}
]
}