{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Child policies v3.2","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"child-policies-v32","__idx":0},"children":["Child policies ",{"$$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 child age restrictions, child rates, free stays, and cot and extra-bed policies in the Demand API v3.2."]}]},{"$$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":["Properties can define rules that affect whether children may stay and how their stay is priced."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the Demand API to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check property age restrictions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve child-rate information for available products."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Identify age ranges where children stay free."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve room-level cot and extra-bed limits and related age and pricing policies."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Children are guests aged 0–17. Include each child’s actual age when searching for accommodation so the API can return relevant availability and pricing."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"which-endpoint-should-i-use","__idx":2},"children":["Which endpoint should I use?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Child-related availability information and static room limits serve different purposes."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["/accommodations/availability returns information for products available for the requested guest group.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.children"]}," entries describe child age bands and the maximum number of children covered by each entry."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_stay"]}," field provides pricing information."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["/accommodations/details returns static room information, including numeric adult and child occupancy limits."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use both responses when assessing a room and product for a guest group."]},{"$$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":"Use it to..."},"children":["Use it to..."]}]}]},{"$$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/search"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search for accommodations using the guest group, including the ages of all 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":["Retrieve available products and prices for the requested guest group, including applicable child age bands and free-stay information."]}]},{"$$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/details"},"children":["/accommodations/details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve property and room information, including minimum guest age, room occupancy limits, and cot and extra-bed policies. Request the relevant ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extras"]}," to return room or policy data."]}]}]}]}]},{"$$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/v3.2/occupancy-allocation"},"children":["v3.2 Occupancy and allocation guide"]}," for details."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"provide-childrens-ages","__idx":3},"children":["Provide children's ages"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When calling /accommodations/search or /accommodations/availability, include the complete guest group."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guests.number_of_adults"]}," — Total number of adults."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guests.children"]}," — Ages of all children."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guests.number_of_rooms"]}," — Number of rooms required."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guests.allocation"]}," — Requested distribution of adults and children across rooms, when applicable."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"guests\": {\n    \"number_of_adults\": 2,\n    \"children\": [2, 10],\n    \"number_of_rooms\": 1\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Keep each child’s actual age throughout the search and booking flow."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not convert children to adults to obtain a different price or make a guest allocation fit. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/v3.2/occupancy-allocation"},"children":["Occupancy & allocation guide"]}," for information about allocating guests across rooms."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"check-property-age-restrictions","__idx":4},"children":["Check property age restrictions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To retrieve property age policies, request ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extras: [\"policies\"]"]}," from /accommodations/details."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies.minimum_guest_age"]}," field defines the minimum age, inclusive, for staying at the property."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"policies\": {\n    \"minimum_guest_age\": 6\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, guests younger than 6 are not allowed to stay."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Interpret ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["minimum_guest_age"]}," as follows:"]},{"$$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":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Guests of any age are allowed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},"–",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["17"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Guests younger than the specified age are not allowed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["18"]}," or higher"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Children aged 0–17 are not allowed."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"adults-only-properties","__idx":5},"children":["Adults-only properties"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A property with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["minimum_guest_age"]}," set to 18 or higher does not allow children aged 0–17."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.children"]}," from /accommodations/availability to determine whether a property is adults-only."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In particular, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.children: null"]}," is not a reliable indicator that children are prohibited."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["minimum_guest_age"]}," is different from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["minimum_checkin_age"]},"."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["minimum_guest_age"]}," defines the minimum age of guests who may stay at the property."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["minimum_checkin_age"]}," defines the minimum age required to check in."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For practical examples covering adults-only properties and other minimum guest ages, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/v3.2/occupancy-use-cases#handle-adults-only-properties"},"children":["Occupancy and allocation use cases"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"understand-child-age-bands-and-pricing","__idx":6},"children":["Understand child age bands and pricing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Child rates are pricing rules that apply to children based on criteria such as their age and the product configuration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Call /accommodations/availability with the complete guest group to retrieve current products and prices."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An available product can return child-rate information in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.children"]},":"]},{"$$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\": true\n      },\n      {\n        \"total\": 1,\n        \"from_age\": 6,\n        \"to_age\": 12,\n        \"free_stay\": false\n      }\n    ],\n    \"total\": 4\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children"]}," entry describes an age band:"]},{"$$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"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"100px"}},"children":["Field"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from_age"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Youngest child age covered by the entry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to_age"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Oldest child age to which the child-rate rule applies."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maximum number of children to which the child-rate rule applies."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_stay"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether children covered by the rule stay free of charge. If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},", their cost is already included in the returned product price."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from_age"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to_age"]}," are inclusive."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The availability response is tailored to the requested guest group."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"check-room-occupancy-limits","__idx":7},"children":["Check room occupancy limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The age bands in /accommodations/availability describes child-rate information for the product, and do not replace the static room occupancy limits returned by /accommodations/details."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use /accommodations/details to check the room occupancy limits:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Request ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extras: [\"rooms\"]"]}," to retrieve room information."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rooms[].maximum_occupancy"]}," in the response to see the room’s static limits."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The v3.2 room-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy"]}," contains numeric adults and children limits, but it does not contain child age bands."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the room limits together with the selected product’s availability information."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check the selected product and guest allocation with /orders/preview before creating the order."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-children-is-null","__idx":8},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An available product can return:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"maximum_occupancy\": {\n    \"adults\": 2,\n    \"children\": null,\n    \"total\": 4\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children: null"]}," means no age-specific child-rate information is returned for the product. Children are priced at adult rates."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["This does not mean children are prohibited."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Call /accommodations/details and check the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies.minimum_guest_age"]}," for property age restrictions and use the room occupancy limits to assess the room’s capacity."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"free-child-stays","__idx":9},"children":["Free child stays"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_stay"]}," indicates whether children covered by a child-rate rule stay free of charge."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"maximum_occupancy\": {\n    \"children\": [\n      {\n        \"total\": 1,\n        \"from_age\": 0,\n        \"to_age\": 5,\n        \"free_stay\": true\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The rule applies to children aged 0–5, inclusive."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Up to one child can use the rule."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_stay: true"]}," indicates that a child covered by the rule stays free of charge."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The returned product price already accounts for the applicable child pricing. Do not subtract the child's price or recalculate the product total yourself."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_stay"]}," describes pricing; it does not mean the child is excluded from the room’s occupancy limits. Check /accommodations/details when you need to determine whether the child can be accommodated."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cots-and-extra-beds","__idx":10},"children":["Cots and extra beds"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cots and extra beds have separate policy and room-level information."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use /accommodations/details to retrieve:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Property-level age and pricing rules through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies.cots_and_extra_beds"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Room-level limits through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rooms[].cots_and_extra_beds"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extras: [\"rooms\"]"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extras: [\"policies\"]"]}," in the request:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"accommodations\": [27635],\n  \"extras\": [\n    \"policies\",\n    \"rooms\"\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cot-and-extra-bed-policies","__idx":11},"children":["Cot and extra-bed policies"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies.cots_and_extra_beds"]}," contains age-related pricing rules for cots and extra beds."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"policies\": {\n    \"cots_and_extra_beds\": [\n      {\n        \"age\": {\n          \"from\": 0,\n          \"to\": 2\n        },\n        \"mode\": \"per_night\",\n        \"price\": 0,\n        \"type\": \"cot\"\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the fields as follows:"]},{"$$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"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["age.from"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Youngest guest age to which the rule applies. The age interval is inclusive."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["age.to"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Oldest guest age to which the rule applies. The age interval is inclusive. The schema uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["18"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," to represent adults."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["How the price is applied per cot or extra bed, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["per_night"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["per_stay"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Price of the cot or extra bed. A value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}," indicates that it is free of charge."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether the rule applies to a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cot"]}," or an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extra_bed"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"room-level-cot-and-extra-bed-limits","__idx":12},"children":["Room-level cot and extra-bed limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rooms[].cots_and_extra_beds"]}," describes the number of cots and extra beds that can be added to a particular 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\": \"2763504\",\n      \"cots_and_extra_beds\": {\n        \"are_allowed_together\": false,\n        \"maximum_number_of_cots\": 1,\n        \"maximum_number_of_extra_beds\": 0\n      }\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_number_of_cots"]}," — Maximum number of cots that can be added to the room."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_number_of_extra_beds"]}," — Maximum number of extra beds that can be added to the room."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["are_allowed_together"]}," — Whether cots and extra beds can be placed in the room at the same time, up to their respective limits."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies.cots_and_extra_beds"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rooms[].cots_and_extra_beds"]}," together."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The policy describes the applicable age and pricing rules, while the room information describes how many cots or extra beds can be added."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cots-extra-beds-and-room-occupancy","__idx":13},"children":["Cots, extra beds and room occupancy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cot and extra-bed information is separate from the room's standard occupancy configuration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When determining whether a guest group can be accommodated:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the room's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the applicable cot or extra-bed policy."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the room-level cot and extra-bed limits."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate the selected product and exact guest allocation using /orders/preview before creating the order."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For worked examples, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/v3.2/occupancy-use-cases#handle-cots-and-extra-beds"},"children":["Handle cots and extra beds"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-to-display","__idx":14},"children":["What to display"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the child-policy information returned by the API to provide travellers with relevant information about their stay such as:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Child age bands and whether children in those bands stay free."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cot and extra-bed availability and applicable charges."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The property’s minimum guest age or other relevant age restrictions."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Always display the product price returned by the API. Child-rate and free-stay rules are already reflected in the returned price."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not infer or display that children are charged as adults solely because ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.children"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not calculate child prices independently from the product price returned by the API."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"recommended-flow","__idx":15},"children":["Recommended flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When handling a search that includes children:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send each child's actual age in /accommodations/search."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["minimum_guest_age"]}," from /accommodations/details when property age restrictions are relevant to your integration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call /accommodations/availability for the selected accommodation using the complete guest group."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.children"]}," to interpret the applicable child-rate information for each product."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_stay"]}," to identify child-rate bands where children stay free of charge."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When you need to determine whether the guest group fits a particular room, use the room occupancy information from /accommodations/details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies.cots_and_extra_beds"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rooms[].cots_and_extra_beds"]}," when cot or extra-bed information is relevant."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use /orders/preview to validate the exact product and guest allocation before creating the order."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":16},"children":["Best practices"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Always provide children's actual ages in search, availability and preview requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep child pricing rules separate from room occupancy rules."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy.children"]}," from /accommodations/availability alone to determine whether children fit the room."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not interpret ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children: null"]}," as confirmation that children are prohibited or should be treated as adults."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["minimum_guest_age"]}," to determine property-level age restrictions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the product prices returned by the API rather than calculating child prices yourself."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treat cot and extra-bed policies separately from standard room occupancy."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate the final product and guest allocation using /orders/preview."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"references","__idx":17},"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/occupancy-allocation"},"children":["Occupancy & allocation guide"]}," for guest allocation, room occupancy rules, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recommendation"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["occupancy_mismatch"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/v3.2/occupancy-use-cases"},"children":["Occupancy and allocation use cases"]}," for worked family-booking examples covering versions 3.2."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refer to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/search-for-available-properties"},"children":["Accommodation search guide"]}," for instructions and best practices when using /accommodations/search and /accommodations/availability."]}]}]}]},"headings":[{"value":"Child policies v3.2","id":"child-policies-v32","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Which endpoint should I use?","id":"which-endpoint-should-i-use","depth":2},{"value":"Provide children's ages","id":"provide-childrens-ages","depth":2},{"value":"Check property age restrictions","id":"check-property-age-restrictions","depth":2},{"value":"Adults-only properties","id":"adults-only-properties","depth":3},{"value":"Understand child age bands and pricing","id":"understand-child-age-bands-and-pricing","depth":2},{"value":"Check room occupancy limits","id":"check-room-occupancy-limits","depth":3},{"value":"When children is null","id":"when-children-is-null","depth":3},{"value":"Free child stays","id":"free-child-stays","depth":2},{"value":"Cots and extra beds","id":"cots-and-extra-beds","depth":2},{"value":"Cot and extra-bed policies","id":"cot-and-extra-bed-policies","depth":3},{"value":"Room-level cot and extra-bed limits","id":"room-level-cot-and-extra-bed-limits","depth":3},{"value":"Cots, extra beds and room occupancy","id":"cots-extra-beds-and-room-occupancy","depth":3},{"value":"What to display","id":"what-to-display","depth":2},{"value":"Recommended flow","id":"recommended-flow","depth":2},{"value":"Best practices","id":"best-practices","depth":2},{"value":"References","id":"references","depth":2}],"frontmatter":{"title":"Child policies","description":"Learn how to interpret child age restrictions, child rates, free stays, and cot and extra-bed policies in Demand API v3.2.","tags":["demand-api","accommodations","child-policies","child-rates","age-restrictions","free-stay","cots","extra-beds","family-travel"],"api":["/accommodations/search","/accommodations/availability","/accommodations/details","/orders/preview"],"keywords":["Booking.com child policies","Demand API child rates","accommodation child rates","children age restrictions","minimum guest age","children stay free","cots and extra beds","family accommodation API"],"x-redocly":{"seo":{"title":"Child policies in the Demand API","description":"Learn how to handle child age restrictions, child rates, free stays, and cot and extra-bed policies using Demand API v3.2."}},"audience":["developer","partners","business"],"apiVersion":"v3.2","product":"accommodation","seo":{"title":"Child policies v3.2"}},"lastModified":"2026-11-19T12:12:56.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/accommodations/v3.2/child-policies","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}