{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/stays/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Book single or multiple rooms","description":"Create AI-native travel products with Travelport's powerful, flexible APIs.","siteUrl":"https://developer.travelport.com/","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":"book-single-or-multiple-rooms","__idx":0},"children":["Book single or multiple rooms"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In all use cases, the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Actor"]}," is the developer implementing the interface between the TripServices APIs and your company's application that provides travel results to your company's end users. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Actors"]}," here are not searching/booking travel for themselves but instead are implementing this data handling for input from your company's travel customers."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"scope","__idx":1},"children":["Scope"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This use case identifies how to book multiple rooms for multiple guests."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"class":"doc-table md","className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Prerequisites"},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Next steps"},"children":["Next steps"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/getting-started/authentication"},"children":["Authentication"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Either:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["v11: <",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/stays/use-cases/searching-for-stays/search-by-airport"},"children":["Search"]}," and Availability, sending the number of guests to book for in each request; you do not send a room quantity in previous requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["v12: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/stays/use-cases/searching-for-stays/search-by-airport"},"children":["SearchComplete"]},", sending the number of guests to book for, but not room quantity."]}]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None required. This step books the requested rooms and completes the workflow."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case","__idx":2},"children":["Use case"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":5,"id":"book-rooms-using-the-create-reservation-reference-payload-request","__idx":3},"children":["Book rooms using the Create Reservation reference payload request"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"class":"doc-table md","className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action"},"children":["Action"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Goals and steps"},"children":["Goals and steps"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code Example"},"children":["Code Example"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Request"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the Create Reservation reference payload, to specify the number of rooms. enter the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["NumberOfRooms set to the number of rooms to book. If you are booking only 1 room, you do not need to send NumberOfRooms. The API books one room by default."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For each traveler, send one instance of the Traveler object with all required details:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["name in the PersonName objects"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["telephone in the Traveler/Telephone objects"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["email in Traveler/email"]}]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"ReservationQueryBuild\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"@type\": \"ReservationQueryBuild\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"ReservationBuild\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"@type\": \"ReservationBuildFromCatalogOffering\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"BuildFromCatalogOfferingHospitality\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"@type\": \"BuildFromCatalogOfferingHospitality\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"NumberOfRooms\": 2,"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Traveler\": ["]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["{"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"@type\": \"Traveler\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"PersonName\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Given\": \"Mariah\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Surname\": \"Roberts\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Title\": \"Ms\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["},"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Telephone\": ["]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["{"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"@type\": \"TelephoneDetail\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"countryAccessCode\": \"91\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"areaCityCode\": \"011\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"phoneNumber\": \"9891766469\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"cityCode\": \"DL\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["}"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["],"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Email\": ["]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["{"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"value\": \"roberts@none.com\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["}"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["],"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The booking response returns room and guest count at the top of the Product object:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Quantity=2 notes that two rooms were booked"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["guests=4 notes that four guests are on the booking"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["{"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"ReservationResponse\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Reservation\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"@type\": \"ReservationDetail\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Offer\": ["]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["{"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"@type\": \"Offer\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"id\": \"O1\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Identifier\": {"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"value\": \"6269ddc1-a017-40cb-bce6-140d5e74e104:cc3280205f5ae9a9b7944c1002c88b33\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"authority\": \"TVPT\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["},"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Product\": ["]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["{"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"@type\": \"ProductHospitality\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Quantity\": 2,"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"bookingCode\": \"T00AABT\","]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"guests\": 4,"]}]}]}]}]}]}]},"headings":[{"value":"Book single or multiple rooms","id":"book-single-or-multiple-rooms","depth":1},{"value":"Scope","id":"scope","depth":4},{"value":"Use case","id":"use-case","depth":4},{"value":"Book rooms using the Create Reservation reference payload request","id":"book-rooms-using-the-create-reservation-reference-payload-request","depth":5}],"frontmatter":{"seo":{"title":"Book single or multiple rooms"}},"lastModified":"2026-05-27T15:34:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/stays/use-cases/booking-stays/book-single-or-multiple-rooms","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}