List Available Currencies | BigCommerce Developer Center

Returns a list of the currencies currently enabled on a BigCommerce store. If the channelId parameter is provided, the response will also include a list of currencies currently enabled for the associated storefront channel.

Note: This endpoint is available with or without a Bearer Token. To use the endpoint without a token, the storeHash parameter is required.

Equivalent Storefront GraphQL API Query: currencies. For more information, see the GraphQL Playground.

Returns a list of the currencies currently enabled on a BigCommerce store. If the `channelId` parameter is provided, the response will also include a list of currencies currently enabled for the associated storefront channel. **Note:** This endpoint is available with or without a Bearer Token. To use the endpoint without a token, the `storeHash` parameter is required. Equivalent Storefront GraphQL API Query: `currencies`. For more information, see the [GraphQL Playground](https://api-b2b.bigcommerce.com/graphql/playground).

Authentication

AuthorizationBearer

Authentication header

Header	Argument	Description
`Authorization`	`Bearer {{B2B_JWT_TOKEN}}`	You can obtain this token using the steps described in the REST Storefront API section[…]

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| |`Authorization`|`Bearer {{B2B_JWT_TOKEN}}`| You can obtain this token using the steps described in the [REST Storefront API](/developer/docs/b2b-edition/getting-started/authentication#rest-storefront-api) section[...]

Query parameters

channelIdstringOptional

The ID for a specific storefront channel. Including this parameter adds a list of channel-specific currencies to the response.

storeHashstringOptional

The unique store hash for the BigCommerce store. If a Bearer Token is provided with the request, the store's information is pulled using the token, and including the parameter will have no effect. If the Bearer Token is omitted this parameter is required to complete the request.

Response

codeintegerDefaults to 200

HTTP response code for the request.

messagestringDefaults to SUCCESS

Message indicating the status of the request.

dataobject

Data associated with the response.

Errors

400

Bad Request Error

1	import requests
2
3	url = "https://api-b2b.bigcommerce.com/api/v2/stores/currencies"
4
5	querystring = {"channelId":"123456","storeHash":"abc123"}
6
7	headers = {"Authorization": "Bearer <token>"}
8
9	response = requests.get(url, headers=headers, params=querystring)
10
11	print(response.json())

1	{
2	"code": 200,
3	"message": "SUCCESS",
4	"data": {
5	"currencies": [
6	{
7	"id": 2,
8	"is_default": true,
9	"country_iso2": "US",
10	"last_updated": "Tue, 14 Feb 2023 21:02:15 +0000",
11	"default_for_country_codes": [
12	"US",
13	"CA",
14	"GB"
15	],
16	"currency_code": "USD",
17	"currency_exchange_rate": "1.3540000",
18	"name": "US Dollar",
19	"token": "$",
20	"auto_update": true,
21	"token_location": "left",
22	"decimal_token": ".",
23	"thousands_token": ",",
24	"decimal_places": 2,
25	"enabled": true,
26	"is_transactional": true
27	}
28	],
29	"channelCurrencies": {
30	"channel_id": 123456,
31	"enabled_currencies": [
32	"USD",
33	"GBP",
34	"IQD"
35	],
36	"default_currency": "USD"
37	},
38	"entered_inclusive_tax": true
39	}
40	}