{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Occupancy and allocation troubleshooting 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-troubleshooting-v32","__idx":0},"children":["Occupancy and allocation troubleshooting ",{"$$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":["Use this guide to diagnose differences in occupancy, guest allocation, child pricing, free stays, and order preview results."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quick-triage","__idx":1},"children":["Quick triage"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reproduce the request."]}," Keep the request body, endpoint, timestamp, request ID, and response together."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Check the guest details."]}," Confirm the adult count, each child’s actual age, number of rooms, and room-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allocation"]},". If comparing search and availability results, check that the dates, guest ages, room count, accommodation IDs, and allocation are the same."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inspect the availability response for the exact request."]}," Review the returned products, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy"]},", child age bands, and price. Availability is specific to the requested guests and dates."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Check static room and property rules."]}," Use /accommodations/details to review ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rooms[].maximum_occupancy"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies.minimum_guest_age"]},", and cot or extra-bed options."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Validate the selected product."]}," Call /orders/preview with the exact selected product IDs and room-level guest allocation. Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," in each product’s response."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For request and response examples, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/occupancy-use-cases"},"children":["Occupancy and allocation use cases"]},". For child-rate and free-stay information, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/child-policies"},"children":["Child policies guide"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"understand-the-occupancy-fields","__idx":2},"children":["Understand the occupancy fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The endpoints return occupancy information for different purposes:"]},{"$$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":"Field or response"},"children":["Field or response"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"How to use it"},"children":["How to use it"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rooms[].maximum_occupancy"]}," in /accommodations/details"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Static room limits for adults and children. The details response does not provide the availability response’s age-band information."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy"]}," in /accommodations/availability"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request-specific product information. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adults"]}," is the adult limit, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," is the overall guest limit, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children"]}," contains age-band child-policy information or is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recommendation"]}," in /accommodations/availability"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Suggested product allocation for the search criteria. Each product can include its allocated adults and children."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," in /orders/preview"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A warning that identifies guests who can be accommodated and guests who remain unallocated."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the availability response:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.total"]}," is the maximum number of guests for the room. It is based on guests using existing beds; cot and extra-bed options are separate."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.adults"]}," is the maximum number of adults for the room."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.children"]}," can be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," or contain age bands. Each band can include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from_age"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to_age"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_stay"]},". The age-band count describes the child policy for that band; it does not add places beyond ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.total"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Children must be accompanied by at least one adult. The number of children cannot exceed ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.total"]}," minus one."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ages in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from_age"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to_age"]}," are inclusive. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_stay"]}," indicates whether children in that age band stay free of charge. The returned API price already reflects free stays, so use the returned price rather than recalculating child charges."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.children"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},", children are allowed but no child-rate bands are returned. They are charged at adult rates. Check the overall ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," and the product returned for the requested guest group; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children: null"]}," does not mean that the room has no capacity for children."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a request includes more children than a child band covers, additional children may be counted or charged as adults. This does not increase the room’s overall ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," capacity."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check the product’s ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adults"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," values, the child age bands, and the preview result together."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-problems-and-resolutions","__idx":3},"children":["Common problems and resolutions"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"children-are-priced-as-adults","__idx":4},"children":["Children are priced as adults"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptom:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.children"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},", or a child is not covered by a returned age band, and the child is priced as an adult."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Likely cause:"]}," The product has no child-rate band for the requested age, or the number of children exceeds the number covered by the applicable band."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resolution:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Match each child’s actual age to the returned ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from_age"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to_age"]}," range."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the band’s ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," to see how many children it covers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the returned product price. Do not create your own child-rate calculation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},", explain that children are allowed but are charged at adult rates."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"no-suitable-product-is-returned-for-the-requested-guest-group","__idx":5},"children":["No suitable product is returned for the requested guest group"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptom:"]}," The availability response does not contain a suitable product or recommended allocation for the requested ages and room allocation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Likely causes:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The property’s minimum guest age excludes one or more travellers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No product is available for the requested dates, room count, ages, or allocation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The requested group exceeds the occupancy limits for the available products."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resolution:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies.minimum_guest_age"]}," in the /accommodations/details response. The value is the minimum age, inclusive, for staying at the property. A value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}," allows guests of any age; a value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["18"]}," means guests under 18 are not allowed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the products and occupancy information returned by /accommodations/availability for the exact guest group and dates."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If a property rule excludes a traveller, select another property that can accommodate the complete group. Do not omit a traveller or change their age to obtain a result."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the property age rule permits the group, check the dates, room count, allocation, and product availability before diagnosing the issue as an age restriction."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["minimum_guest_age"]}," is a property-level stay restriction. Do not confuse it with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["minimum_checkin_age"]},", which applies to the age required to check in."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"search-and-availability-appear-to-interpret-children-differently","__idx":6},"children":["Search and availability appear to interpret children differently"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptom:"]}," Search returns an accommodation, but the availability response shows a different adult or child allocation, child-rate eligibility, or price."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Likely cause:"]}," Search identifies accommodation candidates, while availability returns products for the requested dates and guest group."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In some v3.2 cases, children beyond the applicable child band may be counted or priced as adults. The child band and the room’s overall guest capacity describe different limits."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resolution:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm that both requests use the same dates, number of rooms, guest ages, accommodation IDs, and room allocation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the availability response to inspect each returned product’s ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.adults"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.children"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.total"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treat child age-band information as child-policy information. Do not add its count to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.total"]}," as extra capacity."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate the exact product and guest allocation with /orders/preview before order creation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"a-free-stay-is-not-displayed-as-free","__idx":7},"children":["A free stay is not displayed as free"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptom:"]}," A child’s age matches a band with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_stay: true"]},", but your interface shows an additional charge."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Likely causes:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The child’s age was matched to the wrong band."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The number of children covered by the band’s ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," has been exceeded."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The integration recalculates or adds a charge instead of displaying the API price."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resolution:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Match each child to a band using their actual age and the inclusive ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from_age"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to_age"]}," values."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Apply the band’s ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_stay"]}," information only to the children covered by that band’s ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display the returned price. API prices already account for free child stays; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_stay"]}," is for explaining the policy to travellers."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"occupancy_mismatch-is-returned-by-order-preview","__idx":8},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," is returned by order preview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptom:"]}," /orders/preview returns an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," object with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allocated"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unallocated"]}," guests."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Likely cause:"]}," The selected product or room-level allocation cannot accommodate every requested guest."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resolution:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allocated"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unallocated"]}," to identify which guests fit and which do not."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the selected product’s occupancy information and the guest allocation for each room."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Offer another product, additional rooms, or a revised allocation, as appropriate."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call /orders/preview again with the updated products and allocation."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," is a warning, not a blocking preview error."]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If an order is created while the 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":"li","attributes":{},"children":["Resolve the mismatch where possible; if the partner and booker choose to proceed, clearly explain this responsibility."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When all requested guests fit, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"order-preview-returns-an-api-error","__idx":9},"children":["Order preview returns an API error"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptom:"]}," /orders/preview returns an error response rather than an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," object."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resolution:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Diagnose the actual error code and message. Do not treat ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," as an error; it is a response warning."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm that the request uses valid product IDs and the expected request structure."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the guest ages and allocation against the selected products."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review property-level age restrictions in /accommodations/details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the error persists with a valid request, retain the request ID and response details for investigation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"booking-attempt-blocked-at-preview","__idx":10},"children":["Booking attempt blocked at preview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptom:"]}," orders/preview returns an error when children are included."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Likely cause:"]}," The property is flagged as “adults only” (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["minimum_guest_age: 18"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resolution:"]}," Verify if the property is flagged as \"adults only\" (minimum_guest_age: 18). Exclude adults-only properties when children are present in the request."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":11},"children":["Best practices"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send every child’s actual age in search and availability requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use availability to assess products for the requested dates and guest group; do not assume search results guarantee that a specific product can accommodate the group."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use /accommodations/details for static room limits, minimum guest age, and cot or extra-bed options."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Distinguish overall occupancy limits from child age-band and free-stay information."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the API’s returned prices instead of recalculating child charges."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treat the recommendation as a suggestion for the request, and validate the exact selected products and allocation with /orders/preview."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review and resolve ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]}," before creating an order where possible."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"references","__idx":12},"children":["References"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/occupancy-allocation"},"children":["Occupancy and allocation"]}," for the v3.2 occupancy flow and response interpretation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/occupancy-use-cases"},"children":["Occupancy and allocation use cases"]}," for worked examples, including children counted or priced as adults."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/child-policies"},"children":["Child policies guide"]}," for child rates, free stays, and cot and extra-bed policies."]},{"$$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 request parameters and room allocation."]}]}]}]},"headings":[{"value":"Occupancy and allocation troubleshooting v3.2","id":"occupancy-and-allocation-troubleshooting-v32","depth":1},{"value":"Quick triage","id":"quick-triage","depth":2},{"value":"Understand the occupancy fields","id":"understand-the-occupancy-fields","depth":2},{"value":"Common problems and resolutions","id":"common-problems-and-resolutions","depth":2},{"value":"Children are priced as adults","id":"children-are-priced-as-adults","depth":3},{"value":"No suitable product is returned for the requested guest group","id":"no-suitable-product-is-returned-for-the-requested-guest-group","depth":3},{"value":"Search and availability appear to interpret children differently","id":"search-and-availability-appear-to-interpret-children-differently","depth":3},{"value":"A free stay is not displayed as free","id":"a-free-stay-is-not-displayed-as-free","depth":3},{"value":"occupancy_mismatch is returned by order preview","id":"occupancy_mismatch-is-returned-by-order-preview","depth":3},{"value":"Order preview returns an API error","id":"order-preview-returns-an-api-error","depth":3},{"value":"Booking attempt blocked at preview","id":"booking-attempt-blocked-at-preview","depth":3},{"value":"Best practices","id":"best-practices","depth":2},{"value":"References","id":"references","depth":2}],"frontmatter":{"title":"Occupancy and allocation troubleshooting","description":"Diagnose occupancy and allocation issues, child-rate differences, free-stay display problems, and occupancy warnings in the Demand API.","tags":["demand-api","accommodations","occupancy","allocation","troubleshooting","child-rates","free-stay","orders-preview"],"api":["/accommodations/search","/accommodations/availability","/accommodations/details","/orders/preview"],"keywords":["occupancy troubleshooting","allocation issues API","child rates not applied","maximum occupancy errors","free stay field Demand API","adults and children allocation","occupancy mismatch","order preview warning"],"x-redocly":{"seo":{"title":"Occupancy and allocation troubleshooting in the Demand API","description":"Diagnose occupancy, allocation, child-rate, free-stay, and order preview issues in the Booking.com Demand API."},"audience":["developer","partners"]},"apiVersion":"v3.2","product":"accommodation","seo":{"title":"Occupancy and allocation troubleshooting v3.2"}},"lastModified":"2026-11-18T14:33:48.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/accommodations/v3.2/occupancy-troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}