# 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}]}
```