# Currency <p>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. </p> <p>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.</p> ## Resource Properties ### Currency * currency: The three-letter code (<a href="https://en.wikipedia.org/wiki/ISO_4217">ISO 4217</a> format) for the currency associated with this setting. * Type: x-string * Example: "JPY" * rate_updated_at: The date and time (<a href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601</a> 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. * Type: x-string * Example: "2018-10-03T14:44:08-04:00" ## Retrieves a list of currencies enabled on a shop Retrieves a list of currencies enabled on a shop ### Endpoint /admin/api/#{api_version}/currencies.json (GET) ### Parameters * api_version (required): ### Responses #### 200 Retrieves a list of currencies enabled on a shop Examples: ##### Retrieve a list of currencies enabled on a shop Request: ``` GET /admin/api/unstable/currencies.json ``` Response: ``` 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}]} ```