{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Multi-traveler booking","meta":[{"name":"robots","content":"noindex"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"multi-traveler-booking","__idx":0},"children":["Multi-traveler booking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Spotnana platform allows you to search for and book hotel rooms that can accommodate more than one traveler. In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/hotelapi/hotel/hotelsearch"},"children":["hotel search"]}," API, use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numAdults"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numChildren"]}," fields to enter the number of fellow travelers who'll be sharing the room with you. For example, if you are going to share the room with one adult and one child, then ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numAdults"]}," will be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numChildren"]}," will be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every hotel establishment will have their own restrictions on how many adults and children can share a room. In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/hotelapi/hotel/hoteldetails"},"children":["get hotel details"]}," API, use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rooms"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rateOptions"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maxOccupancy"]}," field to determine the maximum number of adults and children allowed to share a room in their hotel. The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/hotelapi/hotel/hotelsearch"},"children":["hotel search"]}," results will be filtered based on the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy"]}," details entered."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a multi-traveler booking, you only need to pass the primary traveler's information when ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/hotelapi/hotel/hotelcreatepnr"},"children":["creating a hotel booking"]},"."," ","The total number of travelers staying in the room is already conveyed through the occupancy values set during search."," ","The supplier uses the primary traveler's data (user identifier, name, email, and phone number) to create the reservation,"," ","and the room is reserved for the full occupancy specified."," ","Enter the primary traveler's information in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["travelers"]}," array at index ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]},"."," ","You do not need to add entries for any other travelers sharing the room."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sample-request-payload","__idx":1},"children":["Sample request payload"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Assume John Smith is a primary traveler and he is creating a hotel reservation for a total of 3 travelers including himself."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/hotelapi/hotel/hotelsearch"},"children":["hotel search"]}," request, set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numAdults"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3"]}," in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy"]}," field to indicate that three adults will share the room:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"// ... payload truncated for focus\n{\n  \"searchParams\": {\n    \"occupancyDates\": {\n      \"occupancy\": [\n        {\n          \"numAdults\": 3,\n          \"numChildren\": 0\n        }\n      ],\n      \"checkInDate\": {\n        \"iso8601\": \"2026-06-15T15:00\"\n      },\n      \"checkOutDate\": {\n        \"iso8601\": \"2026-06-18T11:00\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Then, when ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/hotelapi/hotel/hotelcreatepnr"},"children":["creating a hotel booking"]},", pass only the primary traveler's information in the travelers array:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"// ... payload truncated for focus\n{\n  \"travelers\": [\n    {\n      \"travelerId\": {\n        \"id\": \"a90e38d1-7c9f-4b2a-8c8a-2c8c3e8f9e6a\"\n      },\n      \"name\": {\n        \"family1\": \"Smith\",\n        \"given\": \"John\"\n      },\n      \"phoneNumber\": {\n        \"countryCode\": 1,\n        \"nationalNumber\": 2125550101\n      },\n      \"email\": \"john.smith@example.com\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/spotnana/hotel_booking_workflow"},"children":["create hotel booking workflow"]}," guide to learn more about the steps involved in creating a hotel booking."]}]},"headings":[{"value":"Multi-traveler booking","id":"multi-traveler-booking","depth":1},{"value":"Sample request payload","id":"sample-request-payload","depth":2}],"frontmatter":{"seo":{"title":"Multi-traveler booking"}},"lastModified":"2026-05-06T07:51:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/hotel_guides/hotel_multitraveler_guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}