{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/api/catalog/activities/cities/","matchPath":"","result":{"data":{"markdownRemark":{"html":"<h1 style=\"position:relative;\"><a href=\"#cities\" aria-label=\"cities 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=\"cities\"></div>Cities</h1>\n<p>Cities in the Musement API can refer to different types of <em>destinations</em>. This includes islands, natural landmarks, beaches, actual cities and more.</p>\n<p>An activity's city appears in both the <code class=\"language-text\">/activities</code> and <code class=\"language-text\">/activities/{activityUuid}</code> endpoints. In the example response below, the activity takes place in Paris:</p>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"10764157266947815000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`{\n\t[...]\n\t&quot;city&quot;: {\n\t\t&quot;id&quot;: 40,\n\t\t&quot;name&quot;: &quot;Paris&quot;,\n\t\t&quot;country&quot;: {\n\t\t\t&quot;id&quot;: 60,\n\t\t\t&quot;name&quot;: &quot;France&quot;,\n\t\t\t&quot;iso_code&quot;: &quot;FR&quot;\n\t\t},\n\t\t[...]\n\t\t&quot;time_zone&quot;: &quot;Europe/Paris&quot;\n\t},\n\t[...]\n}`, `10764157266947815000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-10764157266947815000\">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 punctuation\">[</span>...<span class=\"token punctuation\">]</span>\n\t<span class=\"token property\">\"city\"</span><span class=\"token operator\">:</span> <span class=\"token punctuation\">{</span>\n\t\t<span class=\"token property\">\"id\"</span><span class=\"token operator\">:</span> <span class=\"token number\">40</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"name\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"Paris\"</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"country\"</span><span class=\"token operator\">:</span> <span class=\"token punctuation\">{</span>\n\t\t\t<span class=\"token property\">\"id\"</span><span class=\"token operator\">:</span> <span class=\"token number\">60</span><span class=\"token punctuation\">,</span>\n\t\t\t<span class=\"token property\">\"name\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"France\"</span><span class=\"token punctuation\">,</span>\n\t\t\t<span class=\"token property\">\"iso_code\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"FR\"</span>\n\t\t<span class=\"token punctuation\">}</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token punctuation\">[</span>...<span class=\"token punctuation\">]</span>\n\t\t<span class=\"token property\">\"time_zone\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"Europe/Paris\"</span>\n\t<span class=\"token punctuation\">}</span><span class=\"token punctuation\">,</span>\n\t<span class=\"token punctuation\">[</span>...<span class=\"token punctuation\">]</span>\n<span class=\"token punctuation\">}</span></code></pre></div>\n      </div>\n<p>For more information about cities in the catalog, check out the <a href=\"/api/catalog/cities/\">dedicated section</a>.</p>\n<h2 style=\"position:relative;\"><a href=\"#activities-with-multiple-cities\" aria-label=\"activities with multiple cities 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=\"activities-with-multiple-cities\"></div>Activities with multiple cities</h2>\n<p>Every activity is connected to at least one <em>default</em> city. An activity may be connected to multiple cities. This is a common situation when an attraction is located near multiple destinations or transportation is involved.</p>\n<p>Activities connected to multiple cities will appear in results when <a href=\"/api/catalog/activities/searching/#cities\">filtering by any of the cities</a>. However, only the <em>default</em> city will appear in the activity's <code class=\"language-text\">city</code> property. To see all the cities for a single activity, make the following request:</p>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"41590407228912790000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`curl -X GET '{baseUrl}/activities/{activityUuid}/destinations' \\\\\n-H 'X-Musement-Application: {applicationValue}' \\\\\n-H 'X-Musement-Version: 3.4.0' \\\\\n-H 'Authorization: Bearer {accessToken}'`, `41590407228912790000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-41590407228912790000\">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/{activityUuid}/destinations'</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 response will contain an array of cities. In the example response below, the activity is connected to both Paris (the default) and Versailles:</p>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"52667378966539900000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`[\n\t{\n\t\t&quot;id&quot;: 40,\n\t\t&quot;name&quot;: &quot;Paris&quot;,\n\t\t[...]\n\t\t&quot;country&quot;: {\n\t\t\t&quot;id&quot;: 60,\n\t\t\t&quot;name&quot;: &quot;France&quot;,\n\t\t\t&quot;iso_code&quot;: &quot;FR&quot;\n\t\t},\n\t\t&quot;time_zone&quot;: &quot;Europe/Paris&quot;,\n\t\t&quot;default&quot;: true\n\t},\n\t{\n\t\t&quot;id&quot;: 41,\n\t\t&quot;name&quot;: &quot;Versailles&quot;,\n\t\t[...]\n\t\t&quot;country&quot;: {\n\t\t\t&quot;id&quot;: 60,\n\t\t\t&quot;name&quot;: &quot;France&quot;,\n\t\t\t&quot;iso_code&quot;: &quot;FR&quot;\n\t\t},\n\t\t&quot;time_zone&quot;: &quot;Europe/Paris&quot;,\n\t\t&quot;default&quot;: false\n\t}\n]`, `52667378966539900000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-52667378966539900000\">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 punctuation\">{</span>\n\t\t<span class=\"token property\">\"id\"</span><span class=\"token operator\">:</span> <span class=\"token number\">40</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"name\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"Paris\"</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token punctuation\">[</span>...<span class=\"token punctuation\">]</span>\n\t\t<span class=\"token property\">\"country\"</span><span class=\"token operator\">:</span> <span class=\"token punctuation\">{</span>\n\t\t\t<span class=\"token property\">\"id\"</span><span class=\"token operator\">:</span> <span class=\"token number\">60</span><span class=\"token punctuation\">,</span>\n\t\t\t<span class=\"token property\">\"name\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"France\"</span><span class=\"token punctuation\">,</span>\n\t\t\t<span class=\"token property\">\"iso_code\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"FR\"</span>\n\t\t<span class=\"token punctuation\">}</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"time_zone\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"Europe/Paris\"</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"default\"</span><span class=\"token operator\">:</span> <span class=\"token boolean\">true</span>\n\t<span class=\"token punctuation\">}</span><span class=\"token punctuation\">,</span>\n\t<span class=\"token punctuation\">{</span>\n\t\t<span class=\"token property\">\"id\"</span><span class=\"token operator\">:</span> <span class=\"token number\">41</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"name\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"Versailles\"</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token punctuation\">[</span>...<span class=\"token punctuation\">]</span>\n\t\t<span class=\"token property\">\"country\"</span><span class=\"token operator\">:</span> <span class=\"token punctuation\">{</span>\n\t\t\t<span class=\"token property\">\"id\"</span><span class=\"token operator\">:</span> <span class=\"token number\">60</span><span class=\"token punctuation\">,</span>\n\t\t\t<span class=\"token property\">\"name\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"France\"</span><span class=\"token punctuation\">,</span>\n\t\t\t<span class=\"token property\">\"iso_code\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"FR\"</span>\n\t\t<span class=\"token punctuation\">}</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"time_zone\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"Europe/Paris\"</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"default\"</span><span class=\"token operator\">:</span> <span class=\"token boolean\">false</span>\n\t<span class=\"token punctuation\">}</span>\n<span class=\"token punctuation\">]</span></code></pre></div>\n      </div>","headings":[{"value":"Cities","depth":1},{"value":"Activities with multiple cities","depth":2}]},"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":"d61fc04c-7e21-5e4c-bc20-05db98c5df72__redocly content/api/catalog/activities/cities/","seo":{"title":"Cities","description":"Activities belong to cities, which are destinations like islands, regions and more in the Musement API.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api/catalog/activities/cities.md","pageBaseUrl":"/api/catalog/activities/cities","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Cities","id":"cities"},{"depth":2,"value":"Activities with multiple cities","id":"activities-with-multiple-cities"}]},"data":{"title":"","redirectFrom":["/guide/activities/cities/","/api/partner/catalog/activities/cities/"],"seo":{"description":"Activities belong to cities, which are destinations like islands, regions and more in the Musement API."}},"catalogInfo":null,"link":"/api/catalog/activities/cities/","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"]}