{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/api/getting-started/headers/application/","matchPath":"","result":{"data":{"markdownRemark":{"html":"<h1 style=\"position:relative;\"><a href=\"#x-musement-application-header\" aria-label=\"x musement application header permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"x-musement-application-header\"></div>X-Musement-Application header</h1>\n<p>To better analyze Musement API usage and identify areas of improvement, we have introduced the <code class=\"language-text\">X-Musement-Application</code> header.</p>\n<p>Partners with a signed contract will receive a unique <em>application value</em>. This value is required for all API requests. If you currently do not have an <em>Application value</em>, you can request it at <a href=\"mailto:api-distribution@tui.com\">api-distribution@tui.com</a>.</p>\n<p>Consider the example request below for activities:</p>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"79426969929517450000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`curl -X GET '{baseUrl}/activities' \\\\\n-H 'X-Musement-Version: 3.4.0' \\\\\n-H 'Authorization: Bearer {accessToken}'`, `79426969929517450000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-79426969929517450000\">Copied</div>\n        </div>\n        <div class=\"gatsby-highlight\" data-language=\"bash\"><pre class=\"language-bash\"><code class=\"language-bash\"><span class=\"token function\">curl</span> <span class=\"token parameter variable\">-X</span> GET <span class=\"token string\">'{baseUrl}/activities'</span> <span class=\"token punctuation\">\\</span>\n<span class=\"token parameter variable\">-H</span> <span class=\"token string\">'X-Musement-Version: 3.4.0'</span> <span class=\"token punctuation\">\\</span>\n<span class=\"token parameter variable\">-H</span> <span class=\"token string\">'Authorization: Bearer {accessToken}'</span></code></pre></div>\n      </div>\n<p>Using the new <code class=\"language-text\">X-Musement-Application</code> header, the request becomes:</p>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"61277674986599840000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`curl -X GET '{baseUrl}/activities' \\\\\n-H 'X-Musement-Application: {applicationValue}' \\\\\n-H 'X-Musement-Version: 3.4.0' \\\\\n-H 'Authorization: Bearer {accessToken}'`, `61277674986599840000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-61277674986599840000\">Copied</div>\n        </div>\n        <div class=\"gatsby-highlight\" data-language=\"bash\"><pre class=\"language-bash\"><code class=\"language-bash\"><span class=\"token function\">curl</span> <span class=\"token parameter variable\">-X</span> GET <span class=\"token string\">'{baseUrl}/activities'</span> <span class=\"token punctuation\">\\</span>\n<span class=\"token parameter variable\">-H</span> <span class=\"token string\">'X-Musement-Application: {applicationValue}'</span> <span class=\"token punctuation\">\\</span>\n<span class=\"token parameter variable\">-H</span> <span class=\"token string\">'X-Musement-Version: 3.4.0'</span> <span class=\"token punctuation\">\\</span>\n<span class=\"token parameter variable\">-H</span> <span class=\"token string\">'Authorization: Bearer {accessToken}'</span></code></pre></div>\n      </div>\n<p>The header is also expected for authentication requests:</p>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"6927350451666392000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`curl -X POST '{baseUrl}/login' \\\\\n-H 'X-Musement-Application: {applicationValue}' \\\\\n-H 'X-Musement-Version: 3.4.0' \\\\\n-H 'Content-Type: application/json' \\\\\n--data-raw '{\n\t&quot;client_id&quot;: &quot;{clientId}&quot;,\n\t&quot;client_secret&quot;: &quot;{clientSecret}&quot;,\n\t&quot;grant_type&quot;: &quot;{clientCredentials}&quot;\n}'`, `6927350451666392000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-6927350451666392000\">Copied</div>\n        </div>\n        <div class=\"gatsby-highlight\" data-language=\"bash\"><pre class=\"language-bash\"><code class=\"language-bash\"><span class=\"token function\">curl</span> <span class=\"token parameter variable\">-X</span> POST <span class=\"token string\">'{baseUrl}/login'</span> <span class=\"token punctuation\">\\</span>\n<span class=\"token parameter variable\">-H</span> <span class=\"token string\">'X-Musement-Application: {applicationValue}'</span> <span class=\"token punctuation\">\\</span>\n<span class=\"token parameter variable\">-H</span> <span class=\"token string\">'X-Musement-Version: 3.4.0'</span> <span class=\"token punctuation\">\\</span>\n<span class=\"token parameter variable\">-H</span> <span class=\"token string\">'Content-Type: application/json'</span> <span class=\"token punctuation\">\\</span>\n--data-raw <span class=\"token string\">'{\n\t\"client_id\": \"{clientId}\",\n\t\"client_secret\": \"{clientSecret}\",\n\t\"grant_type\": \"{clientCredentials}\"\n}'</span></code></pre></div>\n      </div>\n<p>This header is <em>required</em> for all endpoints. Calling an endpoint without the header will result in a 400 status code response:</p>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"54224181534139730000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`{\n\t&quot;code&quot;: &quot;2271&quot;,\n\t&quot;message&quot;: &quot;The header 'x-musement-application' is mandatory but was not found on the request. Please specify it and try again.&quot;\n}`, `54224181534139730000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-54224181534139730000\">Copied</div>\n        </div>\n        <div class=\"gatsby-highlight\" data-language=\"json\"><pre class=\"language-json\"><code class=\"language-json\"><span class=\"token punctuation\">{</span>\n\t<span class=\"token property\">\"code\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"2271\"</span><span class=\"token punctuation\">,</span>\n\t<span class=\"token property\">\"message\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"The header 'x-musement-application' is mandatory but was not found on the request. Please specify it and try again.\"</span>\n<span class=\"token punctuation\">}</span></code></pre></div>\n      </div>","headings":[{"value":"X-Musement-Application 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":"a3b2cd5a-2d0d-5127-802b-0975934fb152__redocly content/api/getting-started/headers/application/","seo":{"title":"X-Musement-Application header","description":"Partners receive a unique application value to identify their calls via the Musement API.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api/getting-started/headers/application.md","pageBaseUrl":"/api/getting-started/headers/application","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"X-Musement-Application header","id":"x-musement-application-header"}]},"data":{"title":"","redirectFrom":["/guide/overview/x-musement-application-header/","/api/partner/general-topics/headers/x-musement-application/","/api/partner/general-topics/headers/application/"],"seo":{"description":"Partners receive a unique application value to identify their calls via the Musement API."}},"catalogInfo":null,"link":"/api/getting-started/headers/application/","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"]}