{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Occupancy and allocation v3.2","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"occupancy-and-allocation-v32","__idx":0},"children":["Occupancy and allocation ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070C9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["v3.2"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Learn how to interpret room occupancy rules, allocate adults and children, and validate a guest allocation using the Accommodation API collection."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide explains how to manage adults and children across the accommodation booking flow, including how to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Specify the requested guest group and room allocation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Interpret occupancy and child-rate information returned by /accommodations/availability."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check room occupancy configuration using /accommodations/details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recommendation"]}," returned by /accommodations/availability."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate the selected allocation using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," in /orders/preview."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"occupancy-information-per-endpoint","__idx":2},"children":["Occupancy information per endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Occupancy information serves different purposes across the API flow."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Usage"},"children":["Usage"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/search"},"children":["/accommodations/details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns static information about a room, including its maximum numbers of adults and children."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/availability"},"children":["/accommodations/availability"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Checks the guests and dates in the request and returns available products with occupancy information for those results."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2/demand-api/orders/orders/preview"},"children":["/orders/preview"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validates the exact selected products and guest allocation and reports any guests the product cannot accommodate."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An availability response is specific to the request. Do not use it to infer whether a different guest group, or children of different ages, would fit."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For child rates and display guidance, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/v3.2/child-policies"},"children":["Child policies guide"]},". For worked occupancy examples, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/v3.2/occupancy-use-cases"},"children":["Occupancy and allocation use cases"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"submit-guest-details-and-room-allocation","__idx":3},"children":["Submit guest details and room allocation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In /accommodations/search and /accommodations/availability requests, provide guest details in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guests"]}," object:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number_of_adults"]}," — Total number of adults in the request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children"]}," — Ages of all children in the request. Children are guests aged from 0 to 17. Submit each child’s actual age; do not recategorise children as adults to work around an occupancy result."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number_of_rooms"]}," — Number of rooms required."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allocation"]}," — Distribution of adults and children across the requested rooms. Provide this when you want to specify which guests are assigned to each room."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a request for two rooms, this allocation assigns two adults and two children to each room:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"guests\": {\n    \"allocation\": [\n      {\n        \"number_of_adults\": 2,\n        \"children\": [2, 10]\n      },\n      {\n        \"number_of_adults\": 2,\n        \"children\": [0, 5]\n      }\n    ],\n    \"number_of_adults\": 4,\n    \"children\": [0, 2, 5, 10],\n    \"number_of_rooms\": 2\n  }\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The room-level allocations must match the overall adult count and children’s ages in the request."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/search-for-available-properties#4.-input-guest-details-and-room-allocation"},"children":["Search guide"]}," for more information about guest details and room allocation."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"understand-occupancy-information","__idx":4},"children":["Understand occupancy information"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy"]}," object has different meanings depending on which endpoint returns it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"static-room-limits-in-accommodationsdetails","__idx":5},"children":["Static room limits in /accommodations/details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Request the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rooms"]}," extra to retrieve static occupancy information for each room. A room’s ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy"]}," object includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adults"]}," — Maximum number of adults for the room."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children"]}," — Maximum number of children for the room."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"rooms\": [\n    {\n      \"id\": \"1000420\",\n      \"maximum_occupancy\": {\n        \"adults\": 2,\n        \"children\": 1\n      }\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These values describe the room’s configured limits. They do not confirm availability for the requested dates or that every combination within the limits can be accommodated. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/accommodations/availability"]}," for the requested guests and dates, then use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/orders/preview"]}," to validate the selected product and allocation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-specific-occupancy-information-in-accommodationsavailability","__idx":6},"children":["Request-specific occupancy information in /accommodations/availability"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy"]}," object is returned for an available product. It can include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adults"]}," — Maximum number of adults for the product."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children"]}," — Child occupancy information, including allowed age ranges and the maximum number of children in each range. The child information can be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," — Maximum number of guests for the product."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each child age-band entry can include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," — Maximum number of children in that age band."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from_age"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to_age"]}," — The youngest and oldest ages in that band. Both ages are inclusive."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_stay"]}," — Whether children in that age band stay for free. When it is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},", the child’s cost is already included in the returned price."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"maximum_occupancy\": {\n    \"adults\": 2,\n    \"children\": [\n      {\n        \"total\": 1,\n        \"from_age\": 0,\n        \"to_age\": 5,\n        \"free_stay\": false\n      }\n    ],\n    \"total\": 2\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.total"]}," is the overall maximum of two guests. The child entry describes the applicable child policy for its age band; it does not add a place beyond the overall guest limit. Use the product returned for the exact request and /orders/preview to confirm that the complete guest allocation fits."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," inside a child entry is the maximum number of children covered by that age-band policy. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_stay"]}," is pricing information. The API price already reflects the child policy, so do not recalculate or add a separate child charge based only on this field."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},", there are no child age-band details in the response. Children are allowed and are charged at adult rates. The response for the exact guest group and /orders/preview remain the checks for the selected product and allocation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adults"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," values describe different limits and policy information. Do not add the adult maximum and child-band counts together to calculate capacity beyond ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"when-children-is-null","__idx":7},"children":["When children is null"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children: null"]}," in /accommodations/availability is not sufficient to determine whether children are allowed in the room."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It can occur when:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The room allows children but no applicable child-rate rule is returned for the product."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The room does not allow children of the requested age."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you need to select a product where ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},":"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Match the product's room ID with the corresponding room returned by /accommodations/details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rooms[].maximum_occupancy"]}," to determine whether the requested children can be accommodated."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the requested children can be accommodated, continue to /orders/preview using their actual ages."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," before creating the order - If the room cannot accommodate the requested guests, do not offer that product for the requested allocation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use /orders/preview to validate the final allocation before creating the order."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not replace children with adults when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},". Always preserve the actual guest composition and children's ages."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For practical examples, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/v3.2/occupancy-use-cases#handle-children-null"},"children":["Handle children: null use case"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-the-recommended-allocation","__idx":8},"children":["Use the recommended allocation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recommendation"]}," object returned in the /accommodations/availability contains the product or combination of products recommended for the guest group provided in the request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For each recommended product:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number_of_adults"]}," - Indicates the adults allocated to that product."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children"]}," - Contains the ages of the children allocated to that product."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the recommendation when it meets your integration requirements. If you select a different product or change the guest allocation, check availability for the revised request and validate the selected allocation with /orders/preview."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not assume that every product returned in products can accommodate the requested guest group based only on its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy"]}," information."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you select a product outside ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recommendation"]},", check its room occupancy limits using /accommodations/details and validate the intended allocation with /orders/preview."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"validate-the-allocation-with-orderspreview","__idx":9},"children":["Validate the allocation with /orders/preview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before creating an accommodation order, call /orders/preview with the selected products and the exact adults and children you intend to place in each room."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," in the response:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allocated"]}," — Guests from the request that the product can accommodate."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unallocated"]}," — Guests from the request that the product cannot accommodate."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," — The complete requested allocation can be accommodated."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, this response shows one adult allocated and one adult unallocated:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"occupancy_mismatch\": {\n    \"allocated\": {\n      \"number_of_adults\": 1,\n      \"children\": null\n    },\n    \"unallocated\": {\n      \"number_of_adults\": 1,\n      \"children\": null\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the full allocation can be accommodated, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," is a warning and it does not prevent /orders/preview from succeeding or block order creation."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If an order is created while a mismatch remains, only the maximum allowed occupancy is stored in Booking.com’s systems."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The partner or booker is responsible for handling guests who are not included in that occupancy."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"handle-an-occupancy-mismatch","__idx":10},"children":["Handle an occupancy mismatch"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," is not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},":"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tell the traveller that the selected product cannot accommodate the full guest group."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Let them select another product, add rooms, or revise the allocation as appropriate."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Preview the revised order again."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Resolve the mismatch before creating the order. If the partner and booker choose to proceed while guests remain unallocated, make clear that those guests are not included in the occupancy stored by Booking.com and are their responsibility."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/occupancy-mismatch.ab6c454110f3dd2cdae03dc9e727c968eea041460f1698a66be78799ffbc181e.4302f616.png","alt":"occupancy mismatch example in frontend"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"recommended-integration-flow","__idx":11},"children":["Recommended integration flow"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send the complete guest group, including children’s actual ages, to /accommodations/search or /accommodations/availability."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use /accommodations/details when you need static room occupancy limits or cot and extra-bed information."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Interpret availability only for the guests and dates in that request. Do not infer that additional children or children of different ages would fit."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the returned ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recommendation"]}," when it meets your integration requirements."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Submit the selected products and exact guest allocation to /orders/preview."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," is not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},", revise the product or allocation and preview the order again."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Resolve any mismatch before creating the order, or ensure the partner and booker understand their responsibility for guests not included in the stored occupancy."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":12},"children":["Best practices"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Include children’s actual ages in search and availability requests."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Use /accommodations/details for static room limits and /accommodations/availability for results tailored to the requested guests and dates."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recommendation"]}," object for optimal allocation for the requested guest group."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Interpret child occupancy and pricing information separately."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Do not infer capacity for unrequested children or different child ages from one availability response."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Do not proceed with a booking when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," identifies unallocated guests."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"references","__idx":13},"children":["References"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/v3.2/child-policies"},"children":["Child policies guide"]}," for child rates, free stays, and cot and extra-bed policies."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/v3.2/occupancy-use-cases"},"children":["Occupancy and allocation use cases"]}," for worked examples with different guest groups."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/v3.2/occupancy-troubleshooting"},"children":["Occupancy Troubleshooting"]}," for learn how to resolve occupancy errors."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/search-for-available-properties"},"children":["Accommodation search guide"]}," for search requests and room allocation."]}]}]}]},"headings":[{"value":"Occupancy and allocation v3.2","id":"occupancy-and-allocation-v32","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Occupancy information per endpoint","id":"occupancy-information-per-endpoint","depth":3},{"value":"Submit guest details and room allocation","id":"submit-guest-details-and-room-allocation","depth":2},{"value":"Understand occupancy information","id":"understand-occupancy-information","depth":2},{"value":"Static room limits in /accommodations/details","id":"static-room-limits-in-accommodationsdetails","depth":3},{"value":"Request-specific occupancy information in /accommodations/availability","id":"request-specific-occupancy-information-in-accommodationsavailability","depth":3},{"value":"When children is null","id":"when-children-is-null","depth":4},{"value":"Use the recommended allocation","id":"use-the-recommended-allocation","depth":2},{"value":"Validate the allocation with /orders/preview","id":"validate-the-allocation-with-orderspreview","depth":2},{"value":"Handle an occupancy mismatch","id":"handle-an-occupancy-mismatch","depth":4},{"value":"Recommended integration flow","id":"recommended-integration-flow","depth":2},{"value":"Best practices","id":"best-practices","depth":2},{"value":"References","id":"references","depth":2}],"frontmatter":{"title":"Accommodation occupancy and allocation","description":"Learn how to interpret room occupancy rules, allocate adults and children, and validate guest allocations using the Demand API.","tags":["demand-api","accommodations","occupancy","guest-allocation","maximum-occupancy","child-occupancy","booking-validation"],"api":["/accommodations/search","/accommodations/availability","/accommodations/details","/orders/preview"],"keywords":["Booking.com accommodation occupancy","Demand API occupancy","maximum occupancy","guest allocation","room occupancy limits","child occupancy rules","child age occupancy","recommended guest allocation","occupancy mismatch","accommodation booking validation","multi-room guest allocation"],"x-redocly":{"seo":{"title":"Accommodation occupancy and allocation in the Demand API","description":"Understand static room occupancy limits, request-specific availability, guest allocation, and occupancy mismatch warnings in the Demand API."},"audience":["developer","partners","business"]},"apiVersion":"v3.2","product":"accommodation","seo":{"title":"Occupancy and allocation v3.2"}},"lastModified":"2026-11-19T12:12:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/accommodations/v3.2/occupancy-allocation","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}