Hotel and stay-package data for spa and wellness websites.
SpaPortal API v2 provides hotel profiles, room types, amenities, stay
packages, and indicative prices for spa and wellness websites. Responses
include localized content and structured attributes for listings and detail
pages.Visit types describe the stay packages with their meals,
treatment, stay rules, hotel offers, and price periods.
Quickstart
Make your first authenticated API request.
API reference
Browse conventions, response objects and endpoints.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SpaPortal Docs","colors":{"primary":"#3585BA","light":"#99C246","dark":"#141414"},"logo":{"light":"https://mintcdn.com/spabooking/Bibq090v9MI8jPV2/logo/light.svg?fit=max\u0026auto=format\u0026n=Bibq090v9MI8jPV2\u0026q=85\u0026s=c50b2546b29ce5fb747f06c3c0a287e8","dark":"https://mintcdn.com/spabooking/Bibq090v9MI8jPV2/logo/dark.svg?fit=max\u0026auto=format\u0026n=Bibq090v9MI8jPV2\u0026q=85\u0026s=50c74aef7110c454d7a8a682cc9d67ff"},"favicon":"https://mintcdn.com/spabooking/Bibq090v9MI8jPV2/favicon.svg?fit=max\u0026auto=format\u0026n=Bibq090v9MI8jPV2\u0026q=85\u0026s=c33997c3644726a7de4d900b2fdd36be","api":{"playground":{"display":"interactive"}},"navbar":{"links":[{"href":"mailto:info@spabooking.de","label":"Support"}],"primary":{"type":"button","label":"SpaPortal","href":"https://spaportal.cz/"}},"footer":{"socials":{}},"seo":{"metatags":{"canonical":"https://docs.spaportal.cz"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"spabooking","hasAudioNarration":false,"actualSubdomain":"spabooking","customDomains":["docs.spaportal.cz"],"gitSource":{"type":"github","owner":"spabooking","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeb96afb0fd5b4c7f1f6afa","collectionId":"7f3ffb80-880e-4abf-91a7-701a788f156d","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeb96afb0fd5b4c7f1f6afa"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aeb96afb0fd5b4c7f1f6afa","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"API reference","count":36},{"language":"default","tag":"SpaPortal API","count":17},{"language":"default","tag":"Objects","count":12},{"language":"default","tag":"Endpoints","count":7},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"Introduction","count":2},{"language":"default","tag":"Getting started","count":2},{"language":"default","tag":"Hotels","count":2},{"language":"default","tag":"Room types","count":2},{"language":"default","tag":"Visit types","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"spaportal","slug":"/spaportal","pageMetadata":{"title":"SpaPortal API","description":"Hotel and stay-package data for spa and wellness websites.","icon":"bath","href":"/spaportal"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Hotel and stay-package data for spa and wellness websites.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components},{Card,Columns}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Columns)_missingMdxReference(`Columns`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`SpaPortal API v2 provides hotel profiles, room types, amenities, stay\npackages, and indicative prices for spa and wellness websites. Responses\ninclude localized content and structured attributes for listings and detail\npages.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/api/visit-types`,children:`Visit types`}),` describe the stay packages with their meals,\ntreatment, stay rules, hotel offers, and price periods.`]}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Quickstart`,icon:`rocket`,href:`/quickstart`,children:_jsx(_components.p,{children:`Make your first authenticated API request.`})}),_jsx(Card,{title:`API reference`,icon:`square-terminal`,href:`/api`,children:_jsx(_components.p,{children:`Browse conventions, response objects and endpoints.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"SpaPortal API","description":"Hotel and stay-package data for spa and wellness websites.","icon":"bath","href":"/spaportal"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"spabooking","siteName":"SpaPortal Docs","title":"SpaPortal API - SpaPortal Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T20:34:18.916Z","originalFileLocation":"spaportal.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Hotel and stay-package data for spa and wellness websites.\">\u003cmeta data-mint-head name=\"application-name\" content=\"SpaPortal Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/spabooking/3ILofRrE8iwd8KIp/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/spabooking/3ILofRrE8iwd8KIp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/spabooking/3ILofRrE8iwd8KIp/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/spabooking/3ILofRrE8iwd8KIp/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/spabooking/3ILofRrE8iwd8KIp/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/spabooking/3ILofRrE8iwd8KIp/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/spabooking/3ILofRrE8iwd8KIp/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/spabooking/3ILofRrE8iwd8KIp/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/spabooking/3ILofRrE8iwd8KIp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"SpaPortal API - SpaPortal Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Hotel and stay-package data for spa and wellness websites.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SpaPortal Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.spaportal.cz/spaportal\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://spabooking.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=SpaPortal+API\u0026amp;description=Hotel+and+stay-package+data+for+spa+and+wellness+websites.\u0026amp;theme=c449e4c5bfadb6d592bceac4\u0026amp;signature=7813aedc7a53ad34e1e94dc6c396cb8a6ab08e7024622a26b1e2b7245b1f725d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"SpaPortal API - SpaPortal Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Hotel and stay-package data for spa and wellness websites.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://spabooking.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=SpaPortal+API\u0026amp;description=Hotel+and+stay-package+data+for+spa+and+wellness+websites.\u0026amp;theme=c449e4c5bfadb6d592bceac4\u0026amp;signature=7813aedc7a53ad34e1e94dc6c396cb8a6ab08e7024622a26b1e2b7245b1f725d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/spabooking/3ILofRrE8iwd8KIp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SpaPortal Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3585BA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.spaportal.cz/spaportal\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/spaportal.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.spaportal.cz/#organization\",\"name\":\"SpaPortal Docs\",\"url\":\"https://docs.spaportal.cz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/spabooking/Bibq090v9MI8jPV2/logo/light.svg?fit=max\u0026auto=format\u0026n=Bibq090v9MI8jPV2\u0026q=85\u0026s=c50b2546b29ce5fb747f06c3c0a287e8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.spaportal.cz#website\",\"name\":\"SpaPortal Docs\",\"url\":\"https://docs.spaportal.cz\",\"publisher\":{\"@id\":\"https://docs.spaportal.cz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.spaportal.cz/spaportal#webpage\",\"url\":\"https://docs.spaportal.cz/spaportal\",\"name\":\"SpaPortal API\",\"description\":\"Hotel and stay-package data for spa and wellness websites.\",\"dateModified\":\"2026-11-04T20:34:18.916Z\",\"isPartOf\":{\"@id\":\"https://docs.spaportal.cz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.spaportal.cz/spaportal#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.spaportal.cz/spaportal#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SpaPortal Docs\",\"item\":\"https://docs.spaportal.cz\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"SpaPortal API\",\"item\":\"https://docs.spaportal.cz/spaportal\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.spaportal.cz/spaportal#article\",\"headline\":\"SpaPortal API\",\"name\":\"SpaPortal API\",\"description\":\"Hotel and stay-package data for spa and wellness websites.\",\"url\":\"https://docs.spaportal.cz/spaportal\",\"mainEntityOfPage\":{\"@id\":\"https://docs.spaportal.cz/spaportal#webpage\"},\"dateModified\":\"2026-11-04T20:34:18.916Z\",\"publisher\":{\"@id\":\"https://docs.spaportal.cz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.spaportal.cz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SpaPortal Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"SpaPortal Docs","nav":{"global":null,"tabs":[{"tab":"Introduction","groups":[{"group":"Getting started","pages":[{"title":"SpaPortal API","icon":"bath","href":"/spaportal"},{"title":"Quickstart","icon":"rocket","description":null,"href":"/quickstart"}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides"}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api"}]},{"tab":"API v1","hidden":true,"pages":[{"title":"API v1","href":"/api/v1"}]}]},"basePath":"","title":"SpaPortal API - SpaPortal Docs","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":[],"chunks":[]}