{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Retrieve Terms & Conditions for Car rental orders","siteUrl":"https://developers.booking.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"retrieve-terms--conditions-for-car-rental-orders","__idx":0},"children":["Retrieve Terms & Conditions for Car rental orders"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Learn how to use the /orders/details/cars/terms-and-conditions endpoint to retrieve the full structured terms and conditions for one or more existing car rental orders."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["|"]},{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#dcfce7","color":"#166534","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":[" ","✓ Post-booking"," "]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["|"]}," ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#fbbf24","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["3.2 Beta"]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["|"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/3.2-beta/demand-api/orders/cars-terms-and-conditions"},"children":["/orders/details/cars/terms-and-conditions"]}," endpoint to retrieve the complete legal terms associated with confirmed car rental orders."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response returns ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["hierarchical legal content"]},", organised into chapters containing nested sections, clauses, sub-clauses, and clause options. This structure is designed for rendering in user interfaces such as booking confirmations, vouchers, or order detail pages."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use cases:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display full rental contract details to travellers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Show terms and conditions on order detail pages."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Recreate the booking voucher terms section."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Support legal and compliance requirements."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-works","__idx":1},"children":["How it works"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can provide up to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["10 order IDs"]}," per request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The API returns a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["map of order IDs"]}," to their terms and conditions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each order ID maps to either:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An object containing a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["terms"]}," field, or"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," if the order ID is invalid or not found."]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The endpoint supports partial success:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Valid order IDs return their terms."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Invalid or unknown order IDs return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"important-notes","__idx":2},"children":["Important notes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include at least one valid order ID."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provide ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker.country"]}," to ensure correct legal and regional terms."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[" filters.voucher: true"]}," to return only the subset of terms required for the booking voucher."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The language field accepts a BCP 47 language tag (for example en-gb, es). If not specified or unsupported, the response defaults to English."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-body","__idx":3},"children":["Request body"]},{"$$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":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"minWidth":"100px"}},"children":["Field"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$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":["booker.country"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Two-letter country code (ISO 3166-1 alpha-2, e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["es"]},") identifying the booker's country."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orders"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Car rental order IDs for which to retrieve terms and conditions. Must include at least one valid ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Preferred language for the response (ISO 639-1 language code e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en-gb"]},"). Defaults to English if not specified or unsupported."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters.voucher"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," returns only the terms required to be shown on the booking voucher displayed to the traveller at pick-up."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example request:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\n{\n  \"booker\": {\n    \"country\": \"gb\"\n  },\n  \"language\": \"en-gb\",\n  \"orders\": [\"765255700\", \"invalid_order\"],\n  \"filters\": {\n    \"voucher\": true\n  }\n}\n\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-structure","__idx":4},"children":["Response structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," – Unique identifier for the request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," – A map of order IDs to their terms and conditions."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data map behaviour"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each key is an order ID from the request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each value is either:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An object containing a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["terms"]},"field, or"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," if the order is invalid or not found."]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"123456789\",\n  \"data\": {\n    \"765255700\": {\n      \"terms\": [ ... ]\n    },\n    \"invalid_order\": null\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"terms-object","__idx":5},"children":["Terms object"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["terms"]}," – A hierarchical array representing the full rental agreement."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each node includes:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," (chapter, section, clause, sub_clause, clause_option)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Leaf nodes (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clause_option"]},") contain the final displayable text in text."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"123456789\",\n  \"data\": {\n    \"765255700\": {\n      \"terms\": [\n        {\n          \"type\": \"chapter\",\n          \"title\": \"Rental agreement\",\n          \"children\": [\n            {\n              \"type\": \"section\",\n              \"title\": \"Driver requirements\",\n              \"children\": [\n                {\n                  \"type\": \"clause\",\n                  \"title\": \"Age restrictions\",\n                  \"children\": [\n                    {\n                      \"type\": \"sub_clause\",\n                      \"children\": [\n                        {\n                          \"type\": \"clause_option\",\n                          \"text\": \"Driver must be <b>at least 25 years of age</b> to rent this vehicle.\"\n                        }\n                      ]\n                    }\n                  ]\n                }\n              ]\n            }\n          ]\n        }\n      ]\n    }\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":6},"children":["Best practices"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Validate input"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure all order IDs in the orders array are valid strings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Invalid IDs return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["terms: null"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Always include booker context"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provide",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker.country"]}," to ensure correct legal and regional terms."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use language for localisation"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language"]}," to match the traveller’s locale where possible."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Voucher filtering"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters.voucher:true"]}," when displaying only the terms required on the traveller’s booking voucher page."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Render hierarchy correctly"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Preserve the nested structure when displaying terms."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Only ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clause_option.text"]}," contains final displayable legal text."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["text"]}," may include basic HTML (for example ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":[]}," tags). Ensure safe rendering or sanitisation where required."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"integration-tips","__idx":7},"children":["Integration tips"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treat the response as a tree structure, not flat content."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Avoid flattening unless your UI explicitly requires it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Preserve ordering of all nodes when rendering."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use recursive rendering logic for best fidelity to legal structure."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":8},"children":["Next steps"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Curious to know more?"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/cars/3.2/cars-tutorial"},"children":["Car tutorial"]}," for a complete booking flow."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/demand-api/orders"},"children":["Orders"]}," section for more details."]}]}]}]},"headings":[{"value":"Retrieve Terms & Conditions for Car rental orders","id":"retrieve-terms--conditions-for-car-rental-orders","depth":1},{"value":"How it works","id":"how-it-works","depth":2},{"value":"Important notes","id":"important-notes","depth":3},{"value":"Request body","id":"request-body","depth":3},{"value":"Response structure","id":"response-structure","depth":3},{"value":"Terms object","id":"terms-object","depth":3},{"value":"Best practices","id":"best-practices","depth":2},{"value":"Integration tips","id":"integration-tips","depth":3},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Retrieve car rental order terms and conditions","description":"Learn how to retrieve the full structured terms and conditions for one or more car rental orders using the /orders/details/cars/terms-and-conditions endpoint. Includes hierarchical legal content for display in vouchers, booking confirmations, and order detail pages.","tags":["cars","car rentals","orders","terms and conditions","legal content","demand api"],"api":["/orders/details/cars/terms-and-conditions"],"keywords":["car rental terms and conditions","car rental order details","rental agreement API","post booking terms","booking voucher terms","car rental legal content","demand API orders","retrieve rental contract","structured terms API"],"x-redocly":{"seo":{"title":"Car Rental Terms & Conditions – Demand API v3.2","description":"Step-by-step guide to retrieve structured legal terms and conditions for car rental orders using the /orders/details/cars/terms-and-conditions endpoint in Demand API v3.2. Learn how to render hierarchical rental agreements, handle partial responses, and display voucher-specific terms."},"audience":["developer","partner","integrator"],"apiVersion":"v3.2 Beta","product":["cars","orders"]},"seo":{"title":"Retrieve Terms & Conditions for Car rental orders"}},"lastModified":"2026-05-05T11:16:52.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/cars/3.2/post-booking-terms-and-cond","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}