What Valpas is, what the API does, and how to get started
Valpas is a certification and compliance platform for hotels. It tracks whether hotels carry official Valpas certification, giving guests and partners a reliable way to verify a hotel’s compliance status.The Valpas Public API exposes hotel data for external developers. Each hotel record includes name, description, address with structured postal code, city, and ISO country code, geographic coordinates, star rating, website and reception email, photos, room count, certification status with a badge link, and Netstorming and GIATA integration identifiers. Use the API to build integrations that surface Valpas-verified hotel information in your own applications.The API is designed for external developers building integrations on top of Valpas data. Authentication uses a simple API key passed as a request header, and all endpoints return JSON.
Quickstart
Make your first API call in under 5 minutes.
Authentication
Learn how to authenticate with your API key.
Changelog
See what’s new in the API.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Valpas API","colors":{"primary":"#16A34A"},"logo":{"light":"https://mintcdn.com/valpasenterprisesoy/W5y6HOcQbNAAH5Wm/logo/light.svg?fit=max\u0026auto=format\u0026n=W5y6HOcQbNAAH5Wm\u0026q=85\u0026s=a62cea3faec2275fad1c6f8c4f1f716e","dark":"https://mintcdn.com/valpasenterprisesoy/W5y6HOcQbNAAH5Wm/logo/dark.svg?fit=max\u0026auto=format\u0026n=W5y6HOcQbNAAH5Wm\u0026q=85\u0026s=d91d244079d7e4fc35526c9dc1cea287"},"favicon":"https://mintcdn.com/valpasenterprisesoy/W5y6HOcQbNAAH5Wm/favicon.svg?fit=max\u0026auto=format\u0026n=W5y6HOcQbNAAH5Wm\u0026q=85\u0026s=71e931c9eff6617f8fc5680cd431d384","api":{"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://connect.valpashotels.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"valpasenterprisesoy","hasAudioNarration":false,"actualSubdomain":"valpasenterprisesoy","customDomains":["docs.valpashotels.com"],"gitSource":{"type":"github","owner":"helleheimo","repo":"valpas-public-api","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aa140d79d29726eb60b7d38","collectionId":"701939ab-2b49-4b60-a9f6-4d91e8c4d7bc","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aa140d79d29726eb60b7d38"},"entitlements":{},"buildId":"6aa140d79d29726eb60b7d38","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":12},{"language":"default","tag":"Guides","count":4}]},"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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"introduction","slug":"/introduction","pageMetadata":{"title":"Introduction","description":"What Valpas is, what the API does, and how to get started","href":"/introduction"},"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: \"What Valpas is, what the API does, and how to get started\"\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={p:`p`,..._provideComponents(),...props.components},{Card,CardGroup}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Valpas is a certification and compliance platform for hotels. It tracks whether hotels carry official Valpas certification, giving guests and partners a reliable way to verify a hotel’s compliance status.`}),`\n`,_jsx(_components.p,{children:`The Valpas Public API exposes hotel data for external developers. Each hotel record includes name, description, address with structured postal code, city, and ISO country code, geographic coordinates, star rating, website and reception email, photos, room count, certification status with a badge link, and Netstorming and GIATA integration identifiers. Use the API to build integrations that surface Valpas-verified hotel information in your own applications.`}),`\n`,_jsx(_components.p,{children:`The API is designed for external developers building integrations on top of Valpas data. Authentication uses a simple API key passed as a request header, and all endpoints return JSON.`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Quickstart`,icon:`bolt`,href:`/quickstart`,children:_jsx(_components.p,{children:`Make your first API call in under 5 minutes.`})}),_jsx(Card,{title:`Authentication`,icon:`key`,href:`/authentication`,children:_jsx(_components.p,{children:`Learn how to authenticate with your API key.`})}),_jsx(Card,{title:`Changelog`,icon:`clock-rotate-left`,href:`/changelog`,children:_jsx(_components.p,{children:`See what’s new in the API.`})})]})]})}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":"Introduction","description":"What Valpas is, what the API does, and how to get started","href":"/introduction"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"valpasenterprisesoy","siteName":"Valpas API","title":"Introduction - Valpas API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-12T12:38:37.869Z","originalFileLocation":"introduction.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=\"What Valpas is, what the API does, and how to get started\">\u003cmeta data-mint-head name=\"application-name\" content=\"Valpas API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/valpasenterprisesoy/Tu1dL6Tix20_ukJy/_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/valpasenterprisesoy/Tu1dL6Tix20_ukJy/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/valpasenterprisesoy/Tu1dL6Tix20_ukJy/_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/valpasenterprisesoy/Tu1dL6Tix20_ukJy/_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/valpasenterprisesoy/Tu1dL6Tix20_ukJy/_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/valpasenterprisesoy/Tu1dL6Tix20_ukJy/_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/valpasenterprisesoy/Tu1dL6Tix20_ukJy/_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/valpasenterprisesoy/Tu1dL6Tix20_ukJy/_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/valpasenterprisesoy/Tu1dL6Tix20_ukJy/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Introduction - Valpas API\">\u003cmeta data-mint-head property=\"og:description\" content=\"What Valpas is, what the API does, and how to get started\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Valpas API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.valpashotels.com/introduction\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://valpasenterprisesoy.mintlify.app/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Introduction\u0026amp;description=What+Valpas+is%2C+what+the+API+does%2C+and+how+to+get+started\u0026amp;theme=51105a00b128ecdbfa88e0f6\u0026amp;signature=8b9db163c3013da198e33dcfd45ce0f36eefebb8b0627a0b949a6ce3c37b853b\">\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=\"Introduction - Valpas API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What Valpas is, what the API does, and how to get started\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://valpasenterprisesoy.mintlify.app/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Introduction\u0026amp;description=What+Valpas+is%2C+what+the+API+does%2C+and+how+to+get+started\u0026amp;theme=51105a00b128ecdbfa88e0f6\u0026amp;signature=8b9db163c3013da198e33dcfd45ce0f36eefebb8b0627a0b949a6ce3c37b853b\">\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/valpasenterprisesoy/Tu1dL6Tix20_ukJy/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Valpas API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.valpashotels.com/introduction\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/introduction.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.valpashotels.com/#organization\",\"name\":\"Valpas API\",\"url\":\"https://docs.valpashotels.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/valpasenterprisesoy/W5y6HOcQbNAAH5Wm/logo/light.svg?fit=max\u0026auto=format\u0026n=W5y6HOcQbNAAH5Wm\u0026q=85\u0026s=a62cea3faec2275fad1c6f8c4f1f716e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.valpashotels.com#website\",\"name\":\"Valpas API\",\"url\":\"https://docs.valpashotels.com\",\"publisher\":{\"@id\":\"https://docs.valpashotels.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.valpashotels.com/introduction#webpage\",\"url\":\"https://docs.valpashotels.com/introduction\",\"name\":\"Introduction\",\"description\":\"What Valpas is, what the API does, and how to get started\",\"dateModified\":\"2026-08-12T12:38:37.869Z\",\"isPartOf\":{\"@id\":\"https://docs.valpashotels.com#website\"}},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.valpashotels.com/introduction#article\",\"headline\":\"Introduction\",\"name\":\"Introduction\",\"description\":\"What Valpas is, what the API does, and how to get started\",\"url\":\"https://docs.valpashotels.com/introduction\",\"mainEntityOfPage\":{\"@id\":\"https://docs.valpashotels.com/introduction#webpage\"},\"dateModified\":\"2026-08-12T12:38:37.869Z\",\"publisher\":{\"@id\":\"https://docs.valpashotels.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.valpashotels.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Valpas API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Valpas API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Quickstart","description":"Make your first API call in under 5 minutes","href":"/quickstart"},{"title":"Authentication","href":"/authentication"},{"title":"Changelog","href":"/changelog"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/list-hotels"}]}]},"basePath":"","title":"Introduction - Valpas API","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":[],"chunks":[]}