> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# ListCurrencies

# Package: stores

# Namespace: CurrencyConverter

# Method link: https://dev.wix.com/docs/api-reference/business-solutions/stores/currency-converter/list-currencies.md

## Permission Scopes:
Manage Currencies: SCOPE.DC-CURRENCY-CONVERTER.MANAGE-CURRENCIES

## Introduction

Returns all currencies currently supported by Wix.

---

## REST API

### Schema

```
 Method: listCurrencies
 Description: Returns all currencies currently supported by Wix.
 URL: https://www.wixapis.com/v1/currencies
 Method: GET
 Return type: ListCurrenciesResponse
  - name: currencies | type: array<Currency> | description: Supported currencies 
     - name: code | type: string | description: Currency code. 
     - name: symbol | type: string | description: Currency symbol. 


```

### Examples

### ListCurrencies
```curl
~~~cURL
curl 'https://www.wixapis.com/currency_converter/api/v1/currencies' \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH>'
~~~
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.stores.CurrencyConverter.listCurrencies()
 Description: Returns all currencies currently supported by Wix.
 Return type: PROMISE<ListCurrenciesResponse>
  - name: currencies | type: array<Currency> | description: Supported currencies 
     - name: code | type: string | description: Currency code. 
     - name: symbol | type: string | description: Currency symbol. 


```

### Examples

### Get all supported currencies (with elevated permissions)
```javascript
import { currencies } from '@wix/ecom';
import { auth } from '@wix/essentials';

const elevatedListCurrencies = auth.elevate(currencies.listCurrencies);

elevatedListCurrencies()
  .then((listOfAllCurrencies) => {
    const firstCurrencyCode = listOfAllCurrencies[0].code;
    const firstCurrencyCSymbol = listOfAllCurrencies[0].symbol;
  });

/*
 *  Promise resolves to:
 *  {
 *    "currencies": [
 *      {"code": "EUR", "symbol": "€"},
 *      {"code": "USD", "symbol": "$"},
 *      {"code": "JPY", "symbol": "¥"}
 *    ]
 *  }
 */

```

### Get all supported currencies
```javascript
import { currencies } from '@wix/ecom';

currencies.listCurrencies()
  .then((listOfAllCurrencies) => {
    const firstCurrencyCode = listOfAllCurrencies[0].code;
    const firstCurrencyCSymbol = listOfAllCurrencies[0].symbol;
  });

/*
 *  Promise resolves to:
 *  {
 *    "currencies": [
 *      {"code": "EUR", "symbol": "€"},
 *      {"code": "USD", "symbol": "$"},
 *      {"code": "JPY", "symbol": "¥"}
 *    ]
 *  }
 */
```

### listCurrencies (self-hosted)
Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { currencies } from '@wix/ecom';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { currencies },
  // Include the auth strategy and host as relevant
});


async function listCurrencies() {
  const response = await myWixClient.currencies.listCurrencies();
};
```

---