API version: unstable
API version: 2021-01 Release candidate
API version: 2020-10 Latest
API version: 2020-07
API version: 2020-04
API version: 2020-01
API version: 2019-10 Unsupported
API version: 2019-07 Unsupported

Currency

Version 2020-01

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.

What you can do with Currency

The Shopify API lets you do the following with the Currency resource. More detailed versions of these general actions may be available:

Currency properties

currency
"currency": "JPY"

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

rate_updated_at
"rate_updated_at": "2018-10-03T14:44:08-04:00"

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.

Endpoints

GET /admin/api/2020-01/currencies.json
Retrieves a list of currencies enabled on a shop

Retrieve a list of currencies enabled on a shop

GET /admin/api/2020-01/currencies.json
View 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
    }
  ]
}
Version 2020-04

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.

What you can do with Currency

The Shopify API lets you do the following with the Currency resource. More detailed versions of these general actions may be available:

Currency properties

currency
"currency": "JPY"

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

rate_updated_at
"rate_updated_at": "2018-10-03T14:44:08-04:00"

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.

Endpoints

GET /admin/api/2020-04/currencies.json
Retrieves a list of currencies enabled on a shop

Retrieve a list of currencies enabled on a shop

GET /admin/api/2020-04/currencies.json
View 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
    }
  ]
}
Version 2020-07

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.

What you can do with Currency

The Shopify API lets you do the following with the Currency resource. More detailed versions of these general actions may be available:

Currency properties

currency
"currency": "JPY"

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

rate_updated_at
"rate_updated_at": "2018-10-03T14:44:08-04:00"

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.

Endpoints

GET /admin/api/2020-07/currencies.json
Retrieves a list of currencies enabled on a shop

Retrieve a list of currencies enabled on a shop

GET /admin/api/2020-07/currencies.json
View 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
    }
  ]
}
Version 2020-10 (Latest)

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.

What you can do with Currency

The Shopify API lets you do the following with the Currency resource. More detailed versions of these general actions may be available:

Currency properties

currency
"currency": "JPY"

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

rate_updated_at
"rate_updated_at": "2018-10-03T14:44:08-04:00"

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.

Endpoints

GET /admin/api/2020-10/currencies.json
Retrieves a list of currencies enabled on a shop

Retrieve a list of currencies enabled on a shop

GET /admin/api/2020-10/currencies.json
View 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
    }
  ]
}
Version 2021-01 (Release candidate)

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.

What you can do with Currency

The Shopify API lets you do the following with the Currency resource. More detailed versions of these general actions may be available:

Currency properties

currency
"currency": "JPY"

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

rate_updated_at
"rate_updated_at": "2018-10-03T14:44:08-04:00"

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.

Endpoints

GET /admin/api/2021-01/currencies.json
Retrieves a list of currencies enabled on a shop

Retrieve a list of currencies enabled on a shop

GET /admin/api/2021-01/currencies.json
View 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
    }
  ]
}
Version unstable

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.

What you can do with Currency

The Shopify API lets you do the following with the Currency resource. More detailed versions of these general actions may be available:

Currency properties

currency
"currency": "JPY"

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

rate_updated_at
"rate_updated_at": "2018-10-03T14:44:08-04:00"

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.

Endpoints

GET /admin/api/unstable/currencies.json
Retrieves a list of currencies enabled on a shop

Retrieve a list of currencies enabled on a shop

GET /admin/api/unstable/currencies.json
View 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
    }
  ]
}