{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/api/getting-started/headers/currency/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

X-Musement-Currency header

\n

By default, responses will show prices in United States dollars (USD) or the default currency of the X-Musement-Market header value (if present). You can request prices in a specific currency with the X-Musement-Currency header.

\n

In the example request below, we are asking for prices in British pounds (GBP):

\n
\n
\n
Copy
\n
Copied
\n
\n 
curl -X GET '{baseUrl}/activities/{activityUuid}' \\\n-H 'X-Musement-Application: {applicationValue}' \\\n-H 'X-Musement-Version: 3.4.0' \\\n-H 'X-Musement-Currency: GBP' \\\n-H 'Authorization: Bearer {accessToken}'
\n
\n

As a result, price properties in the response will use British pounds:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n\t[...]\n\t\"retail_price\": { \n\t\t\"currency\": \"GBP\", \n\t\t\"value\": 24, \n\t\t\"formatted_value\": \"£ 24.00\" \n\t}\n\t[...] \n}
\n
\n

For a full list of supported currencies, following the ISO 4217 standard, make the following request:

\n
\n
\n
Copy
\n
Copied
\n
\n 
curl -X GET '{baseUrl}/currencies' \\\n-H 'X-Musement-Application: {applicationValue}' \\\n-H 'X-Musement-Version: 3.4.0' \\\n-H 'Authorization: Bearer {accessToken}'
\n
","headings":[{"value":"X-Musement-Currency header","depth":1}]},"contentItem":{"data":{"lastModified":"2025-12-18T16:31:42.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"35e3d2d7-8ded-5890-ab93-380a0332c482__redocly content/api/getting-started/headers/currency/","seo":{"title":"X-Musement-Currency header","description":"Learn how to the change the currency used in the Musement API responses.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api/getting-started/headers/currency.md","pageBaseUrl":"/api/getting-started/headers/currency","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"X-Musement-Currency header","id":"x-musement-currency-header"}]},"data":{"title":"","redirectFrom":["/guide/overview/currency/","/api/partner/general-topics/headers/currency/"],"seo":{"description":"Learn how to the change the currency used in the Musement API responses."}},"catalogInfo":null,"link":"/api/getting-started/headers/currency/","sidebarName":"__alternative-sidebar__-data-24763-api-sidebars.yaml","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}