[ { "id": "00391351-e308-4aae-8b66-d868ebb37ff3", "name": "Paris Marriott Rive Gauche Hotel & Conference Center", "description": "Surrounded by diverse attractions, Paris Marriott Rive Gauche Hotel is a stylish haven in an iconic travel destination.", "address": "17 Boulevard Saint Jacques, 75014 Paris France", "postal_code": "75014", "city": "Paris", "country_code": "FR", "latitude": 48.831917, "longitude": 2.340172, "language": null, "star_rating": null, "room_count": null, "website_url": "https://www.marriott.com/en-us/hotels/parst-paris-marriott-rive-gauche-hotel-and-conference-center/overview/", "email": null, "images": [ { "url": "https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/1.jpg", "caption": "Great Room Lobby" }, { "url": "https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/2.jpg", "caption": "Palyma Bar" }, { "url": "https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/3.jpg", "caption": "Brasserie Restaurant" } ], "certified": true, "certified_from": null, "certified_until": null, "certification_url": "https://valpashotels.com", "netstorming_id": "45373", "giata_id": 99999999 }]
{
"error": "Request body must include a `giata_ids` array"
}
{
"error": "Unauthorized"
}
{
"error": "Forbidden"
}
{
"error": "Internal server error"
}
API Reference
Batch fetch hotels by GIATA IDs
Returns multiple hotels matching the provided GIATA MultiCodes identifiers. Maximum 1000 IDs per request. IDs with no matching hotel are omitted from the response. Requires the giata scope.
{"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":"api-reference/batch-fetch-hotels-by-giata-ids","slug":"/api-reference/batch-fetch-hotels-by-giata-ids","pageMetadata":{"title":"Batch fetch hotels by GIATA IDs","description":"Returns multiple hotels matching the provided GIATA MultiCodes identifiers. Maximum 1000 IDs per request. IDs with no matching hotel are omitted from the response. Requires the `giata` scope.","deprecated":null,"version":null,"openapi":"/openapi.json post /hotels/giata/batch","href":"/api-reference/batch-fetch-hotels-by-giata-ids","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns multiple hotels matching the provided GIATA MultiCodes identifiers. Maximum 1000 IDs per request. IDs with no matching hotel are omitted from the response. Requires the \", _jsx(_components.code, {\n children: \"giata\"\n }), \" scope.\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Batch fetch hotels by GIATA IDs","description":"Returns multiple hotels matching the provided GIATA MultiCodes identifiers. Maximum 1000 IDs per request. IDs with no matching hotel are omitted from the response. Requires the `giata` scope.","deprecated":null,"version":null,"openapi":"/openapi.json post /hotels/giata/batch","href":"/api-reference/batch-fetch-hotels-by-giata-ids","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"batchGetHotelsByGiataIds","summary":"Batch fetch hotels by GIATA IDs","description":"Returns multiple hotels matching the provided GIATA MultiCodes identifiers. Maximum 1000 IDs per request. IDs with no matching hotel are omitted from the response. Requires the `giata` scope.","requestBody":"9fdd1378-3e26-40d8-afba-f76140e19b86","responses":{"200":"98372adb-536c-4b37-9a14-3025b1d17988","400":"d7447043-d384-42b4-b621-2f04dbeebfb9","401":"2804904f-8c7b-4c7e-a8e7-4b6504fee36d","403":"ee778aa5-65b3-4f46-b20b-e39d3edd1cd0","500":"cbc8f769-d322-4d83-ac91-ba063c8b375c"},"method":"post","type":"path","servers":["c82ddd59-b222-4717-8af4-ec28cc7209d7"],"security":["d857e99b-589a-47b7-b99d-89d7ce7cab32"],"path":"/hotels/giata/batch","baseUrlOptions":["https://connect.valpashotels.com"],"title":"Batch fetch hotels by GIATA IDs","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["giata_ids"],"properties":{"giata_ids":{"type":"array","items":{"type":"integer","uniqueKey":"giata_ids.items.[INDEX]","typeLabel":"integer"},"description":"Array of GIATA IDs to look up (max 1000). Integer-valued strings are also accepted.","example":[99999999,99999998],"isRequired":true,"uniqueKey":"giata_ids","typeLabel":"integer[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"giata_ids":[99999999,99999998]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"98372adb-536c-4b37-9a14-3025b1d17988":{"description":"List of matching hotels","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["id","name","description","postal_code","city","country_code","language","star_rating","website_url","email","images","certified","certified_from","certified_until","certification_url","netstorming_id","giata_id"],"properties":{"id":{"type":"string","description":"Unique hotel identifier","example":"00391351-e308-4aae-8b66-d868ebb37ff3","isRequired":true,"uniqueKey":"items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","description":"Hotel name","example":"Grand Helsinki Hotel","isRequired":true,"uniqueKey":"items.[INDEX].name","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"Marketing description of the hotel (null if not available)","example":"A refined stay in the heart of Helsinki, steps from the central railway station.","isRequired":true,"uniqueKey":"items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Marketing description of the hotel (null if not available)","example":"A refined stay in the heart of Helsinki, steps from the central railway station.","isRequired":true,"uniqueKey":"items.[INDEX].description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].description","typeLabel":"string | null"},"postal_code":{"oneOf":[{"type":"string","description":"Postal code (null if not available)","example":"00100","isRequired":true,"uniqueKey":"items.[INDEX].postal_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Postal code (null if not available)","example":"00100","isRequired":true,"uniqueKey":"items.[INDEX].postal_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].postal_code","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","description":"City name (null if not available)","example":"Helsinki","isRequired":true,"uniqueKey":"items.[INDEX].city.oneOf.0","typeLabel":"string"},{"type":"null","description":"City name (null if not available)","example":"Helsinki","isRequired":true,"uniqueKey":"items.[INDEX].city.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].city","typeLabel":"string | null"},"country_code":{"oneOf":[{"type":"string","description":"Country code (ISO 3166-1 alpha-2, null if not available)","example":"FI","isRequired":true,"uniqueKey":"items.[INDEX].country_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Country code (ISO 3166-1 alpha-2, null if not available)","example":"FI","isRequired":true,"uniqueKey":"items.[INDEX].country_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].country_code","typeLabel":"string | null"},"language":{"oneOf":[{"type":"string","description":"Primary language at the hotel (ISO 639-1 code)","example":"fi","isRequired":true,"uniqueKey":"items.[INDEX].language.oneOf.0","typeLabel":"string"},{"type":"null","description":"Primary language at the hotel (ISO 639-1 code)","example":"fi","isRequired":true,"uniqueKey":"items.[INDEX].language.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].language","typeLabel":"string | null"},"star_rating":{"oneOf":[{"type":"number","description":"Official hotel star rating, e.g. 4 or 4.5 (null if not available)","example":4.5,"isRequired":true,"uniqueKey":"items.[INDEX].star_rating.oneOf.0","typeLabel":"number"},{"type":"null","description":"Official hotel star rating, e.g. 4 or 4.5 (null if not available)","example":4.5,"isRequired":true,"uniqueKey":"items.[INDEX].star_rating.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].star_rating","typeLabel":"number | null"},"website_url":{"oneOf":[{"type":"string","format":"uri","description":"Hotel website URL (null if not available)","example":"https://www.grandhelsinkihotel.com","isRequired":true,"uniqueKey":"items.[INDEX].website_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"Hotel website URL (null if not available)","example":"https://www.grandhelsinkihotel.com","isRequired":true,"uniqueKey":"items.[INDEX].website_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].website_url","typeLabel":"string\u003curi> | null"},"email":{"oneOf":[{"type":"string","format":"email","description":"Hotel reception email address (null if not available)","example":"reception@grandhelsinkihotel.com","isRequired":true,"uniqueKey":"items.[INDEX].email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","format":"email","description":"Hotel reception email address (null if not available)","example":"reception@grandhelsinkihotel.com","isRequired":true,"uniqueKey":"items.[INDEX].email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].email","typeLabel":"string\u003cemail> | null"},"images":{"type":"array","description":"Hotel photos (up to 3), served from the Valpas CDN. Empty array if no photos are available.","items":{"type":"object","required":["url","caption"],"properties":{"url":{"type":"string","format":"uri","description":"Publicly accessible image URL","isRequired":true,"uniqueKey":"items.[INDEX].images.items.[INDEX].url","typeLabel":"string\u003curi>"},"caption":{"oneOf":[{"type":"string","description":"Short image caption (null if not available)","isRequired":true,"uniqueKey":"items.[INDEX].images.items.[INDEX].caption.oneOf.0","typeLabel":"string"},{"type":"null","description":"Short image caption (null if not available)","isRequired":true,"uniqueKey":"items.[INDEX].images.items.[INDEX].caption.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].images.items.[INDEX].caption","typeLabel":"string | null"}},"uniqueKey":"items.[INDEX].images.items.[INDEX]","typeLabel":"object"},"example":[{"url":"https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/1.jpg","caption":"Great Room Lobby"}],"isRequired":true,"uniqueKey":"items.[INDEX].images","typeLabel":"object[]"},"certified":{"type":"boolean","description":"Whether the hotel holds a current Valpas certification","example":true,"isRequired":true,"uniqueKey":"items.[INDEX].certified","typeLabel":"boolean"},"certified_from":{"oneOf":[{"type":"string","format":"date","description":"Date when the hotel's Valpas certification becomes valid (YYYY-MM-DD)","example":"2026-01-15","isRequired":true,"uniqueKey":"items.[INDEX].certified_from.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Date when the hotel's Valpas certification becomes valid (YYYY-MM-DD)","example":"2026-01-15","isRequired":true,"uniqueKey":"items.[INDEX].certified_from.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].certified_from","typeLabel":"string\u003cdate> | null"},"certified_until":{"oneOf":[{"type":"string","format":"date","description":"Date when the hotel's Valpas certification expires (YYYY-MM-DD)","example":"2026-03-30","isRequired":true,"uniqueKey":"items.[INDEX].certified_until.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Date when the hotel's Valpas certification expires (YYYY-MM-DD)","example":"2026-03-30","isRequired":true,"uniqueKey":"items.[INDEX].certified_until.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].certified_until","typeLabel":"string\u003cdate> | null"},"certification_url":{"oneOf":[{"type":"string","format":"uri","description":"Link target for the Valpas certification badge (null when the hotel is not certified)","example":"https://valpashotels.com","isRequired":true,"uniqueKey":"items.[INDEX].certification_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"Link target for the Valpas certification badge (null when the hotel is not certified)","example":"https://valpashotels.com","isRequired":true,"uniqueKey":"items.[INDEX].certification_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].certification_url","typeLabel":"string\u003curi> | null"},"netstorming_id":{"oneOf":[{"type":"string","description":"Netstorming integration identifier","example":"45373","isRequired":true,"uniqueKey":"items.[INDEX].netstorming_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Netstorming integration identifier","example":"45373","isRequired":true,"uniqueKey":"items.[INDEX].netstorming_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].netstorming_id","typeLabel":"string | null"},"giata_id":{"oneOf":[{"type":"integer","description":"GIATA MultiCodes property identifier (null if the hotel is not mapped to a GIATA code, or if your API key lacks the `giata` scope)","example":99999999,"isRequired":true,"uniqueKey":"items.[INDEX].giata_id.oneOf.0","typeLabel":"integer"},{"type":"null","description":"GIATA MultiCodes property identifier (null if the hotel is not mapped to a GIATA code, or if your API key lacks the `giata` scope)","example":99999999,"isRequired":true,"uniqueKey":"items.[INDEX].giata_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].giata_id","typeLabel":"integer | null"},"address":{"oneOf":[{"type":"string","description":"Street address of the hotel","example":"Mannerheimintie 1, 00100 Helsinki","uniqueKey":"items.[INDEX].address.oneOf.0","typeLabel":"string"},{"type":"null","description":"Street address of the hotel","example":"Mannerheimintie 1, 00100 Helsinki","uniqueKey":"items.[INDEX].address.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].address","typeLabel":"string | null"},"latitude":{"oneOf":[{"type":"number","description":"Geographic latitude in decimal degrees","example":60.1699,"uniqueKey":"items.[INDEX].latitude.oneOf.0","typeLabel":"number"},{"type":"null","description":"Geographic latitude in decimal degrees","example":60.1699,"uniqueKey":"items.[INDEX].latitude.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].latitude","typeLabel":"number | null"},"longitude":{"oneOf":[{"type":"number","description":"Geographic longitude in decimal degrees","example":24.9384,"uniqueKey":"items.[INDEX].longitude.oneOf.0","typeLabel":"number"},{"type":"null","description":"Geographic longitude in decimal degrees","example":24.9384,"uniqueKey":"items.[INDEX].longitude.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].longitude","typeLabel":"number | null"},"room_count":{"oneOf":[{"type":"integer","description":"Total number of rooms (null if not configured)","example":85,"uniqueKey":"items.[INDEX].room_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Total number of rooms (null if not configured)","example":85,"uniqueKey":"items.[INDEX].room_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].room_count","typeLabel":"integer | null"}},"uniqueKey":"items.[INDEX]","typeLabel":"object"},"uniqueKey":"","typeLabel":"object[]"},"example":[{"id":"00391351-e308-4aae-8b66-d868ebb37ff3","name":"Paris Marriott Rive Gauche Hotel \u0026 Conference Center","description":"Surrounded by diverse attractions, Paris Marriott Rive Gauche Hotel is a stylish haven in an iconic travel destination.","address":"17 Boulevard Saint Jacques, 75014 Paris France","postal_code":"75014","city":"Paris","country_code":"FR","latitude":48.831917,"longitude":2.340172,"language":null,"star_rating":null,"room_count":null,"website_url":"https://www.marriott.com/en-us/hotels/parst-paris-marriott-rive-gauche-hotel-and-conference-center/overview/","email":null,"images":[{"url":"https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/1.jpg","caption":"Great Room Lobby"},{"url":"https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/2.jpg","caption":"Palyma Bar"},{"url":"https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/3.jpg","caption":"Brasserie Restaurant"}],"certified":true,"certified_from":null,"certified_until":null,"certification_url":"https://valpashotels.com","netstorming_id":"45373","giata_id":99999999}],"examples":{"Example":{"title":"Example","value":[{"id":"00391351-e308-4aae-8b66-d868ebb37ff3","name":"Paris Marriott Rive Gauche Hotel \u0026 Conference Center","description":"Surrounded by diverse attractions, Paris Marriott Rive Gauche Hotel is a stylish haven in an iconic travel destination.","address":"17 Boulevard Saint Jacques, 75014 Paris France","postal_code":"75014","city":"Paris","country_code":"FR","latitude":48.831917,"longitude":2.340172,"language":null,"star_rating":null,"room_count":null,"website_url":"https://www.marriott.com/en-us/hotels/parst-paris-marriott-rive-gauche-hotel-and-conference-center/overview/","email":null,"images":[{"url":"https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/1.jpg","caption":"Great Room Lobby"},{"url":"https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/2.jpg","caption":"Palyma Bar"},{"url":"https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/3.jpg","caption":"Brasserie Restaurant"}],"certified":true,"certified_from":null,"certified_until":null,"certification_url":"https://valpashotels.com","netstorming_id":"45373","giata_id":99999999}]}},"exampleType":"examples"}},"exampleType":"examples"},"d7447043-d384-42b4-b621-2f04dbeebfb9":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable error message","example":"Unauthorized","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Request body must include a `giata_ids` array"},"examples":{"Example":{"title":"Example","value":{"error":"Request body must include a `giata_ids` array"}}},"exampleType":"examples"}},"exampleType":"examples"},"2804904f-8c7b-4c7e-a8e7-4b6504fee36d":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable error message","example":"Unauthorized","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Unauthorized"},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized"}}},"exampleType":"examples"}},"exampleType":"examples"},"ee778aa5-65b3-4f46-b20b-e39d3edd1cd0":{"description":"API key lacks the `giata` scope","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable error message","example":"Unauthorized","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Forbidden"},"examples":{"Example":{"title":"Example","value":{"error":"Forbidden"}}},"exampleType":"examples"}},"exampleType":"examples"},"cbc8f769-d322-4d83-ac91-ba063c8b375c":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable error message","example":"Unauthorized","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Internal server error"},"examples":{"Example":{"title":"Example","value":{"error":"Internal server error"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"d857e99b-589a-47b7-b99d-89d7ce7cab32":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[]}}},"servers":{"c82ddd59-b222-4717-8af4-ec28cc7209d7":{"url":"https://connect.valpashotels.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[]},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"valpasenterprisesoy","siteName":"Valpas API","title":"Batch fetch hotels by GIATA IDs - Valpas API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-18T06:01:04.731Z","originalFileLocation":"api-reference/batch-fetch-hotels-by-giata-ids.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=\"Returns multiple hotels matching the provided GIATA MultiCodes identifiers. Maximum 1000 IDs per request. IDs with no matching hotel are omitted from the response. Requires the giata scope.\">\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=\"Batch fetch hotels by GIATA IDs - Valpas API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns multiple hotels matching the provided GIATA MultiCodes identifiers. Maximum 1000 IDs per request. IDs with no matching hotel are omitted from the response. Requires the giata scope.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Valpas API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.valpashotels.com/api-reference/batch-fetch-hotels-by-giata-ids\">\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=API+Reference\u0026amp;title=Batch+fetch+hotels+by+GIATA+IDs\u0026amp;description=Returns+multiple+hotels+matching+the+provided+GIATA+MultiCodes+identifiers.+Maximum+1000+IDs+per+request.+IDs+with+no+matching+hotel+are+omitted+from+the+respon\u0026amp;theme=51105a00b128ecdbfa88e0f6\u0026amp;signature=7087b232712437485af9f4328e55f8476713de693ce72e4c5acd1cd40535cf6c\">\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=\"Batch fetch hotels by GIATA IDs - Valpas API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns multiple hotels matching the provided GIATA MultiCodes identifiers. Maximum 1000 IDs per request. IDs with no matching hotel are omitted from the response. Requires the giata scope.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://valpasenterprisesoy.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Batch+fetch+hotels+by+GIATA+IDs\u0026amp;description=Returns+multiple+hotels+matching+the+provided+GIATA+MultiCodes+identifiers.+Maximum+1000+IDs+per+request.+IDs+with+no+matching+hotel+are+omitted+from+the+respon\u0026amp;theme=51105a00b128ecdbfa88e0f6\u0026amp;signature=7087b232712437485af9f4328e55f8476713de693ce72e4c5acd1cd40535cf6c\">\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/api-reference/batch-fetch-hotels-by-giata-ids\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/batch-fetch-hotels-by-giata-ids.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/api-reference/batch-fetch-hotels-by-giata-ids#webpage\",\"url\":\"https://docs.valpashotels.com/api-reference/batch-fetch-hotels-by-giata-ids\",\"name\":\"Batch fetch hotels by GIATA IDs\",\"description\":\"Returns multiple hotels matching the provided GIATA MultiCodes identifiers. Maximum 1000 IDs per request. IDs with no matching hotel are omitted from the response. Requires the giata scope.\",\"dateModified\":\"2026-08-18T06:01:04.731Z\",\"isPartOf\":{\"@id\":\"https://docs.valpashotels.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.valpashotels.com/api-reference/batch-fetch-hotels-by-giata-ids#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.valpashotels.com/api-reference/batch-fetch-hotels-by-giata-ids#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.valpashotels.com/api-reference/list-hotels\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Batch fetch hotels by GIATA IDs\",\"item\":\"https://docs.valpashotels.com/api-reference/batch-fetch-hotels-by-giata-ids\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.valpashotels.com/api-reference/batch-fetch-hotels-by-giata-ids#apireference\",\"headline\":\"Batch fetch hotels by GIATA IDs\",\"name\":\"Batch fetch hotels by GIATA IDs\",\"description\":\"Returns multiple hotels matching the provided GIATA MultiCodes identifiers. Maximum 1000 IDs per request. IDs with no matching hotel are omitted from the response. Requires the giata scope.\",\"url\":\"https://docs.valpashotels.com/api-reference/batch-fetch-hotels-by-giata-ids\",\"mainEntityOfPage\":{\"@id\":\"https://docs.valpashotels.com/api-reference/batch-fetch-hotels-by-giata-ids#webpage\"},\"dateModified\":\"2026-08-18T06:01:04.731Z\",\"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":"Guides","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"List hotels","deprecated":null,"version":null,"openapi":"/openapi.json get /hotels","href":"/api-reference/list-hotels"},{"title":"Get hotel by ID","deprecated":null,"version":null,"openapi":"/openapi.json get /hotels/{id}","href":"/api-reference/get-hotel-by-id"},{"title":"Get hotel by Netstorming ID","deprecated":null,"version":null,"openapi":"/openapi.json get /hotels/netstorming/{netstormingId}","href":"/api-reference/get-hotel-by-netstorming-id"},{"title":"Get hotel by GIATA ID","deprecated":null,"version":null,"openapi":"/openapi.json get /hotels/giata/{giataId}","href":"/api-reference/get-hotel-by-giata-id"},{"title":"Batch fetch hotels by Netstorming IDs","description":"Returns multiple hotels matching the provided Netstorming IDs. Maximum 1000 IDs per request. Hotels without a matching Netstorming ID are omitted from the response.","deprecated":null,"version":null,"openapi":"/openapi.json post /hotels/netstorming/batch","href":"/api-reference/batch-fetch-hotels-by-netstorming-ids"},{"title":"Batch fetch hotels by GIATA IDs","deprecated":null,"version":null,"openapi":"/openapi.json post /hotels/giata/batch","href":"/api-reference/batch-fetch-hotels-by-giata-ids"}]}]}]},"basePath":"","title":"Batch fetch hotels by GIATA IDs - Valpas API","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}