{"items":[{"type":"link","label":"Booking.com Demand API","link":"/demand/docs/open-api/3.2/demand-api","routeSlug":"/demand/docs/open-api/3.2/demand-api","content":{"contentType":"overview","meta":{"name":"Booking.com Demand API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"demand-api.json","url":"/_bundle/demand/docs/open-api/3.2/demand-api.json?download"},{"kind":"download","label":"demand-api.yaml","url":"/_bundle/demand/docs/open-api/3.2/demand-api.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Booking.com Demand API (3.2)","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Booking.com Demand API enables Affiliate Partners to access Booking.com's travel inventory, including accommodations, car rentals, and flights. The version 3.2 introduces several improvements and breaking changes from version 3.1, including updates to "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"price structures"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", inclusion of "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Attractions and taxis in orders/details"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for post-booking reporting, and other structural enhancements."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The API follows REST principles and returns data in "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can access endpoints via "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS POST"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" requests."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication: Use your Affiliate ID and token credentials to use these endpoints."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/getting-started/try-out-the-api"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Check the Try out guide!"},"children":[]}]}]}]}]}],"sectionId":"/demand/docs/open-api/3.2/demand-api"}]}]}},{"type":"separator","label":"Travel services","content":null},{"type":"group","label":"Accommodation","link":"/demand/docs/open-api/3.2/demand-api/accommodations","routeSlug":"/demand/docs/open-api/3.2/demand-api/accommodations","items":[{"label":"Search","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/search","routeSlug":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/search","metadata":{"seo":{"title":"Search","description":"Use this endpoint to search for accommodations that match your specified criteria. By default, the response returns the cheapest available product for each accommodation.When applying location filters such as country or region, results are ranked by Booking.com popularity (top picks) rather than price, with higher-ranked listings appearing first."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/accommodations/search","name":"Search","isWebhook":false,"pointer":"/paths/~1accommodations~1search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to search for accommodations that match your specified criteria. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"By default, "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the response returns the cheapest available product"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for each accommodation."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When applying location filters such as country or region, results are ranked by Booking.com popularity (top picks) rather than price, with higher-ranked listings appearing first."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1accommodations~1search/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/searchInput","exampleIds":["paths/~1accommodations~1search/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/searchInput","exampleIds":["paths/~1accommodations~1search/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1accommodations~1search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/accommodations/search","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/searchInput","exampleIds":["paths/~1accommodations~1search/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/accommodations/search","href":"accommodations/accommodations/search","openApiOperationId":"/accommodations/search","summary":"Search"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/searchInput","exampleIds":["paths/~1accommodations~1search/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/searchInput","exampleIds":["paths/~1accommodations~1search/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/searchOutput","exampleIds":["paths/~1accommodations~1search/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/searchOutput","exampleIds":["paths/~1accommodations~1search/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1accommodations~1search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/searchOutput","exampleIds":["paths/~1accommodations~1search/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/searchOutput","exampleIds":["paths/~1accommodations~1search/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/accommodations/search"},{"label":"Availability","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/availability","routeSlug":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/availability","metadata":{"seo":{"title":"Availability","description":"Use this endpoint to check real-time availability, prices, and charges for up to 50 accommodation IDs."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/accommodations/availability","name":"Availability","isWebhook":false,"pointer":"/paths/~1accommodations~1availability/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Availability","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to check real-time availability, prices, and charges for "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"up to 50 accommodation IDs"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"By default, only product availability and prices are returned."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"extras"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filters"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameters to retrieve additional details such as extra charges or payment information."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Mandatory fields"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"accommodations"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"booker"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"checkin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"checkout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"guests"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1accommodations~1availability/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/availabilityInput","exampleIds":["paths/~1accommodations~1availability/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/availabilityInput","exampleIds":["paths/~1accommodations~1availability/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1accommodations~1availability/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/accommodations/availability","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/availabilityInput","exampleIds":["paths/~1accommodations~1availability/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/accommodations/availability","href":"accommodations/accommodations/availability","openApiOperationId":"/accommodations/availability","summary":"Availability"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/availabilityInput","exampleIds":["paths/~1accommodations~1availability/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/availabilityInput","exampleIds":["paths/~1accommodations~1availability/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/availabilityOutput","exampleIds":["paths/~1accommodations~1availability/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/availabilityOutput","exampleIds":["paths/~1accommodations~1availability/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1accommodations~1availability/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/availabilityOutput","exampleIds":["paths/~1accommodations~1availability/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/availabilityOutput","exampleIds":["paths/~1accommodations~1availability/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/accommodations/availability"},{"label":"Chains","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/chains","routeSlug":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/chains","metadata":{"seo":{"title":"Chains","description":"Use this endpoint to retrieve a list of accommodation chains and their associated brands."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/accommodations/chains","name":"Chains","isWebhook":false,"pointer":"/paths/~1accommodations~1chains/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Chains","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to retrieve a list of accommodation chains and their associated brands."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A chain-branded accommodation is part of a larger corporate group and operates under a recognised brand. The returned information can be used to filter search results by chain or brand across other endpoints."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To obtain the full list of chains, call this endpoint with an empty request body."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" values returned are the codes used as input and output in other API requests, ensuring consistency across your integration."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example of chain:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"  \"Radisson Hotel Group\" with brands such as \"Radisson Blu\" or \"Park Inn by Radisson.\""},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1accommodations~1chains/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/accommodations/chains","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/accommodations/chains","href":"accommodations/accommodations/chains","openApiOperationId":"/accommodations/chains","summary":"Chains"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output","exampleIds":["paths/~1accommodations~1chains/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/output","exampleIds":["paths/~1accommodations~1chains/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1accommodations~1chains/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/output","exampleIds":["paths/~1accommodations~1chains/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output","exampleIds":["paths/~1accommodations~1chains/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/accommodations/chains"},{"label":"Constants","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/constants","routeSlug":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/constants","metadata":{"seo":{"title":"Constants","description":"Retrieve standardised codes and names for accommodation-related entities, such as facilities, room types, bed types, themes, and additional charges."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/accommodations/constants","name":"Constants","isWebhook":false,"pointer":"/paths/~1accommodations~1constants/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Constants","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieve standardised codes and names for accommodation-related entities, such as facilities, room types, bed types, themes, and additional charges."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These constants are canonical identifiers that can be used to filter searches, populate reference data, or ensure consistency across other accommodation endpoints."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To fetch constants in multiple languages, provide IETF language tags (see common/languages)."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sending an empty request body returns all available constants."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"constants"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array to request only specific sections (e.g., "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"accommodation_facilities"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bed_types"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1accommodations~1constants/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input","exampleIds":["paths/~1accommodations~1constants/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/input","exampleIds":["paths/~1accommodations~1constants/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1accommodations~1constants/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/accommodations/constants","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/input","exampleIds":["paths/~1accommodations~1constants/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/accommodations/constants","href":"accommodations/accommodations/constants","openApiOperationId":"/accommodations/constants","summary":"Constants"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/input","exampleIds":["paths/~1accommodations~1constants/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input","exampleIds":["paths/~1accommodations~1constants/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/constants_output","exampleIds":["paths/~1accommodations~1constants/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/constants_output","exampleIds":["paths/~1accommodations~1constants/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1accommodations~1constants/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/constants_output","exampleIds":["paths/~1accommodations~1constants/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/constants_output","exampleIds":["paths/~1accommodations~1constants/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/accommodations/constants"},{"label":"Details","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/details","routeSlug":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/details","metadata":{"seo":{"title":"Details","description":"Retrieve detailed information about accommodation properties that match your search criteria."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/accommodations/details","name":"Details","isWebhook":false,"pointer":"/paths/~1accommodations~1details/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieve detailed information about accommodation properties that match your search criteria."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You must provide at least one of the following parameters: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"accommodations"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"airport"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"region"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"extras"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to request additional information such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"facilities"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"photos"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"policies"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rooms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bundles"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Key points:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can request data in multiple languages using IETF language tags."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint provides static information about properties; availability and pricing are retrieved via other endpoints."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Passing an empty "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"extras"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array returns only the core property details."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum 100 accommodation IDs can be queried in a single request."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1accommodations~1details/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/detailsInput","exampleIds":["paths/~1accommodations~1details/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/detailsInput","exampleIds":["paths/~1accommodations~1details/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1accommodations~1details/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/accommodations/details","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/detailsInput","exampleIds":["paths/~1accommodations~1details/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/accommodations/details","href":"accommodations/accommodations/details","openApiOperationId":"/accommodations/details","summary":"Details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/detailsInput","exampleIds":["paths/~1accommodations~1details/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/detailsInput","exampleIds":["paths/~1accommodations~1details/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/detailsOutput","exampleIds":["paths/~1accommodations~1details/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/detailsOutput","exampleIds":["paths/~1accommodations~1details/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1accommodations~1details/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/detailsOutput","exampleIds":["paths/~1accommodations~1details/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/detailsOutput","exampleIds":["paths/~1accommodations~1details/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/accommodations/details"},{"label":"Updates","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/details/changes","routeSlug":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/details/changes","metadata":{"seo":{"title":"Updates","description":"Use this endpoint to track accommodations that have opened, closed, or had content updates since a specific timestamp."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/accommodations/details/changes","name":"Updates","isWebhook":false,"pointer":"/paths/~1accommodations~1details~1changes/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Updates","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to track accommodations that have opened, closed, or had content updates since a specific timestamp."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Changes can include updates to general information, facilities, rooms, photos, payments, and more."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Key points"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can filter results by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp from the response to fetch subsequent updates."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Combine this endpoint with "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/details"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accommodations/details"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to keep your local accommodation cache up to date."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum number of IDs returned is approximately 5000 per request."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1accommodations~1details~1changes/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/changesInput","exampleIds":["paths/~1accommodations~1details~1changes/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/changesInput","exampleIds":["paths/~1accommodations~1details~1changes/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1accommodations~1details~1changes/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/accommodations/details/changes","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/changesInput","exampleIds":["paths/~1accommodations~1details~1changes/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/accommodations/details/changes","href":"accommodations/accommodations/details/changes","openApiOperationId":"/accommodations/details/changes","summary":"Updates"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/changesInput","exampleIds":["paths/~1accommodations~1details~1changes/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/changesInput","exampleIds":["paths/~1accommodations~1details~1changes/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/changesOutput","exampleIds":["paths/~1accommodations~1details~1changes/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/changesOutput","exampleIds":["paths/~1accommodations~1details~1changes/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1accommodations~1details~1changes/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/changesOutput","exampleIds":["paths/~1accommodations~1details~1changes/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/changesOutput","exampleIds":["paths/~1accommodations~1details~1changes/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/accommodations/details/changes"},{"label":"Reviews","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/reviews","routeSlug":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/reviews","metadata":{"seo":{"title":"Reviews","description":"This endpoint provides access to reviews for specified accommodations, allowing you to retrieve traveller feedback associated with a particular property. The reviews returned can be filtered and sorted, with the option to limit the number of reviews per accommodation by specifying the rows parameter. Please note that the ratings score is based on all traveller traffic across Booking.com, and may not necessarily reflect the experience of your own customers. If you choose to display or use these ratings and reviews, you are responsible for ensuring that your travellers are properly informed about what these scores represent."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/accommodations/reviews","name":"Reviews","isWebhook":false,"pointer":"/paths/~1accommodations~1reviews/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reviews","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint provides access to reviews for specified accommodations, allowing you to retrieve traveller feedback associated with a particular property."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The reviews returned can be "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/accommodations/filter-sorting"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"filtered and sorted"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", with the option to limit the number of reviews per accommodation by specifying the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rows"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Please note that the ratings "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"score is based on all traveller traffic across Booking.com"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and may not necessarily reflect the experience of your own customers."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" If you choose to display or use these ratings and reviews, you are responsible for ensuring that your travellers are properly informed about what these scores represent."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1accommodations~1reviews/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/reviewsInput","exampleIds":["paths/~1accommodations~1reviews/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/reviewsInput","exampleIds":["paths/~1accommodations~1reviews/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1accommodations~1reviews/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/accommodations/reviews","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/reviewsInput","exampleIds":["paths/~1accommodations~1reviews/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/accommodations/reviews","href":"accommodations/accommodations/reviews","openApiOperationId":"/accommodations/reviews","summary":"Reviews"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/reviewsInput","exampleIds":["paths/~1accommodations~1reviews/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/reviewsInput","exampleIds":["paths/~1accommodations~1reviews/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/reviewsOutput","exampleIds":["paths/~1accommodations~1reviews/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/reviewsOutput","exampleIds":["paths/~1accommodations~1reviews/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1accommodations~1reviews/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/reviewsOutput","exampleIds":["paths/~1accommodations~1reviews/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/reviewsOutput","exampleIds":["paths/~1accommodations~1reviews/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/accommodations/reviews"},{"label":"Review and scores","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/reviews/scores","routeSlug":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/reviews/scores","metadata":{"seo":{"title":"Review and scores","description":"This endpoint returns score distribution and score breakdown for the specified accommodations. The scores information can be filtered by reviewer parameters and languages."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/accommodations/reviews/scores","name":"Review and scores","isWebhook":false,"pointer":"/paths/~1accommodations~1reviews~1scores/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Review and scores","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This endpoint returns score distribution and score breakdown for the specified accommodations. The scores information can be filtered by reviewer parameters and languages."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1accommodations~1reviews~1scores/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/reviewsScores_input","exampleIds":["paths/~1accommodations~1reviews~1scores/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/reviewsScores_input","exampleIds":["paths/~1accommodations~1reviews~1scores/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1accommodations~1reviews~1scores/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/accommodations/reviews/scores","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/reviewsScores_input","exampleIds":["paths/~1accommodations~1reviews~1scores/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/accommodations/reviews/scores","href":"accommodations/accommodations/reviews/scores","openApiOperationId":"/accommodations/reviews/scores","summary":"Review and scores"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/reviewsScores_input","exampleIds":["paths/~1accommodations~1reviews~1scores/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/reviewsScores_input","exampleIds":["paths/~1accommodations~1reviews~1scores/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/reviewsScores_output","exampleIds":["paths/~1accommodations~1reviews~1scores/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/reviewsScores_output","exampleIds":["paths/~1accommodations~1reviews~1scores/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1accommodations~1reviews~1scores/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/reviewsScores_output","exampleIds":["paths/~1accommodations~1reviews~1scores/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/reviewsScores_output","exampleIds":["paths/~1accommodations~1reviews~1scores/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/accommodations/reviews/scores"},{"label":"Third-party suppliers","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/third-party-suppliers","routeSlug":"/demand/docs/open-api/3.2/demand-api/accommodations/accommodations/third-party-suppliers","metadata":{"seo":{"title":"Third-party suppliers","description":"Use this endpoint to retrieve the list of third-party suppliers that facilitate accommodation inventory on Booking.com."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/accommodations/third-party-suppliers","name":"Third-party suppliers","isWebhook":false,"pointer":"/paths/~1accommodations~1third-party-suppliers/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Third-party suppliers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to retrieve the list of third-party suppliers that facilitate accommodation inventory on Booking.com."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A third-party supplier is an external partner company that provides accommodation inventory through Booking.com. When a product is facilitated by a third-party supplier:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"inventory.third_party"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"inventory.third_party_supplier_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" contains the supplier identifier."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the returned "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" values to match the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"inventory.third_party_supplier_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returned by /accommodations/availability and retrieve supplier information, such as the supplier name and company address."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call this endpoint with an empty request body to retrieve the complete list of suppliers."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1accommodations~1third-party-suppliers/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_500"}},"schemaId":"schema_500","pointer":"/paths/~1accommodations~1third-party-suppliers/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/accommodations/third-party-suppliers","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_500"}},"responseCodes":["200","500"],"pointer":"/accommodations/third-party-suppliers","href":"accommodations/accommodations/third-party-suppliers","openApiOperationId":"/accommodations/third-party-suppliers","summary":"Third-party suppliers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"schema_500","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_500"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/thirdPartySuppliers_output","exampleIds":["paths/~1accommodations~1third-party-suppliers/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/thirdPartySuppliers_output","exampleIds":["paths/~1accommodations~1third-party-suppliers/post/responses/200/content/application~1json/example"]},{"code":"500","description":"Internal server error. Try again later or contact support.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1accommodations~1third-party-suppliers/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1accommodations~1third-party-suppliers/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1accommodations~1third-party-suppliers/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/thirdPartySuppliers_output","exampleIds":["paths/~1accommodations~1third-party-suppliers/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/thirdPartySuppliers_output","exampleIds":["paths/~1accommodations~1third-party-suppliers/post/responses/200/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1accommodations~1third-party-suppliers/post/responses/500/content/application~1json/examples/internal_error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1accommodations~1third-party-suppliers/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/accommodations/third-party-suppliers"}],"content":{"contentType":"group","meta":{"name":"Accommodations"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Accommodation","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This collection includes endpoints related to "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"stays"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" within the connected trip experience. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use these endpoints to:"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"- Search for hotels, apartments, and other accommodation types."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"- Check real-time availability and pricing."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"- Retrieve property details and guest reviews."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/accommodations/search","summary":"Search","prefix":{"name":"post","color":"post"},"badges":[],"link":"/accommodations/accommodations/search","deprecated":false},{"title":"/accommodations/availability","summary":"Availability","prefix":{"name":"post","color":"post"},"badges":[],"link":"/accommodations/accommodations/availability","deprecated":false},{"title":"/accommodations/chains","summary":"Chains","prefix":{"name":"post","color":"post"},"badges":[],"link":"/accommodations/accommodations/chains","deprecated":false},{"title":"/accommodations/constants","summary":"Constants","prefix":{"name":"post","color":"post"},"badges":[],"link":"/accommodations/accommodations/constants","deprecated":false},{"title":"/accommodations/details","summary":"Details","prefix":{"name":"post","color":"post"},"badges":[],"link":"/accommodations/accommodations/details","deprecated":false},{"title":"/accommodations/details/changes","summary":"Updates","prefix":{"name":"post","color":"post"},"badges":[],"link":"/accommodations/accommodations/details/changes","deprecated":false},{"title":"/accommodations/reviews","summary":"Reviews","prefix":{"name":"post","color":"post"},"badges":[],"link":"/accommodations/accommodations/reviews","deprecated":false},{"title":"/accommodations/reviews/scores","summary":"Review and scores","prefix":{"name":"post","color":"post"},"badges":[],"link":"/accommodations/accommodations/reviews/scores","deprecated":false},{"title":"/accommodations/third-party-suppliers","summary":"Third-party suppliers","prefix":{"name":"post","color":"post"},"badges":[],"link":"/accommodations/accommodations/third-party-suppliers","deprecated":false}]}]}]}]}},{"type":"group","label":"Car rentals","link":"/demand/docs/open-api/3.2/demand-api/cars","routeSlug":"/demand/docs/open-api/3.2/demand-api/cars","items":[{"label":"Search car rentals","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/cars/search","routeSlug":"/demand/docs/open-api/3.2/demand-api/cars/search","metadata":{"seo":{"title":"Search car rentals","description":"Use this endpoint to retrieve the available car rentals matching the search criteria."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"search","name":"Search car rentals","isWebhook":false,"pointer":"/paths/~1cars~1search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search car rentals","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Use this endpoint to retrieve the available car rentals matching the search criteria."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1cars~1search/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cars_search_input","exampleIds":["paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByAirport","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByCoordinatesWithResponseLimit","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByPaymentInput","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByCityIdWithSorting"]}},"schemaId":"components/schemas/cars_search_input","exampleIds":["paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByAirport","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByCoordinatesWithResponseLimit","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByPaymentInput","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByCityIdWithSorting"],"pointer":"/paths/~1cars~1search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cars/search","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/cars_search_input","exampleIds":["paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByAirport","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByCoordinatesWithResponseLimit","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByPaymentInput","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByCityIdWithSorting"]}},"responseCodes":["200","400","500"],"pointer":"/cars/search","href":"cars/search","openApiOperationId":"search","summary":"Search car rentals"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/cars_search_input","exampleIds":["paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByAirport","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByCoordinatesWithResponseLimit","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByPaymentInput","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByCityIdWithSorting"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cars_search_input","exampleIds":["paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByAirport","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByCoordinatesWithResponseLimit","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByPaymentInput","paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByCityIdWithSorting"]}},"examples":[{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cars_search_output","exampleIds":["paths/~1cars~1search/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/cars_search_output","exampleIds":["paths/~1cars~1search/post/responses/200/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request is invalid or missing required parameters. Refer to the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handling section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1search/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1cars~1search/post/responses/400/content/application~1json/examples/invalid_parameter"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1search/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1cars~1search/post/responses/400/content/application~1json/examples/invalid_parameter"]},{"code":"500","description":"Internal server error. Try again later or contact support.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1search/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1search/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1cars~1search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/cars_search_output","exampleIds":["paths/~1cars~1search/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cars_search_output","exampleIds":["paths/~1cars~1search/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1search/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1cars~1search/post/responses/400/content/application~1json/examples/invalid_parameter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1search/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1cars~1search/post/responses/400/content/application~1json/examples/invalid_parameter"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1search/post/responses/500/content/application~1json/examples/internal_error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1search/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/cars/search"},{"label":"Car constants","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/cars/constants","routeSlug":"/demand/docs/open-api/3.2/demand-api/cars/constants","metadata":{"seo":{"title":"Car constants","description":"This endpoint returns localised car rental constants used across the Cars API collection, such as extras, fuel policies, payment timings, and transmission types."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"constants","name":"Car constants","isWebhook":false,"pointer":"/paths/~1cars~1constants/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Car constants","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This endpoint returns localised car rental constants used across the Cars API collection, such as extras, fuel policies, payment timings, and transmission types.\n\nIt also returns customer service contact email addresses per requested language for partner support scenarios where Booking.com handles travellers' communication directly. \nTo retrieve all constants, send an empty request body."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1cars~1constants/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cars_constants_input","exampleIds":["paths/~1cars~1constants/post/requestBody/content/application~1json/examples/allConstants","paths/~1cars~1constants/post/requestBody/content/application~1json/examples/specificConstants"]}},"schemaId":"components/schemas/cars_constants_input","exampleIds":["paths/~1cars~1constants/post/requestBody/content/application~1json/examples/allConstants","paths/~1cars~1constants/post/requestBody/content/application~1json/examples/specificConstants"],"pointer":"/paths/~1cars~1constants/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cars/constants","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/cars_constants_input","exampleIds":["paths/~1cars~1constants/post/requestBody/content/application~1json/examples/allConstants","paths/~1cars~1constants/post/requestBody/content/application~1json/examples/specificConstants"]}},"responseCodes":["200","400","500"],"pointer":"/cars/constants","href":"cars/constants","openApiOperationId":"constants","summary":"Car constants"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/cars_constants_input","exampleIds":["paths/~1cars~1constants/post/requestBody/content/application~1json/examples/allConstants","paths/~1cars~1constants/post/requestBody/content/application~1json/examples/specificConstants"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cars_constants_input","exampleIds":["paths/~1cars~1constants/post/requestBody/content/application~1json/examples/allConstants","paths/~1cars~1constants/post/requestBody/content/application~1json/examples/specificConstants"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cars_constants_output","exampleIds":["paths/~1cars~1constants/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/cars_constants_output","exampleIds":["paths/~1cars~1constants/post/responses/200/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request is invalid or missing required parameters. Refer to the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handling section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1constants/post/responses/400/content/application~1json/examples/invalid_parameter"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1constants/post/responses/400/content/application~1json/examples/invalid_parameter"]},{"code":"500","description":"Internal server error. Try again later or contact support.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1constants/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1constants/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1cars~1constants/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/cars_constants_output","exampleIds":["paths/~1cars~1constants/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cars_constants_output","exampleIds":["paths/~1cars~1constants/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1constants/post/responses/400/content/application~1json/examples/invalid_parameter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1constants/post/responses/400/content/application~1json/examples/invalid_parameter"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1constants/post/responses/500/content/application~1json/examples/internal_error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1constants/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/cars/constants"},{"label":"Depots","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/cars/depots","routeSlug":"/demand/docs/open-api/3.2/demand-api/cars/depots","metadata":{"seo":{"title":"Depots","description":"Retrieve a paginated list of car rental depots. Supports incremental updates via the last_modified filter."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"depots","name":"Depots","isWebhook":false,"pointer":"/paths/~1cars~1depots/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Depots","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieve a paginated list of car rental depots. Supports incremental updates via the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_modified"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" filter."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1cars~1depots/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/depots_input","exampleIds":["paths/~1cars~1depots/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/depots_input","exampleIds":["paths/~1cars~1depots/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1cars~1depots/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cars/depots","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/depots_input","exampleIds":["paths/~1cars~1depots/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","500"],"pointer":"/cars/depots","href":"cars/depots","openApiOperationId":"depots","summary":"Depots"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/depots_input","exampleIds":["paths/~1cars~1depots/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/depots_input","exampleIds":["paths/~1cars~1depots/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Depots retrieved successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/depots_output","exampleIds":["paths/~1cars~1depots/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/depots_output","exampleIds":["paths/~1cars~1depots/post/responses/200/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request is invalid or missing required parameters. Refer to the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handling section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots/post/responses/400/content/application~1json/examples/invalid_parameter"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots/post/responses/400/content/application~1json/examples/invalid_parameter"]},{"code":"500","description":"Internal server error. Try again later or contact support.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1cars~1depots/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/depots_output","exampleIds":["paths/~1cars~1depots/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/depots_output","exampleIds":["paths/~1cars~1depots/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots/post/responses/400/content/application~1json/examples/invalid_parameter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots/post/responses/400/content/application~1json/examples/invalid_parameter"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots/post/responses/500/content/application~1json/examples/internal_error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/cars/depots"},{"label":"Depot scores","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/cars/depotscores","routeSlug":"/demand/docs/open-api/3.2/demand-api/cars/depotscores","metadata":{"seo":{"title":"Depot scores","description":"Use this endpoint to retrieve review scores and score breakdowns for depots, including the overall review score and total number of reviews."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"depotScores","name":"Depot scores","isWebhook":false,"pointer":"/paths/~1cars~1depots~1reviews~1scores/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Depot scores","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Use this endpoint to retrieve review scores and score breakdowns for depots, including the overall review score and total number of reviews."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1cars~1depots~1reviews~1scores/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cars_depots_scores_input","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/cars_depots_scores_input","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1cars~1depots~1reviews~1scores/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cars/depots/reviews/scores","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/cars_depots_scores_input","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","500"],"pointer":"/cars/depots/reviews/scores","href":"cars/depotscores","openApiOperationId":"depotScores","summary":"Depot scores"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/cars_depots_scores_input","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cars_depots_scores_input","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cars_depots_scores_output","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/cars_depots_scores_output","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/responses/200/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request is invalid or missing required parameters. Refer to the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handling section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/responses/400/content/application~1json/examples/invalid_parameter"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/responses/400/content/application~1json/examples/invalid_parameter"]},{"code":"500","description":"Internal server error. Try again later or contact support.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1cars~1depots~1reviews~1scores/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/cars_depots_scores_output","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cars_depots_scores_output","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/responses/400/content/application~1json/examples/invalid_parameter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/responses/400/content/application~1json/examples/invalid_parameter"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/responses/500/content/application~1json/examples/internal_error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1depots~1reviews~1scores/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/cars/depots/reviews/scores"},{"label":"Car details","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/cars/details","routeSlug":"/demand/docs/open-api/3.2/demand-api/cars/details","metadata":{"seo":{"title":"Car details","description":"Use this endpoint to fetch car details like bag capacity, number of doors, brand and model, etc."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"details","name":"Car details","isWebhook":false,"pointer":"/paths/~1cars~1details/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Car details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Use this endpoint to fetch car details like bag capacity, number of doors, brand and model, etc."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1cars~1details/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cars_details_input","exampleIds":["paths/~1cars~1details/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/cars_details_input","exampleIds":["paths/~1cars~1details/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1cars~1details/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cars/details","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/cars_details_input","exampleIds":["paths/~1cars~1details/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","500"],"pointer":"/cars/details","href":"cars/details","openApiOperationId":"details","summary":"Car details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/cars_details_input","exampleIds":["paths/~1cars~1details/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cars_details_input","exampleIds":["paths/~1cars~1details/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cars_details_output","exampleIds":["paths/~1cars~1details/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/cars_details_output","exampleIds":["paths/~1cars~1details/post/responses/200/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request is invalid or missing required parameters. Refer to the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handling section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1details/post/responses/400/content/application~1json/examples/invalid_parameter"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1details/post/responses/400/content/application~1json/examples/invalid_parameter"]},{"code":"500","description":"Internal server error. Try again later or contact support.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1details/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1details/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1cars~1details/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/cars_details_output","exampleIds":["paths/~1cars~1details/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cars_details_output","exampleIds":["paths/~1cars~1details/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1details/post/responses/400/content/application~1json/examples/invalid_parameter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1details/post/responses/400/content/application~1json/examples/invalid_parameter"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1details/post/responses/500/content/application~1json/examples/internal_error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1details/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/cars/details"},{"label":"Suppliers","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/cars/suppliers","routeSlug":"/demand/docs/open-api/3.2/demand-api/cars/suppliers","metadata":{"seo":{"title":"Suppliers","description":"Use this endpoint to fetch a list of car rental suppliers. You can use a supplier ID (or an array of them), to retrieve specific details. Alternatively, if you do not add any ID in the request, the response will include all suppliers."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"suppliers","name":"Suppliers","isWebhook":false,"pointer":"/paths/~1cars~1suppliers/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Suppliers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to fetch a list of car rental suppliers. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can use a supplier ID (or an array of them), to retrieve specific details. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Alternatively, if you do not add any ID in the request, the response will include all suppliers."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1cars~1suppliers/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cars_suppliers_input","exampleIds":["paths/~1cars~1suppliers/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/cars_suppliers_input","exampleIds":["paths/~1cars~1suppliers/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1cars~1suppliers/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cars/suppliers","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/cars_suppliers_input","exampleIds":["paths/~1cars~1suppliers/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","500"],"pointer":"/cars/suppliers","href":"cars/suppliers","openApiOperationId":"suppliers","summary":"Suppliers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/cars_suppliers_input","exampleIds":["paths/~1cars~1suppliers/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cars_suppliers_input","exampleIds":["paths/~1cars~1suppliers/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cars_suppliers_output","exampleIds":["paths/~1cars~1suppliers/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/cars_suppliers_output","exampleIds":["paths/~1cars~1suppliers/post/responses/200/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request is invalid or missing required parameters. Refer to the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handling section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1suppliers/post/responses/400/content/application~1json/examples/invalid_parameter"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1suppliers/post/responses/400/content/application~1json/examples/invalid_parameter"]},{"code":"500","description":"Internal server error. Try again later or contact support.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1suppliers/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1suppliers/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1cars~1suppliers/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/cars_suppliers_output","exampleIds":["paths/~1cars~1suppliers/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cars_suppliers_output","exampleIds":["paths/~1cars~1suppliers/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1suppliers/post/responses/400/content/application~1json/examples/invalid_parameter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1suppliers/post/responses/400/content/application~1json/examples/invalid_parameter"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1suppliers/post/responses/500/content/application~1json/examples/internal_error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1suppliers/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/cars/suppliers"}],"content":{"contentType":"group","meta":{"name":"Cars"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Car rentals","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This collection includes endpoints related to "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"car rental"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" services within the connected trip experience."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use these endpoints to:"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"- Search and retrieve car details."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"- Retrieve car specifications, depot locations, and supplier information."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/cars/search","summary":"Search car rentals","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cars/search","deprecated":false},{"title":"/cars/constants","summary":"Car constants","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cars/constants","deprecated":false},{"title":"/cars/depots","summary":"Depots","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cars/depots","deprecated":false},{"title":"/cars/depots/reviews/scores","summary":"Depot scores","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cars/depotscores","deprecated":false},{"title":"/cars/details","summary":"Car details","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cars/details","deprecated":false},{"title":"/cars/suppliers","summary":"Suppliers","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cars/suppliers","deprecated":false}]}]}]}]}},{"type":"separator","label":"Common","content":null},{"type":"group","label":"Locations","link":"/demand/docs/open-api/3.2/demand-api/commonlocations","routeSlug":"/demand/docs/open-api/3.2/demand-api/commonlocations","items":[{"label":"Airports","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/commonlocations/common/locations/airports","routeSlug":"/demand/docs/open-api/3.2/demand-api/commonlocations/common/locations/airports","metadata":{"seo":{"title":"Airports","description":"This endpoint returns a list of airport codes and their names in the selected languages. The airports returned may be filtered by a location id. For example, you can get the list of airports in The Netherlands by passing: {\"country\":\"nl\"}. To get the full list call the endpoint passing an empty body. The airport codes returned are what is used as input and output for other endpoints. This endpoint implements pagination of the results."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/common/locations/airports","name":"Airports","isWebhook":false,"pointer":"/paths/~1common~1locations~1airports/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Airports","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint returns a list of airport codes and their names in the selected languages. The airports returned may be filtered by a location id. For example, you can get the list of airports in The Netherlands by passing: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"country\":\"nl\"}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". To get the full list call the endpoint passing an empty body. The airport codes returned are what is used as input and output for other endpoints. This endpoint implements pagination of the results."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1common~1locations~1airports/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/airportInput","exampleIds":["paths/~1common~1locations~1airports/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/airportInput","exampleIds":["paths/~1common~1locations~1airports/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1common~1locations~1airports/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/common/locations/airports","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/airportInput","exampleIds":["paths/~1common~1locations~1airports/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/common/locations/airports","href":"commonlocations/common/locations/airports","openApiOperationId":"/common/locations/airports","summary":"Airports"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/airportInput","exampleIds":["paths/~1common~1locations~1airports/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/airportInput","exampleIds":["paths/~1common~1locations~1airports/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/airportOutput","exampleIds":["paths/~1common~1locations~1airports/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/airportOutput","exampleIds":["paths/~1common~1locations~1airports/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1common~1locations~1airports/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/airportOutput","exampleIds":["paths/~1common~1locations~1airports/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/airportOutput","exampleIds":["paths/~1common~1locations~1airports/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/common/locations/airports"},{"label":"Cities","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/commonlocations/common/locations/cities","routeSlug":"/demand/docs/open-api/3.2/demand-api/commonlocations/common/locations/cities","metadata":{"seo":{"title":"Cities","description":"This endpoint returns a list of city IDs and their names in the selected languages."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/common/locations/cities","name":"Cities","isWebhook":false,"pointer":"/paths/~1common~1locations~1cities/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cities","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint returns a list of city IDs and their names in the selected languages."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can filter the results by location ID. For example, to retrieve the list of cities in the Netherlands, pass: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"country\":\"nl\"}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To retrieve the bulk list, call the endpoint with an empty request body."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The city IDs returned by this endpoint are used as input and output values in other Demand API endpoints."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If a city ID returned by another Demand API endpoint is not included in the bulk list, retrieve it by passing the ID in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, for example: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"city\":900043160}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A city returned by an ID-specific request may not be included in the bulk list."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1common~1locations~1cities/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/citiesInput","exampleIds":["paths/~1common~1locations~1cities/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/citiesInput","exampleIds":["paths/~1common~1locations~1cities/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1common~1locations~1cities/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/common/locations/cities","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/citiesInput","exampleIds":["paths/~1common~1locations~1cities/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/common/locations/cities","href":"commonlocations/common/locations/cities","openApiOperationId":"/common/locations/cities","summary":"Cities"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/citiesInput","exampleIds":["paths/~1common~1locations~1cities/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/citiesInput","exampleIds":["paths/~1common~1locations~1cities/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/citiesOutput","exampleIds":["paths/~1common~1locations~1cities/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/citiesOutput","exampleIds":["paths/~1common~1locations~1cities/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1common~1locations~1cities/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/citiesOutput","exampleIds":["paths/~1common~1locations~1cities/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/citiesOutput","exampleIds":["paths/~1common~1locations~1cities/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/common/locations/cities"},{"label":"Countries","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/commonlocations/common/locations/countries","routeSlug":"/demand/docs/open-api/3.2/demand-api/commonlocations/common/locations/countries","metadata":{"seo":{"title":"Countries","description":"This endpoint returns a list of country codes and their names in the selected languages. The countries returned may be filtered by a location id. For example, you can get the list of countries that are associated with the European Alps region by passing: {\"region\":1199}. To get the full list call the endpoint passing an empty body. The returned country codes are used as input and output for other endpoints. This endpoint implements pagination of the results."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/common/locations/countries","name":"Countries","isWebhook":false,"pointer":"/paths/~1common~1locations~1countries/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Countries","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint returns a list of country codes and their names in the selected languages. The countries returned may be filtered by a location id. For example, you can get the list of countries that are associated with the European Alps region by passing: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"region\":1199}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To get the full list call the endpoint passing an empty body. The returned country codes are used as input and output for other endpoints. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint implements pagination of the results."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1common~1locations~1countries/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/countriesInput","exampleIds":["paths/~1common~1locations~1countries/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/countriesInput","exampleIds":["paths/~1common~1locations~1countries/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1common~1locations~1countries/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/common/locations/countries","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/countriesInput","exampleIds":["paths/~1common~1locations~1countries/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/common/locations/countries","href":"commonlocations/common/locations/countries","openApiOperationId":"/common/locations/countries","summary":"Countries"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/countriesInput","exampleIds":["paths/~1common~1locations~1countries/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/countriesInput","exampleIds":["paths/~1common~1locations~1countries/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/countriesOutput","exampleIds":["paths/~1common~1locations~1countries/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/countriesOutput","exampleIds":["paths/~1common~1locations~1countries/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1common~1locations~1countries/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/countriesOutput","exampleIds":["paths/~1common~1locations~1countries/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/countriesOutput","exampleIds":["paths/~1common~1locations~1countries/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/common/locations/countries"},{"label":"Districts","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/commonlocations/common/locations/districts","routeSlug":"/demand/docs/open-api/3.2/demand-api/commonlocations/common/locations/districts","metadata":{"seo":{"title":"Districts","description":"This endpoint returns a list of districts with translations in the selected languages. The districts returned may be filtered by a location id. For example, you can get the list of districts in Amsterdam by passing: {\"city\":-2140479}. To get the full list call the endpoint passing an empty body. The district ids returned are what is used as input and output for other endpoints. This endpoint implements pagination of the results."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/common/locations/districts","name":"Districts","isWebhook":false,"pointer":"/paths/~1common~1locations~1districts/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Districts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint returns a list of districts with translations in the selected languages. The districts returned may be filtered by a location id. For example, you can get the list of districts in Amsterdam by passing: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"city\":-2140479}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To get the full list call the endpoint passing an empty body. The district ids returned are what is used as input and output for other endpoints."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This endpoint implements pagination of the results."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1common~1locations~1districts/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/districtsInput","exampleIds":["paths/~1common~1locations~1districts/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/districtsInput","exampleIds":["paths/~1common~1locations~1districts/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1common~1locations~1districts/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/common/locations/districts","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/districtsInput","exampleIds":["paths/~1common~1locations~1districts/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/common/locations/districts","href":"commonlocations/common/locations/districts","openApiOperationId":"/common/locations/districts","summary":"Districts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/districtsInput","exampleIds":["paths/~1common~1locations~1districts/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/districtsInput","exampleIds":["paths/~1common~1locations~1districts/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/districtsOutput","exampleIds":["paths/~1common~1locations~1districts/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/districtsOutput","exampleIds":["paths/~1common~1locations~1districts/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1common~1locations~1districts/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/districtsOutput","exampleIds":["paths/~1common~1locations~1districts/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/districtsOutput","exampleIds":["paths/~1common~1locations~1districts/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/common/locations/districts"},{"label":"Landmarks","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/commonlocations/common/locations/landmarks","routeSlug":"/demand/docs/open-api/3.2/demand-api/commonlocations/common/locations/landmarks","metadata":{"seo":{"title":"Landmarks","description":"This endpoint returns a list of relevant geographical landmark codes and their names in the selected languages. The landmarks returned may be filtered by a location id. For example, you can get the list of landmarks that are associated with the city of Paris in France by passing: {\"city\":-1456928}. To get the full list call the endpoint passing an empty body. The landmark codes returned are what is used as input and output for other endpoints. This endpoint implements pagination of the results."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/common/locations/landmarks","name":"Landmarks","isWebhook":false,"pointer":"/paths/~1common~1locations~1landmarks/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Landmarks","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint returns a list of relevant geographical landmark codes and their names in the selected languages. The landmarks returned may be filtered by a location id. For example, you can get the list of landmarks that are associated with the city of Paris in France by passing: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"city\":-1456928}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To get the full list call the endpoint passing an empty body. The landmark codes returned are what is used as input and output for other endpoints. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint implements pagination of the results."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1common~1locations~1landmarks/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/landmarksInput","exampleIds":["paths/~1common~1locations~1landmarks/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/landmarksInput","exampleIds":["paths/~1common~1locations~1landmarks/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1common~1locations~1landmarks/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/common/locations/landmarks","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/landmarksInput","exampleIds":["paths/~1common~1locations~1landmarks/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/common/locations/landmarks","href":"commonlocations/common/locations/landmarks","openApiOperationId":"/common/locations/landmarks","summary":"Landmarks"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/landmarksInput","exampleIds":["paths/~1common~1locations~1landmarks/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/landmarksInput","exampleIds":["paths/~1common~1locations~1landmarks/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/landmarksOutput","exampleIds":["paths/~1common~1locations~1landmarks/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/landmarksOutput","exampleIds":["paths/~1common~1locations~1landmarks/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1common~1locations~1landmarks/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/landmarksOutput","exampleIds":["paths/~1common~1locations~1landmarks/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/landmarksOutput","exampleIds":["paths/~1common~1locations~1landmarks/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/common/locations/landmarks"},{"label":"Regions","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/commonlocations/common/locations/regions","routeSlug":"/demand/docs/open-api/3.2/demand-api/commonlocations/common/locations/regions","metadata":{"seo":{"title":"Regions","description":"This endpoint returns a list of regions with translations in the selected languages. The regions returned may be filtered by a location id. For example, you can get the list of regions in the Netherlands or that the Netherlands is a part of by passing: {\"country\":\"nl\"}. To get the full list call the endpoint passing an empty body. The region ids returned are what is used as input and output for other endpoints. This endpoint implements pagination of the results."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/common/locations/regions","name":"Regions","isWebhook":false,"pointer":"/paths/~1common~1locations~1regions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Regions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint returns a list of regions with translations in the selected languages. The regions returned may be filtered by a location id. For example, you can get the list of regions in the Netherlands or that the Netherlands is a part of by passing: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"country\":\"nl\"}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". To get the full list call the endpoint passing an empty body. The region ids returned are what is used as input and output for other endpoints. This endpoint implements pagination of the results."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1common~1locations~1regions/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/regionsInput","exampleIds":["paths/~1common~1locations~1regions/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/regionsInput","exampleIds":["paths/~1common~1locations~1regions/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1common~1locations~1regions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/common/locations/regions","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/regionsInput","exampleIds":["paths/~1common~1locations~1regions/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/common/locations/regions","href":"commonlocations/common/locations/regions","openApiOperationId":"/common/locations/regions","summary":"Regions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/regionsInput","exampleIds":["paths/~1common~1locations~1regions/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/regionsInput","exampleIds":["paths/~1common~1locations~1regions/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/regionsOutput","exampleIds":["paths/~1common~1locations~1regions/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/regionsOutput","exampleIds":["paths/~1common~1locations~1regions/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1common~1locations~1regions/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/regionsOutput","exampleIds":["paths/~1common~1locations~1regions/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/regionsOutput","exampleIds":["paths/~1common~1locations~1regions/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/common/locations/regions"}],"content":{"contentType":"group","meta":{"name":"Common/locations"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Locations","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This collection provides standardised "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"location identifiers"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for geographical entities such as airports, countries, cities, and regions. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the returned identifiers when constructing requests across all travel services API collections, including both accommodation and car rental endpoints."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/common/locations/airports","summary":"Airports","prefix":{"name":"post","color":"post"},"badges":[],"link":"/commonlocations/common/locations/airports","deprecated":false},{"title":"/common/locations/cities","summary":"Cities","prefix":{"name":"post","color":"post"},"badges":[],"link":"/commonlocations/common/locations/cities","deprecated":false},{"title":"/common/locations/countries","summary":"Countries","prefix":{"name":"post","color":"post"},"badges":[],"link":"/commonlocations/common/locations/countries","deprecated":false},{"title":"/common/locations/districts","summary":"Districts","prefix":{"name":"post","color":"post"},"badges":[],"link":"/commonlocations/common/locations/districts","deprecated":false},{"title":"/common/locations/landmarks","summary":"Landmarks","prefix":{"name":"post","color":"post"},"badges":[],"link":"/commonlocations/common/locations/landmarks","deprecated":false},{"title":"/common/locations/regions","summary":"Regions","prefix":{"name":"post","color":"post"},"badges":[],"link":"/commonlocations/common/locations/regions","deprecated":false}]}]}]}]}},{"type":"group","label":"Payments","link":"/demand/docs/open-api/3.2/demand-api/commonpayments","routeSlug":"/demand/docs/open-api/3.2/demand-api/commonpayments","items":[{"label":"Retrieve payment cards","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/commonpayments/common/payments/cards","routeSlug":"/demand/docs/open-api/3.2/demand-api/commonpayments/common/payments/cards","metadata":{"seo":{"title":"Retrieve payment cards","description":"This endpoint returns a list of supported payment cards and their names in English. Examples of payment types are the different credit and debit cards. To get the full list call the endpoint passing an empty body. The codes returned are what is used as input and output for other endpoints."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/common/payments/cards","name":"Retrieve payment cards","isWebhook":false,"pointer":"/paths/~1common~1payments~1cards/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve payment cards","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint returns a list of supported payment cards and their names in English. Examples of payment types are the different credit and debit cards. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To get the full list call the endpoint passing an empty body. The codes returned are what is used as input and output for other endpoints."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1common~1payments~1cards/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/common/payments/cards","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/common/payments/cards","href":"commonpayments/common/payments/cards","openApiOperationId":"/common/payments/cards","summary":"Retrieve payment cards"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cards_output","exampleIds":["paths/~1common~1payments~1cards/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/cards_output","exampleIds":["paths/~1common~1payments~1cards/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1common~1payments~1cards/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/cards_output","exampleIds":["paths/~1common~1payments~1cards/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cards_output","exampleIds":["paths/~1common~1payments~1cards/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/common/payments/cards"},{"label":"Retrieve currency codes","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/commonpayments/common/payments/currencies","routeSlug":"/demand/docs/open-api/3.2/demand-api/commonpayments/common/payments/currencies","metadata":{"seo":{"title":"Retrieve currency codes","description":"This endpoint returns a list of currency codes and their names in the selected languages. To get the full list call the endpoint passing an empty body. The currency codes returned are what is used as input and output for other endpoints."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/common/payments/currencies","name":"Retrieve currency codes","isWebhook":false,"pointer":"/paths/~1common~1payments~1currencies/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve currency codes","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint returns a list of currency codes and their names in the selected languages. To get the full list call the endpoint passing an empty body. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency codes returned are what is used as input and output for other endpoints."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1common~1payments~1currencies/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/currencies_input","exampleIds":["paths/~1common~1payments~1currencies/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/currencies_input","exampleIds":["paths/~1common~1payments~1currencies/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1common~1payments~1currencies/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/common/payments/currencies","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/currencies_input","exampleIds":["paths/~1common~1payments~1currencies/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/common/payments/currencies","href":"commonpayments/common/payments/currencies","openApiOperationId":"/common/payments/currencies","summary":"Retrieve currency codes"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/currencies_input","exampleIds":["paths/~1common~1payments~1currencies/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/currencies_input","exampleIds":["paths/~1common~1payments~1currencies/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/currencies_output","exampleIds":["paths/~1common~1payments~1currencies/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/currencies_output","exampleIds":["paths/~1common~1payments~1currencies/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1common~1payments~1currencies/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/currencies_output","exampleIds":["paths/~1common~1payments~1currencies/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/currencies_output","exampleIds":["paths/~1common~1payments~1currencies/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/common/payments/currencies"}],"content":{"contentType":"group","meta":{"name":"Common/payments"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Payments","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provides generic "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"payment-related identifiers"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", including supported currency codes, payment cards, and relevant metadata for booking flows."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"- Use the returned identifiers when constructing requests across all travel services API collections, including both accommodation and car rental endpoints."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/common/payments/cards","summary":"Retrieve payment cards","prefix":{"name":"post","color":"post"},"badges":[],"link":"/commonpayments/common/payments/cards","deprecated":false},{"title":"/common/payments/currencies","summary":"Retrieve currency codes","prefix":{"name":"post","color":"post"},"badges":[],"link":"/commonpayments/common/payments/currencies","deprecated":false}]}]}]}]}},{"type":"group","label":"Languages","link":"/demand/docs/open-api/3.2/demand-api/commonlanguages","routeSlug":"/demand/docs/open-api/3.2/demand-api/commonlanguages","items":[{"label":"Retrieve language codes","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/commonlanguages/common/languages","routeSlug":"/demand/docs/open-api/3.2/demand-api/commonlanguages/common/languages","metadata":{"seo":{"title":"Retrieve language codes","description":"This endpoint returns a list of human language codes and their names in the corresponding language. To get the full list call the endpoint passing an empty body. The language codes returned are what is used as input and output for other endpoints."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/common/languages","name":"Retrieve language codes","isWebhook":false,"pointer":"/paths/~1common~1languages/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve language codes","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This endpoint returns a list of human language codes and their names in the corresponding language. To get the full list call the endpoint passing an empty body. The language codes returned are what is used as input and output for other endpoints."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1common~1languages/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/common/languages","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/common/languages","href":"commonlanguages/common/languages","openApiOperationId":"/common/languages","summary":"Retrieve language codes"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/languages_output","exampleIds":["paths/~1common~1languages/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/languages_output","exampleIds":["paths/~1common~1languages/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1common~1languages/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/languages_output","exampleIds":["paths/~1common~1languages/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/languages_output","exampleIds":["paths/~1common~1languages/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/common/languages"}],"content":{"contentType":"group","meta":{"name":"Common/languages"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Languages","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to retrieve a list of supported IETF language tag codes."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"- You can use these codes when constructing requests across all travel services API collections, including both accommodation and car rental endpoints."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/common/languages","summary":"Retrieve language codes","prefix":{"name":"post","color":"post"},"badges":[],"link":"/commonlanguages/common/languages","deprecated":false}]}]}]}]}},{"type":"separator","label":"Orders","content":null},{"type":"group","label":"Orders","link":"/demand/docs/open-api/3.2/demand-api/orders","routeSlug":"/demand/docs/open-api/3.2/demand-api/orders","items":[{"label":"Preview an order","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/orders/orders/preview","routeSlug":"/demand/docs/open-api/3.2/demand-api/orders/orders/preview","metadata":{"seo":{"title":"Preview an order","description":"Use this endpoint to validate an order before checkout and calculate the final price, including a detailed price breakdown, payment schedule, and cancellation policies for accommodation and car rentals. Provide the booker's details and preferred currency to receive personalised pricing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"orders/preview","name":"Preview an order","isWebhook":false,"pointer":"/paths/~1orders~1preview/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Preview an order","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to validate an order before checkout and calculate the final price, including a detailed price breakdown, payment schedule, and cancellation policies for accommodation and car rentals. Provide the booker's details and preferred currency to receive personalised pricing."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For accommodations: Include check-in and check-out dates, room allocation, and selected products."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For cars: Include the offer ID and search token. Optionally include selected optional products (such as GPS or child seats) returned by /cars/availability to add extras, and/or an insurance.quote_reference from /cars/availability to attach third-party insurance."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1orders~1preview/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/previewInput","exampleIds":["paths/~1orders~1preview/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1preview/post/requestBody/content/application~1json/examples/car_example"]}},"schemaId":"components/schemas/previewInput","exampleIds":["paths/~1orders~1preview/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1preview/post/requestBody/content/application~1json/examples/car_example"],"pointer":"/paths/~1orders~1preview/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/orders/preview","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/previewInput","exampleIds":["paths/~1orders~1preview/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1preview/post/requestBody/content/application~1json/examples/car_example"]}},"responseCodes":["200","400","500"],"pointer":"/orders/preview","href":"orders/orders/preview","openApiOperationId":"orders/preview","summary":"Preview an order"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/previewInput","exampleIds":["paths/~1orders~1preview/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1preview/post/requestBody/content/application~1json/examples/car_example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/previewInput","exampleIds":["paths/~1orders~1preview/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1preview/post/requestBody/content/application~1json/examples/car_example"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/previewOutput","exampleIds":["paths/~1orders~1preview/post/responses/200/content/application~1json/examples/accommodation_example","paths/~1orders~1preview/post/responses/200/content/application~1json/examples/car_example"]}},"schemaId":"components/schemas/previewOutput","exampleIds":["paths/~1orders~1preview/post/responses/200/content/application~1json/examples/accommodation_example","paths/~1orders~1preview/post/responses/200/content/application~1json/examples/car_example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request is invalid or missing required parameters. Refer to the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handling section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1preview/post/responses/400/content/application~1json/examples/invalid_car_offer","paths/~1orders~1preview/post/responses/400/content/application~1json/examples/invalid_request"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1preview/post/responses/400/content/application~1json/examples/invalid_car_offer","paths/~1orders~1preview/post/responses/400/content/application~1json/examples/invalid_request"]},{"code":"500","description":"Internal server error. Try again later or contact support.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1preview/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1preview/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1orders~1preview/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/previewOutput","exampleIds":["paths/~1orders~1preview/post/responses/200/content/application~1json/examples/accommodation_example","paths/~1orders~1preview/post/responses/200/content/application~1json/examples/car_example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/previewOutput","exampleIds":["paths/~1orders~1preview/post/responses/200/content/application~1json/examples/accommodation_example","paths/~1orders~1preview/post/responses/200/content/application~1json/examples/car_example"]}}},{"code":"400","schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1preview/post/responses/400/content/application~1json/examples/invalid_car_offer","paths/~1orders~1preview/post/responses/400/content/application~1json/examples/invalid_request"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1preview/post/responses/400/content/application~1json/examples/invalid_car_offer","paths/~1orders~1preview/post/responses/400/content/application~1json/examples/invalid_request"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1preview/post/responses/500/content/application~1json/examples/internal_error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1preview/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/orders/preview"},{"label":"Create an order","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/orders/orders/create","routeSlug":"/demand/docs/open-api/3.2/demand-api/orders/orders/create","metadata":{"seo":{"title":"Create an order","description":"Use this endpoint to create and confirm an order using a valid order token and the required payment information."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/orders/create","name":"Create an order","isWebhook":false,"pointer":"/paths/~1orders~1create/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create an order","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Use this endpoint to create and confirm an order using a valid order token and the required payment information."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1orders~1create/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ordersCreateInput","exampleIds":["paths/~1orders~1create/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/ordersCreateInput","exampleIds":["paths/~1orders~1create/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1orders~1create/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/orders/create","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ordersCreateInput","exampleIds":["paths/~1orders~1create/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","403","409","500"],"pointer":"/orders/create","href":"orders/orders/create","openApiOperationId":"/orders/create","summary":"Create an order"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/ordersCreateInput","exampleIds":["paths/~1orders~1create/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ordersCreateInput","exampleIds":["paths/~1orders~1create/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The order was successfully created. The response includes the reservation details.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ordersCreateOutput","exampleIds":["paths/~1orders~1create/post/responses/200/content/application~1json/examples/accommodation_example","paths/~1orders~1create/post/responses/200/content/application~1json/examples/car_example"]}},"schemaId":"components/schemas/ordersCreateOutput","exampleIds":["paths/~1orders~1create/post/responses/200/content/application~1json/examples/accommodation_example","paths/~1orders~1create/post/responses/200/content/application~1json/examples/car_example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request is invalid or missing required parameters. Refer to the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handling section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/400/content/application~1json/examples/expired_token","paths/~1orders~1create/post/responses/400/content/application~1json/examples/invalid_token"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/400/content/application~1json/examples/expired_token","paths/~1orders~1create/post/responses/400/content/application~1json/examples/invalid_token"]},{"code":"403","description":"Returned when the requested endpoint is not available in sandbox. Use the production environment instead.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/403/content/application~1json/examples/sandbox_blocked"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/403/content/application~1json/examples/sandbox_blocked"]},{"code":"409","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request could not be completed due to a conflict. This may occur if:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The order contains unavailable items."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A reservation already exists for the same request (duplicate submission)."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refer to the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handling section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_duplicate_response","exampleIds":["paths/~1orders~1create/post/responses/409/content/application~1json/examples/order_unavailable","paths/~1orders~1create/post/responses/409/content/application~1json/examples/duplicate_car_reservation"]}},"schemaId":"components/schemas/error_duplicate_response","exampleIds":["paths/~1orders~1create/post/responses/409/content/application~1json/examples/order_unavailable","paths/~1orders~1create/post/responses/409/content/application~1json/examples/duplicate_car_reservation"]},{"code":"500","description":"Internal server error. Try again later or contact support.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1orders~1create/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ordersCreateOutput","exampleIds":["paths/~1orders~1create/post/responses/200/content/application~1json/examples/accommodation_example","paths/~1orders~1create/post/responses/200/content/application~1json/examples/car_example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ordersCreateOutput","exampleIds":["paths/~1orders~1create/post/responses/200/content/application~1json/examples/accommodation_example","paths/~1orders~1create/post/responses/200/content/application~1json/examples/car_example"]}}},{"code":"400","schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/400/content/application~1json/examples/expired_token","paths/~1orders~1create/post/responses/400/content/application~1json/examples/invalid_token"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/400/content/application~1json/examples/expired_token","paths/~1orders~1create/post/responses/400/content/application~1json/examples/invalid_token"]}}},{"code":"403","schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/403/content/application~1json/examples/sandbox_blocked"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/403/content/application~1json/examples/sandbox_blocked"]}}},{"code":"409","schemaId":"components/schemas/error_duplicate_response","exampleIds":["paths/~1orders~1create/post/responses/409/content/application~1json/examples/order_unavailable","paths/~1orders~1create/post/responses/409/content/application~1json/examples/duplicate_car_reservation"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_duplicate_response","exampleIds":["paths/~1orders~1create/post/responses/409/content/application~1json/examples/order_unavailable","paths/~1orders~1create/post/responses/409/content/application~1json/examples/duplicate_car_reservation"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/500/content/application~1json/examples/internal_error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/orders/create"},{"label":"Orders details","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/orders/orders/details","routeSlug":"/demand/docs/open-api/3.2/demand-api/orders/orders/details","metadata":{"seo":{"title":"Orders details","description":"Use this endpoint to retrieve detailed information about existing orders across supported travel services. Use it to synchronise internal systems, monitor booking updates, and generate reporting or analytics across travel services."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/orders/details","name":"Orders details","isWebhook":false,"pointer":"/paths/~1orders~1details/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Orders details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to retrieve detailed information about existing orders across supported travel services. Use it to synchronise internal systems, monitor booking updates, and generate reporting or analytics across travel services."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can query orders using one of the following filter types:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creation"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"update date"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — retrieve orders created or updated within a 7-day range."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Travel dates"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — filter by service start or end date (up to 7 days)."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Order"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"reservation ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — fetch details for specific orders."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Notes:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'currency' is a required field and must be a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"three-letter ISO 4217 code"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'services' restricts results to one or more travel services: accommodations, cars, flights, attractions, or taxis."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint is ideal for:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Displaying booking details in partner dashboards or traveller confirmation pages."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieving payment information for invoicing or reconciliation workflows."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Performing reporting, or analytics across all travel services."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/orders-api/order-details"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reporting and reconciliation guide"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1orders~1details/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_501","exampleIds":["paths/~1orders~1details/post/requestBody/content/application~1json/examples/byCreated","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byUpdated","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byStart","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byEnd","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byOrders","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byReservations","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byPage"]}},"schemaId":"schema_501","exampleIds":["paths/~1orders~1details/post/requestBody/content/application~1json/examples/byCreated","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byUpdated","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byStart","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byEnd","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byOrders","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byReservations","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byPage"],"pointer":"/paths/~1orders~1details/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/orders/details","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_501","exampleIds":["paths/~1orders~1details/post/requestBody/content/application~1json/examples/byCreated","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byUpdated","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byStart","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byEnd","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byOrders","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byReservations","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byPage"]}},"responseCodes":["200"],"pointer":"/orders/details","href":"orders/orders/details","openApiOperationId":"/orders/details","summary":"Orders details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"schema_501","exampleIds":["paths/~1orders~1details/post/requestBody/content/application~1json/examples/byCreated","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byUpdated","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byStart","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byEnd","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byOrders","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byReservations","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byPage"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_501","exampleIds":["paths/~1orders~1details/post/requestBody/content/application~1json/examples/byCreated","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byUpdated","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byStart","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byEnd","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byOrders","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byReservations","paths/~1orders~1details/post/requestBody/content/application~1json/examples/byPage"]}},"examples":[{},{},{},{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response. Returns a list of orders matching the requested filter criteria.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ordersDetailsOutput","exampleIds":["paths/~1orders~1details/post/responses/200/content/application~1json/examples/accommodation","paths/~1orders~1details/post/responses/200/content/application~1json/examples/car","paths/~1orders~1details/post/responses/200/content/application~1json/examples/mixed"]}},"schemaId":"components/schemas/ordersDetailsOutput","exampleIds":["paths/~1orders~1details/post/responses/200/content/application~1json/examples/accommodation","paths/~1orders~1details/post/responses/200/content/application~1json/examples/car","paths/~1orders~1details/post/responses/200/content/application~1json/examples/mixed"]}],"pointer":"/paths/~1orders~1details/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ordersDetailsOutput","exampleIds":["paths/~1orders~1details/post/responses/200/content/application~1json/examples/accommodation","paths/~1orders~1details/post/responses/200/content/application~1json/examples/car","paths/~1orders~1details/post/responses/200/content/application~1json/examples/mixed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ordersDetailsOutput","exampleIds":["paths/~1orders~1details/post/responses/200/content/application~1json/examples/accommodation","paths/~1orders~1details/post/responses/200/content/application~1json/examples/car","paths/~1orders~1details/post/responses/200/content/application~1json/examples/mixed"]}}}],"examples":[]}]}]}]},"httpPath":"/orders/details"},{"label":"Orders with accommodation details","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/orders/orders/details/accommodations","routeSlug":"/demand/docs/open-api/3.2/demand-api/orders/orders/details/accommodations","metadata":{"seo":{"title":"Orders with accommodation details","description":"Use this endpoint to retrieve detailed information for one or more accommodation orders.You can request order details either by reservation or order ID depending on your integration."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/orders/details/accommodations","name":"Orders with accommodation details","isWebhook":false,"pointer":"/paths/~1orders~1details~1accommodations/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Orders with accommodation details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to retrieve detailed information for one or more accommodation orders.You can request order details either by "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"reservation"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"order"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ID depending on your integration."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response includes all key information for each order, including booking status, pricing, commission, cancellation details, and optional extras."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Results are sorted by order creation date in descending order, with the most recently booked orders listed first."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1orders~1details~1accommodations/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_502","exampleIds":["paths/~1orders~1details~1accommodations/post/requestBody/content/application~1json/examples/byOrders","paths/~1orders~1details~1accommodations/post/requestBody/content/application~1json/examples/byReservations"]}},"schemaId":"schema_502","exampleIds":["paths/~1orders~1details~1accommodations/post/requestBody/content/application~1json/examples/byOrders","paths/~1orders~1details~1accommodations/post/requestBody/content/application~1json/examples/byReservations"],"pointer":"/paths/~1orders~1details~1accommodations/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/orders/details/accommodations","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_502","exampleIds":["paths/~1orders~1details~1accommodations/post/requestBody/content/application~1json/examples/byOrders","paths/~1orders~1details~1accommodations/post/requestBody/content/application~1json/examples/byReservations"]}},"responseCodes":["200","400","500"],"pointer":"/orders/details/accommodations","href":"orders/orders/details/accommodations","openApiOperationId":"/orders/details/accommodations","summary":"Orders with accommodation details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"schema_502","exampleIds":["paths/~1orders~1details~1accommodations/post/requestBody/content/application~1json/examples/byOrders","paths/~1orders~1details~1accommodations/post/requestBody/content/application~1json/examples/byReservations"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_502","exampleIds":["paths/~1orders~1details~1accommodations/post/requestBody/content/application~1json/examples/byOrders","paths/~1orders~1details~1accommodations/post/requestBody/content/application~1json/examples/byReservations"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response containing accommodation order details.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/outputAccommodationsOrder","exampleIds":["paths/~1orders~1details~1accommodations/post/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/outputAccommodationsOrder","exampleIds":["paths/~1orders~1details~1accommodations/post/responses/200/content/application~1json/examples/default"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request is invalid or contains unsupported parameter values. Refer to the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handling section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response"}},"schemaId":"components/schemas/error_response"},{"code":"500","description":"Internal server error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response"}},"schemaId":"components/schemas/error_response"}],"pointer":"/paths/~1orders~1details~1accommodations/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/outputAccommodationsOrder","exampleIds":["paths/~1orders~1details~1accommodations/post/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/outputAccommodationsOrder","exampleIds":["paths/~1orders~1details~1accommodations/post/responses/200/content/application~1json/examples/default"]}}},{"code":"400","schemaId":"components/schemas/error_response","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response"}}},{"code":"500","schemaId":"components/schemas/error_response","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response"}}}],"examples":[]}]}]}]},"httpPath":"/orders/details/accommodations"},{"label":"Orders with car details","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/orders/orders/details/cars","routeSlug":"/demand/docs/open-api/3.2/demand-api/orders/orders/details/cars","metadata":{"seo":{"title":"Orders with car details","description":"Use this endpoint to retrieve detailed information for one or more car rental orders."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/orders/details/cars","name":"Orders with car details","isWebhook":false,"pointer":"/paths/~1orders~1details~1cars/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Orders with car details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to retrieve detailed information for one or more car rental orders."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can request car order details using your "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"reservation"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ID."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response includes booking and cancellation details, commission, pricing, and optional extras (for example, policies)."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Results are sorted by the date of order creation in descending order, with the most recently booked orders listed first."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1orders~1details~1cars/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_503","exampleIds":["paths/~1orders~1details~1cars/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_503","exampleIds":["paths/~1orders~1details~1cars/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1orders~1details~1cars/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/orders/details/cars","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_503","exampleIds":["paths/~1orders~1details~1cars/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","500"],"pointer":"/orders/details/cars","href":"orders/orders/details/cars","openApiOperationId":"/orders/details/cars","summary":"Orders with car details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"schema_503","exampleIds":["paths/~1orders~1details~1cars/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_503","exampleIds":["paths/~1orders~1details~1cars/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/carsDetailsOutput","exampleIds":["paths/~1orders~1details~1cars/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/carsDetailsOutput","exampleIds":["paths/~1orders~1details~1cars/post/responses/200/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request is invalid or missing required parameters. Refer to the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handling section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1orders~1details~1cars/post/responses/400/content/application~1json/examples/invalid_parameter"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1orders~1details~1cars/post/responses/400/content/application~1json/examples/invalid_parameter"]},{"code":"500","description":"Internal server error. Try again later or contact support.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1orders~1details~1cars/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/carsDetailsOutput","exampleIds":["paths/~1orders~1details~1cars/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/carsDetailsOutput","exampleIds":["paths/~1orders~1details~1cars/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1orders~1details~1cars/post/responses/400/content/application~1json/examples/invalid_parameter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1orders~1details~1cars/post/responses/400/content/application~1json/examples/invalid_parameter"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars/post/responses/500/content/application~1json/examples/internal_error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/orders/details/cars"},{"label":"Orders with flight details","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/orders/orders/details/flights","routeSlug":"/demand/docs/open-api/3.2/demand-api/orders/orders/details/flights","metadata":{"seo":{"title":"Orders with flight details","description":"Use this endpoint to retrieve detailed information for one or more flight orders."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/orders/details/flights","name":"Orders with flight details","isWebhook":false,"pointer":"/paths/~1orders~1details~1flights/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Orders with flight details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to retrieve detailed information for one or more flight orders."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can request flight order details either by "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"order ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or by "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"reservation ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response includes structured order data, including pricing, itinerary segments with IATA airport codes, etc."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint is ideal for:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Displaying flight booking details in traveller dashboards or confirmation pages."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Generating post-booking communications and invoices."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Performing reporting or reconciliation tasks that require accurate itinerary and pricing data."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1orders~1details~1flights/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/flights_input"}},"schemaId":"components/schemas/flights_input","pointer":"/paths/~1orders~1details~1flights/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/orders/details/flights","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/flights_input"}},"responseCodes":["200"],"pointer":"/orders/details/flights","href":"orders/orders/details/flights","openApiOperationId":"/orders/details/flights","summary":"Orders with flight details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/flights_input","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/flights_input"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/flights_output","exampleIds":["paths/~1orders~1details~1flights/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/flights_output","exampleIds":["paths/~1orders~1details~1flights/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1orders~1details~1flights/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/flights_output","exampleIds":["paths/~1orders~1details~1flights/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/flights_output","exampleIds":["paths/~1orders~1details~1flights/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/orders/details/flights"},{"label":"Modify an order","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/orders/orders/modify","routeSlug":"/demand/docs/open-api/3.2/demand-api/orders/orders/modify","metadata":{"seo":{"title":"Modify an order","description":"Use this endpoint to modify certain aspects of an accommodation order, such as credit card details, checkin/checkout dates, and room configurations (guest allocation, guest names, and smoking preferences). See the Orders modification guide for examples and best practices."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/orders/modify","name":"Modify an order","isWebhook":false,"pointer":"/paths/~1orders~1modify/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Modify an order","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to modify certain aspects of an accommodation order, such as credit card details, checkin/checkout dates, and room configurations (guest allocation, guest names, and smoking preferences). See the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/orders-api/order-modify"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Orders modification guide"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for examples and best practices."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1orders~1modify/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_504"}},"schemaId":"schema_504","pointer":"/paths/~1orders~1modify/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/orders/modify","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_504"}},"responseCodes":["200"],"pointer":"/orders/modify","href":"orders/orders/modify","openApiOperationId":"/orders/modify","summary":"Modify an order"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"schema_504","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_504"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful modification","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_505"}},"schemaId":"schema_505"}],"pointer":"/paths/~1orders~1modify/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_505","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_505"}}}],"examples":[]}]}]}]},"httpPath":"/orders/modify"},{"label":"Cancel a travel service","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2/demand-api/orders/orders/cancel","routeSlug":"/demand/docs/open-api/3.2/demand-api/orders/orders/cancel","metadata":{"seo":{"title":"Cancel a travel service","description":"Use this endpoint to cancel a travel service within an existing order. Provide the details of the reservation or insurance policy you want to cancel."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/orders/cancel","name":"Cancel a travel service","isWebhook":false,"pointer":"/paths/~1orders~1cancel/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cancel a travel service","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to cancel a travel service within an existing order. Provide the details of the reservation or insurance policy you want to cancel."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Only one travel service can be cancelled per request."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For step-by-step instructions, see the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/orders-api/cancel-order"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cancellations guide"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_499","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1orders~1cancel/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cancelInput","exampleIds":["paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/car_example","paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/insurance_example"]}},"schemaId":"components/schemas/cancelInput","exampleIds":["paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/car_example","paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/insurance_example"],"pointer":"/paths/~1orders~1cancel/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/orders/cancel","servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_499"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/cancelInput","exampleIds":["paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/car_example","paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/insurance_example"]}},"responseCodes":["200","400","403","409","500"],"pointer":"/orders/cancel","href":"orders/orders/cancel","openApiOperationId":"/orders/cancel","summary":"Cancel a travel service"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/cancelInput","exampleIds":["paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/car_example","paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/insurance_example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cancelInput","exampleIds":["paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/car_example","paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/insurance_example"]}},"examples":[{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Indicates the cancellation request was accepted. Depending on the travel service, the cancellation is completed immediately (accommodations) or continues asynchronously (car rental and car insurance cancellations).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cancelOutput","exampleIds":["paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/accommodations_cancel_output","paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/car_processing_output","paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/insurance_processing_output"]}},"schemaId":"components/schemas/cancelOutput","exampleIds":["paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/accommodations_cancel_output","paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/car_processing_output","paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/insurance_processing_output"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request is invalid or missing required parameters. Refer to the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handling section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response"}},"schemaId":"components/schemas/error_response"},{"code":"403","description":"Returned when the requested endpoint is not available in sandbox. Use the production environment instead.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1cancel/post/responses/403/content/application~1json/examples/sandbox_blocked"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1cancel/post/responses/403/content/application~1json/examples/sandbox_blocked"]},{"code":"409","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cancellation request cannot be processed because the travel service is not eligible for cancellation in its current state (for example, it has already been cancelled or is no longer cancellable). Refer to the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handling section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response"}},"schemaId":"components/schemas/error_response"},{"code":"500","description":"Internal server error. Try again later or contact support.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response"}},"schemaId":"components/schemas/error_response"}],"pointer":"/paths/~1orders~1cancel/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/cancelOutput","exampleIds":["paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/accommodations_cancel_output","paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/car_processing_output","paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/insurance_processing_output"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cancelOutput","exampleIds":["paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/accommodations_cancel_output","paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/car_processing_output","paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/insurance_processing_output"]}}},{"code":"400","schemaId":"components/schemas/error_response","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response"}}},{"code":"403","schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1cancel/post/responses/403/content/application~1json/examples/sandbox_blocked"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1cancel/post/responses/403/content/application~1json/examples/sandbox_blocked"]}}},{"code":"409","schemaId":"components/schemas/error_response","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response"}}},{"code":"500","schemaId":"components/schemas/error_response","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response"}}}],"examples":[]}]}]}]},"httpPath":"/orders/cancel"}],"content":{"contentType":"group","meta":{"name":"Orders"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Orders","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API collection enables "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"management of booking orders"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" within the Demand API."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use these endpoints to:"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"- Preview and create new orders."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"- Check order details."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"- Cancel or modify existing orders."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This collection is required to integrate booking and order management functionality."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/orders/preview","summary":"Preview an order","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/orders/preview","deprecated":false},{"title":"/orders/create","summary":"Create an order","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/orders/create","deprecated":false},{"title":"/orders/details","summary":"Orders details","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/orders/details","deprecated":false},{"title":"/orders/details/accommodations","summary":"Orders with accommodation details","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/orders/details/accommodations","deprecated":false},{"title":"/orders/details/cars","summary":"Orders with car details","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/orders/details/cars","deprecated":false},{"title":"/orders/details/flights","summary":"Orders with flight details","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/orders/details/flights","deprecated":false},{"title":"/orders/modify","summary":"Modify an order","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/orders/modify","deprecated":false},{"title":"/orders/cancel","summary":"Cancel a travel service","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/orders/cancel","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/accommodationId":{"id":"components/schemas/accommodationId","kind":"json-schema","title":"accommodationId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies an accommodation property. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/details"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accommodations/details"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/airportId":{"id":"components/schemas/airportId","kind":"json-schema","title":"airportId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A three-letter code that uniquely identifies an airport as defined by the International Air Transport Association (IATA). The full list can be obtained by calling  "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/commonlocations/common/locations/airports","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/locations/airports"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string","pattern":"^[A-Z]{3}$","example":"AMS"}},"components/schemas/booker":{"id":"components/schemas/booker","kind":"json-schema","title":"Booker","data":{"title":"Booker","description":"The booker's information.","type":"object","properties":{"country":{"description":"The booker country for showing the best price for that user and obeying laws regarding the display of taxes and fees.","type":"string","pattern":"^[a-z]{2}$"},"platform":{"description":"The booker platform for showing the platform based deals and prices.","type":"string","enum":["android","desktop","ios","mobile","tablet"]},"state":{"description":"The booker state for showing the best price for that user and obeying laws regarding the display of taxes and fees. Currently applicable only for country US.","type":"string","pattern":"^[a-z]{2}$"},"travel_purpose":{"description":"The travel purpose of the booker.","type":"string","enum":["business","leisure"]},"user_groups":{"description":"The user groups that the booker is a member of.","type":"array","items":{"type":"string","enum":["authenticated"]}}},"required":["country","platform"]}},"components/schemas/checkin":{"id":"components/schemas/checkin","kind":"json-schema","title":"checkin","data":{"description":"The checkin date. Must be within 500 days in the future and in the format yyyy-mm-dd.","type":"string","format":"date"}},"components/schemas/checkout":{"id":"components/schemas/checkout","kind":"json-schema","title":"checkout","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The checkout date. Must be later than {checkin}. Must be between 1 and 90 days after {checkin}. Must be within 500 days in the future and in the format yyyy-mm-dd."},"children":[]}]}]}],"type":"string","format":"date"}},"components/schemas/cityId":{"id":"components/schemas/cityId","kind":"json-schema","title":"cityId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies a city. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/commonlocations/common/locations/cities","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/locations/cities"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer"}},"components/schemas/coordinates":{"id":"components/schemas/coordinates","kind":"json-schema","title":"AccommodationsSearchCoordinatesOutput","data":{"title":"AccommodationsSearchCoordinatesOutput","description":"Limit the result list to the specified coordinates.","type":"object","properties":{"latitude":{"description":"Specify a latitude (as well as a longitude and radius) to do searches around a specific location.","type":"number","format":"double"},"longitude":{"description":"Specify a longitude (as well as a latitude and radius) to do searches around a specific location.","type":"number","format":"double"},"radius":{"description":"The radius is km to search around the specified latitude and longitude.","type":"number","format":"double"}}}},"components/schemas/countryId":{"id":"components/schemas/countryId","kind":"json-schema","title":"countryId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A two-letter code that uniquely identifies a country. This code is defined by the ISO 3166-1 alpha-2 standard (ISO2) as described here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/commonlocations/common/locations/countries","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/locations/countries"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string","pattern":"^[a-z]{2}$","example":"nl"}},"components/schemas/currencyId":{"id":"components/schemas/currencyId","kind":"json-schema","title":"currencyId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/3.2/demand-api/commonpayments/common/payments/currencies","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/payments/currencies"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":["string","null"],"pattern":"^[A-Z]{3}$","example":"EUR"}},"components/schemas/districtId":{"id":"components/schemas/districtId","kind":"json-schema","title":"districtId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies a district. Typically, districts define known areas within a city. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/commonlocations/common/locations/districts","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/locations/districts"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/extras":{"id":"components/schemas/extras","kind":"json-schema","title":"extras","data":{"description":"Input parameter to request for additional information about the products.","type":"array","items":{"type":"string","enum":["extra_charges","products"]}}},"components/schemas/accommodationFacilityId":{"id":"components/schemas/accommodationFacilityId","kind":"json-schema","title":"accommodationFacilityId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies an accommodation property facility. Examples of facilities are: Parking, Restaurant, Room service etc. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/constants","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accommodations/constants"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/accommodationTypeId":{"id":"components/schemas/accommodationTypeId","kind":"json-schema","title":"accommodationTypeId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies an accommodation property type. Examples of accommodation types are: Apartment, Hostel, Hotel etc. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/constants","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accommodations/constants"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/accommodationBrandId":{"id":"components/schemas/accommodationBrandId","kind":"json-schema","title":"accommodationBrandId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies an accommodation brand. Examples of brands are: Radisson Blu, WestCord Hotels, Westin etc. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/chains","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/accommodations/chains"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/cancellation_type_filter":{"id":"components/schemas/cancellation_type_filter","kind":"json-schema","title":"cancellation_type_filter","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filters the results by cancellation type. Currently, only 'free_cancellation' is supported. This will return all products that can be cancelled without incurring any fees within a specified time frame. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"⚠ DEPRECATED:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The 'non_refundable' cancellation type filter is deprecated and will be removed in further versions."},"children":[]}]}]}],"type":"string","enum":["free_cancellation","non_refundable"]}},"components/schemas/meal_plan_filter":{"id":"components/schemas/meal_plan_filter","kind":"json-schema","title":"meal_plan_filter","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter the result based on the selected meal plan. Example: When specified breakfast_included, it will show the product with free breakfast."},"children":[]}]}]}],"type":"string","enum":["all_inclusive","breakfast_included","full_board","half_board"]}},"components/schemas/paymentTimingFilter":{"id":"components/schemas/paymentTimingFilter","kind":"json-schema","title":"paymentTimingFilter","data":{"description":"This parameter specifies that the results should only return accommodation and blocks that contain the specified payment timings.","type":"string","enum":["pay_at_the_property","pay_online"]}},"components/schemas/roomFacilityId":{"id":"components/schemas/roomFacilityId","kind":"json-schema","title":"roomFacilityId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies an accommodation property room facility. Examples of facilities are: Coffee/Tea maker, TV, Airconditioning, etc. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/constants","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accommodations/constants"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/allocation":{"id":"components/schemas/allocation","kind":"json-schema","title":"allocation","data":{"description":"The exact allocation of guests to rooms.","type":"array","items":{"properties":{"children":{"description":"The children ages for this room.","type":"array","items":{"type":"integer","minimum":0,"maximum":17}},"number_of_adults":{"description":"The number of adults for this room.","type":"integer","minimum":1}},"required":["number_of_adults"]}}},"components/schemas/guests":{"id":"components/schemas/guests","kind":"json-schema","title":"AccommodationsGuests","data":{"title":"AccommodationsGuests","description":"The guest details for the request.","type":"object","properties":{"allocation":{"$ref":"#/components/schemas/allocation"},"children":{"description":"Array with the children ages.","type":"array","items":{"type":"integer","minimum":0,"maximum":17}},"number_of_adults":{"description":"The number of adults for the search.","type":"integer","minimum":1},"number_of_rooms":{"description":"The number of rooms needed.","type":"integer","minimum":1}},"required":["number_of_adults","number_of_rooms"]}},"components/schemas/landmarkId":{"id":"components/schemas/landmarkId","kind":"json-schema","title":"landmarkId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies a relevant geographical landmark, like a monument or a natural attraction. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/commonlocations/common/locations/landmarks","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/locations/landmarks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/page":{"id":"components/schemas/page","kind":"json-schema","title":"page","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination token used to retrieve the next page of results. Obtained from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string"}},"components/schemas/regionId":{"id":"components/schemas/regionId","kind":"json-schema","title":"regionId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies a geographical region. Regions usually define official administrative areas within a country, but may also include multiple countries and in some cases un-official but popular designations for geographical areas. An example of a region that crosses multiple countries is the Alps in Europe. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/commonlocations/common/locations/regions","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/locations/regions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/maximumResults":{"id":"components/schemas/maximumResults","kind":"json-schema","title":"maximumResults","data":{"description":"The maximum number of results to return.","type":"integer","multipleOf":10,"minimum":10,"maximum":100,"default":100}},"components/schemas/searchInput":{"id":"components/schemas/searchInput","kind":"json-schema","title":"AccommodationsSearchInput","data":{"title":"AccommodationsSearchInput","type":"object","properties":{"accommodations":{"type":"array","items":{"$ref":"#/components/schemas/accommodationId"},"maxItems":100},"airport":{"$ref":"#/components/schemas/airportId"},"booker":{"$ref":"#/components/schemas/booker"},"checkin":{"$ref":"#/components/schemas/checkin"},"checkout":{"$ref":"#/components/schemas/checkout"},"city":{"$ref":"#/components/schemas/cityId"},"coordinates":{"$ref":"#/components/schemas/coordinates"},"country":{"$ref":"#/components/schemas/countryId"},"currency":{"$ref":"#/components/schemas/currencyId"},"district":{"$ref":"#/components/schemas/districtId"},"extras":{"$ref":"#/components/schemas/extras"},"filters":{"description":"Filter criteria for the search results","type":"object","properties":{"24_hour_reception":{"description":"Filter the result based if the front desk reception is available 24/7. When specified true, the result will filter the products where front desk is available 24/7.","type":"boolean"},"accommodation_facilities":{"type":"array","items":{"$ref":"#/components/schemas/accommodationFacilityId"}},"accommodation_types":{"type":"array","items":{"$ref":"#/components/schemas/accommodationTypeId"}},"brands":{"type":"array","items":{"$ref":"#/components/schemas/accommodationBrandId"}},"cancellation_type":{"$ref":"#/components/schemas/cancellation_type_filter"},"dormitories":{"description":"This parameter specifies if the results should include dormitory beds or rooms. The default behaviour will include the dormitory beds or rooms with other results. When this flag is set to 'only', the response will only include dormitory beds or rooms. When this flag is set to 'exclude', the response will exclude dormitory beds or rooms. When this flag is set to 'include', the response will include dormitory beds or rooms with other results.","type":"string","default":"include","enum":["include","exclude","only"]},"meal_plan":{"$ref":"#/components/schemas/meal_plan_filter"},"payment":{"description":"The payment filter for the request","type":"object","properties":{"credit_card_required":{"description":"Filter to show accommodations which require credit card","type":"boolean"},"timing":{"$ref":"#/components/schemas/paymentTimingFilter"}}},"price":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If specified, will return only results where the price "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"per night"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" falls in the specified range (inclusive). This filter requires that a currency is passed"},"children":[]}]}]}],"type":"object","properties":{"maximum":{"description":"Set the maximum price per night, in the specified currency, or omit to indicate no upper limit.","type":"number","format":"double"},"minimum":{"description":"Set the minimum price per night, in the specified currency, or omit to indicate no lower limit.","type":"number","format":"double"}}},"rating":{"description":"The rating filter for the request","type":"object","properties":{"minimum_review_score":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Show only hotels with review_score >= that. Review score should be in the range 1 to 10."},"children":[]}]}]}],"type":"integer","minimum":0,"maximum":10},"stars":{"description":"Limit to accommodations with the given number(s) of stars. Stars should be in the range of 1 to 5.","type":"array","items":{"type":"number","minimum":1,"maximum":5}}}},"room_facilities":{"type":"array","items":{"$ref":"#/components/schemas/roomFacilityId"}},"sustainability_certification":{"description":"Filter the result based on if the property has sustainability certification. When specified true, the result will filter and return only the accommodations that have sustainability certification.","type":"boolean"},"travel_proud":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter the result based on if the property is LGBTQ+ friendly. When specified true, the result will filter and return only the accommodations that are Proud Certified."},"children":[]}]}]}],"type":"boolean"}}},"guests":{"$ref":"#/components/schemas/guests"},"landmark":{"$ref":"#/components/schemas/landmarkId"},"page":{"$ref":"#/components/schemas/page"},"region":{"$ref":"#/components/schemas/regionId"},"rows":{"$ref":"#/components/schemas/maximumResults"},"sort":{"description":"The sorting parameters for the response","type":"object","properties":{"by":{"description":"The way to sort your results. NOTE: When ordering by distance please make sure to specify the latitude and longitude!","type":"string","enum":["distance","price","review_score","stars"]},"direction":{"description":"Specifies the sort direction. Please note that descending order is not supported when sorting by distance.","type":"string","enum":["ascending","descending"]}}}},"required":["booker","checkin","checkout","guests"]}},"components/schemas/requestId":{"id":"components/schemas/requestId","kind":"json-schema","title":"requestId","data":{"description":"Uniquely identifies the request. Please provide this identifier when contacting support.","type":"string"}},"components/schemas/commission":{"id":"components/schemas/commission","kind":"json-schema","title":"AccommodationsCommission","data":{"title":"AccommodationsCommission","description":"Commission details for the partner for a given accommodation","type":"object","properties":{"amount":{"description":"The actual commission amount for the partner.","type":"number","format":"double","minimum":0},"percentage":{"description":"Percentage of the fee that will be received as commission.","type":"number","format":"double","minimum":0}}}},"components/schemas/currency":{"id":"components/schemas/currency","kind":"json-schema","title":"currency","data":{"type":"object","properties":{"accommodation":{"$ref":"#/components/schemas/currencyId"},"booker":{"$ref":"#/components/schemas/currencyId"}}}},"components/schemas/deepLinkUrl":{"id":"components/schemas/deepLinkUrl","kind":"json-schema","title":"deepLinkUrl","data":{"description":"A mobile app URL that directs the user to a specific page or content within the Booking.com app. The link can only be used on a device with the Booking.com app installed. It typically includes an Affiliate ID (AID) to attribute bookings to the affiliate partner when users are redirected","type":"string","format":"url"}},"components/schemas/monetaryAmount":{"id":"components/schemas/monetaryAmount","kind":"json-schema","title":"monetaryAmount","data":{"type":"number","format":"double","multipleOf":0.01,"exclusiveMinimum":0}},"components/schemas/priceMultiCurrencyOutput":{"id":"components/schemas/priceMultiCurrencyOutput","kind":"json-schema","title":"AccommodationsPriceMultiCurrency","data":{"title":"AccommodationsPriceMultiCurrency","type":"object","properties":{"accommodation_currency":{"$ref":"#/components/schemas/monetaryAmount"},"booker_currency":{"$ref":"#/components/schemas/monetaryAmount"}}}},"components/schemas/chargeTypeId":{"id":"components/schemas/chargeTypeId","kind":"json-schema","title":"chargeTypeId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies an accommodation charge type. Examples of charges are: VAT, City Tax, etc. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/constants","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accommodations/constants"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":0}},"components/schemas/conditionId":{"id":"components/schemas/conditionId","kind":"json-schema","title":"conditionId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies the condition ID. Find the full list in the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/accommodations/prices-accommodations","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pricing guidelines"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":["integer","null"],"minimum":0}},"components/schemas/display":{"id":"components/schemas/display","kind":"json-schema","title":"display","data":{"description":"Indicates if this charge is included in the display price.","type":"boolean"}},"components/schemas/totalAmountV32":{"id":"components/schemas/totalAmountV32","kind":"json-schema","title":"totalAmountV32","data":{"description":"The total price for this charge.","type":"object","properties":{"accommodation_currency":{"$ref":"#/components/schemas/monetaryAmount"},"booker_currency":{"$ref":"#/components/schemas/monetaryAmount"}}}},"components/schemas/chargeSummarySearchV32":{"id":"components/schemas/chargeSummarySearchV32","kind":"json-schema","title":"AccommodationsSearchChargeSummary","data":{"title":"AccommodationsSearchChargeSummary","description":"A charge summed across multiple products.","type":"object","properties":{"charge":{"$ref":"#/components/schemas/chargeTypeId"},"condition":{"$ref":"#/components/schemas/conditionId"},"included_in":{"title":"ChargeIncludedIn","description":"Indicates where this charge is included","type":"object","properties":{"display":{"$ref":"#/components/schemas/display"}}},"total_amount":{"$ref":"#/components/schemas/totalAmountV32"}}}},"components/schemas/PriceSummarySearchV32":{"id":"components/schemas/PriceSummarySearchV32","kind":"json-schema","title":"OrdersPreviewProductSumPriceOutput","data":{"title":"OrdersPreviewProductSumPriceOutput","description":"The price components of all the products selected summed.","type":"object","properties":{"base":{"description":"The sum base price of all products selected. Does not include any extra charges.","$ref":"#/components/schemas/priceMultiCurrencyOutput"},"charges":{"description":"The sum of charges for all products selected, grouped by charge type.","type":"array","items":{"$ref":"#/components/schemas/chargeSummarySearchV32"}},"display":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The display price that must be shown to the traveller. Equivalent to base + charges where included_in.display=true."},"children":[]}]}]}],"$ref":"#/components/schemas/priceMultiCurrencyOutput"},"total":{"description":"The total sum price. Includes all extra charges of all products.","$ref":"#/components/schemas/priceMultiCurrencyOutput"}}}},"components/schemas/productId":{"id":"components/schemas/productId","kind":"json-schema","title":"productId","data":{"description":"Unique ID of the product.","type":"string"}},"components/schemas/bundleId":{"id":"components/schemas/bundleId","kind":"json-schema","title":"bundleId","data":{"description":"The bundle ID of the product comprising of value added products.","type":"integer"}},"components/schemas/dealV32":{"id":"components/schemas/dealV32","kind":"json-schema","title":"Deal","data":{"title":"Deal","description":"This specifies the deal tagging for the product.","type":["object","null"],"properties":{"discount_percentage":{"description":"Discount percentage of the applied deal.","type":"integer","minimum":1},"public_price":{"description":"Original price of this product, before applying any discounts.","$ref":"#/components/schemas/priceMultiCurrencyOutput"},"tags":{"description":"The tags of all the applied deals.","type":"array","items":{"type":"string","enum":["black_friday","limited_time_deal","logged_in_deal","mobile_rate","seasonal_deal"]}}}}},"components/schemas/inventoryOutputType":{"id":"components/schemas/inventoryOutputType","kind":"json-schema","title":"inventoryOutputType","data":{"description":"Type of inventory - either net or sell rates.","type":"string","enum":["net","sell"]}},"components/schemas/inventoryOutput":{"id":"components/schemas/inventoryOutput","kind":"json-schema","title":"InventoryOutput","data":{"title":"InventoryOutput","type":"object","properties":{"third_party":{"type":"boolean","description":"Indicates whether the product is facilitated by a third-party supplier."},"type":{"$ref":"#/components/schemas/inventoryOutputType"}}}},"components/schemas/productCancellationType":{"id":"components/schemas/productCancellationType","kind":"json-schema","title":"productCancellationType","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cancellation policy applicable to this product: \"free_cancellation\" allows a period for free cancellation, \"non_refundable\" means immediate loss of total amount, \"partially_refundable\" means a portion of the amount may be refunded if the booking is cancelled."},"children":[]}]}]}],"type":"string","enum":["free_cancellation","non_refundable","partially_refundable"]}},"components/schemas/productCancellationPolicySearch":{"id":"components/schemas/productCancellationPolicySearch","kind":"json-schema","title":"AccommodationsProductCancellationPolicy","data":{"title":"AccommodationsProductCancellationPolicy","description":"The cancellation policy for this product.","type":"object","properties":{"free_cancellation_until":{"description":"Until when the order for this product can be cancelled for free.","type":["string","null"],"format":"date-time"},"type":{"$ref":"#/components/schemas/productCancellationType"}}}},"components/schemas/productMealPlanPolicy":{"id":"components/schemas/productMealPlanPolicy","kind":"json-schema","title":"AccommodationsProductMealPlanPolicy","data":{"title":"AccommodationsProductMealPlanPolicy","description":"The meal plan policy for this product.","type":"object","properties":{"meals":{"description":"The meals included in the meal plan.","type":"array","items":{"type":"string","enum":["breakfast","dinner","lunch"]}},"plan":{"description":"The meal plan included in this product.","type":"string","enum":["all_inclusive","breakfast_included","full_board","half_board","no_plan"]}}}},"components/schemas/productPaymentTimings":{"id":"components/schemas/productPaymentTimings","kind":"json-schema","title":"productPaymentTimings","data":{"description":"The payment timings supported by this product.","type":"array","items":{"type":"string","enum":["pay_at_the_property","pay_online_later","pay_online_now"]}}},"components/schemas/productPaymentPolicyNew":{"id":"components/schemas/productPaymentPolicyNew","kind":"json-schema","title":"AccommodationsProductPaymentPolicyNew","data":{"title":"AccommodationsProductPaymentPolicyNew","description":"Payment terms and conditions for this product.","type":"object","properties":{"prepayment_required":{"description":"Whether prepayment is required for this product.","type":"boolean"},"timings":{"$ref":"#/components/schemas/productPaymentTimings"}}}},"components/schemas/productPoliciesSearch":{"id":"components/schemas/productPoliciesSearch","kind":"json-schema","title":"AccommodationsProductPolicies","data":{"title":"AccommodationsProductPolicies","description":"The policies for this product.","type":"object","properties":{"cancellation":{"$ref":"#/components/schemas/productCancellationPolicySearch"},"meal_plan":{"$ref":"#/components/schemas/productMealPlanPolicy"},"payment":{"$ref":"#/components/schemas/productPaymentPolicyNew"}}}},"components/schemas/basePriceV32":{"id":"components/schemas/basePriceV32","kind":"json-schema","title":"basePriceV32","data":{"description":"The base price. It does not include any extra charges.","type":"object","properties":{"accommodation_currency":{"$ref":"#/components/schemas/monetaryAmount"},"booker_currency":{"$ref":"#/components/schemas/monetaryAmount"}}}},"components/schemas/chargeMode":{"id":"components/schemas/chargeMode","kind":"json-schema","title":"chargeMode","data":{"description":"The mode of this charge. Determines how the price is calculated.","type":"string","enum":["calculated_amount","incalculable","percentage","per_day","per_night","per_person_per_day","per_person_per_night","per_person_per_stay","per_stay"]}},"components/schemas/chargePercentage":{"id":"components/schemas/chargePercentage","kind":"json-schema","title":"chargePercentage","data":{"description":"The percentage of 'base' that this charge amounts to. Only applicable when 'mode' is 'percentage'.","type":"number","multipleOf":0.01,"exclusiveMinimum":0,"nullable":true}},"components/schemas/unitAmountV32":{"id":"components/schemas/unitAmountV32","kind":"json-schema","title":"unitAmountV32","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The price per unit for this charge. Only applicable when 'mode' is 'per_day', 'per_night', 'per_person_per_day', 'per_person_per_night', or 'per_person_per_stay'."},"children":[]}]}]}],"type":"object","properties":{"accommodation_currency":{"$ref":"#/components/schemas/monetaryAmount"},"booker_currency":{"$ref":"#/components/schemas/monetaryAmount"}},"nullable":true}},"components/schemas/chargeBreakdownSearchV32":{"id":"components/schemas/chargeBreakdownSearchV32","kind":"json-schema","title":"chargeBreakdownSearchV32","data":{"description":"The charge breakdown. Includes taxes and fees.","type":"array","items":{"title":"AccommodationsCharge","description":"Detailed information about an individual charge, including where it is applied.","type":"object","properties":{"charge":{"$ref":"#/components/schemas/chargeTypeId"},"condition":{"$ref":"#/components/schemas/conditionId"},"included_in":{"title":"ChargeIncludedIn","description":"Indicates where this charge is included","type":"object","properties":{"display":{"$ref":"#/components/schemas/display"}}},"mode":{"$ref":"#/components/schemas/chargeMode"},"percentage":{"$ref":"#/components/schemas/chargePercentage"},"total_amount":{"$ref":"#/components/schemas/totalAmountV32"},"unit_amount":{"$ref":"#/components/schemas/unitAmountV32"}}}}},"components/schemas/displayPriceV32":{"id":"components/schemas/displayPriceV32","kind":"json-schema","title":"displayPriceV32","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The display price that must be shown to the traveller in accordance with local booker protection laws. This price includes the base accommodation cost and all charges that are legally required to be part of the displayed amount. Equivalent to base + charges where included_in.display=true."},"children":[]}]}]}],"type":"object","properties":{"accommodation_currency":{"$ref":"#/components/schemas/monetaryAmount"},"booker_currency":{"$ref":"#/components/schemas/monetaryAmount"}}}},"components/schemas/totalPriceV32":{"id":"components/schemas/totalPriceV32","kind":"json-schema","title":"totalPriceV32","data":{"description":"The total price. Includes all extra charges.","type":"object","properties":{"accommodation_currency":{"$ref":"#/components/schemas/monetaryAmount"},"booker_currency":{"$ref":"#/components/schemas/monetaryAmount"}}}},"components/schemas/priceSearchV32":{"id":"components/schemas/priceSearchV32","kind":"json-schema","title":"AccommodationsSearchProductPrice","data":{"title":"AccommodationsSearchProductPrice","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contains the price components of an accommodation product. The 'base', 'display', 'chargeable_online' prices, and 'charges' are returned only when explicitly requested using extras=extra_charges."},"children":[]}]}]}],"type":"object","properties":{"base":{"$ref":"#/components/schemas/basePriceV32"},"charges":{"$ref":"#/components/schemas/chargeBreakdownSearchV32"},"display":{"$ref":"#/components/schemas/displayPriceV32"},"total":{"$ref":"#/components/schemas/totalPriceV32"}}}},"components/schemas/roomIdString":{"id":"components/schemas/roomIdString","kind":"json-schema","title":"roomIdString","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique identifier for a specific room within an accommodation property. You can retrieve the full list of available room IDs by calling "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/details"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accommodations/details"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string"}},"components/schemas/product":{"id":"components/schemas/product","kind":"json-schema","title":"AccommodationsSearchProductOutput","data":{"title":"AccommodationsSearchProductOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Details product information. It requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"extras\":[\"products\"]}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"object","properties":{"id":{"$ref":"#/components/schemas/productId"},"bundle":{"$ref":"#/components/schemas/bundleId"},"children":{"description":"The ages of the children allocated to this product.","type":"array","items":{"type":"integer","minimum":0,"maximum":17}},"deal":{"$ref":"#/components/schemas/dealV32"},"inventory":{"$ref":"#/components/schemas/inventoryOutput"},"number_available":{"description":"Number of rooms available at this price.","type":"integer","minimum":1,"nullable":true},"number_of_adults":{"description":"The number of adults allocated to this product.","type":"integer","minimum":1},"policies":{"$ref":"#/components/schemas/productPoliciesSearch"},"price":{"$ref":"#/components/schemas/priceSearchV32"},"room":{"$ref":"#/components/schemas/roomIdString"}}}},"components/schemas/url":{"id":"components/schemas/url","kind":"json-schema","title":"url","data":{"description":"Internet address for the property page on Booking.com.","type":"string","format":"url"}},"components/schemas/accommodationSearch":{"id":"components/schemas/accommodationSearch","kind":"json-schema","title":"AccommodationsSearchDataOutput","data":{"title":"AccommodationsSearchDataOutput","description":"","type":"object","properties":{"id":{"$ref":"#/components/schemas/accommodationId"},"commission":{"$ref":"#/components/schemas/commission"},"currency":{"$ref":"#/components/schemas/currency"},"deep_link_url":{"$ref":"#/components/schemas/deepLinkUrl"},"price":{"$ref":"#/components/schemas/PriceSummarySearchV32"},"products":{"type":"array","items":{"$ref":"#/components/schemas/product"}},"url":{"$ref":"#/components/schemas/url"}}}},"components/schemas/searchOutput":{"id":"components/schemas/searchOutput","kind":"json-schema","title":"AccommodationsSearchOutput","data":{"title":"AccommodationsSearchOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/accommodationSearch"}},"metadata":{"title":"MetadataOutput","type":"object","properties":{"next_page":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":"string","nullable":true}}}}}},"components/schemas/availability_extras":{"id":"components/schemas/availability_extras","kind":"json-schema","title":"availability_extras","data":{"description":"Input parameter to request for additional information about this product.","type":"array","items":{"type":"string","enum":["extra_charges"]}}},"components/schemas/free_cancellation_type_filter":{"id":"components/schemas/free_cancellation_type_filter","kind":"json-schema","title":"free_cancellation_type_filter","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filters the result for the cancellation type specified. Possible values are free_cancellation. The result will contain all the products with free_cancellation."},"children":[]}]}]}],"type":"string","enum":["free_cancellation"]}},"components/schemas/paymentInputFilter":{"id":"components/schemas/paymentInputFilter","kind":"json-schema","title":"paymentInputFilter","data":{"description":"Payment input information to filter results.","properties":{"timing":{"$ref":"#/components/schemas/paymentTimingFilter"}}}},"components/schemas/filters":{"id":"components/schemas/filters","kind":"json-schema","title":"AccommodationsAvailabilityFiltersInput","data":{"title":"AccommodationsAvailabilityFiltersInput","description":"The filters to apply in this availability request.","type":"object","properties":{"cancellation_type":{"$ref":"#/components/schemas/free_cancellation_type_filter"},"meal_plan":{"$ref":"#/components/schemas/meal_plan_filter"},"payment":{"$ref":"#/components/schemas/paymentInputFilter"}}}},"components/schemas/availabilityInput":{"id":"components/schemas/availabilityInput","kind":"json-schema","title":"AccommodationsAvailabilityInput","data":{"title":"AccommodationsAvailabilityInput","type":"object","properties":{"accommodations":{"type":"array","items":{"$ref":"#/components/schemas/accommodationId"}},"booker":{"$ref":"#/components/schemas/booker"},"checkin":{"$ref":"#/components/schemas/checkin"},"checkout":{"$ref":"#/components/schemas/checkout"},"currency":{"$ref":"#/components/schemas/currencyId"},"extras":{"$ref":"#/components/schemas/availability_extras"},"filters":{"$ref":"#/components/schemas/filters"},"guests":{"$ref":"#/components/schemas/guests"}},"required":["accommodations","booker","checkin","checkout","guests"]}},"components/schemas/thirdPartySupplierId":{"id":"components/schemas/thirdPartySupplierId","kind":"json-schema","title":"thirdPartySupplierId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier of a third-party accommodation supplier. Use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/accommodations/third-party-suppliers"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/accommodations/third-party-suppliers"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the full list of suppliers and their details."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/availabilityInventoryOutput":{"id":"components/schemas/availabilityInventoryOutput","kind":"json-schema","title":"AccommodationsAvailabilityInventoryOutput","data":{"title":"AccommodationsAvailabilityInventoryOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Inventory details for an accommodation product returned by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/accommodations/availability"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"object","properties":{"third_party":{"type":"boolean","description":"Indicates whether the product is facilitated by a third-party supplier."},"third_party_supplier_id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier of the third-party supplier that facilitates this product. Returned only for third-party inventory (when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"third_party"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). The field may be omitted if the supplier information is unavailable. Use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/accommodations/third-party-suppliers"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/accommodations/third-party-suppliers"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve supplier details."},"children":[]}]}]}],"$ref":"#/components/schemas/thirdPartySupplierId"},"type":{"$ref":"#/components/schemas/inventoryOutputType"}}}},"components/schemas/children":{"id":"components/schemas/children","kind":"json-schema","title":"children","data":{"description":"The information about maximum number of children and their allowed ages for this room.","type":"array","items":{"title":"AccommodationsChildren","type":"object","properties":{"total":{"description":"The maximum number of children for this room.","type":"integer","minimum":1},"from_age":{"description":"The youngest age of the children allowed in this room.","type":"integer","minimum":0,"maximum":17},"to_age":{"description":"The oldest age of the children allowed in this room.","type":"integer","minimum":0,"maximum":17},"free_stay":{"description":"Whether children in this age bracket will be staying for free. False indicates their cost was already included in the price.","type":"boolean"}}}}},"components/schemas/maximumOccupancy":{"id":"components/schemas/maximumOccupancy","kind":"json-schema","title":"AccommodationsMaximumOccupancy","data":{"title":"AccommodationsMaximumOccupancy","description":"Information related to maximum number of occupancy inside the room.","type":"object","properties":{"adults":{"description":"The maximum number of adults for this room.","type":"integer","minimum":1},"children":{"$ref":"#/components/schemas/children"},"total":{"description":"The maximum number of guests for this room.","type":"integer","minimum":1}}}},"components/schemas/priceCurrencyOutput":{"id":"components/schemas/priceCurrencyOutput","kind":"json-schema","title":"AccommodationsPriceCurrency","data":{"title":"AccommodationsPriceCurrency","description":"The price in both accommodation and booker currencies (booker might be null, if not requested)","type":"object","properties":{"accommodation_currency":{"$ref":"#/components/schemas/monetaryAmount"},"booker_currency":{"$ref":"#/components/schemas/monetaryAmount"}}}},"components/schemas/productDetailedCancellationPolicyMultiCurrency":{"id":"components/schemas/productDetailedCancellationPolicyMultiCurrency","kind":"json-schema","title":"productDetailedCancellationPolicyMultiCurrency","data":{"description":"The cancellation policy schedule for this product.","type":"array","items":{"title":"AccommodationsProductDetailedCancellationPolicyMultiCurrency","type":"object","properties":{"from":{"description":"The time from which this cancellation fee applies.","oneOf":[{"title":"Date-Time","type":"string","format":"date-time","description":"ISO 8601 date-time","example":"2026-06-01T12:00:00Z"},{"title":"Literal 'now'","type":"string","enum":["now"],"description":"Indicates that the cancellation fee applies immediately at booking time."},{"title":"Not applicable (Null)","type":"null"}]},"price":{"description":"The cancellation fee.","$ref":"#/components/schemas/priceCurrencyOutput"}}}}},"components/schemas/dataTypes_productCancellationType":{"id":"components/schemas/dataTypes_productCancellationType","kind":"json-schema","title":"dataTypes_productCancellationType","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cancellation policy applicable to this product: \"free_cancellation\" allows a period for free cancellation, \"non_refundable\" means immediate loss of total amount, \"special_conditions\" means partly refundable."},"children":[]}]}]}],"type":"string","enum":["free_cancellation","non_refundable","special_conditions"]}},"components/schemas/productCancellationPolicyAvailabilityMultiCurrency":{"id":"components/schemas/productCancellationPolicyAvailabilityMultiCurrency","kind":"json-schema","title":"AccommodationsProductCancellationPolicyMultiCurrency","data":{"title":"AccommodationsProductCancellationPolicyMultiCurrency","description":"The cancellation policy for this product.","type":"object","properties":{"free_cancellation_until":{"description":"Until when the order for this product can be cancelled for free.","type":["string","null"],"format":"date-time"},"schedule":{"$ref":"#/components/schemas/productDetailedCancellationPolicyMultiCurrency"},"type":{"$ref":"#/components/schemas/dataTypes_productCancellationType"}}}},"components/schemas/productPoliciesMultiCurrencyAvailability":{"id":"components/schemas/productPoliciesMultiCurrencyAvailability","kind":"json-schema","title":"AccommodationsProductPolicies","data":{"title":"AccommodationsProductPolicies","description":"The policies for this product.","type":"object","properties":{"cancellation":{"$ref":"#/components/schemas/productCancellationPolicyAvailabilityMultiCurrency"},"meal_plan":{"$ref":"#/components/schemas/productMealPlanPolicy"},"payment":{"$ref":"#/components/schemas/productPaymentPolicyNew"}}}},"components/schemas/chargeableOnline":{"id":"components/schemas/chargeableOnline","kind":"json-schema","title":"chargeableOnline","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether this charge is chargeable online or not. Not applicable to \"pay_at_the_property\" timing."},"children":[]}]}]}],"type":"boolean","nullable":true}},"components/schemas/chargeBreakdownV32":{"id":"components/schemas/chargeBreakdownV32","kind":"json-schema","title":"chargeBreakdownV32","data":{"description":"The charge breakdown. Includes taxes and fees.","type":"array","items":{"title":"AccommodationsChargeWithChargeableOnline","description":"Detailed information about an individual charge, including where it is applied.","type":"object","properties":{"charge":{"$ref":"#/components/schemas/chargeTypeId"},"condition":{"$ref":"#/components/schemas/conditionId"},"included_in":{"title":"ChargeIncludedIn","description":"Indicates where this charge is included","type":"object","properties":{"chargeable_online":{"$ref":"#/components/schemas/chargeableOnline"},"display":{"$ref":"#/components/schemas/display"}}},"mode":{"$ref":"#/components/schemas/chargeMode"},"percentage":{"$ref":"#/components/schemas/chargePercentage"},"total_amount":{"$ref":"#/components/schemas/totalAmountV32"},"unit_amount":{"$ref":"#/components/schemas/unitAmountV32"}}}}},"components/schemas/chargeableOnlinePriceV32":{"id":"components/schemas/chargeableOnlinePriceV32","kind":"json-schema","title":"chargeableOnlinePriceV32","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount collected by Booking.com from the Virtual Credit Cards (VCCs) when using online payment methods (e.g., pay_online_now, pay_online_later). Equivalent to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"base + charges"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" where "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"included_in.chargeable_online=true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for agency-model properties where Booking.com does not process payments."},"children":[]}]}]}],"type":"object","properties":{"accommodation_currency":{"$ref":"#/components/schemas/monetaryAmount"},"booker_currency":{"$ref":"#/components/schemas/monetaryAmount"}},"nullable":true}},"components/schemas/priceV32":{"id":"components/schemas/priceV32","kind":"json-schema","title":"AccommodationsProductPrice","data":{"title":"AccommodationsProductPrice","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contains the price components of an accommodation product. The 'base', 'display', 'chargeable_online' prices, and 'charges' are returned only when explicitly requested using extras=extra_charges."},"children":[]}]}]}],"type":"object","properties":{"base":{"$ref":"#/components/schemas/basePriceV32"},"charges":{"$ref":"#/components/schemas/chargeBreakdownV32"},"chargeable_online":{"$ref":"#/components/schemas/chargeableOnlinePriceV32"},"display":{"$ref":"#/components/schemas/displayPriceV32"},"total":{"$ref":"#/components/schemas/totalPriceV32"}}}},"components/schemas/availabilityProduct":{"id":"components/schemas/availabilityProduct","kind":"json-schema","title":"AccommodationsAvailabilityProductOutput","data":{"title":"AccommodationsAvailabilityProductOutput","description":"","type":"object","properties":{"id":{"$ref":"#/components/schemas/productId"},"bundle":{"$ref":"#/components/schemas/bundleId"},"deal":{"$ref":"#/components/schemas/dealV32"},"inventory":{"$ref":"#/components/schemas/availabilityInventoryOutput"},"maximum_occupancy":{"$ref":"#/components/schemas/maximumOccupancy"},"number_available":{"description":"How many units of this product are still available.","type":"integer","minimum":1},"policies":{"$ref":"#/components/schemas/productPoliciesMultiCurrencyAvailability"},"price":{"$ref":"#/components/schemas/priceV32"},"room":{"$ref":"#/components/schemas/roomIdString"}}}},"components/schemas/chargeSummaryV32":{"id":"components/schemas/chargeSummaryV32","kind":"json-schema","title":"AccommodationsChargeSummary","data":{"title":"AccommodationsChargeSummary","description":"A charge summed across multiple products.","type":"object","properties":{"charge":{"$ref":"#/components/schemas/chargeTypeId"},"condition":{"$ref":"#/components/schemas/conditionId"},"included_in":{"title":"ChargeIncludedIn","description":"Indicates where this charge is included","type":"object","properties":{"display":{"$ref":"#/components/schemas/display"},"chargeable_online":{"$ref":"#/components/schemas/chargeableOnline"}}},"total_amount":{"$ref":"#/components/schemas/totalAmountV32"}}}},"components/schemas/recommendation_priceV32":{"id":"components/schemas/recommendation_priceV32","kind":"json-schema","title":"AccommodationsRecommendationPrice","data":{"title":"AccommodationsRecommendationPrice","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contains the price components of the recommended accommodation product or selection of products. The 'base', 'display', 'chargeable_online' prices, and 'charges' are returned only when explicitly requested using extras=extra_charges."},"children":[]}]}]}],"type":"object","properties":{"base":{"$ref":"#/components/schemas/basePriceV32"},"charges":{"description":"The charge breakdown. Includes taxes and fees.","type":"array","items":{"$ref":"#/components/schemas/chargeSummaryV32"}},"chargeable_online":{"$ref":"#/components/schemas/chargeableOnlinePriceV32"},"display":{"$ref":"#/components/schemas/displayPriceV32"},"total":{"$ref":"#/components/schemas/totalPriceV32"}}}},"components/schemas/recommendation_children":{"id":"components/schemas/recommendation_children","kind":"json-schema","title":"recommendation_children","data":{"description":"The ages of the children allocated to this product.","type":"array","items":{"type":"integer","minimum":0,"maximum":17}}},"components/schemas/numberOfAdults":{"id":"components/schemas/numberOfAdults","kind":"json-schema","title":"numberOfAdults","data":{"description":"The number of adults allocated to this product.","type":"integer","minimum":1}},"components/schemas/productV32":{"id":"components/schemas/productV32","kind":"json-schema","title":"AccommodationsAvailabilityRecommendationProductOutput","data":{"title":"AccommodationsAvailabilityRecommendationProductOutput","description":"Represents a recommended product and its allocation details.","type":"object","properties":{"id":{"$ref":"#/components/schemas/productId"},"children":{"$ref":"#/components/schemas/recommendation_children"},"number_of_adults":{"$ref":"#/components/schemas/numberOfAdults"},"price":{"$ref":"#/components/schemas/recommendation_priceV32"}}}},"components/schemas/recommendation":{"id":"components/schemas/recommendation","kind":"json-schema","title":"AccommodationsAvailabilityRecommendationOutput","data":{"title":"AccommodationsAvailabilityRecommendationOutput","description":"The products recommended for the provided search criteria.","type":"object","properties":{"price":{"$ref":"#/components/schemas/recommendation_priceV32"},"products":{"description":"","type":"array","items":{"$ref":"#/components/schemas/productV32"}}}}},"components/schemas/availability":{"id":"components/schemas/availability","kind":"json-schema","title":"AccommodationsAvailabilityDataOutput,","data":{"title":"AccommodationsAvailabilityDataOutput,","description":"","type":"object","properties":{"id":{"$ref":"#/components/schemas/accommodationId"},"currency":{"$ref":"#/components/schemas/currency"},"deep_link_url":{"$ref":"#/components/schemas/deepLinkUrl"},"products":{"type":"array","items":{"$ref":"#/components/schemas/availabilityProduct"}},"recommendation":{"$ref":"#/components/schemas/recommendation"},"url":{"$ref":"#/components/schemas/url"}}}},"components/schemas/availabilityOutput":{"id":"components/schemas/availabilityOutput","kind":"json-schema","title":"AccommodationsAvailabilityOutput","data":{"title":"AccommodationsAvailabilityOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/availability"}}}}},"components/schemas/accommodationChainId":{"id":"components/schemas/accommodationChainId","kind":"json-schema","title":"accommodationChainId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies an accommodation chain. Examples of chains are: Radisson Hotel Group, Hilton Worldwide etc. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/chains","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/accommodations/chains"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/accommodationBrand":{"id":"components/schemas/accommodationBrand","kind":"json-schema","title":"AccommodationsChainsBrandDataOutput","data":{"title":"AccommodationsChainsBrandDataOutput","description":"Returns the internal code and name of an accommodation brand.","type":"object","properties":{"id":{"$ref":"#/components/schemas/accommodationBrandId"},"name":{"description":"Name of the accommodation brand.","type":"string"}}}},"components/schemas/accommodationChain":{"id":"components/schemas/accommodationChain","kind":"json-schema","title":"AccommodationsChainsOutput","data":{"title":"AccommodationsChainsOutput","description":"Returns the internal code, name and list of associated brands for an accommodation chain.","type":"object","properties":{"id":{"$ref":"#/components/schemas/accommodationChainId"},"brands":{"description":"List of all the brands associated with this accommodation chain.","type":"array","items":{"$ref":"#/components/schemas/accommodationBrand"}},"name":{"description":"Name of the accommodation chain.","type":"string"}}}},"components/schemas/output":{"id":"components/schemas/output","kind":"json-schema","title":"AccommodationsChainsBrandOutput","data":{"title":"AccommodationsChainsBrandOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/accommodationChain"}}}}},"components/schemas/languageId":{"id":"components/schemas/languageId","kind":"json-schema","title":"languageId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/IETF_language_tag"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"IETF language tag code"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" that uniquely identifies a supported human language or dialect. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Demand API only accepts lowercase for the language codes. Examples: \"nl\" for Dutch/Nederlands or \"en-us\" for English (US). To retrieve the full list of supported languages, call the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/common/languages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint in the same Demand API version you are using."},"children":[]}]}]}],"type":"string","pattern":"^[a-z]{2}(-[a-z]{2})?$","example":"en-us"}},"components/schemas/input":{"id":"components/schemas/input","kind":"json-schema","title":"AccommodationsConstantsInput","data":{"title":"AccommodationsConstantsInput","type":"object","properties":{"constants":{"description":"Allows to filter the results only for specific sections.","type":"array","items":{"type":"string","enum":["accommodation_facilities","accommodation_themes","accommodation_types","bed_types","charge_types","facility_types","review_scores","room_facilities","room_types"]}},"languages":{"type":"array","items":{"$ref":"#/components/schemas/languageId"},"default":["en-gb"]}}}},"components/schemas/facilityTypeId":{"id":"components/schemas/facilityTypeId","kind":"json-schema","title":"facilityTypeId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies the accommodation facility type. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/constants","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accommodations/constants"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/translatedString":{"id":"components/schemas/translatedString","kind":"json-schema","title":"TranslatedString","data":{"title":"TranslatedString","description":"A string localised in multiple languages.","type":"object","patternProperties":{"^[a-z]{2}(-[a-z]{2})$":{"description":"The content localised in this language.","type":["string","null"]}}}},"components/schemas/accommodationFacility":{"id":"components/schemas/accommodationFacility","kind":"json-schema","title":"AccommodationsFacilityOutput","data":{"title":"AccommodationsFacilityOutput","description":"A service, equipment or characteristic available at property level, like for example: \"Swimming pool outdoor\".","type":"object","properties":{"id":{"$ref":"#/components/schemas/accommodationFacilityId"},"facility_type":{"$ref":"#/components/schemas/facilityTypeId"},"name":{"$ref":"#/components/schemas/translatedString"}},"required":["id","facility_type","name"],"additionalProperties":false}},"components/schemas/accommodationThemeId":{"id":"components/schemas/accommodationThemeId","kind":"json-schema","title":"accommodationThemeId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies an accommodation property theme. Examples of themes are: Beach/Seaside, Ski/Wintersports, Luxury etc. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/constants","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accommodations/constants"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/accommodationTheme":{"id":"components/schemas/accommodationTheme","kind":"json-schema","title":"AccommodationsThemeOutput","data":{"title":"AccommodationsThemeOutput","description":"Accommodations can be grouped in \"themes\" depending on their characteristics. For example: \"Beach/Seaside\".","type":"object","properties":{"id":{"$ref":"#/components/schemas/accommodationThemeId"},"name":{"$ref":"#/components/schemas/translatedString"}},"required":["id","name"],"additionalProperties":false}},"components/schemas/accommodationType":{"id":"components/schemas/accommodationType","kind":"json-schema","title":"AccommodationsTypeOutput","data":{"title":"AccommodationsTypeOutput","description":"The type of an accommodation. Examples of types are \"Hotel\", \"Apartment\", etc.","type":"object","properties":{"id":{"$ref":"#/components/schemas/accommodationTypeId"},"name":{"$ref":"#/components/schemas/translatedString"}},"required":["id","name"],"additionalProperties":false}},"components/schemas/bedTypeId":{"id":"components/schemas/bedTypeId","kind":"json-schema","title":"bedTypeId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies a bed type. Examples of bed types are: Single, Double etc. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/constants","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accommodations/constants"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/bedType":{"id":"components/schemas/bedType","kind":"json-schema","title":"AccommodationsBedTypeOutput","data":{"title":"AccommodationsBedTypeOutput","description":"","type":"object","properties":{"id":{"$ref":"#/components/schemas/bedTypeId"},"description":{"description":"Translated description of the bed size in metric.","$ref":"#/components/schemas/translatedString"},"description_imperial":{"description":"Translated description of the bed size in imperial.","$ref":"#/components/schemas/translatedString"},"name":{"description":"Translated name of the bed type.","$ref":"#/components/schemas/translatedString"}},"required":["id","description","description_imperial","name"],"additionalProperties":false}},"components/schemas/chargeType":{"id":"components/schemas/chargeType","kind":"json-schema","title":"AccommodationsChargeTypeOutput","data":{"title":"AccommodationsChargeTypeOutput","description":"These are additional charges, which may be included or excluded from the reservation price. If excluded, the amounts may be added by the property upon checkout. The exclusions depend on several factors like local legislation, and sometimes can only be indicated but not be calculated at the time of the reservation.","type":"object","properties":{"id":{"$ref":"#/components/schemas/chargeTypeId"},"name":{"$ref":"#/components/schemas/translatedString"}},"required":["id","name"],"additionalProperties":false}},"components/schemas/facilityType":{"id":"components/schemas/facilityType","kind":"json-schema","title":"AccommodationsFacilityTypeOutput","data":{"title":"AccommodationsFacilityTypeOutput","description":"A more generic designation meant to group a set of facilities.","type":"object","properties":{"id":{"$ref":"#/components/schemas/facilityTypeId"},"name":{"$ref":"#/components/schemas/translatedString"}},"required":["id","name"],"additionalProperties":false}},"components/schemas/reviewScore":{"id":"components/schemas/reviewScore","kind":"json-schema","title":"AccommodationsReviewScoreOutput","data":{"title":"AccommodationsReviewScoreOutput","description":"Review score category name for each score interval.","type":"object","properties":{"name":{"$ref":"#/components/schemas/translatedString"},"minimum_score":{"description":"The minimum score of this review score category.","type":"number","multipleOf":0.1,"minimum":1,"maximum":10},"maximum_score":{"description":"The maximum score of this review score category","type":"number","multipleOf":0.1,"minimum":1,"maximum":10}},"required":["name","minimum_score","maximum_score"],"additionalProperties":false}},"components/schemas/roomFacility":{"id":"components/schemas/roomFacility","kind":"json-schema","title":"AccommodationsRoomFacilityOutput","data":{"title":"AccommodationsRoomFacilityOutput","description":"A service, equipment or characteristic available at room level, like for example: \"Coffee/Tea maker\".","type":"object","properties":{"id":{"$ref":"#/components/schemas/roomFacilityId"},"facility_type":{"$ref":"#/components/schemas/facilityTypeId"},"name":{"$ref":"#/components/schemas/translatedString"}},"required":["id","facility_type","name"],"additionalProperties":false}},"components/schemas/roomTypeId":{"id":"components/schemas/roomTypeId","kind":"json-schema","title":"roomTypeId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies an accommodation property room type. Example of room types are: Suite, Apartment, Twin/Double etc. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/constants","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accommodations/constants"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/roomType":{"id":"components/schemas/roomType","kind":"json-schema","title":"AccommodationsRoomTypeOutput","data":{"title":"AccommodationsRoomTypeOutput","description":"Designations for different types of rooms, based on topology and/or setup. Examples: \"Twin/Double\" or \"Dormitory room\".","type":"object","properties":{"id":{"$ref":"#/components/schemas/roomTypeId"},"name":{"$ref":"#/components/schemas/translatedString"}},"required":["id","name"],"additionalProperties":false}},"components/schemas/constants_output":{"id":"components/schemas/constants_output","kind":"json-schema","title":"AccommodationsConstantsOutput","data":{"title":"AccommodationsConstantsOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"title":"ConstantsDataOutput","type":"object","properties":{"accommodation_facilities":{"type":"array","items":{"$ref":"#/components/schemas/accommodationFacility"}},"accommodation_themes":{"type":"array","items":{"$ref":"#/components/schemas/accommodationTheme"}},"accommodation_types":{"type":"array","items":{"$ref":"#/components/schemas/accommodationType"}},"bed_types":{"type":"array","items":{"$ref":"#/components/schemas/bedType"}},"charge_types":{"type":"array","items":{"$ref":"#/components/schemas/chargeType"}},"facility_types":{"type":"array","items":{"$ref":"#/components/schemas/facilityType"}},"review_scores":{"type":"array","items":{"$ref":"#/components/schemas/reviewScore"}},"room_facilities":{"type":"array","items":{"$ref":"#/components/schemas/roomFacility"}},"room_types":{"type":"array","items":{"$ref":"#/components/schemas/roomType"}}}}}}},"components/schemas/extrasV32":{"id":"components/schemas/extrasV32","kind":"json-schema","title":"extrasV32","data":{"description":"Input parameter to request for additional information about the accommodation property. It should be passed as a JSON array with one or more items.","type":"array","items":{"type":"string","enum":["bundles","description","facilities","payment","photos","policies","refuses_free_cancellation_requests","rooms"]}}},"components/schemas/detailsInput":{"id":"components/schemas/detailsInput","kind":"json-schema","title":"AccommodationsDetailsInput","data":{"title":"AccommodationsDetailsInput","type":"object","properties":{"accommodation_facilities":{"type":"array","items":{"$ref":"#/components/schemas/accommodationFacilityId"}},"accommodation_types":{"type":"array","items":{"$ref":"#/components/schemas/accommodationTypeId"}},"accommodations":{"type":"array","items":{"$ref":"#/components/schemas/accommodationId"},"maxItems":100},"airport":{"$ref":"#/components/schemas/airportId"},"brands":{"type":"array","items":{"$ref":"#/components/schemas/accommodationBrandId"}},"city":{"$ref":"#/components/schemas/cityId"},"country":{"$ref":"#/components/schemas/countryId"},"extras":{"$ref":"#/components/schemas/extrasV32"},"languages":{"type":"array","items":{"$ref":"#/components/schemas/languageId"}},"page":{"$ref":"#/components/schemas/page"},"payment":{"$ref":"#/components/schemas/paymentInputFilter"},"region":{"$ref":"#/components/schemas/regionId"},"rows":{"$ref":"#/components/schemas/maximumResults","maximum":1000}}}},"components/schemas/valueAddType":{"id":"components/schemas/valueAddType","kind":"json-schema","title":"valueAddType","data":{"description":"Identifies the type of value-added benefit included in the bundle, such as complimentary services, monetary credits, percentage discounts, or experiential amenities. Enum values encode how the benefit is applied, including time scope (per day or per stay) and unit scope (per room or per adult).","type":"string","enum":["parking","food_drink_credit_per_day_per_room","food_drink_credit_per_day_per_adult","property_credit_per_day_per_room","food_drink_credit_per_stay_per_adult","food_drink_credit_per_stay_per_room","property_credit_per_day_per_adult","property_credit_per_stay_per_adult","property_credit_per_stay_per_room","food_drink_discount","property_discount","early_checkin","late_checkout","late_checkin","spa_daily","spa_hourly","spa_massage","high_speed_internet","airport_transfer","safari_game_drive","safari_walk","pets_stay","bottle_of_wine","bottle_of_champagne","park_sleep_fly"]}},"components/schemas/valueAddTranslated":{"id":"components/schemas/valueAddTranslated","kind":"json-schema","title":"ValueAddTranslatedOutput","data":{"title":"ValueAddTranslatedOutput","type":"object","description":"Value-added service with its type and descriptive text localised in multiple languages.","properties":{"type":{"$ref":"#/components/schemas/valueAddType"},"description":{"title":"TranslatedStringArray","description":"List of descriptive text lines for the value-added service, localised in multiple languages.","type":"object","patternProperties":{"^[a-z]{2}(-[a-z]{2})$":{"description":"The content localised in this language.","type":"array","nullable":true,"items":{"$ref":"#/components/schemas/translatedString"}}}}}}},"components/schemas/bundleTranslated":{"id":"components/schemas/bundleTranslated","kind":"json-schema","title":"BundleTranslatedOutput","data":{"title":"BundleTranslatedOutput","type":"object","description":"List of value-added services included in this bundle.","properties":{"id":{"type":"integer","description":"Bundle identifier"},"value_adds":{"type":"array","items":{"$ref":"#/components/schemas/valueAddTranslated"}}}}},"components/schemas/valueAdds_bundlesTranslated":{"id":"components/schemas/valueAdds_bundlesTranslated","kind":"json-schema","title":"BundlesTranslatedOutput","data":{"title":"BundlesTranslatedOutput","description":"List of value-added bundles available for this accommodation. Each bundle groups one or more value-added benefits and includes localised descriptive text for display.","type":"array","items":{"$ref":"#/components/schemas/bundleTranslated"}}},"components/schemas/checkinCheckoutTimes":{"id":"components/schemas/checkinCheckoutTimes","kind":"json-schema","title":"AccommodationsCheckinCheckoutTimesOutput","data":{"title":"AccommodationsCheckinCheckoutTimesOutput","type":"object","properties":{"checkin_from":{"description":"The time from when checkin starts at this property.","type":["string","null"],"pattern":"(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]:00"},"checkin_to":{"description":"The time till when checkin can be done at this property.","type":["string","null"],"pattern":"(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]:00"},"checkout_from":{"description":"The time from when checkout starts at this property.","type":["string","null"],"pattern":"(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]:00"},"checkout_to":{"description":"The time till when checkout can be done at this property.","type":["string","null"],"pattern":"(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]:00"}}}},"components/schemas/contact":{"id":"components/schemas/contact","kind":"json-schema","title":"AccommodationsContactOutput","data":{"title":"AccommodationsContactOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contact information of the accommodation. It can be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the data is missing."},"children":[]}]}]}],"type":"object","properties":{"email":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Email address of the accommodation. It can be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the data is missing."},"children":[]}]}]}],"type":"string","nullable":true},"telephone":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Telephone number of the accommodation. It can be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the data is missing."},"children":[]}]}]}],"type":"string","nullable":true}},"nullable":true}},"components/schemas/contacts":{"id":"components/schemas/contacts","kind":"json-schema","title":"AccommodationsContactsOutput","data":{"title":"AccommodationsContactsOutput","description":"Contact information of the accommodation.","type":"object","properties":{"general":{"$ref":"#/components/schemas/contact"},"reservations":{"$ref":"#/components/schemas/contact"}}}},"components/schemas/traderAddress":{"id":"components/schemas/traderAddress","kind":"json-schema","title":"AccommodationsAddress","data":{"title":"AccommodationsAddress","description":"An address object.","type":"object","properties":{"address_line":{"type":"string"},"city":{"type":"string"},"country":{"type":"string"},"post_code":{"type":"string"}}}},"components/schemas/description":{"id":"components/schemas/description","kind":"json-schema","title":"AccommodationsDescriptionOutput","data":{"title":"AccommodationsDescriptionOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Textual information about the accommodation. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"extras\":[\"description\"]}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"object","properties":{"host_type":{"description":"Type of host.","type":"string","enum":["private","professional","unknown"]},"important_information":{"description":"Text containing important information about the property. The value is translated in the requested languages.","$ref":"#/components/schemas/translatedString"},"license_numbers":{"description":"List of all the license numbers of this accommodation property.","type":"array","nullable":true,"items":{"type":"string"}},"text":{"description":"The translated description text of this accommodation property in the requested languages. The maximum number of characters returned may be limited by contract.","$ref":"#/components/schemas/translatedString"},"trader":{"title":"TraderOutput","description":"The trader information.","type":"object","nullable":true,"properties":{"address":{"description":"The address of the trader","$ref":"#/components/schemas/traderAddress"},"email":{"description":"The email of the trader","type":"string"},"name":{"description":"The name of the trader","type":"string"},"registration_number":{"description":"The registration number of the trader","type":"string"},"telephone":{"description":"The telephone of the trader","type":"string"},"trade_register":{"description":"The trade register name","type":"string"},"trader_verified":{"description":"Indicates whether the trader has successfully met Booking.com's internal verification process, based on established criteria and checklists","type":"boolean"}}}}}},"components/schemas/facility":{"id":"components/schemas/facility","kind":"json-schema","title":"AccommodationsFacilityOutput","data":{"title":"AccommodationsFacilityOutput","description":"Facility information for the accommodation.","type":"object","properties":{"id":{"$ref":"#/components/schemas/accommodationFacilityId"},"attributes":{"type":"array","items":{"description":"List of optional attributes for this facility.","type":"string","enum":["offsite","paid"]}}}}},"components/schemas/internetFacility":{"id":"components/schemas/internetFacility","kind":"json-schema","title":"AccommodationsInternetFacilityOutput","data":{"title":"AccommodationsInternetFacilityOutput","description":"Information about the internet facilities available at the accommodation.","type":"object","properties":{"charge_mode":{"type":"string","description":"The charging model for internet access at the accommodation.","nullable":true,"enum":["charges_are_applicable","free","per_day","per_half_hour","per_hour","per_minute"]},"connection_type":{"type":"string","description":"The type of internet connection available, whether wireless (Wi-Fi) or wired.","nullable":true,"enum":["wifi","wired"]},"coverage":{"type":"string","description":"The extent of the internet coverage within the accommodation, indicating the areas where internet access is available.","nullable":true,"enum":["all_rooms","business_center","entire_property","public_areas","some_rooms"]},"price":{"description":"The price for using the internet facility, if applicable.","$ref":"#/components/schemas/monetaryAmount","minimum":0,"nullable":true}}}},"components/schemas/parkingFacility":{"id":"components/schemas/parkingFacility","kind":"json-schema","title":"AccommodationsParkingFacilityOutput","data":{"title":"AccommodationsParkingFacilityOutput","description":"Information about the parking facilities available at the accommodation, including pricing, type, location, and reservation requirements.","type":"object","properties":{"charge_mode":{"type":"string","description":"The charging model for parking, such as per hour, per day, or free.","nullable":true,"enum":["free","charges_are_applicable","charges_may_apply","per_hour","per_day","per_week","per_stay"]},"location":{"type":"string","description":"The location of the parking facility relative to the accommodation (on-site or nearby).","nullable":true,"enum":["on_site","nearby"]},"price":{"$ref":"#/components/schemas/monetaryAmount","description":"The price for using the parking facility, if applicable.","minimum":0,"nullable":true},"reservation":{"type":"string","description":"Indicates whether a reservation is required for parking at the accommodation.","nullable":true,"enum":["needed","not_needed","not_possible"]},"type":{"type":"string","description":"The type of parking available, either public or private.","nullable":true,"enum":["private","public"]}}}},"components/schemas/restaurantFacility":{"id":"components/schemas/restaurantFacility","kind":"json-schema","title":"AccommodationsRestaurantFacilityOutput","data":{"title":"AccommodationsRestaurantFacilityOutput","description":"Information about the restaurant facilities available at the accommodation.","type":"object","properties":{"accept_reservations":{"description":"Indicates whether the restaurant accepts reservations.","type":"boolean"},"guests_only":{"description":"Indicates whether the restaurant is exclusive to guests or open to the public.","type":"boolean"},"name":{"type":"string","description":"The name of the restaurant."},"status":{"type":"string","description":"The operational status of the restaurant (e.g., open or closed).","nullable":true,"enum":["closed","open"]}}}},"components/schemas/swimmingPoolFacility":{"id":"components/schemas/swimmingPoolFacility","kind":"json-schema","title":"AccommodationsSwimmingPoolFacilityOutput","data":{"title":"AccommodationsSwimmingPoolFacilityOutput","description":"Details about the swimming pool occupancy limits and options.","type":"object","properties":{"allowed_age_type":{"type":"string","description":"The age group allowed to use the swimming pool (e.g., adults only, all ages, or kids only).","nullable":true,"enum":["adults_only","all_ages","kids_only"]},"payment_type":{"type":"string","description":"The payment model for pool access, either free or paid.","nullable":true,"enum":["free","paid"]},"type":{"type":"string","description":"The type of swimming pool (indoor, outdoor, or a combination).","nullable":true,"enum":["indoor","indoor_and_outdoor","outdoor"]}}}},"components/schemas/facilityDetails":{"id":"components/schemas/facilityDetails","kind":"json-schema","title":"accommodationsFacilityDetailsOutput","data":{"title":"accommodationsFacilityDetailsOutput","description":"Comprehensive information about the facilities available at the accommodation.","type":"object","properties":{"internet_facility":{"description":"Details about the internet facilities available at the accommodation, including price, charge mode and connection type.","type":"object","$ref":"#/components/schemas/internetFacility"},"parking_facilities":{"type":"array","description":"A list of parking facilities available at the accommodation.","items":{"$ref":"#/components/schemas/parkingFacility"}},"restaurant_facilities":{"type":"array","description":"A list of restaurant facilities available at the accommodation.","items":{"$ref":"#/components/schemas/restaurantFacility"}},"swimming_pool_facilities":{"type":"array","description":"A list of swimming pool facilities available at the accommodation.","items":{"$ref":"#/components/schemas/swimmingPoolFacility"}}}}},"components/schemas/fiscalInformation":{"id":"components/schemas/fiscalInformation","kind":"json-schema","title":"AccommodationsFiscalInformationOutput","data":{"title":"AccommodationsFiscalInformationOutput","description":"All fiscal related information of this accommodation property.","type":"object","properties":{"legal_name":{"type":"string"},"vat_number":{"type":"string"}}}},"components/schemas/checkinMethod":{"id":"components/schemas/checkinMethod","kind":"json-schema","title":"checkinMethod","data":{"description":"An enumeration that describes the conditions for the checkin process and for collecting the key to access the property. This is typically relevant for non-hotel accommodations (like houses or apartments) without a 24 hours front-desk.","type":"string","enum":["door_code","lock_box","reception","secret_spot","someone_will_meet","unknown"]}},"components/schemas/keyLocation":{"id":"components/schemas/keyLocation","kind":"json-schema","title":"keyLocation","data":{"description":"Location of the key to access this accommodation property.","type":"string","enum":["at_the_property","door_code","different_place","unknown"]}},"components/schemas/keyCollectionInformation":{"id":"components/schemas/keyCollectionInformation","kind":"json-schema","title":"AccommodationsKeyCollectionInformationOutput","data":{"title":"AccommodationsKeyCollectionInformationOutput","type":"object","properties":{"checkin_method":{"$ref":"#/components/schemas/checkinMethod"},"key_location":{"$ref":"#/components/schemas/keyLocation"}}}},"components/schemas/locations_cityId":{"id":"components/schemas/locations_cityId","kind":"json-schema","title":"locations_cityId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Uniquely identifies a city. The full list of cities can be retrieved from "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/common/locations/cities"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/common/locations/cities"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer"}},"components/schemas/coordinate":{"id":"components/schemas/coordinate","kind":"json-schema","title":"coordinate","data":{"type":"number","multipleOf":0.000001}},"components/schemas/locations_coordinates":{"id":"components/schemas/locations_coordinates","kind":"json-schema","title":"locations_coordinates","data":{"titles":"Coordinates","type":"object","properties":{"latitude":{"description":"The latitude.","$ref":"#/components/schemas/coordinate"},"longitude":{"description":"The longitude.","$ref":"#/components/schemas/coordinate"}}}},"components/schemas/locations_countryId":{"id":"components/schemas/locations_countryId","kind":"json-schema","title":"locations_countryId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166 country code. The full list of countries can be retrieved from "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/common/locations/countries"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/common/locations/countries"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string","pattern":"[a-z]{2}"}},"components/schemas/accommodationLocation":{"id":"components/schemas/accommodationLocation","kind":"json-schema","title":"AccommodationsLocationOutput","data":{"title":"AccommodationsLocationOutput","description":"All location related information of this accommodation property.","type":"object","properties":{"address":{"description":"Translated accommodation address.","$ref":"#/components/schemas/translatedString"},"city":{"$ref":"#/components/schemas/locations_cityId"},"coordinates":{"$ref":"#/components/schemas/locations_coordinates"},"country":{"$ref":"#/components/schemas/locations_countryId"},"districts":{"type":"array","items":{"$ref":"#/components/schemas/districtId"}},"postal_code":{"type":"string"},"regions":{"type":"array","items":{"$ref":"#/components/schemas/regionId"}}}}},"components/schemas/mealPrices":{"id":"components/schemas/mealPrices","kind":"json-schema","title":"MealPrices","data":{"title":"MealPrices","description":"Details regarding the meal pricing options offered at this accommodation.","type":"object","properties":{"breakfast":{"description":"The price of breakfast per person, expressed in the accommodation's local currency. If the value is null, it indicates that breakfast pricing is not available.","type":"number","minimum":0,"nullable":true},"dinner":{"description":"The price of dinner per person, expressed in the accommodation's local currency. If the value is null, it indicates that dinner pricing is not available.","type":"number","minimum":0,"nullable":true},"lunch":{"description":"The price of lunch per person, expressed in the accommodation's local currency. If the value is null, it indicates that lunch pricing is not available.","type":"number","minimum":0,"nullable":true}}}},"components/schemas/paymentCardId":{"id":"components/schemas/paymentCardId","kind":"json-schema","title":"paymentCardId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies a payment type. Examples of payment types are the different credit and debit cards. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/commonpayments/common/payments/cards","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/payments/cards"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/paymentMethods":{"id":"components/schemas/paymentMethods","kind":"json-schema","title":"AccommodationsDetailsPaymentMethodsOutput","data":{"title":"AccommodationsDetailsPaymentMethodsOutput","description":"Payment methods accepted by this property.","type":"object","properties":{"cards":{"description":"Credit cards accepted when paying at the property","type":"array","items":{"$ref":"#/components/schemas/paymentCardId"}},"cash":{"description":"Whether this property accepts cash","type":"boolean","example":true},"virtual_cards":{"description":"Virtual credit cards accepted when paying at the property","type":"array","items":{"$ref":"#/components/schemas/paymentCardId"}}}}},"components/schemas/payment":{"id":"components/schemas/payment","kind":"json-schema","title":"AccommodationsPaymentOutput","data":{"title":"AccommodationsPaymentOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payment information related to this property. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"extras\":[\"payment\"]}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"object","properties":{"methods":{"$ref":"#/components/schemas/paymentMethods"},"timings":{"$ref":"#/components/schemas/productPaymentTimings"},"cvc_required":{"description":"Whether cvc is mandatory for creating order for this accommodation.","type":"boolean"},"domestic_no_cc":{"description":"Whether domestic bookers can book without credit card for products with free cancellation policies.","type":"boolean"},"amex_cvc_required":{"description":"If amex card is used as payment method to create order for this accommodation, whether cvc is mandatory for that.","type":"boolean"}}}},"components/schemas/photoUrl":{"id":"components/schemas/photoUrl","kind":"json-schema","title":"AccommodationsPhotoUrlOutput","data":{"title":"AccommodationsPhotoUrlOutput","type":"object","properties":{"large":{"description":"URL of the photo image with a maximum width of 1280 pixels.","type":"string","format":"url","example":"https://q-xx.bstatic.com/xdata/images/hotel/max1280/20934654.jpg?k=806399263699a47361bdbbefc9c872a3db03eea26c4a815f5f4df95c93e38cdb&o="},"standard":{"description":"URL of the photo image with a maximum width of 500 pixels.","type":"string","format":"url","example":"https://q-xx.bstatic.com/xdata/images/hotel/max500/20934654.jpg?k=806399263699a47361bdbbefc9c872a3db03eea26c4a815f5f4df95c93e38cdb&o="},"thumbnail":{"description":"URL of the photo thumbnail image with dimensions 100x100 pixels.","type":"string","format":"url","example":"https://q-xx.bstatic.com/xdata/images/hotel/100x100/20934654.jpg?k=806399263699a47361bdbbefc9c872a3db03eea26c4a815f5f4df95c93e38cdb&o="},"thumbnail_large":{"description":"URL of the photo thumbnail image with dimensions 300x300 pixels.","type":"string","format":"url","example":"https://q-xx.bstatic.com/xdata/images/hotel/300x300/20934654.jpg?k=806399263699a47361bdbbefc9c872a3db03eea26c4a815f5f4df95c93e38cdb&o="}}}},"components/schemas/accommodationPhoto":{"id":"components/schemas/accommodationPhoto","kind":"json-schema","title":"AccommodationsPhotoOutput","data":{"title":"AccommodationsPhotoOutput","type":"object","properties":{"main_photo":{"description":"Flags this as the main photo. Not returned otherwise.","type":"boolean","example":true},"tags":{"type":"array","items":{"description":"A list of tags associated with the photo. Manually generated.","type":"string","example":"Bathroom"}},"url":{"$ref":"#/components/schemas/photoUrl"}}}},"components/schemas/petsPolicy":{"id":"components/schemas/petsPolicy","kind":"json-schema","title":"AccommodationsPetsPolicyOutput","data":{"title":"AccommodationsPetsPolicyOutput","type":"object","properties":{"allowed":{"description":"An enumerated value describing if pets are allowed","type":"string","enum":["yes","no","upon_request"]},"charge_mode":{"description":"An enumerated value describing the charge mode for pets","type":"string","enum":["free","charges_may_apply"]}}}},"components/schemas/referenceDate":{"id":"components/schemas/referenceDate","kind":"json-schema","title":"referenceDate","data":{"type":"string","enum":["checkin","checkout"]}},"components/schemas/paymentCollectionDate":{"id":"components/schemas/paymentCollectionDate","kind":"json-schema","title":"paymentCollectionDate","data":{"type":"object","properties":{"reference_date":{"$ref":"#/components/schemas/referenceDate"},"days_offset":{"description":"The number of days on or before reference date.","type":"integer"}}}},"components/schemas/paymentMethod":{"id":"components/schemas/paymentMethod","kind":"json-schema","title":"paymentMethod","data":{"type":"string","enum":["bank_transfer","cash","credit_card","paypal","other"]}},"components/schemas/paymentRefundDate":{"id":"components/schemas/paymentRefundDate","kind":"json-schema","title":"paymentRefundDate","data":{"type":"object","properties":{"reference_date":{"$ref":"#/components/schemas/referenceDate"},"days_offset":{"description":"The number of days on or after reference date.","type":"integer"}}}},"components/schemas/deposit":{"id":"components/schemas/deposit","kind":"json-schema","title":"deposit","data":{"properties":{"collect":{"properties":{"date":{"$ref":"#/components/schemas/paymentCollectionDate"},"payment_method":{"$ref":"#/components/schemas/paymentMethod"}}},"refund":{"properties":{"date":{"$ref":"#/components/schemas/paymentRefundDate"},"payment_method":{"$ref":"#/components/schemas/paymentMethod"}}}}}},"components/schemas/damagePolicy":{"id":"components/schemas/damagePolicy","kind":"json-schema","title":"damagePolicy","data":{"type":"object","description":"DamagePolicy of the property","properties":{"deposit":{"description":"If a deposit needs to be paid upfront","type":"object","$ref":"#/components/schemas/deposit"},"amount":{"description":"The amount that can be charged","type":"number","format":"double"},"currency":{"description":"Currency in which payment needs to be made","type":"string"}}}},"components/schemas/travelProud":{"id":"components/schemas/travelProud","kind":"json-schema","title":"travelProud","data":{"description":"Boolean value is \"true\" if property has travel proud badge and \"false\" otherwise.","type":"boolean"}},"components/schemas/programmes":{"id":"components/schemas/programmes","kind":"json-schema","title":"AccommodationsProgrammes","data":{"title":"AccommodationsProgrammes","description":"Details of programmes undergone by the property.","type":"object","properties":{"travel_proud":{"$ref":"#/components/schemas/travelProud"},"sustainable_offerings":{"$ref":"#/components/schemas/sustainability"}}}},"components/schemas/sustainability":{"id":"components/schemas/sustainability","kind":"json-schema","title":"AccommodationsSustainability","data":{"title":"AccommodationsSustainability","description":"Sustainability certifications associated with the property.","type":"object","nullable":true,"properties":{"certifications":{"description":"The external sustainability certifications awarded to the property.","type":"array","items":{"$ref":"#/components/schemas/sustainabilityCertification"}}}}},"components/schemas/sustainabilityCertification":{"id":"components/schemas/sustainabilityCertification","kind":"json-schema","title":"AccommodationsSustainabilityCertification","data":{"title":"AccommodationsSustainabilityCertification","type":"object","properties":{"name":{"description":"The name of the sustainability certification.","type":"string"}}}},"components/schemas/number_of_reviews":{"id":"components/schemas/number_of_reviews","kind":"json-schema","title":"number_of_reviews","data":{"description":"Number of validated reviews for this accommodation.","type":"integer","minimum":0}},"components/schemas/review_score":{"id":"components/schemas/review_score","kind":"json-schema","title":"review_score","data":{"description":"A decimal number indicating the current review score of this accommodation property, in the range 1..10.","type":"number","multipleOf":0.1,"minimum":1,"maximum":10}},"components/schemas/rating":{"id":"components/schemas/rating","kind":"json-schema","title":"AccommodationsDetailsRatingOutput","data":{"title":"AccommodationsDetailsRatingOutput","type":"object","properties":{"number_of_reviews":{"$ref":"#/components/schemas/number_of_reviews"},"preferred":{"description":"Boolean value is \"true\" if this accommodation is in the Booking.com's preferred program and \"false\" otherwise.","type":"boolean","example":true},"review_score":{"$ref":"#/components/schemas/review_score","nullable":true},"stars":{"description":"Number of stars of this accommodation property.","type":"number","format":"double","multipleOf":0.1,"nullable":true,"minimum":1,"maximum":5,"example":4},"stars_type":{"description":"An enumerated value describing which type of stars this accommodation has.","type":"string","nullable":true,"enum":["estimated_by_accommodation","estimated_by_booking","official"]}}}},"components/schemas/roomAttribute":{"id":"components/schemas/roomAttribute","kind":"json-schema","title":"roomAttribute","data":{"type":"string","enum":["non_smoking","smoking","work_friendly"]}},"components/schemas/bed":{"id":"components/schemas/bed","kind":"json-schema","title":"AccommodationsBedOutput","data":{"title":"AccommodationsBedOutput","description":"Detail information about a type of bed and number of beds included in this configuration.","type":"object","properties":{"bed_type":{"$ref":"#/components/schemas/bedTypeId"},"number_of_beds":{"description":"Number of similar beds included in this configuration.","type":"integer","minimum":0}}}},"components/schemas/bedConfiguration":{"id":"components/schemas/bedConfiguration","kind":"json-schema","title":"AccommodationsBedConfigurationOutput","data":{"title":"AccommodationsBedConfigurationOutput","description":"List of all beds available for this configuration.","type":"object","properties":{"id":{"description":"Uniquely identifies this bed configuration.","type":"string"},"configuration":{"description":"Detail list of all different types and number of beds included in this configuration.","type":"array","items":{"$ref":"#/components/schemas/bed"}}}}},"components/schemas/bedOption":{"id":"components/schemas/bedOption","kind":"json-schema","title":"AccommodationsBedOptionOutput","data":{"title":"AccommodationsBedOptionOutput","description":"List of all possible bed arrangements. For apartments and other types of hotel accommodations, beds and bathrooms may be available as separate rooms.","type":"object","properties":{"bed_configurations":{"description":"Lists all alternative bed configurations that are supported.","type":"array","items":{"$ref":"#/components/schemas/bedConfiguration"}},"has_bathroom":{"description":"Flags if this area includes its own bathroom.","type":"boolean"},"is_bedroom":{"description":"Flags if this area is marked as a bedroom, otherwise, it should be considered a living room.","type":"boolean"}}}},"components/schemas/roomV32":{"id":"components/schemas/roomV32","kind":"json-schema","title":"AccommodationsDetailsRoomOutput","data":{"title":"AccommodationsDetailsRoomOutput","type":"object","properties":{"id":{"$ref":"#/components/schemas/roomIdString"},"attributes":{"description":"Lists a set of attribute qualifiers for this room. Will not be returned if no relevant attributes are applicable.","type":"array","items":{"$ref":"#/components/schemas/roomAttribute"}},"bed_options":{"description":"Lists all possible bedding options for this room or apartment.","type":"array","items":{"$ref":"#/components/schemas/bedOption"}},"cots_and_extra_beds":{"title":"AccommodationsRoomsCotsAndExtraBedsOutput","description":"Lists room options regarding adding cots and/or extra beds.","type":"object","properties":{"are_allowed_together":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Flags if cots and extra beds can be placed together in the room. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" allows both up to their maximum limits. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" requires exclusive choice of either cots or extra beds."},"children":[]}]}]}],"type":"boolean"},"maximum_number_of_cots":{"description":"Maximum number of cots that can be added.","type":"integer","minimum":0},"maximum_number_of_extra_beds":{"description":"Maximum number of extra beds that can be added.","type":"integer","minimum":0}}},"description":{"description":"Translated description of the room.","$ref":"#/components/schemas/translatedString"},"facilities":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The list of facilities available in this room. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"extras\":[\"rooms\",\"facilities\"]}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/facility"}},"maximum_occupancy":{"title":"AccommodationsDetailsMaximumOccupancyOutput","description":"Occupancy limits and options.","type":"object","properties":{"adults":{"description":"Maximum number of adults.","type":"integer","minimum":0},"children":{"description":"Maximum number of children.","type":"integer","minimum":0}}},"name":{"description":"Translated name of the room.","$ref":"#/components/schemas/translatedString"},"number_of_rooms":{"title":"AccommodationsNumberOfRoomsOutput","description":"Breakdown of the internal layout, including the number of bedrooms, bathrooms, and living rooms within this room type or accommodation unit.","type":"object","properties":{"bathrooms":{"description":"Total number of bathrooms.","type":"integer","minimum":0},"bedrooms":{"description":"Total number of rooms equipped with a bed.","type":"integer","minimum":0},"living_rooms":{"description":"Total number of rooms without a bed.","type":"integer","minimum":0}}},"photos":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of photos for this accommodation room. The maximum number of photos returned may be limited by contract. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"extras\":[\"rooms\",\"photos\"]}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The photos are returned in no particular order."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/accommodationPhoto"}},"room_type":{"$ref":"#/components/schemas/roomTypeId"},"size":{"description":"The room area in square meters.","type":"number","minimum":0,"example":20}}}},"components/schemas/accommodationDetail":{"id":"components/schemas/accommodationDetail","kind":"json-schema","title":"AccommodationsDetailsDataOutput","data":{"title":"AccommodationsDetailsDataOutput","description":"All static information related to an accommodation property (excludes information on availability).","type":"object","properties":{"id":{"$ref":"#/components/schemas/accommodationId"},"accommodation_status":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Operational status of the accommodation. Note that closed accommodations are only included in the response when querying by accommodation ID ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"accommodations"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"); requests by location ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"airport"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"region"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") exclude closed accommodations, so those responses only contain accommodations with status "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"open"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"open"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The accommodation is open and bookable."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"closed_fraud"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The accommodation is closed due to fraud or related trust and safety concerns. Only returned when fraud visibility is enabled for your account; otherwise such accommodations are reported as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"closed_permanently"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"closed_temporarily"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The accommodation is temporarily closed."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"closed_permanently"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The accommodation is permanently closed."},"children":[]}]}]}]}],"type":"string","enum":["open","closed_fraud","closed_temporarily","closed_permanently"]},"accommodation_type":{"$ref":"#/components/schemas/accommodationTypeId"},"booker_address_required":{"description":"A boolean indicating whether a booker address is required for the property. If true, a booker address must be provided in the orders/create endpoint. If false, the booker address is not required and can be omitted from the orders/create endpoint.","type":"boolean"},"brands":{"type":"array","items":{"$ref":"#/components/schemas/accommodationBrandId"}},"bundles":{"$ref":"#/components/schemas/valueAdds_bundlesTranslated"},"checkin_checkout_times":{"$ref":"#/components/schemas/checkinCheckoutTimes"},"contacts":{"$ref":"#/components/schemas/contacts"},"currency":{"$ref":"#/components/schemas/currencyId"},"description":{"$ref":"#/components/schemas/description"},"facilities":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The list of facilities available in this property. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"extras\":[\"facilities\"]}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/facility"}},"facility_details":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provides detailed information about the facilities available at the accommodation. This data is accessible by including "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"extras\":[\"facilities\"]}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the request."},"children":[]}]}]}],"$ref":"#/components/schemas/facilityDetails"},"fiscal_information":{"$ref":"#/components/schemas/fiscalInformation"},"is_genius":{"description":"Whether the accommodation participates in the Genius programme.","type":"boolean"},"key_collection_information":{"$ref":"#/components/schemas/keyCollectionInformation"},"location":{"$ref":"#/components/schemas/accommodationLocation"},"long_stay_friendly":{"description":"Whether the accommodation is suitable for long stays.","type":"boolean"},"meal_prices":{"$ref":"#/components/schemas/mealPrices"},"name":{"description":"Translated name of the accommodation property.","$ref":"#/components/schemas/translatedString"},"number_of_rooms":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Approximate number of bookable rooms or accommodation units configured in the Booking.com system. This value is not an availability indicator and "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"does not necessarily represent the property's physical room count"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". For holiday homes and similar private rentals, this may be 1 even when the property contains multiple bedrooms, because the entire property is offered as a single bookable unit."},"children":[]}]}]}],"type":"integer","minimum":0},"payment":{"$ref":"#/components/schemas/payment"},"photos":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of photos for this accommodation property. The maximum number of photos returned may be limited by contract. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"extras\":[\"photos\"]}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The photos are returned in no particular order."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/accommodationPhoto"}},"policies":{"title":"AccommodationsPoliciesOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set of price relevant rules, options and constraints defined by the accommodation for this product. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"extras\":[\"policies\"]}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"object","properties":{"cots_and_extra_beds":{"description":"Prices for cots and extra beds.","type":"array","items":{"title":"PoliciesCotsAndExtraBedsOutput","type":"object","properties":{"age":{"title":"AccommodationsPoliciesAgeOutput","description":"Ages to which this entry is applicable. Children are aged 0-17. 18/null means adult. The interval is inclusive.","type":"object","properties":{"from":{"type":"integer","minimum":0,"maximum":18},"to":{"type":["integer","null"],"minimum":0,"maximum":18}}},"mode":{"description":"How the price is applied per cot/extra bed.","type":"string","enum":["per_night","per_stay"]},"price":{"description":"Non-null when the price is fixed or free.","$ref":"#/components/schemas/monetaryAmount","minimum":0,"type":["number","null"]},"type":{"description":"Whether this entry relates to a cot or an extra bed.","type":"string","enum":["cot","extra_bed"]}}}},"maximum_checkin_age":{"description":"Defines the maximum (inclusive) check-in age for this property. If null, then there is no maximum age for checking in","type":"integer","minimum":18},"minimum_checkin_age":{"description":"Defines the minimum (inclusive) check-in age for this property.","type":"integer","minimum":18},"minimum_guest_age":{"description":"Defines the minimum age (inclusive) for staying in this property. If \"0\", then a guest of any age is allowed.","type":"integer","minimum":0},"pets":{"$ref":"#/components/schemas/petsPolicy"},"damage":{"$ref":"#/components/schemas/damagePolicy"}}},"price_category":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates the qualitative price reference (between $ and $$$$) on how expensive an accommodation is. Accommodations in the same city are sorted by ascending price (average per guest per night in the last month), the ones in the lowest 25 percentile are in category $, between 25 and 50 percentile are in category $$, between 50 and 75 percentile are in category $$$, remaining ones are in category $$$$."},"children":[]}]}]}],"type":"string","pattern":"[$]{0,4}"},"programmes":{"$ref":"#/components/schemas/programmes"},"ranking":{"description":"Public ranking score of the accommodation.","type":"number","minimum":0},"rating":{"$ref":"#/components/schemas/rating"},"refuses_free_cancellation_requests":{"description":"Shows whether the property does not accept requests to waive the cancellation fee. Check this field before sending the cancellation request.\n\ntrue: The property does not accept waiving the cancellation fee.\nfalse: The property may approve a request to cancel the reservation without paying the cancellation fee","type":"boolean"},"rooms":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The list of room types available at this property. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"extras\":[\"rooms\"]}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/roomV32"}},"spoken_languages":{"description":"Languages spoken by the staff of this accommodation property.","type":"array","items":{"$ref":"#/components/schemas/languageId"}},"themes":{"type":"array","items":{"$ref":"#/components/schemas/accommodationThemeId"}},"url":{"title":"AccommodationsUrlsOutput","description":"Consolidated URLs for web and app redirects.","type":"object","properties":{"app":{"description":"A mobile app URL that directs the user to a specific page or content within the Booking.com app. The link can only be used on a device with the Booking.com app installed. It typically includes an Affiliate ID (AID) to attribute bookings to the affiliate partner when users are redirected.","$ref":"#/components/schemas/deepLinkUrl"},"web":{"description":"Internet address for the property page on Booking.com.","$ref":"#/components/schemas/url"}}},"work_friendly":{"description":"Whether the accommodation is suitable for working remotely.","type":"boolean"}}}},"components/schemas/detailsOutput":{"id":"components/schemas/detailsOutput","kind":"json-schema","title":"AccommodationsDetailsOutput","data":{"title":"AccommodationsDetailsOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/accommodationDetail"}},"metadata":{"title":"MetadataOutput","type":"object","properties":{"next_page":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":["string","null"]}}}}}},"components/schemas/changesInput":{"id":"components/schemas/changesInput","kind":"json-schema","title":"AccommodationsDetailsChangesInput","data":{"title":"AccommodationsDetailsChangesInput","type":"object","properties":{"last_change":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The timestamp in ISO-8601 format from which changes to accommodations are returned (inclusive). Only UTC time zone is supported. We support changes for last 24 hours. Format: YYYY-MM-DDTHH:mm:ss+00:00"},"children":[]}]}]}],"type":"string","format":"date-time"},"filters":{"description":"parameter basis which filtering needs to be done. Only one of (countries or cities) must be provided.","type":"object","properties":{"countries":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter changes based on these countries. The valid full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/commonlocations/common/locations/countries","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/locations/countries"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/countryId"}},"cities":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter changes based on these cities. The valid full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/commonlocations/common/locations/cities","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/locations/cities"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/cityId"}}}}},"required":["last_change"]}},"components/schemas/changes":{"id":"components/schemas/changes","kind":"json-schema","title":"changes","data":{"description":"The list of changed accommodations.","type":"object","properties":{"changed":{"description":"Accommodations which have had relevant changes to their content since the given timestamp. Changes being tracked include: general information, standard phrase, photos, payments, facilities and rooms.","type":"array","items":{"type":"integer"}},"closed":{"description":"Accommodations which have closed since the given timestamp. Note that these same accommodations may be re-opened shortly after.","type":"object","properties":{"fraud":{"type":"array","items":{"type":"integer"}},"permanently":{"type":"array","items":{"type":"integer"}},"temporarily":{"type":"array","items":{"type":"integer"}}}},"opened":{"description":"Accommodations which have opened since the given timestamp. Note that sometimes accommodations may be closed again shortly after.","type":"array","items":{"type":"integer"}}}}},"components/schemas/changesOutput":{"id":"components/schemas/changesOutput","kind":"json-schema","title":"AccommodationsDetailsChangesOutput","data":{"title":"AccommodationsDetailsChangesOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"changes":{"$ref":"#/components/schemas/changes"},"from":{"description":"ISO 8601 timestamp which indicates the timestamp from which the changes are returned (inclusive).","type":"string","format":"date-time"},"next":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601 timestamp which indicates the next timestamp to be used for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_change"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This will be 1 second after the latest change returned in the result (all changes from the \"last\" second are returned). NOTE: this field will not be present unless changes are returned. In this case, repeat the call after one minute with the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_change"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" date."},"children":[]}]}]}],"type":"string","format":"date-time"},"total_changes":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Total number of changed accommodation ids returned. If 0, then repeat the call after one minute with the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_change"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" date."},"children":[]}]}]}],"type":"integer"}}}}}},"components/schemas/travel_purpose":{"id":"components/schemas/travel_purpose","kind":"json-schema","title":"travel_purpose","data":{"description":"Defines if this was a leisure or business trip.","type":"string","enum":["business","leisure"]}},"components/schemas/reviewer_type":{"id":"components/schemas/reviewer_type","kind":"json-schema","title":"reviewer_type","data":{"description":"The reviewer type.","type":"string","enum":["couple","extended_group","family_with_children","solo_traveller"]}},"components/schemas/reviewer":{"id":"components/schemas/reviewer","kind":"json-schema","title":"AccommodationsReviewer","data":{"title":"AccommodationsReviewer","type":"object","properties":{"countries":{"description":"Limits reviews to those written by reviewer from the given country.","type":"array","items":{"$ref":"#/components/schemas/countryId"}},"travel_purposes":{"description":"Limits reviews to those written by specific travel purposes.","type":"array","items":{"$ref":"#/components/schemas/travel_purpose"}},"types":{"description":"Limits reviews to those written by specific reviewer type.","type":"array","items":{"$ref":"#/components/schemas/reviewer_type"}}}}},"components/schemas/reviewsInput":{"id":"components/schemas/reviewsInput","kind":"json-schema","title":"AccommodationsReviewsInput","data":{"title":"AccommodationsReviewsInput","type":"object","properties":{"accommodations":{"type":"array","items":{"$ref":"#/components/schemas/accommodationId"},"minItems":1,"maxItems":100},"languages":{"description":"Limits reviews to those written in this language.","type":"array","items":{"$ref":"#/components/schemas/languageId"}},"last_change":{"description":"Limits the reviews to those changed after the given date. Format: YYYY-MM-DD.","type":"string","format":"date"},"page":{"$ref":"#/components/schemas/page"},"reviewer":{"$ref":"#/components/schemas/reviewer"},"rows":{"$ref":"#/components/schemas/maximumResults"},"score":{"title":"AccommodationsReviewScoreInput","type":"object","properties":{"maximum":{"description":"Limits the reviews to those having score lesser or equal to this value.","type":"integer","minimum":1,"maximum":10},"minimum":{"description":"Limits the reviews to those having score greater or equal to this value.","type":"integer","minimum":1,"maximum":10}}}},"required":["accommodations"]}},"components/schemas/reviews":{"id":"components/schemas/reviews","kind":"json-schema","title":"reviews","data":{"type":"array","items":{"title":"AccommodationsReviewOutput","type":"object","properties":{"id":{"description":"Unique identifier of the review.","type":"integer"},"date":{"description":"The date when the review was last modified. Format: YYYY-MM-DD.","type":"string","format":"date"},"language":{"$ref":"#/components/schemas/languageId"},"negative":{"description":"Negative comments from this review.","type":["string","null"]},"positive":{"description":"Positive comments from this review.","type":["string","null"]},"reviewer":{"title":"AccommodationsReviewerOutput","type":"object","properties":{"country":{"$ref":"#/components/schemas/countryId"},"name":{"description":"Name of the reviewer. If the value is null then the reviewer is anonymous.","type":["string","null"]},"travel_purpose":{"$ref":"#/components/schemas/travel_purpose"},"type":{"$ref":"#/components/schemas/reviewer_type"}}},"score":{"description":"The aggregated score of the review.","type":"number","multipleOf":0.1,"minimum":1,"maximum":10},"summary":{"description":"The summary of the review.","type":["string","null"]},"text_meets_guidelines":{"description":"Set to true when review meets the guidelines. The review text will be removed if it doesn't meet guidelines.","type":"boolean"}}}}},"components/schemas/accommodationReviews":{"id":"components/schemas/accommodationReviews","kind":"json-schema","title":"AccommodationsReviewsDataOutput","data":{"title":"AccommodationsReviewsDataOutput","description":"","type":"object","properties":{"id":{"$ref":"#/components/schemas/accommodationId"},"reviews":{"$ref":"#/components/schemas/reviews"},"url":{"$ref":"#/components/schemas/url"}}}},"components/schemas/reviewsOutput":{"id":"components/schemas/reviewsOutput","kind":"json-schema","title":"AccommodationsReviewsOutput","data":{"title":"AccommodationsReviewsOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/accommodationReviews"}},"metadata":{"title":"MetadataOutput","type":"object","properties":{"next_page":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":["string","null"]}}}}}},"components/schemas/reviewsScores_input":{"id":"components/schemas/reviewsScores_input","kind":"json-schema","title":"AccommodationsReviewsInput","data":{"title":"AccommodationsReviewsInput","type":"object","properties":{"accommodations":{"type":"array","items":{"$ref":"#/components/schemas/accommodationId"},"minItems":1,"maxItems":100},"languages":{"description":"Limits reviews to those written in this language.","type":"array","items":{"$ref":"#/components/schemas/languageId"}},"reviewer":{"$ref":"#/components/schemas/reviewer"}},"required":["accommodations"]}},"components/schemas/score":{"id":"components/schemas/score","kind":"json-schema","title":"score","data":{"description":"A decimal number indicating the review score of this criteria, in the range 1..10.","type":"number","multipleOf":0.1,"minimum":1,"maximum":10}},"components/schemas/breakdown_schema":{"id":"components/schemas/breakdown_schema","kind":"json-schema","title":"AccommodationsReviewsBreakdownSchemaOutput","data":{"title":"AccommodationsReviewsBreakdownSchemaOutput","type":"object","properties":{"number_of_reviews":{"description":"Number of reviews for this criteria.","type":"integer","minimum":0},"score":{"$ref":"#/components/schemas/score"}}}},"components/schemas/breakdown":{"id":"components/schemas/breakdown","kind":"json-schema","title":"AccommodationsReviewsBreakdownOutput","data":{"title":"AccommodationsReviewsBreakdownOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Review scores breakdown for each criteria. List of criteria includes: cleanliness, comfort, facilities, free_wifi, location, staff, value_for_money."},"children":[]}]}]}],"type":"object","patternProperties":{"^(cleanliness|comfort|facilities|free_wifi|location|staff|value_for_money)$":{"$ref":"#/components/schemas/breakdown_schema"}}}},"components/schemas/distribution_schema":{"id":"components/schemas/distribution_schema","kind":"json-schema","title":"AccommodationsReviewsDistributionSchemaOutput","data":{"title":"AccommodationsReviewsDistributionSchemaOutput","type":"object","properties":{"number_of_reviews":{"description":"Number of reviews with this score.","type":"integer","minimum":0},"percentage":{"description":"Percent of score distribution for this score.","type":"number","multipleOf":0.01}}}},"components/schemas/distribution":{"id":"components/schemas/distribution","kind":"json-schema","title":"AccommodationsReviewsDistributionOutput","data":{"title":"AccommodationsReviewsDistributionOutput","description":"Overall score distribution for each score (1-10).","type":"object","patternProperties":{"^[1-9]|10$":{"$ref":"#/components/schemas/distribution_schema"}}}},"components/schemas/scores":{"id":"components/schemas/scores","kind":"json-schema","title":"AccommodationsReviewsScoresOutput","data":{"title":"AccommodationsReviewsScoresOutput","description":"","type":"object","properties":{"id":{"$ref":"#/components/schemas/accommodationId"},"breakdown":{"$ref":"#/components/schemas/breakdown"},"distribution":{"$ref":"#/components/schemas/distribution"},"number_of_reviews":{"$ref":"#/components/schemas/number_of_reviews"},"score":{"$ref":"#/components/schemas/review_score"},"url":{"$ref":"#/components/schemas/url"}}}},"components/schemas/reviewsScores_output":{"id":"components/schemas/reviewsScores_output","kind":"json-schema","title":"AccommodationsReviewsOutput","data":{"title":"AccommodationsReviewsOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/scores"}}}}},"components/schemas/thirdPartySupplier":{"id":"components/schemas/thirdPartySupplier","kind":"json-schema","title":"AccommodationsThirdPartySupplier","data":{"title":"AccommodationsThirdPartySupplier","description":"Information about a third-party accommodation supplier.","type":"object","properties":{"id":{"$ref":"#/components/schemas/thirdPartySupplierId"},"name":{"description":"Display name of the third-party supplier.","type":"string"},"company_address":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Registered company address of the third-party supplier. May be omitted or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the address is not available."},"children":[]}]}]}],"type":"string","nullable":true}}}},"components/schemas/thirdPartySuppliers_output":{"id":"components/schemas/thirdPartySuppliers_output","kind":"json-schema","title":"AccommodationsThirdPartySuppliersOutput","data":{"title":"AccommodationsThirdPartySuppliersOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"description":"List of third-party accommodation suppliers.","type":"array","items":{"$ref":"#/components/schemas/thirdPartySupplier"}}}}},"components/schemas/error_response":{"id":"components/schemas/error_response","kind":"json-schema","title":"ErrorResponse","data":{"title":"ErrorResponse","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"errors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"message":{"type":"string"}},"required":["id","message"]}}},"required":["request_id","errors"]}},"components/schemas/schemas-booker":{"id":"components/schemas/schemas-booker","kind":"json-schema","title":"schemas-booker","data":{"description":"Defines the booker context.","type":"object","properties":{"country":{"description":"The booker country for showing the best price for that user and obeying laws regarding the display of taxes and fees.","$ref":"#/components/schemas/countryId"}},"required":["country"]}},"components/schemas/driver":{"id":"components/schemas/driver","kind":"json-schema","title":"driver","data":{"description":"Defines the driver context.","type":"object","properties":{"age":{"description":"Driver age. Affects the availability and price of the products.","type":"integer","minimum":18,"maximum":99}},"required":["age"]}},"components/schemas/schemas-supplierId":{"id":"components/schemas/schemas-supplierId","kind":"json-schema","title":"schemas-supplierId","data":{"description":"Supplier id.","type":"integer"}},"components/schemas/schemas-filters":{"id":"components/schemas/schemas-filters","kind":"json-schema","title":"schemas-filters","data":{"description":"Defines the filtering criteria for refining the request results. It allows you to specify various parameters to narrow down the available car rental options based on specific attributes.","type":"object","properties":{"air_conditioning":{"description":"Filters the results to include car rentals with or without air conditioning. Setting this value to true will only return vehicles with air conditioning, while false will exclude them.","type":"boolean"},"car_categories":{"description":"Filters the results based on the selected car categories.","type":"array","items":{"type":"string","enum":["carriers","compact_suv","convertible","estate","large","large_suv","medium","midsize_suv","pickup","premium","small","suvs"],"x-enumDescriptions":{"carriers":"Vans or minivans designed for carrying larger groups or luggage.","compact_suv":"Compact SUVs offering a balance of SUV versatility and city-friendly dimensions.","convertible":"Vehicles with a retractable or removable roof for open-air driving.","estate":"Station wagons or estate cars offering extra luggage space.","large":"Large vehicles offering ample interior space and comfort.","large_suv":"Full-size SUVs with maximum passenger and cargo space.","medium":"Mid-sized vehicles offering a balance of comfort and fuel efficiency.","midsize_suv":"Midsize SUVs providing more interior room and capability than compact models.","pickup":"Pickup trucks with an open cargo bed, suitable for hauling and off-road use.","premium":"High-end or luxury vehicles with premium features.","small":"Compact cars ideal for city driving and short distances.","suvs":"Sport Utility Vehicles offering higher ground clearance and versatility."}}},"depot_location_type":{"description":"Filters the results based on the type of depot location where the vehicle is picked up or dropped off.","type":"string","enum":["in_terminal","car_rental_centre","outside_terminal","airport_hotel","shuttle_bus","meet_greet","trainstation","downtown"],"x-enumDescriptions":{"in_terminal":"Depot is located inside the airport terminal building.","car_rental_centre":"Depot is located in a dedicated car rental centre on or near airport grounds.","outside_terminal":"Depot is outside the terminal area, usually a short walk or drive away.","airport_hotel":"Depot is located at or inside an airport hotel.","shuttle_bus":"Depot requires a shuttle bus transfer from the airport or another meeting point.","meet_greet":"A rental agent meets the traveller in person at an agreed pick-up point (e.g., arrivals hall).","trainstation":"Depot is located in or near a train station.","downtown":"Depot is located in a central/downtown city area."}},"fuel_types":{"description":"Filters the results by one or more fuel types.","type":"array","items":{"type":"string","enum":["electric","hybrid","petrol_or_diesel","plug_in_hybrid"],"x-enumDescriptions":{"electric":"Fully electric vehicles.","hybrid":"Self-charging hybrid vehicles.","petrol_or_diesel":"Vehicles powered by petrol, diesel, or other conventional types, such as LPG, ethanol, hydrogen or multi-fuel.","plug_in_hybrid":"Plug-in hybrid vehicles."}}},"mileage_type":{"description":"Filters the results based on the mileage type associated with the rental vehicle.","type":"string","enum":["limited","unlimited"]},"number_of_seats":{"description":"Filters the results based on the number of seats in the vehicle. This allows you to specify a vehicle that can accommodate a specific number of passengers.","type":"integer"},"price":{"description":"Filters the results to include only vehicles whose total rental price falls within the specified range (inclusive). Prices are evaluated in the requested currency.","type":"object","properties":{"maximum":{"description":"Returns only vehicles with a total rental price less than or equal to this value, in the requested currency. Omit to indicate no upper limit.","type":"number","format":"double"},"minimum":{"description":"Returns only vehicles with a total rental price greater than or equal to this value, in the requested currency. Omit to indicate no lower limit.","type":"number","format":"double"}}},"rating":{"description":"Filter vehicles by the minimum review score of the depot.","type":"object","properties":{"minimum_review_score":{"description":"Return only vehicles from depots with a review score greater than or equal to the specified value. Valid values range from 1 to 10.","type":"integer","minimum":1,"maximum":10}}},"supplier_ids":{"description":"Filters the results based on the supplier ID of the vehicle. This allows you to retrieve vehicles from specific suppliers. A maximum of 10 supplier IDs can be provided.","maxItems":10,"type":"array","items":{"$ref":"#/components/schemas/schemas-supplierId"}},"transmission_type":{"description":"Filters the results based on the transmission type of the vehicle.","type":"string","enum":["automatic","manual"]}}}},"components/schemas/maximumResultsCarsSearch":{"id":"components/schemas/maximumResultsCarsSearch","kind":"json-schema","title":"maximumResultsCarsSearch","data":{"description":"The maximum number of results to return for car searches.","type":"integer","multipleOf":10,"minimum":10,"maximum":500,"default":500}},"components/schemas/paymentInput":{"id":"components/schemas/paymentInput","kind":"json-schema","title":"paymentInput","data":{"type":"object","properties":{"timings":{"description":"Filters the results to include only car rentals that offer the specified payment timings. Use this parameter to search for cars based on the timing of payment (e.g., payment upfront, partial payment, or payment at the depot).","type":"array","items":{"type":"string","enum":["pay_online_now","pay_partial_online_now","pay_at_pickup"]}}}}},"components/schemas/locationAsAirport":{"id":"components/schemas/locationAsAirport","kind":"json-schema","title":"locationAsAirport","data":{"description":"Defines location of the related route point by airport.","type":"object","properties":{"airport":{"$ref":"#/components/schemas/airportId"}}}},"components/schemas/dataTypes_coordinates":{"id":"components/schemas/dataTypes_coordinates","kind":"json-schema","title":"Coordinates","data":{"title":"Coordinates","type":"object","properties":{"latitude":{"type":"number","format":"double"},"longitude":{"type":"number","format":"double"}}}},"components/schemas/locationAsCoordinates":{"id":"components/schemas/locationAsCoordinates","kind":"json-schema","title":"locationAsCoordinates","data":{"description":"Defines location of the related route point by coordinates.","type":"object","properties":{"coordinates":{"description":"Defines the geographic coordinates of the searched location.","$ref":"#/components/schemas/dataTypes_coordinates"}}}},"components/schemas/locationAsCity":{"id":"components/schemas/locationAsCity","kind":"json-schema","title":"locationAsCity","data":{"description":"Defines location of the related route point by city.","type":"object","properties":{"city":{"$ref":"#/components/schemas/cityId"}}}},"components/schemas/routePointInput":{"id":"components/schemas/routePointInput","kind":"json-schema","title":"routePointInput","data":{"description":"Defines the pickup or dropoff route point.","type":"object","properties":{"datetime":{"description":"Pickup / dropoff datetime. Must be a local datetime without timezone offset, in the format yyyy-MM-dd'T'HH:mm:ss.","example":"2026-11-01T11:05:00","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$"},"location":{"description":"Pickup / dropoff location.","oneOf":[{"$ref":"#/components/schemas/locationAsAirport"},{"$ref":"#/components/schemas/locationAsCoordinates"},{"$ref":"#/components/schemas/locationAsCity"}]}},"required":["datetime","location"]}},"components/schemas/routeInput":{"id":"components/schemas/routeInput","kind":"json-schema","title":"routeInput","data":{"description":"Defines the route context.","type":"object","properties":{"pickup":{"description":"Pick up location and time.","$ref":"#/components/schemas/routePointInput"},"dropoff":{"description":"Drop off location and time.","$ref":"#/components/schemas/routePointInput"}},"required":["pickup","dropoff"]}},"components/schemas/sort":{"id":"components/schemas/sort","kind":"json-schema","title":"sort","data":{"description":"Defines how the search results are sorted. If omitted, results are sorted by the recommended option.","type":"object","required":["by"],"properties":{"by":{"description":"The criterion used to sort the search results.","type":"string","enum":["recommended","price","distance","review_score"],"x-enumDescriptions":{"recommended":"Sort by the recommended order. This is the default when the sort parameter is omitted.","price":"Sort by price in ascending order.","distance":"Sort by distance in ascending order. Available only when both the pickup and dropoff locations are specified using latitude and longitude coordinates. Otherwise, the recommended sort order is applied.","review_score":"Sort by review score in descending order."}},"direction":{"description":"Deprecated. Specifies the sort direction. This field is no longer used and will be removed in a future version.","type":"string","enum":["ascending","descending"],"deprecated":true}}}},"components/schemas/cars_search_input":{"id":"components/schemas/cars_search_input","kind":"json-schema","title":"cars_search_input","data":{"type":"object","properties":{"booker":{"$ref":"#/components/schemas/schemas-booker"},"currency":{"$ref":"#/components/schemas/currencyId"},"driver":{"$ref":"#/components/schemas/driver"},"filters":{"$ref":"#/components/schemas/schemas-filters"},"maximum_results":{"$ref":"#/components/schemas/maximumResultsCarsSearch","default":500},"language":{"description":"Optional. Controls the language of the Booking.com web and app URLs returned in the response. If not specified, English (en-gb) is used.","$ref":"#/components/schemas/languageId","default":"en-gb"},"page":{"$ref":"#/components/schemas/page"},"payment":{"description":"Payment-related input filters that allow you to narrow down car search results based on the payment timing options.","$ref":"#/components/schemas/paymentInput"},"route":{"$ref":"#/components/schemas/routeInput"},"sort":{"$ref":"#/components/schemas/sort"}},"required":["booker","currency","driver","route"]}},"components/schemas/carFleetId":{"id":"components/schemas/carFleetId","kind":"json-schema","title":"carFleetId","data":{"description":"This ID corresponds to a specific car model and supplier (fleet) combination, as returned by the /cars/details endpoint. Cache the details keyed by this ID and use it to match search results to your cached data.","type":"integer","minimum":1}},"components/schemas/categories":{"id":"components/schemas/categories","kind":"json-schema","title":"categories","data":{"description":"The categories assigned to the car.","type":"array","items":{"type":"string","enum":["carriers","compact_suv","convertible","estate","large","large_suv","medium","midsize_suv","pickup","premium","small","suvs"],"x-enumDescriptions":{"carriers":"Vans or minivans designed for carrying larger groups or luggage.","compact_suv":"Compact SUVs offering a balance of SUV versatility and city-friendly dimensions.","convertible":"Vehicles with a retractable or removable roof for open-air driving.","estate":"Station wagons or estate cars offering extra luggage space.","large":"Large vehicles offering ample interior space and comfort.","large_suv":"Full-size SUVs with maximum passenger and cargo space.","medium":"Mid-sized vehicles offering a balance of comfort and fuel efficiency.","midsize_suv":"Midsize SUVs providing more interior room and capability than compact models.","pickup":"Pickup trucks with an open cargo bed, suitable for hauling and off-road use.","premium":"High-end or luxury vehicles with premium features.","small":"Compact cars ideal for city driving and short distances.","suvs":"Sport Utility Vehicles offering higher ground clearance and versatility."}}}},"components/schemas/dealsOutput":{"id":"components/schemas/dealsOutput","kind":"json-schema","title":"Deal","data":{"title":"Deal","description":"This specifies the deal tagging for the product.","type":["object","null"],"properties":{"discount_percentage":{"description":"Discount percentage of the applied deals.","type":"integer","minimum":1},"public_price":{"description":"Original price of this product, before applying any discounts.","$ref":"#/components/schemas/monetaryAmount"},"tags":{"description":"The tags of all the applied deals.","type":"array","items":{"type":"string","enum":["black_friday","getaway_deal","mobile_rate"]}}}}},"components/schemas/offerId":{"id":"components/schemas/offerId","kind":"json-schema","title":"offerId","data":{"description":"This ID identifies the car rental offer and its associated policies. Include it when calling the /cars/availability endpoint.","type":"integer","minimum":1}},"components/schemas/cancellationOutput":{"id":"components/schemas/cancellationOutput","kind":"json-schema","title":"cancellationOutput","data":{"description":"The cancellation policy that applies to this product.","type":"object","properties":{"details":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provides the policy details if the cancellation is free. For example:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"duration='PT48H' and context=before_pickup means 'Free cancellation is available up to 48 hrs before pick up'."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"duration='P7D' and context=within_given_time_period_of_booking means 'Free cancellation is available within 7 days of booking'"},"children":[]}]}]}]}],"type":["object","null"],"properties":{"context":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The context in which the cancellation policy applies. For example 'before_pickup'"},"children":[]}]}]}],"type":"string","enum":["before_pickup","within_given_time_period_of_booking"]},"duration":{"description":"The duration until which the cancellation is free. This is in ISO-8601/Duration format.","type":"string","pattern":"^P(?:\\dY)?(?:\\dM)?(?:\\dD)?(?:T(?:\\dH)?(?:\\dM)?(?:\\dS)?)?$"}}},"type":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type of cancellation present. For example 'free_cancellation' or 'non-refundable'."},"children":[]}]}]}],"type":"string","enum":["free_cancellation","non-refundable"]}}}},"components/schemas/mileageOutput":{"id":"components/schemas/mileageOutput","kind":"json-schema","title":"mileageOutput","data":{"description":"The mileage policy that applies to this product.","type":"object","properties":{"amount":{"description":"The amount that must be paid if the distance limit is exceeded.","type":["number","null"],"format":"double"},"currency":{"$ref":"#/components/schemas/currencyId"},"distance_limit":{"description":"The maximal distance limit allowed for this product before additional fees apply.","type":["number","null"],"format":"double","minimum":0},"distance_unit":{"description":"The unit of measurement for the distance limit. For example 'km' or 'miles'.","type":"string","enum":["kilometers","miles"]},"type":{"description":"The type of mileage policy applied.","type":"string","enum":["limited","unlimited"]}},"required":["type"]}},"components/schemas/paymentOutput":{"id":"components/schemas/paymentOutput","kind":"json-schema","title":"paymentOutput","data":{"description":"The payment policy that applies to this product.","type":"object","properties":{"timing":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The applied payment timing. For example 'pay_online_now'."},"children":[]}]}]}],"type":"string","enum":["pay_online_now","pay_partial_online_now","pay_at_pickup"]}},"required":["timing"]}},"components/schemas/policiesOutput":{"id":"components/schemas/policiesOutput","kind":"json-schema","title":"policiesOutput","data":{"description":"The policies that apply to this product.","type":"object","properties":{"cancellation":{"$ref":"#/components/schemas/cancellationOutput"},"damage_excess":{"description":"The maximum amount a traveller may be charged for damages to the car during the rental period, as specified by the rental agreement.","type":["object","null"],"properties":{"amount":{"description":"The amount to be charged.","type":"number","format":"double"},"currency":{"$ref":"#/components/schemas/currencyId"}}},"deposit":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount of money that will be temporarily pre-authorised or blocked on the traveller’s credit card at the rental location as a security deposit, to cover potential damage or extra charges."},"children":[]}]}]}],"type":["object","null"],"properties":{"amount":{"description":"The amount to be charged.","type":"number","format":"double"},"currency":{"$ref":"#/components/schemas/currencyId"}}},"insurance_package":{"description":"The supplier insurance package applied to this product by default. Use the insurance object instead when third-party insurance products are configured in your account.","type":"string","enum":["basic","inclusive","zero_excess"]},"fuel":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The fuel policy that applies to this product. Maps to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fuel_policies"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" constant returned by the /cars/constants endpoint."},"children":[]}]}]}],"type":"string","enum":["return_same","return_same_or_prepay_no_refunds","return_same_preauth","free_tank","prepay_no_refunds","prepay_part_refunds","prepay_refunds"]},"mileage":{"$ref":"#/components/schemas/mileageOutput"},"payment":{"$ref":"#/components/schemas/paymentOutput"},"theft_excess":{"description":"The maximum amount a traveller may be charged in the event of car theft during the rental period, as outlined in the rental agreement.","type":["object","null"],"properties":{"amount":{"description":"The amount to be charged.","type":"number","format":"double"},"currency":{"$ref":"#/components/schemas/currencyId"}}}}}},"components/schemas/schemas-chargeTypeId":{"id":"components/schemas/schemas-chargeTypeId","kind":"json-schema","title":"schemas-chargeTypeId","data":{"description":"The type of this charge.","type":"string"}},"components/schemas/charge":{"id":"components/schemas/charge","kind":"json-schema","title":"CarsCharge","data":{"title":"CarsCharge","description":"Defines the charge, including the type of charge and its total amount.","type":"object","properties":{"charge":{"$ref":"#/components/schemas/schemas-chargeTypeId"},"total_amount":{"description":"The total price for this charge.","$ref":"#/components/schemas/monetaryAmount"}}}},"components/schemas/productPrice":{"id":"components/schemas/productPrice","kind":"json-schema","title":"productPrice","data":{"description":"The price components of this product.","type":"object","properties":{"currency":{"$ref":"#/components/schemas/currencyId"},"credit_card_required":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether a credit card is required as a guarantee for this vehicle."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"true: A credit card must be provided and will be passed to the supplier for guarantee purposes. Applies to vehicles with 'payment.timing = pay_at_pickup'."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"false: A credit card is explicitly not required."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"null: Information not available or not applicable (for example, pay-online-now vehicles where credit card requirements are currently unknown)."},"children":[]}]}]}]}],"type":["boolean","null"]},"extra_charges":{"title":"CarsProductExtraCharges","description":"The charge breakdown. Includes taxes and fees included in the drive away price.","type":"array","items":{"$ref":"#/components/schemas/charge"}},"total":{"description":"The total price. Includes all extra charges.","$ref":"#/components/schemas/monetaryAmount"}}}},"components/schemas/depots_depotId":{"id":"components/schemas/depots_depotId","kind":"json-schema","title":"depots_depotId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier of a depot. Retrieve the full list by calling the (/cars/depots](#/cars/depots)."},"children":[]}]}]}],"type":"integer","minimum":1,"example":5944}},"components/schemas/routePointOutput":{"id":"components/schemas/routePointOutput","kind":"json-schema","title":"routePointOutput","data":{"description":"Defines the product pickup / dropoff route point.","type":"object","properties":{"depot":{"description":"The identifier of the depot used for pickup or dropoff.","$ref":"#/components/schemas/depots_depotId"},"depot_location_type":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Type of depot location where the vehicle is picked up or dropped off. For example, 'shuttle_bus', 'in_terminal', etc."},"children":[]}]}]}],"type":"string","enum":["in_terminal","car_rental_centre","outside_terminal","airport_hotel","shuttle_bus","meet_greet","trainstation","downtown"]}}}},"components/schemas/routeOutput":{"id":"components/schemas/routeOutput","kind":"json-schema","title":"routeOutput","data":{"description":"Defines the actual route associated with the product.","type":"object","properties":{"pickup":{"description":"Defines the product pickup route point.","$ref":"#/components/schemas/routePointOutput"},"dropoff":{"description":"Defines the product dropoff route point.","$ref":"#/components/schemas/routePointOutput"}}}},"components/schemas/insuranceOutput":{"id":"components/schemas/insuranceOutput","kind":"json-schema","title":"insuranceOutput","data":{"description":"Third-party insurance product for this car rental. Only present for eligible partner configurations. Null if not available.","type":["object","null"],"properties":{"name":{"description":"The display name of the insurance product.","type":"string","examples":["Full Protection"]},"id":{"description":"The identifier for the type of insurance product.","type":"string","examples":["999"]},"price":{"description":"The price of the insurance product for the full rental period.","type":"object","properties":{"amount":{"description":"The insurance price amount.","$ref":"#/components/schemas/monetaryAmount"},"currency":{"$ref":"#/components/schemas/currencyId"}}}}}},"components/schemas/vehicleSupplierId":{"id":"components/schemas/vehicleSupplierId","kind":"json-schema","title":"vehicleSupplierId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Uniquely identifies a vehicle supplier. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/cars/suppliers"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/cars/suppliers"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/urlOutput":{"id":"components/schemas/urlOutput","kind":"json-schema","title":"urlOutput","data":{"description":"Urls to the relevant pages.","type":"object","properties":{"app":{"description":"URL for the related page on Booking App.","type":"string","format":"uri"},"web":{"description":"URL for the related page on cars.booking.com.","type":"string","format":"uri"}}}},"components/schemas/schemas-product":{"id":"components/schemas/schemas-product","kind":"json-schema","title":"schemas-product","data":{"description":"Detailed information about car rental product.","type":"object","properties":{"car":{"$ref":"#/components/schemas/carFleetId"},"categories":{"$ref":"#/components/schemas/categories"},"deal":{"$ref":"#/components/schemas/dealsOutput"},"offer":{"$ref":"#/components/schemas/offerId"},"policies":{"$ref":"#/components/schemas/policiesOutput"},"price":{"$ref":"#/components/schemas/productPrice"},"route":{"$ref":"#/components/schemas/routeOutput"},"special_offer":{"description":"The special offer included with this product, if any. This can be an additional service, a free upgrade, or a promotional feature provided by the supplier. If no special offer applies, the value will be null.","type":["string","null"],"examples":["upgrade"],"enum":["one_additional_driver","two_additional_drivers","three_additional_drivers","all_additional_drivers","gps","baby_or_child_seat","priority_pickup","wifi_device","sim_card","upgrade","black_friday","getaway_deal","mobile_rate"]},"insurance":{"$ref":"#/components/schemas/insuranceOutput"},"supplier":{"description":"Related supplier id.","$ref":"#/components/schemas/vehicleSupplierId"},"url":{"$ref":"#/components/schemas/urlOutput"},"estimated_commission":{"title":"EstimatedCommissionOutput","description":"Estimated commission the partner may earn if the traveller books this car. Expressed in the selected currency and based on predictive modelling at search time. Only returned when the predicted commission feature is enabled for the partner. Omitted when the feature is unavailable or when a reliable estimate cannot be produced.","type":["object","null"],"properties":{"amount":{"description":"Estimated commission amount in the currency below.","$ref":"#/components/schemas/monetaryAmount"},"currency":{"$ref":"#/components/schemas/currencyId"}}}}}},"components/schemas/metadata":{"id":"components/schemas/metadata","kind":"json-schema","title":"MetadataOutput","data":{"title":"MetadataOutput","description":"Metadata about the request.","type":"object","properties":{"next_page":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":"string","nullable":true},"total_results":{"description":"The total number of results available.","type":"integer","minimum":0}}}},"components/schemas/cars_search_output":{"id":"components/schemas/cars_search_output","kind":"json-schema","title":"cars_search_output","data":{"type":"object","required":["request_id","data"],"properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/schemas-product"}},"metadata":{"$ref":"#/components/schemas/metadata"},"search_token":{"description":"Encoded string that must be passed in subsequent requests to identify the context of the car search. Note: It is specific to Car rentals and differs from other tokens used in booking flows.","type":"string"}}}},"components/schemas/cars_constants_input":{"id":"components/schemas/cars_constants_input","kind":"json-schema","title":"CarsConstantsInput","data":{"title":"CarsConstantsInput","type":"object","properties":{"constants":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this field to limit the response to specific categories, such as fuel_policies, depot_services, customer_services, etc. If omitted, all constants are returned."},"children":[]}]}]}],"type":"array","items":{"type":"string","enum":["car_categories","customer_services","depot_services","depot_types","extras","special_offers","fuel_policies","fuel_types","general","payment_timings","protection_levels","review_scores","transmission"],"x-enumDescriptions":{"car_categories":"Vehicle categories used to group rental cars by size and type, such as economy, SUV, or premium.","customer_services":"Customer support contact details per language.","depot_services":"Services available at the car pick-up location.","depot_types":"Types of car rental locations, such as airport, downtown, or train station.","extras":"Optional add-ons such as child seats, GPS, or winter equipment.","special_offers":"Included benefits or promotions bundled with the rental.","fuel_policies":"Fuel handling policies for the rental.","fuel_types":"Types of fuel supported by the vehicle.","general":"General attributes and labels used across the Cars API.","payment_timings":"When the traveller is charged for the booking.","protection_levels":"Levels of insurance or protection coverage applied to the rental, affecting the traveller's financial liability.","review_scores":"Categories used to evaluate customer reviews of rental experiences, such as cleanliness or pick-up speed.","transmission":"Vehicle transmission types."}}},"languages":{"type":"array","description":"List of language codes used to localise constant names. Each constant name is returned as a translated object keyed by language. If not provided, en-gb is used by default.","items":{"$ref":"#/components/schemas/languageId"},"default":["en-gb"]}}}},"components/schemas/carsConstant":{"id":"components/schemas/carsConstant","kind":"json-schema","title":"CarsConstant","data":{"title":"CarsConstant","description":"Represents a constant identifier and its translated display names for the requested languages.","type":"array","items":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Id and translated names for the constant. Some constants may represent bundled products rather than single items. For example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"skierized_equipment"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" refers to a winter sports package that typically includes a ski rack (up to 4 pairs of skis), an ice scraper, and winter or all-season tyres. Exact components may vary by supplier."},"children":[]}]}]}],"type":"object","properties":{"id":{"type":"string"},"name":{"$ref":"#/components/schemas/translatedString"}}}}},"components/schemas/cars_constants_output":{"id":"components/schemas/cars_constants_output","kind":"json-schema","title":"CarsConstantsOutput","data":{"title":"CarsConstantsOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"title":"ConstantsDataOutput","description":"Contains constant groups keyed by constant type. Each group includes a list of constant identifiers and their translated names.","type":"object","properties":{"car_categories":{"$ref":"#/components/schemas/carsConstant"},"customer_services":{"description":"Customer service contact details per language. For each requested language, the API returns the corresponding customer support email address. English uses the default address, while other languages include a language-specific suffix.","$ref":"#/components/schemas/carsConstant"},"depot_services":{"$ref":"#/components/schemas/carsConstant"},"depot_types":{"$ref":"#/components/schemas/carsConstant"},"extras":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of available extra products. Each item represents an optional add-on. Some extras may be bundled packages rather than individual items. For example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"skierized_equipment"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" refers to a winter sports package that typically includes a ski rack, ice scraper, and winter or all-season tyres."},"children":[]}]}]}],"$ref":"#/components/schemas/carsConstant"},"special_offers":{"$ref":"#/components/schemas/carsConstant"},"fuel_policies":{"$ref":"#/components/schemas/carsConstant"},"fuel_types":{"$ref":"#/components/schemas/carsConstant"},"general":{"$ref":"#/components/schemas/carsConstant"},"payment_timings":{"$ref":"#/components/schemas/carsConstant"},"protection_levels":{"$ref":"#/components/schemas/carsConstant"},"review_scores":{"$ref":"#/components/schemas/carsConstant"},"transmission":{"$ref":"#/components/schemas/carsConstant"}}}}}},"components/schemas/depots_input":{"id":"components/schemas/depots_input","kind":"json-schema","title":"depots_input","data":{"type":"object","properties":{"last_modified":{"description":"Returns depots modified after the specified timestamp (exclusive).","example":"2026-03-01T11:05:00+00:00","format":"date-time","type":"string"},"maximum_results":{"$ref":"#/components/schemas/maximumResults"},"languages":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of language codes to return translated fields. If a translation is unavailable, the default language ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"en-gb"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") is returned."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/languageId"},"default":["en-gb"]},"page":{"$ref":"#/components/schemas/page"}}}},"components/schemas/depots_contact":{"id":"components/schemas/depots_contact","kind":"json-schema","title":"depots_contact","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contact information of the depot. Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when unavailable."},"children":[]}]}]}],"type":"object","properties":{"email":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Email address of the depot. Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when unavailable."},"children":[]}]}]}],"example":"depot@test.booking.com","type":["string","null"]},"telephone":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Telephone number of the depot. Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when unavailable."},"children":[]}]}]}],"example":"+31882847620","type":["string","null"]}}}},"components/schemas/city":{"id":"components/schemas/city","kind":"json-schema","title":"city","data":{"description":"Unique identifier of the city where the depot is located. If the city ID is not included in the list returned by /common/locations/cities, call that endpoint using the city filter.","type":"integer","example":-1471393}},"components/schemas/openingHoursRange":{"id":"components/schemas/openingHoursRange","kind":"json-schema","title":"openingHoursRange","data":{"description":"Depot opening hours range.","type":"object","properties":{"closing_time":{"description":"Depot closing time","example":"21:00:00","format":"time","type":"string"},"opening_time":{"description":"Depot opening time.","example":"07:00:00","format":"time","type":"string"}}}},"components/schemas/workingHours":{"id":"components/schemas/workingHours","kind":"json-schema","title":"workingHours","data":{"description":"Opening and closing times per day of the week. Days may be omitted if the depot is closed.","type":"object","patternProperties":{"^(monday|tuesday|wednesday|thursday|friday|saturday|sunday)$":{"description":"Working hours for the day.","type":"array","items":{"$ref":"#/components/schemas/openingHoursRange"}}}}},"components/schemas/instructions":{"id":"components/schemas/instructions","kind":"json-schema","title":"instructions","data":{"description":"Pickup or drop-off information.","type":["object","null"],"properties":{"instructions":{"description":"Translated pickup or drop-off instructions.","$ref":"#/components/schemas/translatedString"},"working_hours":{"description":"Depot working hours.","$ref":"#/components/schemas/workingHours"}}}},"components/schemas/location":{"id":"components/schemas/location","kind":"json-schema","title":"location","data":{"description":"Depot location information.","type":"object","properties":{"address":{"description":"Depot address information.","example":"5 Aankomstpassage","type":["string","null"]},"airport":{"description":"Airport IATA code.","example":"AMS","type":["string","null"]},"depot_location_type":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies where the depot is located (for example, inside the terminal, at a train station, or downtown). Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when not defined."},"children":[]}]}]}],"type":["string","null"],"enum":["in_terminal","car_rental_centre","outside_terminal","airport_hotel","shuttle_bus","meet_greet","trainstation","downtown"],"x-enumDescriptions":{"in_terminal":"Depot is located inside the airport terminal building.","car_rental_centre":"Depot is located in a dedicated car rental centre on or near airport grounds.","outside_terminal":"Depot is outside the terminal area, usually a short walk or drive away.","airport_hotel":"Depot is located at or inside an airport hotel.","shuttle_bus":"Depot requires a shuttle bus transfer from the airport or another meeting point.","meet_greet":"A rental agent meets the traveller in person at an agreed pick-up point (e.g., arrivals hall).","trainstation":"Depot is located in or near a train station.","downtown":"Depot is located in a central/downtown city area."}},"coordinates":{"$ref":"#/components/schemas/dataTypes_coordinates"},"country":{"$ref":"#/components/schemas/countryId"},"name":{"description":"Translated depot name.","allOf":[{"$ref":"#/components/schemas/translatedString"}],"example":{"en-gb":"Amsterdam Airport Schiphol - Terminal 3"}},"post_code":{"description":"Depot post code","example":"1118 AX","type":["string","null"]}}}},"components/schemas/numberOfReviews":{"id":"components/schemas/numberOfReviews","kind":"json-schema","title":"numberOfReviews","data":{"description":"Number of validated reviews for the depot.","type":"integer","example":125,"minimum":0}},"components/schemas/depots_reviewScore":{"id":"components/schemas/depots_reviewScore","kind":"json-schema","title":"depots_reviewScore","data":{"description":"Current review score of the depot, in the range 1.0 to 10.0.","type":"number","example":8.7,"multipleOf":0.1,"minimum":1,"maximum":10}},"components/schemas/ratings":{"id":"components/schemas/ratings","kind":"json-schema","title":"ratings","data":{"description":"Review count and average score for the depot.","type":["object","null"],"properties":{"number_of_reviews":{"$ref":"#/components/schemas/numberOfReviews"},"score":{"$ref":"#/components/schemas/depots_reviewScore"}}}},"components/schemas/depot":{"id":"components/schemas/depot","kind":"json-schema","title":"depot","data":{"description":"Static information about the car rental depot.","type":"object","properties":{"id":{"description":"Unique depot's ID.","$ref":"#/components/schemas/depots_depotId"},"contact":{"$ref":"#/components/schemas/depots_contact"},"city":{"description":"Unique identifier of the city. If the city ID is not included in the list returned by /common/locations/cities, call that endpoint using the city filter.","$ref":"#/components/schemas/city"},"pickup":{"description":"Pickup information for the depot.","$ref":"#/components/schemas/instructions"},"location":{"$ref":"#/components/schemas/location"},"dropoff":{"description":"Drop-off information for the depot.","$ref":"#/components/schemas/instructions"},"services":{"description":"List of services provided by the depot.","type":"array","items":{"type":"string","enum":["shuttle","meet_greet","unknown"]}},"supplier":{"description":"Unique identifier of the vehicle supplier. You can see the full list of supplier IDs calling /cars/suppliers.","$ref":"#/components/schemas/vehicleSupplierId"},"ratings":{"description":"Number of reviews and average score for the depot.","$ref":"#/components/schemas/ratings"}}}},"components/schemas/depots_output":{"id":"components/schemas/depots_output","kind":"json-schema","title":"depots_output","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/depot"}},"metadata":{"description":"Metadata about the request.","type":"object","properties":{"next_page":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates that more results are available. Pass this token to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to retrieve the next page of results."},"children":[]}]}]}],"type":["string","null"]}}}}}},"components/schemas/cars_depots_scores_input":{"id":"components/schemas/cars_depots_scores_input","kind":"json-schema","title":"cars_depots_scores_input","data":{"type":"object","properties":{"maximum_results":{"$ref":"#/components/schemas/maximumResults"},"page":{"$ref":"#/components/schemas/page"}}}},"components/schemas/schemas-breakdown_schema":{"id":"components/schemas/schemas-breakdown_schema","kind":"json-schema","title":"schemas-breakdown_schema","data":{"description":"Review score information for a specific evaluation category.","type":"object","properties":{"score":{"anyOf":[{"$ref":"#/components/schemas/score"},{"type":"null"}]}}}},"components/schemas/schemas-breakdown":{"id":"components/schemas/schemas-breakdown","kind":"json-schema","title":"schemas-breakdown","data":{"description":"Breakdown of review scores by evaluation category.","type":"object","properties":{"cleanliness":{"$ref":"#/components/schemas/schemas-breakdown_schema"},"condition":{"$ref":"#/components/schemas/schemas-breakdown_schema"},"drop_off_speed":{"$ref":"#/components/schemas/schemas-breakdown_schema"},"friendliness":{"$ref":"#/components/schemas/schemas-breakdown_schema"},"likeliness_rent_again":{"allOf":[{"$ref":"#/components/schemas/schemas-breakdown_schema"}],"deprecated":true,"description":"Deprecated. This field will be removed in a future version."},"location":{"$ref":"#/components/schemas/schemas-breakdown_schema"},"pick_up_speed":{"$ref":"#/components/schemas/schemas-breakdown_schema"},"value_for_money":{"$ref":"#/components/schemas/schemas-breakdown_schema"}},"additionalProperties":false}},"components/schemas/schemas-scores":{"id":"components/schemas/schemas-scores","kind":"json-schema","title":"schemas-scores","data":{"description":"Review scores, rating breakdown, and review volume information for a depot.","type":"object","properties":{"id":{"$ref":"#/components/schemas/depots_depotId"},"breakdown":{"$ref":"#/components/schemas/schemas-breakdown"},"number_of_reviews":{"anyOf":[{"$ref":"#/components/schemas/numberOfReviews"},{"type":"null"}]},"score":{"anyOf":[{"$ref":"#/components/schemas/depots_reviewScore"},{"type":"null"}]}}}},"components/schemas/cars_depots_scores_output":{"id":"components/schemas/cars_depots_scores_output","kind":"json-schema","title":"cars_depots_scores_output","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/schemas-scores"}},"metadata":{"description":"Pagination metadata for the response.","type":"object","properties":{"next_page":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":["string","null"]}}}}}},"components/schemas/cars_details_input":{"id":"components/schemas/cars_details_input","kind":"json-schema","title":"cars_details_input","data":{"type":"object","properties":{"last_modified":{"description":"The last modified date-time, only returns depots newer than this timestamp. The value should be within last 7 days","example":"2023-11-01T11:05:00+00:00","format":"date-time","type":"string"},"maximum_results":{"$ref":"#/components/schemas/maximumResults"},"page":{"$ref":"#/components/schemas/page"}}}},"components/schemas/carId":{"id":"components/schemas/carId","kind":"json-schema","title":"carId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Uniquely identifies a car specification. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/cars/details"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/cars/suppliers"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/capacity":{"id":"components/schemas/capacity","kind":"json-schema","title":"capacity","data":{"description":"Car's capacity","type":"object","properties":{"bags":{"description":"Car's Baggage Capacity.","type":"object","properties":{"large":{"description":"Number of large bags.","type":"number","minimum":0},"small":{"description":"Number of small bags.","type":"number","minimum":0}},"nullable":true},"doors":{"description":"Number of doors in the car.","type":"string"},"seats":{"description":"Number of seats in the car.","type":"string"}}}},"components/schemas/specification":{"id":"components/schemas/specification","kind":"json-schema","title":"specification","data":{"properties":{"code":{"description":"Car's code in ACRISS Standard (https://www.acriss.org/car-codes/expanded-matrix/).","type":"string"},"description":{"description":"Car Description Based on ACRISS Category and Type (https://www.acriss.org/car-codes/expanded-matrix/).","type":"string"},"fuel":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Car's fuel type. Maps to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fuel_types"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" constant returned by the /cars/constants endpoint."},"children":[]}]}]}],"type":"string","enum":["electric","petrol","plug_in_hybrid","multi_fuel","diesel","hybrid","lpg","hydrogen","ethanol","unspecified"]},"transmission":{"description":"Car's transmission.","type":"string","enum":["automatic","manual"]}}}},"components/schemas/details":{"id":"components/schemas/details","kind":"json-schema","title":"details","data":{"description":"All static information related to cars.","properties":{"id":{"description":"Unique car's ID.","$ref":"#/components/schemas/carId"},"capacity":{"$ref":"#/components/schemas/capacity"},"country":{"$ref":"#/components/schemas/countryId"},"features":{"description":"List of possible car's features.","type":"array","items":{"type":"string","enum":["air_conditioning","all_wheel_drive"]}},"image":{"description":"Car's image URL.","type":"string"},"make":{"description":"Car's maker/brand.","type":"string"},"model":{"description":"Car's model.","type":"string"},"specification":{"description":"Car's specification.","$ref":"#/components/schemas/specification"},"supplier":{"description":"Related supplier id.","$ref":"#/components/schemas/vehicleSupplierId"}},"type":"object"}},"components/schemas/cars_details_output":{"id":"components/schemas/cars_details_output","kind":"json-schema","title":"cars_details_output","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/details"}},"metadata":{"description":"Metadata about the request.","type":"object","properties":{"next_page":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":"string","nullable":true}}}}}},"components/schemas/cars_suppliers_input":{"id":"components/schemas/cars_suppliers_input","kind":"json-schema","title":"cars_suppliers_input","data":{"type":"object","properties":{"maximum_results":{"$ref":"#/components/schemas/maximumResults"},"page":{"$ref":"#/components/schemas/page"},"suppliers":{"description":"Defines the suppliers that should be returned. Without it all suppliers will be returned","type":"array","items":{"$ref":"#/components/schemas/vehicleSupplierId"},"maxItems":100}}}},"components/schemas/supplier":{"id":"components/schemas/supplier","kind":"json-schema","title":"supplier","data":{"description":"All static information related to an vehicle supplier.","type":"object","properties":{"id":{"$ref":"#/components/schemas/vehicleSupplierId"},"logo":{"description":"Supplier logo image URL.","type":"string","format":"uri"},"name":{"description":"Brand name of the vehicle supplier.","type":"string"}}}},"components/schemas/cars_suppliers_output":{"id":"components/schemas/cars_suppliers_output","kind":"json-schema","title":"cars_suppliers_output","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/supplier"}},"metadata":{"$ref":"#/components/schemas/metadata"}}}},"components/schemas/language":{"id":"components/schemas/language","kind":"json-schema","title":"LanguageOutput","data":{"title":"LanguageOutput","description":"The language code and its designation in the corresponding language.","type":"object","properties":{"id":{"$ref":"#/components/schemas/languageId"},"name":{"type":"string"}}}},"components/schemas/languages_output":{"id":"components/schemas/languages_output","kind":"json-schema","title":"LanguagesOutput","data":{"title":"LanguagesOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/language"}}}}},"components/schemas/airportInput":{"id":"components/schemas/airportInput","kind":"json-schema","title":"AirportsInput","data":{"title":"AirportsInput","type":"object","properties":{"airport":{"$ref":"#/components/schemas/airportId"},"city":{"$ref":"#/components/schemas/cityId"},"country":{"$ref":"#/components/schemas/countryId"},"district":{"$ref":"#/components/schemas/districtId"},"landmark":{"$ref":"#/components/schemas/landmarkId"},"languages":{"type":"array","items":{"$ref":"#/components/schemas/languageId"},"default":["en-gb"]},"page":{"$ref":"#/components/schemas/page"},"region":{"$ref":"#/components/schemas/regionId"},"rows":{"$ref":"#/components/schemas/maximumResults","maximum":1000}}}},"components/schemas/airport":{"id":"components/schemas/airport","kind":"json-schema","title":"AirportOutput","data":{"title":"AirportOutput","description":"The three-letter IATA airport code and the translated name(s).","type":"object","properties":{"id":{"$ref":"#/components/schemas/airportId"},"name":{"$ref":"#/components/schemas/translatedString"}}}},"components/schemas/airportOutput":{"id":"components/schemas/airportOutput","kind":"json-schema","title":"AirportsOutput","data":{"title":"AirportsOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/airport"}},"metadata":{"title":"MetadataOutput","type":"object","properties":{"next_page":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":"string","nullable":true}}}}}},"components/schemas/citiesInput":{"id":"components/schemas/citiesInput","kind":"json-schema","title":"CitiesInput","data":{"title":"CitiesInput","type":"object","properties":{"airport":{"$ref":"#/components/schemas/airportId"},"city":{"$ref":"#/components/schemas/cityId"},"country":{"$ref":"#/components/schemas/countryId"},"district":{"$ref":"#/components/schemas/districtId"},"landmark":{"$ref":"#/components/schemas/landmarkId"},"languages":{"type":"array","items":{"$ref":"#/components/schemas/languageId"},"default":["en-gb"]},"page":{"$ref":"#/components/schemas/page"},"region":{"$ref":"#/components/schemas/regionId"},"rows":{"$ref":"#/components/schemas/maximumResults","maximum":1000}}}},"components/schemas/cities_city":{"id":"components/schemas/cities_city","kind":"json-schema","title":"CityOutput","data":{"title":"CityOutput","description":"The city internal code and the translated name(s).","type":"object","properties":{"id":{"$ref":"#/components/schemas/cityId"},"name":{"$ref":"#/components/schemas/translatedString"},"coordinates":{"$ref":"#/components/schemas/dataTypes_coordinates"}}}},"components/schemas/citiesOutput":{"id":"components/schemas/citiesOutput","kind":"json-schema","title":"CitiesOutput","data":{"title":"CitiesOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/cities_city"}},"metadata":{"title":"MetadataOutput","type":"object","properties":{"next_page":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":"string","nullable":true}}}}}},"components/schemas/countriesInput":{"id":"components/schemas/countriesInput","kind":"json-schema","title":"CountriesInput","data":{"title":"CountriesInput","type":"object","properties":{"airport":{"$ref":"#/components/schemas/airportId"},"city":{"$ref":"#/components/schemas/cityId"},"country":{"$ref":"#/components/schemas/countryId"},"district":{"$ref":"#/components/schemas/districtId"},"landmark":{"$ref":"#/components/schemas/landmarkId"},"languages":{"type":"array","items":{"$ref":"#/components/schemas/languageId"},"default":["en-gb"]},"page":{"$ref":"#/components/schemas/page"},"region":{"$ref":"#/components/schemas/regionId"},"rows":{"$ref":"#/components/schemas/maximumResults","maximum":1000}}}},"components/schemas/country":{"id":"components/schemas/country","kind":"json-schema","title":"CountryOutput","data":{"title":"CountryOutput","description":"The two-letter ISO2 country code and the translated name(s).","type":"object","properties":{"id":{"$ref":"#/components/schemas/countryId"},"name":{"$ref":"#/components/schemas/translatedString"}}}},"components/schemas/countriesOutput":{"id":"components/schemas/countriesOutput","kind":"json-schema","title":"CountriesOutput","data":{"title":"CountriesOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/country"}},"metadata":{"title":"MetadataOutput","type":"object","properties":{"next_page":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":"string","nullable":true}}}}}},"components/schemas/districtsInput":{"id":"components/schemas/districtsInput","kind":"json-schema","title":"DistrictsInput","data":{"title":"DistrictsInput","type":"object","properties":{"airport":{"$ref":"#/components/schemas/airportId"},"city":{"$ref":"#/components/schemas/cityId"},"country":{"$ref":"#/components/schemas/countryId"},"district":{"$ref":"#/components/schemas/districtId"},"landmark":{"$ref":"#/components/schemas/landmarkId"},"languages":{"type":"array","items":{"$ref":"#/components/schemas/languageId"},"default":["en-gb"]},"page":{"$ref":"#/components/schemas/page"},"region":{"$ref":"#/components/schemas/regionId"},"rows":{"$ref":"#/components/schemas/maximumResults","maximum":1000}}}},"components/schemas/district":{"id":"components/schemas/district","kind":"json-schema","title":"DistrictOutput","data":{"title":"DistrictOutput","description":"The district id and the translated name(s).","type":"object","properties":{"id":{"$ref":"#/components/schemas/districtId"},"name":{"$ref":"#/components/schemas/translatedString"},"coordinates":{"$ref":"#/components/schemas/dataTypes_coordinates"}}}},"components/schemas/districtsOutput":{"id":"components/schemas/districtsOutput","kind":"json-schema","title":"DistrictsOutput","data":{"title":"DistrictsOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/district"}},"metadata":{"title":"MetadataOutput","type":"object","properties":{"next_page":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":"string","nullable":true}}}}}},"components/schemas/landmarksInput":{"id":"components/schemas/landmarksInput","kind":"json-schema","title":"LandmarksInput","data":{"title":"LandmarksInput","type":"object","properties":{"airport":{"$ref":"#/components/schemas/airportId"},"city":{"$ref":"#/components/schemas/cityId"},"country":{"$ref":"#/components/schemas/countryId"},"district":{"$ref":"#/components/schemas/districtId"},"landmark":{"$ref":"#/components/schemas/landmarkId"},"languages":{"type":"array","items":{"$ref":"#/components/schemas/languageId"},"default":["en-gb"]},"page":{"$ref":"#/components/schemas/page"},"region":{"$ref":"#/components/schemas/regionId"},"rows":{"$ref":"#/components/schemas/maximumResults","maximum":1000}}}},"components/schemas/landmark":{"id":"components/schemas/landmark","kind":"json-schema","title":"LandmarkOutput","data":{"title":"LandmarkOutput","description":"The landmark internal code and the translated name(s).","type":"object","properties":{"id":{"$ref":"#/components/schemas/landmarkId"},"name":{"$ref":"#/components/schemas/translatedString"},"coordinates":{"$ref":"#/components/schemas/dataTypes_coordinates"}}}},"components/schemas/landmarksOutput":{"id":"components/schemas/landmarksOutput","kind":"json-schema","title":"LandmarksOutput","data":{"title":"LandmarksOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/landmark"}},"metadata":{"title":"MetadataOutput","type":"object","properties":{"next_page":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":"string","nullable":true}}}}}},"components/schemas/regionsInput":{"id":"components/schemas/regionsInput","kind":"json-schema","title":"RegionsInput","data":{"title":"RegionsInput","type":"object","properties":{"airport":{"$ref":"#/components/schemas/airportId"},"city":{"$ref":"#/components/schemas/cityId"},"country":{"$ref":"#/components/schemas/countryId"},"landmark":{"$ref":"#/components/schemas/landmarkId"},"languages":{"type":"array","items":{"$ref":"#/components/schemas/languageId"},"default":["en-gb"]},"page":{"$ref":"#/components/schemas/page"},"region":{"$ref":"#/components/schemas/regionId"},"rows":{"$ref":"#/components/schemas/maximumResults","maximum":1000}}}},"components/schemas/region":{"id":"components/schemas/region","kind":"json-schema","title":"RegionOutput","data":{"title":"RegionOutput","description":"The region id and the translated name(s).","type":"object","properties":{"id":{"$ref":"#/components/schemas/regionId"},"name":{"$ref":"#/components/schemas/translatedString"}}}},"components/schemas/regionsOutput":{"id":"components/schemas/regionsOutput","kind":"json-schema","title":"RegionsOutput","data":{"title":"RegionsOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/region"}},"metadata":{"title":"MetadataOutput","type":"object","properties":{"next_page":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":"string","nullable":true}}}}}},"components/schemas/dataTypes_paymentCardId":{"id":"components/schemas/dataTypes_paymentCardId","kind":"json-schema","title":"dataTypes_paymentCardId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A signed integer number that uniquely identifies a payment type. Examples of payment types are the different credit and debit cards. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/3.2/demand-api/commonpayments/common/payments/cards","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/payments/cards"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"integer","minimum":1}},"components/schemas/paymentCard":{"id":"components/schemas/paymentCard","kind":"json-schema","title":"PaymentCardOutput","data":{"title":"PaymentCardOutput","description":"The payment card identifier code and its designation in English.","type":"object","properties":{"id":{"$ref":"#/components/schemas/dataTypes_paymentCardId"},"name":{"type":"string"}}}},"components/schemas/cards_output":{"id":"components/schemas/cards_output","kind":"json-schema","title":"CardsDataOutput","data":{"title":"CardsDataOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/paymentCard"}}}}},"components/schemas/currencies_input":{"id":"components/schemas/currencies_input","kind":"json-schema","title":"CurrenciesInput","data":{"title":"CurrenciesInput","type":"object","properties":{"languages":{"type":"array","items":{"$ref":"#/components/schemas/languageId"},"default":["en-gb"]}}}},"components/schemas/currencies_currency":{"id":"components/schemas/currencies_currency","kind":"json-schema","title":"CurrencyOutput","data":{"title":"CurrencyOutput","description":"The ISO 4217 currency code and its designation in the selected language.","type":"object","properties":{"id":{"$ref":"#/components/schemas/currencyId"},"name":{"$ref":"#/components/schemas/translatedString"}}}},"components/schemas/currencies_output":{"id":"components/schemas/currencies_output","kind":"json-schema","title":"CurrenciesOutput","data":{"title":"CurrenciesOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/currencies_currency"}}}}},"components/schemas/carProductInput":{"id":"components/schemas/carProductInput","kind":"json-schema","title":"CarProductInput","data":{"title":"CarProductInput","description":"Input for selecting optional extras (for example, child seats or GPS).","type":"object","properties":{"id":{"description":"Identifier of the add-on product returned by /cars/availability. The ID is scoped to the current search session and must match the selected offer.","type":"string"},"amount":{"description":"Quantity of the selected add-on product returned by /cars/availability. Must be 1 or greater.","type":"integer","minimum":1}},"required":["id","amount"]}},"components/schemas/carInput":{"id":"components/schemas/carInput","kind":"json-schema","title":"OrdersPreviewCarInput","data":{"title":"OrdersPreviewCarInput","description":"Additional information related to the car order. This field is mutually exclusive with accommodation; only one of them can be included in a request.","type":"object","properties":{"search_token":{"description":"Encoded string returned by the car search. Note: It is specific to Car rentals and differs from other tokens used in booking flows.","type":"string"},"offer":{"$ref":"#/components/schemas/offerId"},"products":{"description":"List of additional products to add to the car rental (e.g., child seats, GPS, additional insurance).","type":"array","items":{"$ref":"#/components/schemas/carProductInput"}},"insurance":{"description":"Insurance details for this car rental. Include this to add third-party insurance to the booking. If omitted, the booking proceeds without insurance.","type":"object","properties":{"quote_reference":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The insurance quote reference obtained from /cars/availability."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Include this field to attach third-party insurance to the booking. If omitted, the booking proceeds without insurance."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The quote_reference must be valid and not expired. If invalid or expired, the request will fail or insurance will not be applied."},"children":[]}]}]}],"type":"string"}},"required":["quote_reference"]},"language":{"description":"Optional. Specifies the language used for insurance documents (IPID and policy document) returned in the response.\n\nIf not provided, or if the requested language is not available, documents default to English (en-gb).\nIf English is also not available for the selected insurance product, the insurance object is not returned, as legally required documentation must be provided.\n\nNote: Uses IETF language tag format (for example, 'fr', 'de').","$ref":"#/components/schemas/languageId"}},"required":["search_token","offer"]}},"components/schemas/preview_booker":{"id":"components/schemas/preview_booker","kind":"json-schema","title":"OrdersPreviewBookerOutput","data":{"title":"OrdersPreviewBookerOutput","description":"The booker's information.","type":"object","properties":{"country":{"description":"The booker country for showing the best price for that user and obeying laws regarding the display of taxes and fees.","type":"string","pattern":"^[a-z]{2}$"},"platform":{"description":"The booker platform for showing the platform based deals and prices.","type":"string","enum":["android","desktop","ios","mobile","tablet"]},"travel_purpose":{"description":"The travel purpose of the booker.","type":"string","enum":["business","leisure"]},"user_groups":{"description":"The user groups that the booker is a member of.","type":"array","items":{"type":"string","enum":["authenticated"]}}},"required":["country","platform"]}},"components/schemas/preview_allocation":{"id":"components/schemas/preview_allocation","kind":"json-schema","title":"OrdersPreviewAccommodationAllocationOutput","data":{"title":"OrdersPreviewAccommodationAllocationOutput","description":"The exact allocation of guests to a room.","type":"object","properties":{"children":{"description":"The children ages for this room.","type":"array","items":{"type":"integer","minimum":0,"maximum":17}},"number_of_adults":{"description":"The number of adults for this room.","type":"integer","minimum":1}},"required":["number_of_adults"]}},"components/schemas/productInput":{"id":"components/schemas/productInput","kind":"json-schema","title":"OrdersPreviewProductInput","data":{"title":"OrdersPreviewProductInput","description":"Input parameter with the product id and the desired allocation for that product","type":"object","properties":{"id":{"$ref":"#/components/schemas/productId"},"allocation":{"$ref":"#/components/schemas/preview_allocation"}}}},"components/schemas/accommodationInput":{"id":"components/schemas/accommodationInput","kind":"json-schema","title":"OrdersPreviewAccommodationInput","data":{"title":"OrdersPreviewAccommodationInput","description":"Input parameter with the checkin and checkout date and all the accommodation products to be ordered. This field is mutually exclusive with car; only one of them can be included in a request.","type":"object","properties":{"id":{"$ref":"#/components/schemas/accommodationId"},"booker":{"$ref":"#/components/schemas/preview_booker"},"checkin":{"$ref":"#/components/schemas/checkin"},"checkout":{"$ref":"#/components/schemas/checkout"},"products":{"type":"array","items":{"$ref":"#/components/schemas/productInput"}}},"required":["id","booker","checkin","checkout","products"]}},"components/schemas/previewInput":{"id":"components/schemas/previewInput","kind":"json-schema","title":"OrdersPreviewInput","data":{"title":"OrdersPreviewInput","type":"object","properties":{"car":{"$ref":"#/components/schemas/carInput"},"accommodation":{"$ref":"#/components/schemas/accommodationInput"},"currency":{"$ref":"#/components/schemas/currencyId"}},"oneOf":[{"title":"Preview car order","description":"Use this option to preview pricing and policies for car rentals.","required":["car"]},{"title":"Preview accommodation order","description":"Use this option to preview pricing and policies for accommodation reservations.","required":["accommodation"]}]}},"components/schemas/paymentSchedule":{"id":"components/schemas/paymentSchedule","kind":"json-schema","title":"AccommodationsPaymentSchedule","data":{"title":"AccommodationsPaymentSchedule","type":"object","properties":{"at":{"description":"The date at which this instalment will be charged.","type":"string","format":"date"},"price":{"description":"The amount charged in this instalment.","$ref":"#/components/schemas/priceCurrencyOutput"}}}},"components/schemas/dataTypes_paymentMethods":{"id":"components/schemas/dataTypes_paymentMethods","kind":"json-schema","title":"AccommodationsPaymentMethods","data":{"title":"AccommodationsPaymentMethods","type":"object","description":"The payment methods available for the payment timing selected.","properties":{"airplus":{"description":"Whether airplus can be used as a payment method for this order.","type":"boolean"},"cards":{"description":"The cards available to pay.","type":"array","items":{"$ref":"#/components/schemas/dataTypes_paymentCardId"}},"wallet":{"description":"Whether wallet can be used as a payment method for this order.","type":"boolean"}},"nullable":true}},"components/schemas/productPaymentTimingsDates":{"id":"components/schemas/productPaymentTimingsDates","kind":"json-schema","title":"AccommodationsProductPaymentTimingsDates","data":{"title":"AccommodationsProductPaymentTimingsDates","description":"","type":"object","properties":{"pay_online_now":{"title":"AccommodationsPayOnlineNow","type":["object","null"],"properties":{"dates":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Schedule specifying the instalments for paying the order for the \"pay_online_now\" option. For each,entry in the schedule, a charge will be made at the time of that entry."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/paymentSchedule"}},"method_required":{"description":"Whether a payment method is required for this payment timing.","type":"boolean"},"methods":{"$ref":"#/components/schemas/dataTypes_paymentMethods"}}},"pay_online_later":{"title":"AccommodationsPayOnlineLater","type":"object","properties":{"dates":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Schedule specifying the instalments for paying the order for this product for the \"pay_online_later\" option.  For each entry in the schedule, a charge will be made at the time of that entry."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/paymentSchedule"}},"method_required":{"description":"Whether a payment method is required for this payment timing.","type":"boolean"},"methods":{"$ref":"#/components/schemas/dataTypes_paymentMethods"}},"nullable":true},"pay_at_the_property":{"title":"AccommodationsPayAtTheProperty","type":"object","properties":{"dates":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Schedule specifying the instalments for paying the order for this product for the \"pay_at_the_property\" option.  For each entry in the schedule, a charge will be made at the time of that entry."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/paymentSchedule"}},"method_required":{"description":"Whether a payment method is required for this payment timing.","type":"boolean"},"methods":{"$ref":"#/components/schemas/dataTypes_paymentMethods"}},"nullable":true}}}},"components/schemas/PriceSummaryPreviewV32":{"id":"components/schemas/PriceSummaryPreviewV32","kind":"json-schema","title":"OrdersPreviewProductSumPriceOutput","data":{"title":"OrdersPreviewProductSumPriceOutput","description":"The price components of all the products selected summed.","type":"object","properties":{"base":{"description":"The sum base price of all products selected. Does not include any extra charges.","$ref":"#/components/schemas/priceMultiCurrencyOutput"},"chargeable_online":{"description":"The price that is chargeable online. null for agency properties.","$ref":"#/components/schemas/priceMultiCurrencyOutput","nullable":true},"charges":{"description":"The sum of charges for all products selected, grouped by charge type.","type":"array","items":{"$ref":"#/components/schemas/chargeSummaryV32"}},"display":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The display price that must be shown to the traveller. Equivalent to base + charges where included_in.display=true."},"children":[]}]}]}],"$ref":"#/components/schemas/priceMultiCurrencyOutput"},"total":{"description":"The total sum price. Includes all extra charges of all products.","$ref":"#/components/schemas/priceMultiCurrencyOutput"}}}},"components/schemas/productDetailedPoliciesMultiCurrency":{"id":"components/schemas/productDetailedPoliciesMultiCurrency","kind":"json-schema","title":"AccommodationsProductDetailedPoliciesMultiCurrency","data":{"title":"AccommodationsProductDetailedPoliciesMultiCurrency","description":"The policies for this product.","type":"object","properties":{"cancellation":{"$ref":"#/components/schemas/productDetailedCancellationPolicyMultiCurrency"},"meal_plan":{"$ref":"#/components/schemas/productMealPlanPolicy"}}}},"components/schemas/roomIdPreview":{"id":"components/schemas/roomIdPreview","kind":"json-schema","title":"roomIdPreview","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique identifier for a specific room within an accommodation property. You can retrieve the full list of available room IDs by calling "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/details"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accommodations/details"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":["string","null"]}},"components/schemas/occupancyOutput":{"id":"components/schemas/occupancyOutput","kind":"json-schema","title":"OccupancyOutput","data":{"title":"OccupancyOutput","description":"Describes an occupancy in terms of number of adults and children's ages.","type":"object","properties":{"number_of_adults":{"description":"The number of adults.","type":"integer","minimum":0},"children":{"description":"Contains the ages of the accommodated children. Null if there are no children.","type":["array","null"],"items":{"type":"integer","minimum":0,"maximum":17}}},"required":["number_of_adults","children"]}},"components/schemas/occupancyMismatchOutput":{"id":"components/schemas/occupancyMismatchOutput","kind":"json-schema","title":"OccupancyMismatchOutput","data":{"title":"OccupancyMismatchOutput","description":"Represents the distribution of requested guests relative to the product's capacity. Includes the guests that can be accommodated (allocated) and those that cannot (unallocated).","type":"object","properties":{"allocated":{"description":"The guests from the original request that the product can accommodate.","$ref":"#/components/schemas/occupancyOutput"},"unallocated":{"description":"The guests from the original request that could not be accommodated by this product.","$ref":"#/components/schemas/occupancyOutput"}},"required":["allocated","unallocated"],"example":{"allocated":{"number_of_adults":1,"children":null},"unallocated":{"number_of_adults":1,"children":null}}}},"components/schemas/previewProductOutput":{"id":"components/schemas/previewProductOutput","kind":"json-schema","title":"OrdersPreviewProductOutput","data":{"title":"OrdersPreviewProductOutput","description":"The returned information of the product selected","type":"object","properties":{"id":{"$ref":"#/components/schemas/productId"},"bundle":{"$ref":"#/components/schemas/bundleId"},"deal":{"$ref":"#/components/schemas/dealV32"},"inventory":{"$ref":"#/components/schemas/inventoryOutput"},"policies":{"$ref":"#/components/schemas/productDetailedPoliciesMultiCurrency"},"price":{"$ref":"#/components/schemas/priceV32"},"room":{"$ref":"#/components/schemas/roomIdPreview"},"occupancy_mismatch":{"description":"Details any mismatch between the requested occupancy and the product's capacity. \n-When one or more guests cannot be accommodated, the object contains those that can be accommodated (allocated) and those that cannot (unallocated). \n-If all requested guests fit, the object is null.","type":["object","null"],"$ref":"#/components/schemas/occupancyMismatchOutput"}}}},"components/schemas/carMonetaryAmountOutput":{"id":"components/schemas/carMonetaryAmountOutput","kind":"json-schema","title":"carMonetaryAmountOutput","data":{"description":"Monetary amount and currency details.","type":"object","properties":{"value":{"description":"Numeric amount for the charge.","type":"number","format":"double","example":129.99},"currency":{"$ref":"#/components/schemas/currencyId"},"timing":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the payment is due (for example, 'pay_at_pickup' or 'pay_online_now')."},"children":[]}]}]}],"type":"string"}},"required":["value","currency"]}},"components/schemas/carsPriceOutput":{"id":"components/schemas/carsPriceOutput","kind":"json-schema","title":"carsPriceOutput","data":{"description":"Price amounts in both display and local currencies.","type":"object","properties":{"display":{"description":"Price amount shown to the traveller in the selected display currency.","$ref":"#/components/schemas/carMonetaryAmountOutput"},"pay":{"description":"The amount to be paid in the specified currency. This may be collected online at the time of booking or at the pickup desk.","$ref":"#/components/schemas/carMonetaryAmountOutput"}}}},"components/schemas/chargeTypeIdOutput":{"id":"components/schemas/chargeTypeIdOutput","kind":"json-schema","title":"chargeTypeIdOutput","data":{"description":"Identifier for the charge type applied to the rental.","type":"string"}},"components/schemas/carExtraOutput":{"id":"components/schemas/carExtraOutput","kind":"json-schema","title":"carExtraOutput","data":{"description":"Details of an individual extra charge, including type and amount.","type":"object","properties":{"charge_type":{"$ref":"#/components/schemas/chargeTypeIdOutput"},"amount":{"description":"Amount for this specific charge.","$ref":"#/components/schemas/carsPriceOutput"}}}},"components/schemas/carExtrasChargeOutput":{"id":"components/schemas/carExtrasChargeOutput","kind":"json-schema","title":"carExtrasChargeOutput","data":{"description":"Breakdown of conditional and non-conditional extra charges.","type":"object","properties":{"conditional":{"description":"Charges that might apply under a specific condition.","type":"array","items":{"$ref":"#/components/schemas/carExtraOutput"}},"non_conditional":{"description":"All non-conditional charges that will necessarily be paid","type":"array","items":{"$ref":"#/components/schemas/carExtraOutput"}}}}},"components/schemas/carProductOutput":{"id":"components/schemas/carProductOutput","kind":"json-schema","title":"CarProductOutput","data":{"title":"CarProductOutput","description":"Details of a selected extra for the vehicle, including pricing information.","type":"object","properties":{"id":{"description":"The unique identifier of the extra.","type":"string"},"type":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies the type of optional extra or service associated with the vehicle. For example, gps for a navigation system, baby_seat for a child seat, or wifi_router for mobile internet. Some values may represent similar extras because suppliers use different naming conventions for the same or comparable products."},"children":[]}]}]}],"type":"string","enum":["additional_driver","baby_seat","bluetooth_handsfree_kit","booster_seat","child_booster_seat","child_seat","child_seat_isofix","etc_card_electronic_toll_collection_card","excess_protection","fast_track","gps","infant_seat","luggage_rack","personal_travel_assistant","queue_jump","roof_rack","ski_box","ski_rack","skierized_equipment","snow_chains","snow_tyres","wifi_mobile","wifi_router"],"x-enumDescriptions":{"additional_driver":"Authorises an additional person to drive the vehicle.","baby_seat":"Baby seat for infants up to around 12 months or 9 kg/20 lbs.","bluetooth_handsfree_kit":"Bluetooth device for hands-free phone calls while driving.","booster_seat":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Booster seat for children around 4–11 years old, up to 45 kg/100 lbs."},"children":[]}]}]}],"child_booster_seat":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Booster seat for children around 4–11 years old, up to 45 kg/100 lbs."},"children":[]}]}]}],"child_seat":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Child seat for children around 1–3 years old, up to 18 kg/40 lbs."},"children":[]}]}]}],"child_seat_isofix":"Child safety seat compatible with ISOFIX anchor points.","etc_card_electronic_toll_collection_card":"Electronic toll collection card for automatic toll payments.","excess_protection":"Covers the excess payable in the event of damage or theft.","fast_track":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Equivalent to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"queue_jump"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"gps":"Satellite navigation device.","infant_seat":"Infant seat for babies or young children.","luggage_rack":"Additional luggage storage.","personal_travel_assistant":"Travel assistance service.","queue_jump":"Allows travellers to skip the standard queue at pickup.","roof_rack":"Roof-mounted rack for carrying additional luggage or equipment.","ski_box":"Roof-mounted enclosed storage box for skis or luggage.","ski_rack":"Roof-mounted rack designed to transport skis.","skierized_equipment":"Winter sports equipment.","snow_chains":"Tyre chains for snow.","snow_tyres":"Winter tyres.","wifi_mobile":"Mobile WiFi hotspot providing internet access during the rental.","wifi_router":"Portable WiFi router providing internet access."}},"selected_quantity":{"description":"The number of units selected for this product.","type":"integer","minimum":1},"mode":{"type":"string","description":"Defines how the product price is calculated. This determines whether pricing is applied per unit, per day, or for the full rental period.","enum":["each_per_day","per_day","each_per_rental","per_rental"],"x-enumDescriptions":{"each_per_day":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Price is charged per unit of the product, per day of the rental period. Total cost = unit price × quantity × number of rental days."},"children":[]}]}]}],"per_day":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Price is charged once per day for the product, regardless of quantity. Total cost = daily price × number of rental days."},"children":[]}]}]}],"each_per_rental":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Price is charged per unit for the full rental period. Total cost = unit price × quantity."},"children":[]}]}]}],"per_rental":"Price is charged once for the full rental period, regardless of quantity or duration."}},"price":{"description":"Pricing details for this product.","type":"object","properties":{"unit_amount":{"$ref":"#/components/schemas/carsPriceOutput"},"total_amount":{"$ref":"#/components/schemas/carsPriceOutput"}}}}}},"components/schemas/priceSummaryCar":{"id":"components/schemas/priceSummaryCar","kind":"json-schema","title":"OrdersPreviewCarPriceOutput","data":{"title":"OrdersPreviewCarPriceOutput","description":"Summary of all pricing components for the selected car products.","type":"object","properties":{"base":{"description":"Base price for all selected products. Excludes any extra charges.","$ref":"#/components/schemas/carsPriceOutput"},"extra_charges":{"description":"Breakdown of additional charges, such as taxes or fees, included in the total drive-away price.","$ref":"#/components/schemas/carExtrasChargeOutput"},"products":{"description":"List of selected additional products with their pricing and details.","type":"array","items":{"$ref":"#/components/schemas/carProductOutput"}},"total":{"description":"Total price for the car rental product in the selected display currency. Includes the base rental price and all mandatory vehicle-related charges. Optional extras and third-party products, such as additional insurance, may be priced separately.","$ref":"#/components/schemas/carMonetaryAmountOutput"}}}},"components/schemas/carCancellationOutput":{"id":"components/schemas/carCancellationOutput","kind":"json-schema","title":"carCancellationOutput","data":{"description":"The cancellation policy that applies to this product.","type":"object","properties":{"details":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Conditions under which free cancellation applies. For example: \\n- duration='PT48H' and context='before_pickup' means 'Free cancellation up to 48 hours before pickup'. \\n- duration='P7D' and context='within_given_time_period_of_booking' means 'Free cancellation within 7 days of booking'."},"children":[]}]}]}],"type":["object","null"],"properties":{"context":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The context in which the cancellation policy applies. For example 'before_pickup'"},"children":[]}]}]}],"type":"string","enum":["before_pickup","within_given_time_period_of_booking"]},"duration":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Duration during which free cancellation is available (ISO 8601 duration format, e.g. P2D = 2 days)."},"children":[]}]}]}],"type":"string","pattern":"^P(?:\\dY)?(?:\\dM)?(?:\\dD)?(?:T(?:\\dH)?(?:\\dM)?(?:\\dS)?)?$"}}},"type":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cancellation policy type (e.g. 'free_cancellation' or 'non-refundable')."},"children":[]}]}]}],"type":"string","enum":["free_cancellation","non-refundable"]}}}},"components/schemas/carMileageOutput":{"id":"components/schemas/carMileageOutput","kind":"json-schema","title":"carMileageOutput","data":{"description":"Mileage policy for the selected car rental.","type":"object","properties":{"distance_limit":{"description":"Maximum distance allowed before additional fees apply.","type":["number","null"],"format":"double","example":300,"minimum":0},"distance_unit":{"description":"The unit of measurement for the distance limit. For example 'km' or 'miles'.","type":"string","enum":["kilometers","miles"]},"amount":{"description":"The amount that must be paid if the distance limit is exceeded.","$ref":"#/components/schemas/monetaryAmount","nullable":true},"currency":{"description":"The currency of the amount that must be paid if the distance limit is exceeded.","$ref":"#/components/schemas/currencyId","nullable":true},"type":{"description":"The type of mileage policy applied.","type":"string","enum":["limited","unlimited"]}}}},"components/schemas/carPoliciesDatesOutput":{"id":"components/schemas/carPoliciesDatesOutput","kind":"json-schema","title":"carPoliciesDatesOutput","data":{"description":"Payment schedule, showing when and how much is due.","type":"object","properties":{"at":{"description":"Date when the payment is due (ISO 8601 format).","example":"2025-11-01","format":"date","type":"string"},"amount":{"description":"Amount payable on this date.","type":"object","$ref":"#/components/schemas/carsPriceOutput"}}}},"components/schemas/carPoliciesPaymentOutput":{"id":"components/schemas/carPoliciesPaymentOutput","kind":"json-schema","title":"carPoliciesPaymentOutput","data":{"description":"Payment policy details for the car rental, including key dates and amounts.","type":"object","properties":{"dates":{"type":"array","items":{"$ref":"#/components/schemas/carPoliciesDatesOutput"}}}}},"components/schemas/insuranceDocument":{"id":"components/schemas/insuranceDocument","kind":"json-schema","title":"InsuranceDocument","data":{"title":"InsuranceDocument","description":"A single insurance document.","type":"object","properties":{"name":{"description":"The insurance document type.","type":"string","enum":["policy_document","ipid"],"x-enumDescriptions":{"policy_document":"Full legal insurance contract: terms and conditions of cover, exclusions, eligibility, claim conditions, and cancellation terms.","ipid":"Insurance Product Information Document (IPID): a short, compliance-focused summary of the key coverage information to help the traveller understand the insurance product before purchase."}},"url":{"description":"URL of the insurance document.","type":"string","format":"uri","examples":["https://staging.rentalcover.com/en/pds"]}},"required":["name","url"]}},"components/schemas/carInsuranceOutput":{"id":"components/schemas/carInsuranceOutput","kind":"json-schema","title":"CarInsuranceOutput","data":{"title":"CarInsuranceOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Detailed third-party insurance quote for this car rental."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returned when insurance is available for the selected offer and a valid quote_reference is provided."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If insurance is not available, not selected, or cannot be resolved for the current offer, this field is null."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This object represents a bookable insurance product and includes pricing, coverage, and policy documentation."},"children":[]}]}]}],"type":["object","null"],"properties":{"quote_reference":{"description":"Unique reference for this insurance quote. Expires after 90 minutes.","type":"string","examples":["38df45ef-a6fb-4e24-a1d2-66fc3af23d76#1t0juiba8h6n2"]},"name":{"description":"The display name of the insurance product.","type":"string","examples":["Full Protection"]},"id":{"description":"The identifier for the type of insurance product.","type":"string","examples":["999"]},"price":{"description":"The price of the insurance product for the full rental period.","$ref":"#/components/schemas/carsPriceOutput"},"coverage_amount":{"description":"The maximum coverage amount provided by the insurance product.","type":"object","properties":{"value":{"description":"The numeric value of the maximum coverage.","$ref":"#/components/schemas/monetaryAmount"},"currency":{"description":"The currency of the coverage amount.","$ref":"#/components/schemas/currencyId"}}},"documents":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Legal documents for this insurance product. Always returned when the insurance object is present, and always contains the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"policy_document"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" entry. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ipid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" entry is only included when an IPID applies (EEA and UK countries) and is available in the requested language."},"children":[]}]}]}],"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/insuranceDocument"}}},"required":["quote_reference","name","id","price","documents"]}},"components/schemas/preview":{"id":"components/schemas/preview","kind":"json-schema","title":"OrdersPreviewDataOutput","data":{"title":"OrdersPreviewDataOutput","description":"Contains the calculated order details for accommodation or car products, including pricing, policies, etc.","type":"object","properties":{"accommodation":{"title":"OrdersPreviewAccommodationOutput","description":"The products to order related to an accommodation","type":"object","properties":{"id":{"$ref":"#/components/schemas/accommodationId"},"currency":{"$ref":"#/components/schemas/currency"},"general_policies":{"properties":{"payment":{"$ref":"#/components/schemas/productPaymentTimingsDates"}}},"price":{"$ref":"#/components/schemas/PriceSummaryPreviewV32"},"products":{"type":"array","items":{"$ref":"#/components/schemas/previewProductOutput"}}}},"car":{"type":"object","properties":{"offer":{"$ref":"#/components/schemas/offerId"},"currency":{"description":"The currencies requested.","type":"object","properties":{"booker":{"$ref":"#/components/schemas/currencyId"},"payment":{"$ref":"#/components/schemas/currencyId"}}},"price":{"$ref":"#/components/schemas/priceSummaryCar"},"policies":{"description":"The policies that apply to this car.","type":"object","properties":{"cancellation":{"$ref":"#/components/schemas/carCancellationOutput"},"damage_excess":{"description":"The maximum amount a traveller may be charged for damages to the car during the rental period, as specified by the rental agreement.","type":"object","properties":{"amount":{"description":"The amount of the damage excess.","$ref":"#/components/schemas/carsPriceOutput"}}},"deposit":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount of money that will be temporarily pre-authorised or blocked on the traveller’s credit card at the rental location as a security deposit, to cover potential damage or extra charges."},"children":[]}]}]}],"type":"object","properties":{"amount":{"description":"The amount of the deposit.","$ref":"#/components/schemas/carsPriceOutput"}}},"fuel_policy":{"description":"The fuel policy that applies to this car.","type":"string","enum":["return_same","return_same_or_prepay_no_refunds","return_same_preauth","free_tank","prepay_no_refunds","prepay_part_refunds","prepay_refunds","unknown"]},"mileage":{"$ref":"#/components/schemas/carMileageOutput"},"payment":{"$ref":"#/components/schemas/carPoliciesPaymentOutput"},"theft_excess":{"description":"The maximum amount a traveller may be charged in the event of car theft during the rental period, as outlined in the rental agreement.","type":"object","properties":{"amount":{"description":"The amount of the theft excess.","$ref":"#/components/schemas/carsPriceOutput"}}}}},"insurance":{"$ref":"#/components/schemas/carInsuranceOutput"}}},"order_token":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A token containing the necessary data to be used on subsequent requests to [orders/create]. This token expires 15 minutes after it is issued."},"children":[]}]}]}],"type":"string"}}}},"components/schemas/previewOutput":{"id":"components/schemas/previewOutput","kind":"json-schema","title":"OrdersPreviewOutput","data":{"title":"OrdersPreviewOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"$ref":"#/components/schemas/preview"}}}},"components/schemas/guest":{"id":"components/schemas/guest","kind":"json-schema","title":"OrderCreateGuestInput","data":{"title":"OrderCreateGuestInput","type":"object","properties":{"email":{"description":"The email address of the guest.","type":"string"},"name":{"description":"The name of the guest.","type":"string"}},"required":["email","name"]}},"components/schemas/create_product":{"id":"components/schemas/create_product","kind":"json-schema","title":"OrderCreateProductInformationInput","data":{"title":"OrderCreateProductInformationInput","description":"Additional information related to each product related to the products in this order.","type":"object","properties":{"id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID for this product. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Please note that this MUST match the product IDs used for related /orders/preview request."},"children":[]}]}]}],"$ref":"#/components/schemas/productId"},"bed_configuration":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bed configuration ID to select for this product. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Please note that it can not be guaranteed that the selected bed_configuration will be available."},"children":[]}]}]}],"type":"string"},"guests":{"description":"The guest details for this product.","type":"array","items":{"$ref":"#/components/schemas/guest"}}},"required":["id"]}},"components/schemas/estimatedArrivalTime":{"id":"components/schemas/estimatedArrivalTime","kind":"json-schema","title":"EstimatedArrivalTimeInput","data":{"title":"EstimatedArrivalTimeInput","description":"Estimated arrival time of the guests.","type":"object","properties":{"hour":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Approximate hour of arrival to the hotel. Allowed values are from 0 to 23. This time should be within the hotel reception hours, or will be ignored otherwise with a warning will be appended to special_requests."},"children":[]}]}]}],"type":"integer","minimum":0,"maximum":23},"next_day":{"description":"Set this to true, if the hour selected is for the day after checkin.","type":"boolean","default":"false"}},"required":["hour"]}},"components/schemas/accommodation":{"id":"components/schemas/accommodation","kind":"json-schema","title":"Accommodation order creation request","data":{"title":"Accommodation order creation request","description":"Additional information related to the accommodation order. Only one travel service object can be included in a request.","type":"object","properties":{"label":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom string defined by the partner to track attribution throughout the booking journey. Use a consistent, parseable format (e.g. brand-market_platform-channel_campaign) to encode campaign, traffic source, platform, language, or other identifiers. Recommended for accurate reporting and analytics. See the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/orders-api/labels-attributions"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Labels and attributions guide"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"type":"string"},"products":{"description":"List of accommodation products returned in /orders/preview that should be included in this order.","type":"array","items":{"$ref":"#/components/schemas/create_product"}},"remarks":{"title":"OrderCreateRemarksInput","description":"Optional remarks from the guest.","type":"object","properties":{"estimated_arrival_time":{"$ref":"#/components/schemas/estimatedArrivalTime"},"special_requests":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional comments or requests from the guest. Special requests cannot be guaranteed – but the property will do its best to meet your needs."},"children":[]}]}]}],"type":"string"}}}}}},"components/schemas/address":{"id":"components/schemas/address","kind":"json-schema","title":"OrderCreateAddressInput","data":{"title":"OrderCreateAddressInput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The booker's address to be used for creating this order. All fields of this object are required if the /accommodations/details endpoint indicates that the booker's address is necessary by returning booker_address_required=true."},"children":[]}]}]}],"type":"object","properties":{"address_line":{"description":"The details of this address.","type":"string"},"city":{"description":"The city for this address.","type":"string"},"country":{"description":"The country for this address.","$ref":"#/components/schemas/countryId"},"post_code":{"description":"Post code for this address.","type":"string"}},"required":["country"]}},"components/schemas/create_booker":{"id":"components/schemas/create_booker","kind":"json-schema","title":"OrderCreateBookerInput","data":{"title":"OrderCreateBookerInput","description":"The booker's information.","type":"object","properties":{"address":{"$ref":"#/components/schemas/address"},"company":{"description":"The booker's company name.","type":"string"},"email":{"description":"The booker's email address.","type":"string"},"language":{"$ref":"#/components/schemas/languageId"},"name":{"title":"OrderCreateBookerNameInput","description":"The name of the booker.","type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"}},"required":["first_name","last_name"]},"telephone":{"description":"The booker's telephone number.","type":"string"}},"required":["address","email","name","telephone"]}},"components/schemas/billing_address":{"id":"components/schemas/billing_address","kind":"json-schema","title":"OrderCreateBusinessAddressInput","data":{"title":"OrderCreateBusinessAddressInput","description":"The address to bill this reservation","type":"object","properties":{"address_line":{"description":"The details of this address.","type":"string"},"city":{"description":"The city for this address.","type":"string"},"country":{"description":"The country for this address.","$ref":"#/components/schemas/countryId"},"post_code":{"description":"Post code for this address.","type":"string"}}}},"components/schemas/create_payment":{"id":"components/schemas/create_payment","kind":"json-schema","title":"OrderCreatePaymentInput","data":{"title":"OrderCreatePaymentInput","description":"Payment related information for the order.","type":"object","properties":{"airplus":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All information related to airplus payment. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"This is required if airplus is selected as payment method."},"children":[]}]}]}],"type":"object","properties":{"dbi":{"title":"OrderCreateDbiInput","description":"Descriptive billing information(dbi) details to pass to AirPlus.","type":"object","properties":{"accounting_code":{"description":"Accounting code to pass in descriptive billing information.","type":"string","minLength":1,"maxLength":17},"accounting_unit":{"description":"Accounting unit to pass in descriptive billing information.","type":"string","minLength":1,"maxLength":17},"cost_centre":{"description":"Cost centre to pass in descriptive billing information.","type":"string","minLength":1,"maxLength":17},"department_code":{"description":"Department code to pass in descriptive billing information.","type":"string","minLength":1,"maxLength":17},"employee_number":{"description":"Employee number to pass in descriptive billing information.","type":"string","minLength":1,"maxLength":17},"internal_account":{"description":"Internal account to pass in descriptive billing information.","type":"string","minLength":1,"maxLength":17},"order_number":{"description":"Order number to pass in descriptive billing information.","type":"string","minLength":1,"maxLength":17},"project_number":{"description":"Project number to pass in descriptive billing information.","type":"string","minLength":1,"maxLength":17}}},"number":{"description":"12 digit Airplus Number.","type":"string"}},"required":["number"]},"business_information":{"title":"OrderCreateBusinessInformationInput","description":"All business related information for billing and authorisation form. This must be included for the payments that require authorisation form.","type":"object","properties":{"authorisation_form":{"title":"OrderCreateAuthorisationFormInput","description":"Information that is relevant for generating an authorisation form.","type":"object","properties":{"chargeable_items":{"description":"Items which can be charged using a provided virtual credit card.","type":"array","items":{"type":"string","enum":["alcohol","breakfast","food_beverage","internet","parking","phone","taxes"]}}}},"billing":{"title":"OrderCreateBillingInput","description":"All information to be used in the invoice.","type":"object","properties":{"address":{"$ref":"#/components/schemas/billing_address"},"email":{"description":"Email to send the invoice to.","type":"string"},"vat":{"description":"VAT number to be used in the invoice.","type":"string"}},"required":["email","vat"]},"company":{"description":"Company that will issue an authorisation form for the virtual credit card and used in the invoice.","type":"string"}},"required":["company"]},"card":{"title":"OrderCreateCardInput","description":"Card information for executing the payment.","type":"object","properties":{"authentication":{"title":"OrderCreateCardAuthenticationInput","description":"Card authentication information for executing the payment.","type":"object","properties":{"riskified":{"title":"OrderCreateRiskifiedInput","description":"Riskified information for external fraud verification.","type":"object","properties":{"ip_address":{"description":"The booker's IP address.","type":"string","format":"ipv4"},"session_id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Riskified provided session_id for external fraud verification."},"children":[]}]}]}],"type":"string"}},"required":["ip_address","session_id"]},"sca_exemption":{"description":"The type of SCA exemption to be applied to the payment.","type":"string","enum":["moto","virtual"]},"3d_secure":{"title":"OrderCreate3dSecureInput","description":"3-factor authentication information for the card.","type":"object","properties":{"authentication_value":{"description":"Cardholder Authentication Verification Value.","type":"string"},"eci":{"description":"The electronic commerce indicator.","type":"string"},"transaction":{"description":"The unique ID assigned by the DS to identify a single transaction.","type":"string"},"authentication_response":{"description":"The 3D Secure transaction status (transStatus) returned by the Access Control Server (ACS) following a challenge flow. For transactions completed in a frictionless flow, provide the transStatus from the Authentication Response. Optional if no challenge is required.","type":"string","example":"Y"}},"required":["authentication_value","eci","transaction"]}}},"cardholder":{"description":"Name of the cardholder.","type":"string"},"cvc":{"description":"3 or 4 digits card validation code (CVC) of this card.","type":"string"},"expiry_date":{"description":"Expiry date of the card. Format: YYYY-MM","type":"string"},"number":{"description":"Number of the card.","type":"string"},"subtype":{"description":"Indicates a special processing subtype for cards whose network behaviour cannot be determined reliably from the card number alone.\n\nUse this field for supported co-branded or specialised card programmes (such as UnionPay co-branded cards) to ensure correct payment routing and authorisation handling.\nOmit for standard Visa, Mastercard, or UnionPay cards","type":"string","enum":["unionpay_cobrand"]}},"required":["cardholder","cvc","expiry_date","number"]},"include_receipt":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is used to determine whether to include payment "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"receipt_url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the response or not."},"children":[]}]}]}],"type":"boolean"},"method":{"description":"The payment method to be used for this order.","type":"string","enum":["airplus","card","wallet"]},"timing":{"type":"string","description":"The payment timing for this order. Use the value returned in the preview response. The available values depend on the travel service.","enum":["pay_at_pickup","pay_at_the_property","pay_online_later","pay_online_now","pay_partial_online_now"],"x-enumDescriptions":{"pay_at_pickup":"Only for car rental orders. Traveller pays at the car rental pick-up location.","pay_at_the_property":"Only for accommodation orders. Traveller pays at the accommodation property.","pay_online_later":"Only for accommodation orders. Traveller pays online at a later time before check-in.","pay_online_now":"Traveller pays online immediately at the time of booking.","pay_partial_online_now":"Only for car rental orders. Traveller pays part online at booking and the remainder at the car rental pick-up location."}}},"required":["timing"]}},"components/schemas/ordersCreateInput":{"id":"components/schemas/ordersCreateInput","kind":"json-schema","title":"OrderCreateInput","data":{"title":"OrderCreateInput","type":"object","properties":{"accommodation":{"$ref":"#/components/schemas/accommodation"},"booker":{"$ref":"#/components/schemas/create_booker"},"order_token":{"description":"A token containing the necessary data to be used for creating this order.","type":"string"},"payment":{"$ref":"#/components/schemas/create_payment"}},"required":["booker","order_token","payment"]}},"components/schemas/thirdPartyInventoryOutput":{"id":"components/schemas/thirdPartyInventoryOutput","kind":"json-schema","title":"Third party inventory related information for the created order. This field is only available for third party inventory orders.","data":{"title":"Third party inventory related information for the created order. This field is only available for third party inventory orders.","type":"object","properties":{"checkin_number":{"description":"The number required at the time of check-in. It allows guests to confirm their order at the accommodation.","type":"string","example":"473026811"},"confirmation_number":{"description":"The confirmation number, when used in conjunction with the pincode, helps verify the customer's order and facilitates efficient support during inquiries or troubleshooting.","type":"string","example":"12365478936925814787"}}}},"components/schemas/accommodationOutput":{"id":"components/schemas/accommodationOutput","kind":"json-schema","title":"OrderCreateAccommodationOutput","data":{"title":"OrderCreateAccommodationOutput","description":"All accommodation related information for this order.","type":"object","properties":{"pincode":{"description":"Pincode for this accommodation order.","type":"string"},"reservation":{"description":"Reservation ID for this accommodation order.","type":"string"},"third_party_inventory":{"$ref":"#/components/schemas/thirdPartyInventoryOutput"}}}},"components/schemas/create_paymentOutput":{"id":"components/schemas/create_paymentOutput","kind":"json-schema","title":"OrderCreatePaymentOutput","data":{"title":"OrderCreatePaymentOutput","description":"All payment related information for this order.","type":"object","properties":{"authorisation_form_url":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Link to a virtual credit card''s authorisation form, valid for 7 minutes from issue. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"This will only the added if the request has authorisation_form."},"children":[]}]}]}],"type":"string","format":"uri","example":"https://secure-admin.booking.com/airplus_auth_form_pdf.html?token=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA&lang=en"},"receipt_url":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Link to the payment receipt of the order. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"This will only be added if include_receipt is true."},"children":[]}]}]}],"type":"string","format":"uri","example":"https://secure.booking.com/payment_receipt.html?bn=0000000000&pincode=0000&lang=en"}}}},"components/schemas/carOutput":{"id":"components/schemas/carOutput","kind":"json-schema","title":"OrderCreateCarOutput","data":{"title":"OrderCreateCarOutput","description":"All car rental related information for this order. This field is only present for car rental orders.","type":"object","properties":{"reservation_id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The reservation ID (booking reference) for this car rental order. Use this identifier to retrieve the full, up-to-date booking details and status via the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/orders/details/cars/live"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}],"type":"string","example":"89423719"},"status":{"description":"This endpoint always returns \"Processing\", indicating that the booking request has been accepted and is being processed asynchronously. Retrieve the order details using /orders/details/cars/live to obtain its latest status.","type":"string","enum":["Processing"],"example":"Processing"}}}},"components/schemas/ordersCreateOutput":{"id":"components/schemas/ordersCreateOutput","kind":"json-schema","title":"OrderCreateOutput","data":{"title":"OrderCreateOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"title":"OrderCreateDataOutput","oneOf":[{"title":"Accommodation order creation output","type":"object","properties":{"order":{"description":"ID for this order.","type":"string"},"accommodation":{"$ref":"#/components/schemas/accommodationOutput"},"payment":{"$ref":"#/components/schemas/create_paymentOutput"}},"required":["accommodation"]},{"title":"Car order creation output","type":"object","properties":{"order":{"description":"ID for this order.","type":"string"},"car":{"$ref":"#/components/schemas/carOutput"}},"required":["car"]}]}}}},"components/schemas/error_duplicate_response":{"id":"components/schemas/error_duplicate_response","kind":"json-schema","title":"ErrorDuplicateResponse","data":{"title":"ErrorDuplicateResponse","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"errors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"message":{"type":"string"},"reservation":{"type":"string","description":"The reservation ID associated with the duplicated request. Only returned when a reservation already exists."}},"required":["id","message"]}}},"required":["request_id","errors"]}},"components/schemas/orderDatetimeFilter":{"id":"components/schemas/orderDatetimeFilter","kind":"json-schema","title":"OrderDetailsDatetimeFilterInput","data":{"title":"OrderDetailsDatetimeFilterInput","description":"Filter orders by their \"created\" or \"updated\" timestamp. The maximum time range is 7 days.","type":"object","properties":{"from":{"description":"ISO 8601 timestamp in UTC. Start of the time range (inclusive). The value should be within last 1 year.","type":"string","format":"date-time"},"to":{"description":"ISO 8601 timestamp in UTC, which indicates the timestamp till which you want to filter orders to (inclusive). It has to be greater than or equal to \"from\".","type":"string","format":"date-time"}},"required":["from"]}},"components/schemas/orderSort":{"id":"components/schemas/orderSort","kind":"json-schema","title":"OrderDetailsSortInput","data":{"title":"OrderDetailsSortInput","description":"The sorting parameters for the response.","type":"object","properties":{"by":{"description":"The way to sort your results.","type":"string","enum":["created","updated"],"default":"created"},"direction":{"description":"The direction you wish for your sort.by parameter to be sorted in.","type":"string","enum":["ascending","descending"],"default":"descending"}},"required":["by","direction"]}},"components/schemas/schemas-extras":{"id":"components/schemas/schemas-extras","kind":"json-schema","title":"schemas-extras","data":{"description":"Input parameter to request for additional information about this order.","type":"array","items":{"type":"string","enum":["payment"]}}},"components/schemas/services":{"id":"components/schemas/services","kind":"json-schema","title":"services","data":{"description":"Restricts results to one or more travel services. If omitted, behaviour depends on the filter used. Identifier-based requests return accommodation orders only, while date-based requests return all supported travel services available to the partner.","type":"array","items":{"type":"string","enum":["accommodations","cars","flights","attractions","taxis"]}}},"components/schemas/inputUpdated":{"id":"components/schemas/inputUpdated","kind":"json-schema","title":"Order details by last update input","data":{"title":"Order details by last update input","description":"Request parameters to retrieve orders by their last update timestamp. Supports sorting, pagination, and optional data enrichment.","type":"object","properties":{"updated":{"$ref":"#/components/schemas/orderDatetimeFilter"},"currency":{"$ref":"#/components/schemas/currencyId"},"maximum_results":{"$ref":"#/components/schemas/maximumResults"},"sort":{"$ref":"#/components/schemas/orderSort"},"extras":{"$ref":"#/components/schemas/schemas-extras"},"services":{"$ref":"#/components/schemas/services"}},"required":["updated","currency"]}},"components/schemas/inputCreated":{"id":"components/schemas/inputCreated","kind":"json-schema","title":"Order details by creation date input","data":{"title":"Order details by creation date input","description":"Request parameters to retrieve orders based on their creation timestamp. Commonly used for reporting and initial data ingestion.","type":"object","properties":{"created":{"$ref":"#/components/schemas/orderDatetimeFilter"},"currency":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/commonpayments/common/payments/currencies","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/payments/currencies"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"$ref":"#/components/schemas/currencyId"},"maximum_results":{"$ref":"#/components/schemas/maximumResults"},"sort":{"$ref":"#/components/schemas/orderSort"},"extras":{"$ref":"#/components/schemas/schemas-extras"},"services":{"$ref":"#/components/schemas/services"}},"required":["created","currency"]}},"components/schemas/orderDateFilter":{"id":"components/schemas/orderDateFilter","kind":"json-schema","title":"OrderDetailsDateFilterInput","data":{"title":"OrderDetailsDateFilterInput","description":"Filter orders by date range, covering the \"start\" and \"end\" date. The maximum date range is up to 7 days (1 week).","type":"object","properties":{"from":{"description":"ISO 8601 date in \"YYYY-MM-DD\" format. Start of the date range (inclusive). You can filter orders up to 1 year in the past and 500 days in the future.","type":"string","format":"date","example":"2026-06-01"},"to":{"description":"ISO 8601 date in \"YYYY-MM-DD\" format. End of the date range (inclusive). It has to be greater than or equal to \"from\". It uses \"from\" value as default.","type":"string","format":"date","example":"2026-06-03"}},"required":["from"]}},"components/schemas/inputStart":{"id":"components/schemas/inputStart","kind":"json-schema","title":"Order details by start date input","data":{"title":"Order details by start date input","description":"Request parameters to retrieve orders based on the start date of the travel service (for example, check-in or pickup date).","type":"object","properties":{"start":{"$ref":"#/components/schemas/orderDateFilter"},"currency":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/commonpayments/common/payments/currencies","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/payments/currencies"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"$ref":"#/components/schemas/currencyId"},"maximum_results":{"$ref":"#/components/schemas/maximumResults"},"sort":{"$ref":"#/components/schemas/orderSort"},"extras":{"$ref":"#/components/schemas/schemas-extras"},"services":{"$ref":"#/components/schemas/services"}},"required":["start","currency"]}},"components/schemas/inputEnd":{"id":"components/schemas/inputEnd","kind":"json-schema","title":"Order details by end date input","data":{"title":"Order details by end date input","description":"Request parameters to retrieve orders based on the end date of the travel service (for example, check-out or drop-off date).","type":"object","properties":{"end":{"$ref":"#/components/schemas/orderDateFilter"},"currency":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/commonpayments/common/payments/currencies","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/payments/currencies"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"$ref":"#/components/schemas/currencyId"},"maximum_results":{"$ref":"#/components/schemas/maximumResults"},"sort":{"$ref":"#/components/schemas/orderSort"},"extras":{"$ref":"#/components/schemas/schemas-extras"},"services":{"$ref":"#/components/schemas/services"}},"required":["end","currency"]}},"components/schemas/order":{"id":"components/schemas/order","kind":"json-schema","title":"order","data":{"description":"Order ID for which details should be returned.","type":"string"}},"components/schemas/inputOrder":{"id":"components/schemas/inputOrder","kind":"json-schema","title":"Order details by order IDs input","data":{"title":"Order details by order IDs input","description":"Request parameters to retrieve orders using a list of known order IDs. Use this option when you already know the order identifiers and need to retrieve precise records.","type":"object","properties":{"currency":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/commonpayments/common/payments/currencies","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/payments/currencies"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"$ref":"#/components/schemas/currencyId"},"orders":{"description":"List of order IDs for which details should be returned.","type":"array","items":{"$ref":"#/components/schemas/order"},"maxItems":100},"sort":{"$ref":"#/components/schemas/orderSort"},"extras":{"$ref":"#/components/schemas/schemas-extras"},"services":{"$ref":"#/components/schemas/services"}},"required":["orders","currency"]}},"components/schemas/inputReservations":{"id":"components/schemas/inputReservations","kind":"json-schema","title":"Order details by reservation IDs input","data":{"title":"Order details by reservation IDs input","type":"object","description":"Request parameters to retrieve order details using a list of reservation IDs across supported travel services.","properties":{"currency":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/demand/docs/open-api/demand-api/commonpayments/common/payments/currencies","target":"_blank"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/payments/currencies"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"$ref":"#/components/schemas/currencyId"},"reservations":{"description":"List of reservation IDs for which details should be returned.","type":"array","items":{"type":"string"},"maxItems":100},"sort":{"$ref":"#/components/schemas/orderSort"},"extras":{"$ref":"#/components/schemas/schemas-extras"},"services":{"$ref":"#/components/schemas/services"}},"required":["reservations","currency"]}},"components/schemas/inputPage":{"id":"components/schemas/inputPage","kind":"json-schema","title":"Order details by pagination input","data":{"title":"Order details by pagination input","description":"Request parameters to retrieve orders using the pagination token, allowing sequential access to large result sets.","type":"object","properties":{"page":{"$ref":"#/components/schemas/page"},"extras":{"$ref":"#/components/schemas/schemas-extras"}},"required":["page"]}},"components/schemas/accommodation_reservation":{"id":"components/schemas/accommodation_reservation","kind":"json-schema","title":"accommodation_reservation","data":{"description":"This is the reservation id for the accommodation in this order.","type":"string"}},"components/schemas/attractionOutput":{"id":"components/schemas/attractionOutput","kind":"json-schema","title":"OrderDetailsAttractionsOutput","data":{"description":"Details of an attraction included in this order.","title":"OrderDetailsAttractionsOutput","type":"object","properties":{"name":{"description":"The name of the attraction.","type":"string","example":"Eiffel Tower Guided Tour"},"location":{"title":"OrderDetailsAttractionLocationOutput","type":"object","description":"Location details of the attraction.","properties":{"city":{"description":"The city where the attraction is located.","type":"string"},"country":{"$ref":"#/components/schemas/countryId"}}},"reservation":{"description":"This is the reservation id for the attraction in this order.","type":"string"}}}},"components/schemas/platform":{"id":"components/schemas/platform","kind":"json-schema","title":"platform","data":{"description":"The booker platform for showing the platform based deals and prices.","type":"string","enum":["app","desktop","mobile_browser","tablet","unknown"]}},"components/schemas/bookerOutput":{"id":"components/schemas/bookerOutput","kind":"json-schema","title":"OrderDetailsBookerOutput","data":{"title":"OrderDetailsBookerOutput","description":"The booker's information.","type":"object","properties":{"address":{"title":"OrderDetailsAddressOutput","description":"The booker's address for showing the best price for that user and obeying laws regarding the display of taxes and fees.","type":"object","properties":{"city":{"description":"The city for this address.","type":["string","null"]},"country":{"description":"The country for this address.","type":["string","null"]}}},"email":{"description":"The booker's email address.","type":["string","null"]},"language":{"$ref":"#/components/schemas/languageId"},"name":{"title":"OrderDetailsBookerNameOutput","description":"The name of the booker.","type":"object","properties":{"first_name":{"type":["string","null"]},"last_name":{"type":["string","null"]}}},"platform":{"description":"Platform used to create the booking.","type":"string","$ref":"#/components/schemas/platform"},"telephone":{"description":"The booker's telephone number.","type":["string","null"]},"travel_purpose":{"description":"The travel purpose of the booker.","type":["string","null"],"enum":["business","leisure","unknown"]}}}},"components/schemas/car_reservation":{"id":"components/schemas/car_reservation","kind":"json-schema","title":"car_reservation","data":{"description":"This is the reservation id for the car in this order.","type":"string"}},"components/schemas/createdOutput":{"id":"components/schemas/createdOutput","kind":"json-schema","title":"createdOutput","data":{"description":"Order creation time. For taxi orders with multiple legs, this is the earliest creation date among all legs.","type":"string","format":"date-time"}},"components/schemas/schemas-priceCurrencyOutput":{"id":"components/schemas/schemas-priceCurrencyOutput","kind":"json-schema","title":"PriceCurrencyOutput","data":{"title":"PriceCurrencyOutput","description":"The amount in both product and booker currencies (booker might be null, if not requested)","type":["object","null"],"properties":{"booker_currency":{"description":"Amount in the booker's selected currency","$ref":"#/components/schemas/monetaryAmount"},"product_currency":{"description":"Amount in the product's base currency","$ref":"#/components/schemas/monetaryAmount"}}}},"components/schemas/itinerary":{"id":"components/schemas/itinerary","kind":"json-schema","title":"ItineraryPoint","data":{"title":"ItineraryPoint","type":"object","properties":{"airport":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A three-letter code that uniquely identifies an airport as defined by the International Air Transport Association (IATA). The full list can be obtained by calling  "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/common/locations/airports"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/locations/airports"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"pattern":"^[A-Z]{3}$","type":"string","example":"AMS"},"date_time":{"description":"Date time of the itinerary.","type":"string","format":"date-time","example":"2025-09-17T18:45:00Z"}}}},"components/schemas/itineraryOutput":{"id":"components/schemas/itineraryOutput","kind":"json-schema","title":"ItineraryOutput","data":{"title":"ItineraryOutput","type":"object","properties":{"arrival":{"description":"Arrival details.","$ref":"#/components/schemas/itinerary"},"departure":{"description":"Departure details.","$ref":"#/components/schemas/itinerary"}}}},"components/schemas/loyaltyRewardOutput":{"id":"components/schemas/loyaltyRewardOutput","kind":"json-schema","title":"loyaltyRewardOutput","data":{"description":"Details of the loyalty rewards associated with this order.","type":["array","null"],"items":{"title":"OrderDetailsLoyaltyRewardOutput","type":"object","properties":{"amount":{"description":"Reward amount expressed in the units defined by the reward type (for example, cash, miles, or points).","type":"number","format":"double"},"currency":{"description":"Currency used for reward calculation.","$ref":"#/components/schemas/currencyId"},"eligible":{"description":"Whether the order is eligible for the reward.","type":"boolean"},"fulfillment_at":{"description":"Date and time at which the reward should be fulfilled.","type":"string","format":"date"},"fulfillment_by":{"description":"Entity responsible for fulfilling the reward.","type":"string","enum":["partner","booking.com"]},"loyalty_data":{"description":"Loyalty information required to fulfil the reward.","type":["array","null"],"items":{"title":"OrderDetailsLoyaltyDataOutput","type":"object","properties":{"name":{"description":"Name of the loyalty data.","type":"string"},"value":{"description":"Value of the loyalty data.","type":"string"}}}},"type":{"description":"Type of reward.","type":"string","enum":["cash","mile","point","voucher","voucher_money","voucher_subscription","voucher_percentage"]}}}}},"components/schemas/paymentTransactions":{"id":"components/schemas/paymentTransactions","kind":"json-schema","title":"paymentTransactions","data":{"type":"array","items":{"title":"OrderDetailsPaymentTransactionOutput","type":["object","null"],"properties":{"amount":{"description":"Amount of the transaction.","type":"number"},"at":{"description":"Time of the transaction.","type":"string","format":"date-time"},"transaction_currency":{"description":"Currency in which the transaction took place.","type":"string"}}}}},"components/schemas/orderStatusOutput":{"id":"components/schemas/orderStatusOutput","kind":"json-schema","title":"OrderDetailsStatusOutput","data":{"title":"OrderDetailsStatusOutput","description":"Overall status of the order. Not all status values apply to every travel service.","type":"string","enum":["booked","cancelled","cancelled_by_guest","cancelled_by_accommodation","stayed","no_show","unknown"],"x-enumDescriptions":{"booked":"The order has been confirmed. Applicable to all supported travel services.","cancelled":"The order has been cancelled. Applicable to all supported travel services.","cancelled_by_guest":"The accommodation reservation was cancelled by the traveller.","cancelled_by_accommodation":"The accommodation reservation was cancelled by the accommodation provider.","stayed":"The accommodation stay has been completed.","no_show":"The traveller did not arrive for the accommodation stay.","unknown":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used only for taxi orders containing multiple legs when the individual legs have different statuses. Inspect "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"taxis[].status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to determine the status of each leg."},"children":[]}]}]}]}}},"components/schemas/status":{"id":"components/schemas/status","kind":"json-schema","title":"status","data":{"type":"string","enum":["booked","cancelled","cancelled_by_accommodation","cancelled_by_guest","no_show","stayed"]}},"components/schemas/taxiOutput":{"id":"components/schemas/taxiOutput","kind":"json-schema","title":"OrderDetailsTaxiOutput","data":{"description":"Details of an individual taxi leg.","title":"OrderDetailsTaxiOutput","type":"object","properties":{"commission":{"title":"TaxiCommissionOutput","description":"Commission details for this taxi leg.","type":"object","properties":{"actual_amount":{"description":"The actual commission amount for this taxi leg.","$ref":"#/components/schemas/schemas-priceCurrencyOutput"},"estimated_amount":{"description":"The estimated commission amount for this taxi leg.","$ref":"#/components/schemas/schemas-priceCurrencyOutput"}}},"created":{"description":"The creation time of this taxi leg.","type":"string","format":"date-time"},"currencies":{"title":"TaxiCurrencyOutput","description":"Product and booker currencies for this taxi leg.","type":"object","properties":{"booker":{"description":"Booker's currency (ISO 4217).","$ref":"#/components/schemas/currencyId"},"product":{"description":"Product's base currency (ISO 4217).","$ref":"#/components/schemas/currencyId"}}},"dropoff_location":{"description":"Details of the dropoff location for this taxi leg.","title":"OrderDetailsTaxiDropoffLocationOutput","type":"object","properties":{"address":{"description":"The full address of the dropoff location.","type":"string","example":"Stationsplein 9, 3511 CE Utrecht"},"city":{"description":"The city of the dropoff location.","type":"string","example":"Utrecht"},"country":{"$ref":"#/components/schemas/countryId"}}},"end":{"description":"The end date and time of this taxi leg.","type":"string","format":"date-time"},"leg":{"description":"Unique identifier for this taxi leg within the order.","type":"string","example":"607244787653565"},"pickup_location":{"description":"Details of the pickup location for this taxi leg.","title":"OrderDetailsTaxiPickupLocationOutput","type":"object","properties":{"address":{"description":"The full address of the pickup location.","type":"string","example":"Amstel 51, 1018 EH Amsterdam, Netherlands"},"city":{"description":"The city of the pickup location.","type":"string","example":"Amsterdam"},"country":{"$ref":"#/components/schemas/countryId"}}},"price":{"title":"TaxiPriceOutput","description":"The price components for this taxi leg.","type":"object","properties":{"commissionable":{"description":"Price on which the commission is calculated for this taxi leg.","$ref":"#/components/schemas/schemas-priceCurrencyOutput"},"total":{"description":"Total price for this taxi leg.","$ref":"#/components/schemas/schemas-priceCurrencyOutput"}}},"reservation":{"description":"The reservation identifier shared by all taxi legs belonging to the same taxi order.","type":"string","example":"916957580"},"start":{"description":"The start date and time of this taxi leg.","type":"string","format":"date-time"},"status":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Status of this taxi leg. Unlike the aggregated order status, each taxi leg reports its own lifecycle. Use this field when tracking multi-leg taxi orders."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A status of booked indicates that the ride has been successfully reserved, and is to be fulfilled."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Taxi legs may still transition to cancelled or cancelled_by_guest after being booked."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Partners should use this field to track the real-time lifecycle of each leg, especially for multi-leg taxi orders where different legs may have different statuses."},"children":[]}]}]}],"$ref":"#/components/schemas/status"},"updated":{"description":"The last update time of this taxi leg.","type":"string","format":"date-time"}}}},"components/schemas/updatedOutput":{"id":"components/schemas/updatedOutput","kind":"json-schema","title":"updatedOutput","data":{"description":"Time the order was last updated. For taxi orders with multiple legs, this is the latest last modified time among all legs.","type":"string","format":"date-time"}},"components/schemas/orderDetailsData":{"id":"components/schemas/orderDetailsData","kind":"json-schema","title":"OrderDetailsDataOutput","data":{"title":"OrderDetailsDataOutput","description":"All details for this order.","type":"object","properties":{"id":{"description":"Unique identifier of the order.","type":"string"},"accommodations":{"title":"OrderDetailsAccommodationsOutput","type":"object","properties":{"inventory":{"$ref":"#/components/schemas/inventoryOutput"},"location":{"title":"AccommodationLocationOutput","description":"Accommodation location.","type":"object","properties":{"address":{"description":"Accommodation address.","type":"string"},"city":{"$ref":"#/components/schemas/cityId"},"country":{"$ref":"#/components/schemas/countryId"}}},"name":{"description":"Accommodation name.","type":"string"},"number_of_guests":{"description":"Number of guests included in the accommodation reservation.","type":"number","minimum":1},"reservation":{"$ref":"#/components/schemas/accommodation_reservation"},"stay_probability":{"description":"Probability that the traveller will complete the stay, based on internal calculations. A score of 0 indicates the highest likelihood of cancellation, while a score of 1 represents the highest likelihood of the traveller staying. Note: This score may not always be available.","type":["number","null"],"format":"double","multipleOf":0.01,"minimum":0,"maximum":1}}},"affiliate":{"description":"The affiliate id used for this order.","type":"integer"},"attractions":{"$ref":"#/components/schemas/attractionOutput"},"booker":{"$ref":"#/components/schemas/bookerOutput"},"cars":{"title":"OrderDetailsCarsOutput","type":"object","properties":{"dropoff_location":{"title":"OrderDetailsCarsDropoffLocationOutput","type":"object","properties":{"city":{"description":"The city where the dropoff location is.","type":"string"},"country":{"$ref":"#/components/schemas/countryId"}}},"payment":{"title":"OrderDetailsCarsPaymentOutput","description":"The payment policy that applies to this car rental.","type":"object","properties":{"timing":{"description":"Indicates when payment for this car rental is expected.\n\nUse this field to determine whether prepayment is required or if payment will occur at pickup.","type":"string","enum":["pay_online_now","pay_at_pickup","pay_partial_online_now","unknown"],"x-enumDescriptions":{"pay_online_now":"Payment is collected online at the time of booking.","pay_at_pickup":"Payment is collected locally at the pickup location.","pay_partial_online_now":"Part of the payment is made online at the moment of booking and the remaining at the pickup location.","unknown":"Payment timing is not available or could not be determined."}}},"required":["timing"]},"pickup_location":{"title":"OrderDetailsCarsPickupLocationOutput","type":"object","properties":{"city":{"description":"The city where the pickup location is.","type":"string"},"country":{"$ref":"#/components/schemas/countryId"}}},"reservation":{"$ref":"#/components/schemas/car_reservation"}}},"created":{"$ref":"#/components/schemas/createdOutput"},"commission":{"title":"OrderDetailsCommissionOutput","description":"Commission details for the partner for a given order. For taxi orders with multiple legs, amounts are the sum across all legs.","type":"object","properties":{"actual_commission_amount":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For accommodation: This is the final commission for this order ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if value is not yet available). For other travel services: It represents the estimated commission before billing and the final commission after billing."},"children":[]}]}]}],"$ref":"#/components/schemas/schemas-priceCurrencyOutput"},"actual_percentage":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Actual commission percentage for this order ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if not yet available). For taxi orders with multiple legs, this is the percentage of legs."},"children":[]}]}]}],"type":["number","null"],"format":"double"},"estimated_commission_amount":{"description":"This is an estimation displayed until the actual commission amount becomes available. For accommodations, may be null once the final commission value is set.","$ref":"#/components/schemas/schemas-priceCurrencyOutput"}}},"currencies":{"title":"OrderCurrencyOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Product and booker currencies. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"booker"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if it was not specified in the request."},"children":[]}]}]}],"type":"object","properties":{"booker":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Booker’s currency (ISO 4217). See the full list of currencies calling the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/open-api/demand-api/commonpayments/common/payments/currencies"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/payments/currencies"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"$ref":"#/components/schemas/currencyId"},"product":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Product’s base currency (ISO 4217). See the full list of currencies calling the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/open-api/demand-api/commonpayments/common/payments/currencies"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/payments/currencies"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". For taxi orders with multiple legs, this is the currency of the first leg."},"children":[]}]}]}],"$ref":"#/components/schemas/currencyId"}}},"end":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date when this order ends. Must be later than "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"start"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". For taxi orders with multiple legs, this is the latest pickup time among all legs."},"children":[]}]}]}],"type":"string","format":"date-time"},"flights":{"title":"OrderDetailsFlightsOutput","type":"object","description":"Flight details for this order.","properties":{"itineraries":{"type":"array","description":"List of flight itineraries included in the order.","items":{"$ref":"#/components/schemas/itineraryOutput"}},"reservation":{"description":"This is the reservation id for flight in this order.","type":"string"}}},"label":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom string defined by the partner to track attribution throughout the booking journey. Use a consistent, machine-parseable format (for example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"brand-market_platform-channel_campaign"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") to encode campaign, traffic source, platform, language, or other identifiers. Recommended for reliable reporting and analytics. See the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/orders-api/labels-attributions"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Labels and attributions guide"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"type":["string","null"]},"loyalty_reward":{"$ref":"#/components/schemas/loyaltyRewardOutput"},"payment":{"title":"OrderDetailsPaymentOutput","description":"The payment details of this order.","type":"object","properties":{"accommodations":{"title":"OrderDetailsAccommodationPaymentOutput","description":"The accommodation specific payment details of this order.","type":["object","null"],"properties":{"authorisation_form":{"description":"Link to the authorisation form of the order.","type":["string","null"],"format":"uri","example":"https://secure-admin.booking.com/airplus_auth_form_pdf.html?token=AAAA&lang=en-us"},"receipt_url":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Link to the payment receipt of the order. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"This will only be added if the payment is already charged."},"children":[]}]}]}],"type":["string","null"],"format":"uri","example":"https://secure.booking.com/payment_receipt.html?bn=0000000000&pincode=0000&lang=en"},"reservation":{"description":"Reservation ID for this accommodation order.","type":"string"}}},"method":{"description":"The payment method used for this order.","type":"string","enum":["airplus","card","wallet"]},"paid":{"description":"The paid transactions for this order.","$ref":"#/components/schemas/paymentTransactions"},"pending":{"description":"The pending transactions for this order.","$ref":"#/components/schemas/paymentTransactions"},"timing":{"description":"The payment timing of this order.","type":"string","enum":["pay_at_the_property","pay_online_later","pay_online_now"]}}},"price":{"title":"OrderDetailsPriceOutput","description":"The price components of this order. For taxi orders with multiple legs, amounts are the sum across all legs.","type":"object","properties":{"commissionable_price":{"description":"Price on which the commission is calculated, in both currencies (booker and product).","$ref":"#/components/schemas/schemas-priceCurrencyOutput"},"total_price":{"description":"Final order price including all charges, in both currencies.","$ref":"#/components/schemas/schemas-priceCurrencyOutput"}}},"start":{"description":"The date when this order starts. For taxi orders with multiple legs, this is the earliest pickup time among all legs.","type":"string","format":"date-time"},"status":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overall order status. The returned values depend on the travel service associated with the order:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accommodation:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"booked"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled_by_guest"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled_by_accommodation"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"stayed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_show"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cars"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Flights"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Attractions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"booked"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Taxi"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"booked"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unknown"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For taxi orders containing multiple legs, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unknown"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" indicates that the individual legs have different statuses. Inspect "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"taxis[].status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to determine the status of each leg."},"children":[]}]}]}],"$ref":"#/components/schemas/orderStatusOutput"},"taxis":{"description":"List of taxi legs included in this order. Each item represents a separate taxi leg (e.g., outbound and return trips).","type":["array","null"],"items":{"$ref":"#/components/schemas/taxiOutput"}},"updated":{"$ref":"#/components/schemas/updatedOutput"}}}},"components/schemas/ordersDetailsOutput":{"id":"components/schemas/ordersDetailsOutput","kind":"json-schema","title":"OrderDetailsOutput","data":{"title":"OrderDetailsOutput","description":"Collection of orders matching the request.","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/orderDetailsData"}},"metadata":{"$ref":"#/components/schemas/metadata"},"request_id":{"$ref":"#/components/schemas/requestId"}}}},"components/schemas/accommodations_extras":{"id":"components/schemas/accommodations_extras","kind":"json-schema","title":"accommodations_extras","data":{"description":"Input parameter to request for additional information about the accommodation order. It should be passed as a JSON array with one or more items.","type":"array","items":{"type":"string","enum":["accommodation_details","policies","extra_charges"]}}},"components/schemas/accommodations_inputOrder":{"id":"components/schemas/accommodations_inputOrder","kind":"json-schema","title":"OrderInput","data":{"title":"OrderInput","type":"object","properties":{"orders":{"description":"List of order IDs for which details should be returned.","type":"array","items":{"$ref":"#/components/schemas/order"},"maxItems":100},"currency":{"$ref":"#/components/schemas/currencyId"},"extras":{"$ref":"#/components/schemas/accommodations_extras"},"language":{"description":"Language for translated content. If not provided, English (en-gb) is used by default.","$ref":"#/components/schemas/languageId"}},"required":["orders"]}},"components/schemas/reservation":{"id":"components/schemas/reservation","kind":"json-schema","title":"reservation","data":{"description":"Accommodation reservation id for which details have to be returned.","type":"string"}},"components/schemas/inputReservation":{"id":"components/schemas/inputReservation","kind":"json-schema","title":"ReservationInput","data":{"title":"ReservationInput","type":"object","properties":{"reservations":{"type":"array","items":{"$ref":"#/components/schemas/reservation"},"maxItems":100},"currency":{"$ref":"#/components/schemas/currencyId"},"extras":{"$ref":"#/components/schemas/accommodations_extras"},"language":{"description":"Language in which translation should be provided. The default language is from settings","$ref":"#/components/schemas/languageId"}},"required":["reservations"]}},"components/schemas/accommodations_bookerOutput":{"id":"components/schemas/accommodations_bookerOutput","kind":"json-schema","title":"OrderDetailsBookerOutput","data":{"title":"OrderDetailsBookerOutput","description":"The booker's information.","type":"object","properties":{"external_account":{"description":"This is a unique identifier that represents the account provided by the partner in Booking.com settings. This field is used to link a specific accommodation order to the corresponding account so is possible to accurately allocate loyalty points or other benefits in the partner's loyalty and rewards programs.","type":"string"},"platform":{"description":"The booker platform for showing the platform based deals and prices.","$ref":"#/components/schemas/platform"}}}},"components/schemas/accommodations_checkinMethod":{"id":"components/schemas/accommodations_checkinMethod","kind":"json-schema","title":"accommodations_checkinMethod","data":{"description":"An enumeration that describes the check-in process and key collection method. This is typically applicable to non-hotel accommodations (such as houses or apartments) that do not have a 24-hour front desk.","type":"string","enum":["door_code","lock_box","reception","secret_spot","someone_will_meet","unknown"]}},"components/schemas/accommodations_keyLocation":{"id":"components/schemas/accommodations_keyLocation","kind":"json-schema","title":"accommodations_keyLocation","data":{"description":"Location of the key to access this accommodation property.","type":"string","enum":["at_the_property","different_place","unknown"]}},"components/schemas/accommodations_keyCollectionInformation":{"id":"components/schemas/accommodations_keyCollectionInformation","kind":"json-schema","title":"AccommodationsKeyCollectionInformationOutput","data":{"title":"AccommodationsKeyCollectionInformationOutput","type":"object","properties":{"additional_instructions":{"description":"Free-text instructions that provide additional context or details about the key collection or check-in process, such as access codes, entry procedures, or contact information.","type":"string"},"alternate_location":{"title":"AlternateLocationOutput","description":"This is the alternate location where the key for this accommodation property can be collected. It is provided if the key is not available at the accommodation property itself but instead at another designated location.","type":"object","properties":{"address":{"type":"string"},"city":{"type":"string"},"postal_code":{"type":"string"}}},"checkin_method":{"$ref":"#/components/schemas/accommodations_checkinMethod"},"key_location":{"$ref":"#/components/schemas/accommodations_keyLocation"}}}},"components/schemas/pricePerAccommodationReservation":{"id":"components/schemas/pricePerAccommodationReservation","kind":"json-schema","title":"AccommodationReservationPriceOutput","data":{"title":"AccommodationReservationPriceOutput","description":"The price components of this accommodation order.","type":["object","null"],"properties":{"commissionable":{"description":"The commissionable price. Reservation price on which commission amount is calculated.","$ref":"#/components/schemas/priceCurrencyOutput","nullable":true},"total":{"description":"The total price. Includes all extra charges.","$ref":"#/components/schemas/priceCurrencyOutput"}}}},"components/schemas/valueAddPostBook":{"id":"components/schemas/valueAddPostBook","kind":"json-schema","title":"ValueAddPostBookOutput","data":{"title":"ValueAddPostBookOutput","type":"object","description":"Value-added service with its type and descriptive text localised in specified language.","properties":{"type":{"$ref":"#/components/schemas/valueAddType"},"description":{"type":"array","description":"Translated descriptive text in the requested language.","items":{"type":"string"}}}}},"components/schemas/bundlePostBook":{"id":"components/schemas/bundlePostBook","kind":"json-schema","title":"BundlePostBookOutput","data":{"title":"BundlePostBookOutput","type":"object","description":"A bundle attached to the reservation that includes information about the value-added service in the specified language.","properties":{"id":{"type":"integer","description":"Bundle identifier"},"value_adds":{"type":"array","items":{"$ref":"#/components/schemas/valueAddPostBook"}}}}},"components/schemas/accommodations_guest":{"id":"components/schemas/accommodations_guest","kind":"json-schema","title":"GuestOutput","data":{"title":"GuestOutput","type":"object","properties":{"email":{"description":"The email address of the guest.","type":["string","null"]},"name":{"description":"The name of the guest.","type":"string"}}}},"components/schemas/detailsAccommodationsProductPolicies":{"id":"components/schemas/detailsAccommodationsProductPolicies","kind":"json-schema","title":"AccommodationDetailsProductPoliciesOutput","data":{"title":"AccommodationDetailsProductPoliciesOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The policies for this product. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{\"extras\":[\"policies\"]}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"object","properties":{"cancellation":{"$ref":"#/components/schemas/productDetailedCancellationPolicyMultiCurrency","nullable":true},"meal_plan":{"$ref":"#/components/schemas/productMealPlanPolicy"},"smoking_preference":{"description":"Smoking Preference for this product.","type":["string","null"],"enum":["smoking","non-smoking"]}}}},"components/schemas/chargeV32":{"id":"components/schemas/chargeV32","kind":"json-schema","title":"OrdersDetailsCharge","data":{"title":"OrdersDetailsCharge","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Charge information. Note: chargeable_online is not available in this endpoint."},"children":[]}]}]}],"type":"object","properties":{"charge":{"$ref":"#/components/schemas/chargeTypeId"},"mode":{"$ref":"#/components/schemas/chargeMode"},"percentage":{"$ref":"#/components/schemas/chargePercentage"},"total_amount":{"$ref":"#/components/schemas/priceCurrencyOutput"},"unit_amount":{"$ref":"#/components/schemas/priceCurrencyOutput","nullable":true},"condition":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies the condition under which this charge applies. Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the charge is not conditional."},"children":[]}]}]}],"$ref":"#/components/schemas/conditionId","nullable":true},"included_in":{"title":"ChargeIncludedInDetails","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates where this charge is included. Note: chargeable_online is not available in this endpoint."},"children":[]}]}]}],"type":"object","properties":{"display":{"description":"Indicates if this charge is included in the display price.","type":"boolean"}}}}}},"components/schemas/accommodations_productPrice":{"id":"components/schemas/accommodations_productPrice","kind":"json-schema","title":"AccommodationDetailsProductPriceOutput","data":{"title":"AccommodationDetailsProductPriceOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The price components of this product. 'base', 'display', and 'charges' are returned only when explicitly requested (via 'extras=extra_charges'). Note: chargeable_online field is not available in this endpoint."},"children":[]}]}]}],"type":"object","properties":{"base":{"description":"The base price. It does not include any extra charges.","$ref":"#/components/schemas/priceCurrencyOutput","nullable":true},"display":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The display price that must be shown to the traveller under local booker protection laws. Equivalent to base + charges where included_in.display=true."},"children":[]}]}]}],"$ref":"#/components/schemas/priceCurrencyOutput","nullable":true},"charges":{"description":"The charge breakdown. Includes taxes and fees.","type":"array","items":{"$ref":"#/components/schemas/chargeV32"}},"total":{"description":"The total price. Includes all extra charges.","$ref":"#/components/schemas/priceCurrencyOutput","nullable":true}}}},"components/schemas/detailsAccommodationsProductOutput":{"id":"components/schemas/detailsAccommodationsProductOutput","kind":"json-schema","title":"OrdersDetailsAccommodationsProductsOutput","data":{"title":"OrdersDetailsAccommodationsProductsOutput","description":"The returned information of the product reserved.","type":"object","properties":{"allocation":{"title":"OrdersDetailsAccommodationsPropertiesOutput","description":"The allocation of guests, adults and children for this product.","type":"object","properties":{"guests":{"description":"The number of guests reserved for this product.","type":"integer","minimum":1},"adults":{"description":"The number of adults reserved for this product.","type":["integer","null"],"minimum":1},"children":{"description":"The list of ages of all children reserved for this product.","type":"array","items":{"description":"The age of a child","type":["integer","null"],"maximum":17}}}},"bundle":{"$ref":"#/components/schemas/bundlePostBook"},"guests":{"description":"The guest details for this product.","type":"array","items":{"$ref":"#/components/schemas/accommodations_guest"}},"policies":{"$ref":"#/components/schemas/detailsAccommodationsProductPolicies"},"price":{"$ref":"#/components/schemas/accommodations_productPrice"},"room":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique identifier for a specific room within an accommodation property. You can retrieve the full list of available room IDs by calling "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/details"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"accommodations/details"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string"},"room_details":{"title":"RoomDetailsOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Room details for this product (via 'extras=accommodation_details')."},"children":[]}]}]}],"type":"object","properties":{"name":{"description":"The room name given to this product.","type":"string"}}},"room_reservation":{"description":"The room reservation id given to this product.","type":"string"},"status":{"description":"Status of the product.","$ref":"#/components/schemas/status"}}}},"components/schemas/ordersDetailsAccommodations":{"id":"components/schemas/ordersDetailsAccommodations","kind":"json-schema","title":"OrdersDetailsAccommodationsOutput","data":{"title":"OrdersDetailsAccommodationsOutput","description":"Object containing all the information related to accommodation order.","type":"object","properties":{"id":{"description":"Order ID for this accommodation order.","type":"string"},"accommodation":{"description":"Hotel ID for this accommodation order.","type":"integer"},"accommodation_details":{"title":"OrdersAccommodationDetailsOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accommodation details for this accommodation order (via 'extras=accommodation_details')."},"children":[]}]}]}],"type":"object","properties":{"email":{"description":"Accommodation email.","type":"string"},"location":{"title":"AccommodationLocationOutput","description":"Accommodation location.","type":"object","properties":{"address":{"description":"Accommodation address.","type":"string"},"city":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accommodation city_id."},"children":[]}]}]}],"type":"integer"},"coordinates":{"title":"AccommodationCoordinatesOutput","description":"Accommodation coordinates.","type":"object","properties":{"latitude":{"description":"Accommodation latitude coordinate.","type":"number"},"longitude":{"description":"Accommodation longitude coordinate.","type":"number"}}},"country":{"description":"Accommodation country.","$ref":"#/components/schemas/countryId"},"post_code":{"description":"Accommodation post code.","type":"string"}}},"name":{"description":"Accommodation name.","type":"string"},"telephone":{"description":"Accommodation telephone.","type":"string"}}},"accommodation_order_references":{"description":"List of additional accommodation order references generated by the accommodation.","type":"array","items":{"type":"string"}},"booker":{"$ref":"#/components/schemas/accommodations_bookerOutput"},"cancellation_details":{"title":"OrderCancellationDetailsOutput","description":"Fee charged for cancellation and the datetime at which the cancellation occurred. (If not cancelled, value is null).","type":"object","properties":{"at":{"description":"Cancellation datetime.","type":"string","format":"date-time"},"fee":{"description":"Cancellation fee.","$ref":"#/components/schemas/priceCurrencyOutput"},"original_total_price":{"description":"The total amount that would have been charged if this order had not been cancelled. Includes all extra charges.","$ref":"#/components/schemas/priceCurrencyOutput"}},"nullable":true},"checkin":{"description":"The checkin date of this accommodation order.","type":"string","format":"date"},"checkout":{"description":"The checkout date of this accommodation order.","type":"string","format":"date"},"commission":{"title":"OrderCommissionOutput","description":"Commission details for the partner for this accommodation order.","type":"object","properties":{"actual_amount":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Actual commission amount for this accommodation order ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if value is not yet available)."},"children":[]}]}]}],"$ref":"#/components/schemas/priceCurrencyOutput","nullable":true},"actual_percentage":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Actual commission percentage for this accommodation order ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if value is not yet available)."},"children":[]}]}]}],"type":["number","null"],"format":"double"},"estimated_amount":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Estimated commission amount for this accommodation order ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the actual amount is given)."},"children":[]}]}]}],"$ref":"#/components/schemas/priceCurrencyOutput","nullable":true}}},"credit_slip_number":{"description":"The financial document issued by Booking.com to partners, detailing the payout amount and the associated transaction information. It serves as a formal record of the payment, ensuring transparency and facilitating accurate financial tracking for both parties.","type":["string","null"]},"currency":{"title":"OrderCurrencyOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accommodation and booker currencies (booker will be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", if the request did not specify the currency)."},"children":[]}]}]}],"type":"object","properties":{"accommodation":{"$ref":"#/components/schemas/currencyId"},"booker":{"nullable":true,"$ref":"#/components/schemas/currencyId"}}},"inventory":{"$ref":"#/components/schemas/inventoryOutput"},"key_collection_information":{"type":["array","null"],"items":{"$ref":"#/components/schemas/accommodations_keyCollectionInformation"}},"label":{"description":"Label provided when the accommodation order was created.","type":["string","null"]},"pin_code":{"description":"The pin code of this accommodation order.","type":"string"},"price":{"$ref":"#/components/schemas/pricePerAccommodationReservation"},"products":{"type":"array","items":{"$ref":"#/components/schemas/detailsAccommodationsProductOutput"}},"reservation":{"description":"Reservation ID for given accommodation order.","type":"string"},"remarks":{"description":"Guest remarks added while creating order.","type":"string"},"status":{"description":"Status of this accommodation order.","$ref":"#/components/schemas/status"},"stay_probability":{"description":"Score that predicts the likelihood of a traveller's intent to stay, based on internal calculations. A score of 0 indicates the highest likelihood of cancellation, while a score of 1 represents the highest likelihood of the traveller staying. Note: This score may not always be available.","type":["number","null"],"format":"double","multipleOf":0.01,"minimum":0,"maximum":1}}}},"components/schemas/outputAccommodationsOrder":{"id":"components/schemas/outputAccommodationsOrder","kind":"json-schema","title":"OrdersDetailsAccommodationsOutput","data":{"title":"OrdersDetailsAccommodationsOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ordersDetailsAccommodations"}}}}},"components/schemas/cars_extras":{"id":"components/schemas/cars_extras","kind":"json-schema","title":"cars_extras","data":{"description":"Optional extra details to include in the response, passed as a JSON array.","type":"array","items":{"type":"string","enum":["policies"]}}},"components/schemas/carsDetailsInputOrder":{"id":"components/schemas/carsDetailsInputOrder","kind":"json-schema","title":"OrderInput","data":{"title":"OrderInput","type":"object","properties":{"orders":{"description":"List of order IDs for which details should be returned.","type":"array","items":{"$ref":"#/components/schemas/order"},"maxItems":100},"currency":{"$ref":"#/components/schemas/currencyId"},"extras":{"description":"Optional extra details to include in the response, passed as a JSON array.","$ref":"#/components/schemas/cars_extras"}},"required":["orders"]}},"components/schemas/carsDetailsInputReservation":{"id":"components/schemas/carsDetailsInputReservation","kind":"json-schema","title":"ReservationInput","data":{"title":"ReservationInput","type":"object","properties":{"reservations":{"description":"List of reservation IDs for which details should be returned.","type":"array","items":{"$ref":"#/components/schemas/order"},"maxItems":100},"currency":{"$ref":"#/components/schemas/currencyId"},"extras":{"description":"Optional extra details to include in the response, passed as a JSON array.","$ref":"#/components/schemas/cars_extras"}},"required":["reservations"]}},"components/schemas/cars_priceCurrencyOutput":{"id":"components/schemas/cars_priceCurrencyOutput","kind":"json-schema","title":"CarsPriceCurrency","data":{"title":"CarsPriceCurrency","description":"The price in both depot and booker currencies (booker might be null, if not requested)","type":"object","properties":{"depot_currency":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The price in depot currency. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"DEPRECATED: Always expect null/omitted."},"children":[]}]}]}]}],"$ref":"#/components/schemas/monetaryAmount","deprecated":true,"nullable":true},"booker_currency":{"$ref":"#/components/schemas/monetaryAmount"}}}},"components/schemas/cars_routePointOutput":{"id":"components/schemas/cars_routePointOutput","kind":"json-schema","title":"cars_routePointOutput","data":{"description":"Pickup or drop-off location details.","type":"object","properties":{"datetime":{"description":"Pickup/drop-off date and time in ISO-8601 format.","example":"2023-11-01T11:05:00+00:00","format":"date-time","type":"string"}}}},"components/schemas/pricePerCarReservation":{"id":"components/schemas/pricePerCarReservation","kind":"json-schema","title":"CarReservationPriceOutput","data":{"title":"CarReservationPriceOutput","description":"The price breakdown for this car order.","type":"object","properties":{"commissionable":{"description":"The commissionable price, representing the car rental cost used to calculate the commission amount. DEPRECATED: Always expect null/omitted in this endpoint. Check the orders/details endpoint for commission details instead.","$ref":"#/components/schemas/cars_priceCurrencyOutput","nullable":true,"deprecated":true},"total":{"description":"The total price, including all extra charges.","$ref":"#/components/schemas/cars_priceCurrencyOutput"}},"nullable":true}},"components/schemas/cars_paymentOutput":{"id":"components/schemas/cars_paymentOutput","kind":"json-schema","title":"cars_paymentOutput","data":{"description":"The payment policy that applies to this product.","type":"object","properties":{"timing":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The applied payment timing. For example 'pay_online_now'."},"children":[]}]}]}],"type":"string","enum":["pay_online_now","pay_at_pickup","pay_partial_online_now","unknown"]}},"required":["timing"]}},"components/schemas/cars_policiesOutput":{"id":"components/schemas/cars_policiesOutput","kind":"json-schema","title":"cars_policiesOutput","data":{"description":"The policies that apply to this product.","type":"object","properties":{"payment":{"$ref":"#/components/schemas/cars_paymentOutput"}}}},"components/schemas/cars_productPrice":{"id":"components/schemas/cars_productPrice","kind":"json-schema","title":"CarDetailsProductPriceOutput","data":{"title":"CarDetailsProductPriceOutput","description":"Detailed breakdown of the product's price components.","type":"object","properties":{"base":{"description":"The base price. This does not include any extra charges.","$ref":"#/components/schemas/cars_priceCurrencyOutput","nullable":true},"total":{"description":"The total price including any extra charges.","$ref":"#/components/schemas/cars_priceCurrencyOutput","nullable":true}}}},"components/schemas/detailsCarsProductOutput":{"id":"components/schemas/detailsCarsProductOutput","kind":"json-schema","title":"OrdersDetailsCarsProductsOutput","data":{"title":"OrdersDetailsCarsProductsOutput","description":"Information about the reserved product within the order.","type":"object","properties":{"car":{"description":"Related car id","$ref":"#/components/schemas/carId"},"policies":{"$ref":"#/components/schemas/cars_policiesOutput"},"price":{"$ref":"#/components/schemas/cars_productPrice"},"status":{"description":"Status of the product.","$ref":"#/components/schemas/status"}}}},"components/schemas/ordersDetailsCars":{"id":"components/schemas/ordersDetailsCars","kind":"json-schema","title":"OrdersDetailsCarsOutput","data":{"title":"OrdersDetailsCarsOutput","description":"Object containing all the information related to car order.","type":"object","properties":{"id":{"description":"Order ID for this car order.","type":"string"},"affiliate":{"description":"The affiliate ID used for this order.","type":"number"},"commission":{"description":"Commission details for the partner for this car order. DEPRECATED: Always expect null/omitted in this endpoint. Check the orders/details endpoint for commission details instead.","nullable":true,"deprecated":true,"type":"object","properties":{"actual_amount":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Actual commission amount for this car order ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if value is not yet available)."},"children":[]}]}]}],"$ref":"#/components/schemas/cars_priceCurrencyOutput","nullable":true,"deprecated":true},"actual_percentage":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Actual commission percentage for this car order ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if value is not yet available)."},"children":[]}]}]}],"type":"number","format":"double","nullable":true,"deprecated":true},"estimated_amount":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Estimated commission amount for this car order ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the actual amount is given)."},"children":[]}]}]}],"$ref":"#/components/schemas/cars_priceCurrencyOutput","nullable":true}}},"currency":{"title":"OrderCurrencyOutput","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Depot and booker currencies (depot will be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" going forward)."},"children":[]}]}]}],"type":"object","properties":{"depot":{"$ref":"#/components/schemas/currencyId","nullable":true,"deprecated":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Depot currency ID. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"DEPRECATED: Will be set to null."},"children":[]}]}]}]}]},"booker":{"nullable":true,"$ref":"#/components/schemas/currencyId"}}},"dropoff":{"description":"Drop-off depot location and time.","$ref":"#/components/schemas/cars_routePointOutput"},"label":{"description":"Identifier associated with the car booking. DEPRECATED: Always expect null/omitted in this endpoint. If you need to use 'label' for attributions, refer to orders/details","type":"string","nullable":true,"deprecated":true},"pickup":{"description":"Pick up depot location and time.","$ref":"#/components/schemas/cars_routePointOutput"},"price":{"$ref":"#/components/schemas/pricePerCarReservation"},"products":{"type":"array","items":{"$ref":"#/components/schemas/detailsCarsProductOutput"}},"reservation":{"description":"This is the reservation id for the car in this order.","type":"string"},"status":{"description":"Status of this car order.","$ref":"#/components/schemas/status"}}}},"components/schemas/carsDetailsOutput":{"id":"components/schemas/carsDetailsOutput","kind":"json-schema","title":"OrdersDetailsCarsOutput","data":{"title":"OrdersDetailsCarsOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","description":"List of car order objects containing full details for each requested reservation.","items":{"$ref":"#/components/schemas/ordersDetailsCars"}}}}},"components/schemas/flights_input":{"id":"components/schemas/flights_input","kind":"json-schema","title":"FlightsDetailsInput","data":{"title":"FlightsDetailsInput","type":"object","properties":{"currency":{"$ref":"#/components/schemas/currencyId"}},"oneOf":[{"title":"FlightsDetailsInputByOrders","properties":{"orders":{"description":"List of order IDs for which details should be returned. Mutually exclusive with 'reservations'.","type":"array","items":{"type":"string","description":"Flight order id for which details have to be returned."},"maxItems":100}},"required":["orders"],"example":{"currency":"EUR","orders":["1234567890123456","9876543210987654"]}},{"title":"FlightsDetailsInputByReservations","properties":{"reservations":{"description":"List of reservation IDs for which details should be returned. Mutually exclusive with 'orders'.","type":"array","items":{"type":"string","description":"Flight reservation id for which details have to be returned."},"maxItems":100}},"required":["reservations"],"example":{"currency":"EUR","reservations":["2321873123","4666773123"]}}]}},"components/schemas/currencyOutput":{"id":"components/schemas/currencyOutput","kind":"json-schema","title":"CurrencyOutput","data":{"title":"CurrencyOutput","type":"object","properties":{"booker_currency":{"description":"The currency of the booker.","type":"string"},"order_currency":{"description":"The currency in which the order was created.","type":"string"}}}},"components/schemas/flights_itinerary":{"id":"components/schemas/flights_itinerary","kind":"json-schema","title":"ItineraryPoint","data":{"title":"ItineraryPoint","type":"object","properties":{"airport":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A three-letter code that uniquely identifies an airport as defined by the International Air Transport Association (IATA). The full list can be obtained by calling  "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/common/locations/airports"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"common/locations/airports"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"pattern":"^[A-Z]{3}$","type":"string"},"date_time":{"description":"Date time of the itinerary.","type":"string","format":"date-time"}}}},"components/schemas/flights_itineraryOutput":{"id":"components/schemas/flights_itineraryOutput","kind":"json-schema","title":"ItineraryOutput","data":{"title":"ItineraryOutput","type":"object","properties":{"arrival":{"description":"Arrival itinerary.","$ref":"#/components/schemas/flights_itinerary"},"departure":{"description":"Departure itinerary.","$ref":"#/components/schemas/flights_itinerary"}}}},"components/schemas/priceOutput":{"id":"components/schemas/priceOutput","kind":"json-schema","title":"PriceOutput","data":{"title":"PriceOutput","type":"object","properties":{"booker_currency":{"description":"The price in the currency of the booker","type":"number","format":"double"},"order_currency":{"description":"The price in the currency in which order was created","type":"number","format":"double"}}}},"components/schemas/flightsOutput":{"id":"components/schemas/flightsOutput","kind":"json-schema","title":"FlightsOutput","data":{"title":"FlightsOutput","type":"object","properties":{"id":{"description":"Order id","type":"string"},"reservation":{"description":"This is the reservation id for the travel service in this order.","type":"string"},"currency":{"$ref":"#/components/schemas/currencyOutput"},"itineraries":{"type":"array","items":{"$ref":"#/components/schemas/flights_itineraryOutput"}},"label":{"description":"Identifier associated with the order.","type":"string"},"price":{"$ref":"#/components/schemas/priceOutput"},"status":{"type":"string","enum":["booked","cancelled","unknown"]}}}},"components/schemas/flights_output":{"id":"components/schemas/flights_output","kind":"json-schema","title":"OrdersDetailsFlightsOutput","data":{"title":"OrdersDetailsFlightsOutput","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/flightsOutput"}},"request_id":{"$ref":"#/components/schemas/requestId"}}}},"components/schemas/orderId":{"id":"components/schemas/orderId","kind":"json-schema","title":"orderId","data":{"type":"string","description":"Order ID to be modified"}},"components/schemas/dateChange":{"id":"components/schemas/dateChange","kind":"json-schema","title":"dateChange","data":{"type":"object","properties":{"checkin":{"type":"string","format":"date","description":"New checkin date"},"checkout":{"type":"string","format":"date","description":"New checkout date"}},"required":["checkin","checkout"]}},"components/schemas/roomChange":{"id":"components/schemas/roomChange","kind":"json-schema","title":"roomChange","data":{"type":"object","properties":{"room_reservation":{"type":"string"},"allocation":{"type":"object","properties":{"number_of_adults":{"type":"integer"}}},"guests":{"description":"Guest information for the room.","type":"array","items":{"type":"object","properties":{"name":{"type":"string"}}}},"smoking_preference":{"type":"string","enum":["no_preference","non_smoking","smoking"]}}}},"components/schemas/accommodationChange":{"id":"components/schemas/accommodationChange","kind":"json-schema","title":"accommodationChange","data":{"type":"object","properties":{"reservation":{"type":"string","description":"Reservation ID"},"change":{"oneOf":[{"title":"DateChange","$ref":"#/components/schemas/dateChange"},{"title":"RoomChange","$ref":"#/components/schemas/roomChange"}]},"type":{"description":"Type of the accommodation change","type":"string","enum":["dates","room"]}},"required":["reservation","type","change"]}},"components/schemas/accommodationModificationInput":{"id":"components/schemas/accommodationModificationInput","kind":"json-schema","title":"accommodationModificationInput","data":{"type":"object","properties":{"order":{"$ref":"#/components/schemas/orderId"},"modification":{"type":"object","properties":{"accommodation":{"$ref":"#/components/schemas/accommodationChange"}},"required":["accommodation"]}},"required":["order","modification"]}},"components/schemas/cardDetails":{"id":"components/schemas/cardDetails","kind":"json-schema","title":"cardDetails","data":{"type":"object","properties":{"cardholder":{"type":"string","description":"Cardholder name"},"cvc":{"type":"string","description":"A 3 or 4 digit Card Verification Code (CVC) associated with the used card"},"expiry_date":{"type":"string","format":"YYYY-MM","description":"Card expiry date"},"number":{"type":"string","description":"Card number"}},"required":["cardholder","cvc","expiry_date","number"]}},"components/schemas/paymentChange":{"id":"components/schemas/paymentChange","kind":"json-schema","title":"paymentChange","data":{"type":"object","properties":{"change":{"$ref":"#/components/schemas/cardDetails"},"type":{"description":"Type of the payment change","type":"string","enum":["card"]}},"required":["type","change"]}},"components/schemas/paymentModificationInput":{"id":"components/schemas/paymentModificationInput","kind":"json-schema","title":"paymentModificationInput","data":{"type":"object","properties":{"order":{"$ref":"#/components/schemas/orderId"},"modification":{"type":"object","properties":{"payment":{"$ref":"#/components/schemas/paymentChange"}},"required":["payment"]}},"required":["modification"]}},"components/schemas/statusOutput":{"id":"components/schemas/statusOutput","kind":"json-schema","title":"statusOutput","data":{"description":"Status for this modification request.","type":"string","enum":["successful","failed"]}},"components/schemas/accommodationModificationOutput":{"id":"components/schemas/accommodationModificationOutput","kind":"json-schema","title":"accommodationModificationOutput","data":{"type":"object","properties":{"modification":{"type":"object","properties":{"accommodation":{"type":"object","properties":{"new_price":{"description":"New price to be paid after the modification","type":"number","format":"double"},"status":{"$ref":"#/components/schemas/statusOutput"}}}}}}}},"components/schemas/paymentModificationOutput":{"id":"components/schemas/paymentModificationOutput","kind":"json-schema","title":"paymentModificationOutput","data":{"type":"object","properties":{"modifications":{"type":"object","properties":{"payment":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/statusOutput"}}}}}}}},"components/schemas/cancelInput":{"id":"components/schemas/cancelInput","kind":"json-schema","title":"OrdersCancelInput","data":{"title":"OrdersCancelInput","description":"Cancels a travel service within an existing order. Provide the reservation details for the travel service you want to cancel. Only one travel service can be cancelled per request.","type":"object","properties":{"order":{"description":"Unique identifier of the order containing the travel service to cancel.","type":"string"},"accommodation":{"title":"AccommodationOrdersCancelInput","type":"object","properties":{"reservation":{"description":"Unique identifier of the Accommodation order to cancel.","type":"string"},"reason":{"description":"Free-text explanation for the cancellation request.","type":"string"},"request_property_approval":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deprecated."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" For accommodation orders only. If a cancellation fee applies, you can request the accommodation to waive the fee and approve free cancellation. This is subject to accommodation approval."},"children":[]}]}]}],"type":"boolean","deprecated":true}},"required":["reservation","reason"]},"car":{"title":"CarsOrdersCancelInput","type":"object","properties":{"reservation":{"description":"Unique identifier of the car rental reservation to cancel.","type":"string"},"reason":{"description":"Free-text explanation for the cancellation request.","type":"string"},"booker":{"description":"Information about the person who made the booking. Required for car cancellations.","type":"object","properties":{"country":{"$ref":"#/components/schemas/countryId"}},"required":["country"]}},"required":["reservation","reason","booker"]},"insurance":{"title":"InsuranceOrdersCancelInput","description":"Details of the insurance policy to cancel. Cancelling the insurance policy does not cancel the associated car rental reservation.","type":"object","properties":{"car":{"title":"CarsInsuranceOrdersCancelInput","type":"object","properties":{"reservation":{"description":"Unique identifier of the car rental reservation associated with the insurance policy.","type":"string"},"policy_reference":{"description":"Unique identifier of the insurance policy to cancel.","type":"string"},"booker":{"description":"Information about the person who made the booking.","type":"object","properties":{"country":{"$ref":"#/components/schemas/countryId"}},"required":["country"]}},"required":["reservation","policy_reference","booker"]}},"required":["car"]}},"oneOf":[{"title":"Cancel a car order","description":"Use this option to cancel a car rental reservation.","required":["car"]},{"title":"Cancel an accommodation order","description":"Use this option to cancel an accommodation reservation.","required":["accommodation"]},{"title":"Cancel a car insurance policy","description":"Use this option to cancel an insurance policy without cancelling the associated car rental reservation.","required":["insurance"]}]}},"components/schemas/cancelOutput":{"id":"components/schemas/cancelOutput","kind":"json-schema","title":"OrdersCancelOutput","data":{"title":"OrdersCancelOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"title":"OrdersCancelDataOutput","type":"object","properties":{"status":{"oneOf":[{"title":"Accommodation cancellation status","description":"Returned for accommodation cancellations. The reservation has already been cancelled successfully. If the cancellation cannot be completed, the API returns an error response.","type":"string","enum":["successful"]},{"title":"Car rental and car insurance cancellation status","description":"Returned for car rental and car insurance cancellations. The cancellation request has been accepted and is processed asynchronously. Retrieve the latest car order details using /orders/details/cars/live (Beta) to confirm that the reservation or insurance policy has been cancelled. If the request cannot be processed, the API returns an error response instead.","type":"string","enum":["processing"]}]}}}}}},"schema_499":{"kind":"json-schema","data":{"type":"integer"},"id":"schema_499"},"schema_500":{"kind":"json-schema","data":{"type":"object","additionalProperties":false,"properties":{}},"id":"schema_500"},"schema_501":{"kind":"json-schema","data":{"oneOf":[{"title":"Filter by last update date","description":"Retrieve orders that were last updated within a specific time range. Use this to sync incremental changes, such as status updates, cancellations, or modifications.","$ref":"#/components/schemas/inputUpdated"},{"title":"Filter by creation date","description":"Retrieve orders that were created within a specific time range. Useful for initial data ingestion, reporting, or tracking newly created bookings.","$ref":"#/components/schemas/inputCreated"},{"title":"Filter by start date","description":"Retrieve orders based on the start date of the travel service (for example, check-in, pickup, or departure). Ideal for operational workflows and upcoming trips.","$ref":"#/components/schemas/inputStart"},{"title":"Filter by end date","description":"Retrieve orders based on the end date of the travel service (for example, check-out or return). Useful for post-stay processing, reporting, or completed trips.","$ref":"#/components/schemas/inputEnd"},{"title":"Filter by order IDs","description":"Retrieve details for a specific list of order IDs. Use this when you already know the order identifiers and need to fetch precise records.","$ref":"#/components/schemas/inputOrder"},{"title":"Filter by reservation IDs","description":"Retrieve orders linked to a specific list of reservation IDs across services. Useful when your system stores reservation-level identifiers instead of order IDs.","$ref":"#/components/schemas/inputReservations"},{"title":"Paginate through all orders","description":"Retrieve orders using a pagination token. Use this to iterate through large datasets when processing all available orders.","$ref":"#/components/schemas/inputPage"}]},"id":"schema_501"},"schema_502":{"kind":"json-schema","data":{"oneOf":[{"title":"Input by Order IDs","$ref":"#/components/schemas/accommodations_inputOrder"},{"title":"Input by reservation IDs","$ref":"#/components/schemas/inputReservation"}]},"id":"schema_502"},"schema_503":{"kind":"json-schema","data":{"oneOf":[{"title":"CarsDetailsInputByOrders","$ref":"#/components/schemas/carsDetailsInputOrder","deprecated":true,"description":"DEPRECATED: Do not use the order ID in your request, use the reservation ID instead."},{"title":"CarsDetailsInputByReservations","$ref":"#/components/schemas/carsDetailsInputReservation"}]},"id":"schema_503"},"schema_504":{"kind":"json-schema","data":{"oneOf":[{"title":"AccommodationModification","$ref":"#/components/schemas/accommodationModificationInput"},{"title":"PaymentModification","$ref":"#/components/schemas/paymentModificationInput"}]},"id":"schema_504"},"schema_505":{"kind":"json-schema","data":{"oneOf":[{"title":"AccommodationModificationResponse","$ref":"#/components/schemas/accommodationModificationOutput"},{"title":"PaymentModificationResponse","$ref":"#/components/schemas/paymentModificationOutput"}]},"id":"schema_505"}},"exampleStore":{"components/examples/output":{"id":"components/examples/output","value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":"509430129718799","accommodation":123456,"accommodation_details":{"email":"test_hotel@booking.com","location":{"address":"111 Street Road","city":20089219,"coordinates":{"latitude":11.923274,"longitude":-92.716188},"country":"us","post_code":"NY 1234"},"name":"Test Booking Hotel USA","telephone":"+19876543210"},"accommodation_order_references":["12345","ABED2312"],"booker":{"external_account":"13610217","platform":"mobile"},"cancellation_details":{"at":"2025-12-09T00:00:00+00:00","fee":{"accommodation_currency":170.01,"booker_currency":186.87},"original_total_price":{"accommodation_currency":170.01,"booker_currency":186.87}},"checkin":"2025-12-10","checkout":"2025-12-18","commission":{"actual_amount":null,"actual_percentage":null,"estimated_amount":{"accommodation_currency":17.5,"booker_currency":19.23}},"credit_slip_number":"hsnl1223445","currency":{"accommodation":"EUR","booker":"USD"},"inventory":{"third_party":false,"type":"sell"},"key_collection_information":[{"additional_instructions":"The keys are in a keybox located next to the front door.","alternate_location":{"address":"abc","city":"bdweb","postal_code":"1015XX"},"checkin_method":"someone_will_meet","key_location":"at_the_property"}],"label":"One123","pin_code":"1234","price":{"commissionable":{"accommodation_currency":164.01,"booker_currency":180.27},"total":{"accommodation_currency":170.01,"booker_currency":186.87}},"products":[{"allocation":{"adults":2,"children":[3,4,5],"guests":5},"guests":[{"email":"test.name@booking.com","name":"Test Name"}],"policies":{"cancellation":[{"from":null,"price":{"accommodation_currency":170.01,"booker_currency":186.87}}],"meal_plan":{"meals":["breakfast"],"plan":"breakfast_included"},"smoking_preference":"non-smoking"},"price":{"base":{"accommodation_currency":170.01,"booker_currency":186.87},"display":{"accommodation_currency":200.97,"booker_currency":220.9},"charges":[{"charge":142,"mode":"per_person_per_night","percentage":null,"total_amount":{"accommodation_currency":6,"booker_currency":6.6},"unit_amount":{"accommodation_currency":3,"booker_currency":3.3},"condition":null,"included_in":{"display":true}},{"charge":21,"mode":"percentage","percentage":9,"total_amount":{"accommodation_currency":14.04,"booker_currency":15.43},"unit_amount":null,"condition":null,"included_in":{"display":true}},{"charge":22,"mode":"percentage","percentage":7,"total_amount":{"accommodation_currency":10.92,"booker_currency":12},"unit_amount":null,"condition":null,"included_in":{"display":true}}],"total":{"accommodation_currency":200.97,"booker_currency":220.9}},"room":"12345","room_details":{"name":"Double Deluxe Room"},"room_reservation":"1234567890","status":"booked"}],"remarks":"We will need an extra cot. Need room on higher floor","reservation":"12345678","status":"booked","stay_probability":0.12}]},"summary":"Accommodation order details response"},"paths/~1accommodations~1search/post/requestBody/content/application~1json/example":{"value":{"booker":{"country":"nl","platform":"desktop"},"checkin":"!START_DATE!","checkout":"!END_DATE!","city":-2140479,"extras":["extra_charges","products"],"guests":{"number_of_adults":2,"number_of_rooms":1}},"id":"paths/~1accommodations~1search/post/requestBody/content/application~1json/example"},"paths/~1accommodations~1search/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":10004,"currency":{"accommodation":"EUR","booker":"EUR"},"deep_link_url":"booking://hotel/10004?affiliate_id=!AFFILIATE_ID!&checkin=!START_DATE!&checkout=!END_DATE!&mcid=10","price":{"base":{"accommodation_currency":1081.49,"booker_currency":1081.49},"charges":[{"charge":21,"condition":null,"included_in":{"display":true},"total_amount":{"accommodation_currency":97.34,"booker_currency":97.34}},{"charge":22,"condition":null,"included_in":{"display":true},"total_amount":{"accommodation_currency":75.7,"booker_currency":75.7}},{"charge":142,"condition":null,"included_in":{"display":true},"total_amount":{"accommodation_currency":6,"booker_currency":6}}],"display":{"accommodation_currency":1260.52,"booker_currency":1260.52},"total":{"accommodation_currency":1260.52,"booker_currency":1260.52}},"products":[{"id":"1000420_95127794_2_0_0","bundle":null,"children":[],"deal":null,"inventory":{"third_party":false,"type":"sell"},"number_of_adults":2,"policies":{"cancellation":{"free_cancellation_until":null,"type":"non_refundable"},"meal_plan":{"meals":[],"plan":"no_plan"},"payment":{"timings":["pay_at_the_property"]}},"price":{"base":{"accommodation_currency":1081.49,"booker_currency":1081.49},"charges":[{"charge":21,"condition":null,"included_in":{"display":true,"chargeable_online":true},"mode":"percentage","percentage":9,"total_amount":{"accommodation_currency":107.07,"booker_currency":107.07},"unit_amount":null},{"charge":22,"condition":null,"included_in":{"display":true,"chargeable_online":false},"mode":"percentage","percentage":7,"total_amount":{"accommodation_currency":83.27,"booker_currency":83.27},"unit_amount":null},{"charge":142,"condition":null,"included_in":{"display":true,"chargeable_online":true},"mode":"per_person_per_night","percentage":null,"total_amount":{"accommodation_currency":6,"booker_currency":6},"unit_amount":{"accommodation_currency":3,"booker_currency":3}}],"display":{"accommodation_currency":1260.52,"booker_currency":1260.52},"total":{"accommodation_currency":1260.52,"booker_currency":1260.52}},"room":"1000425"}],"url":"https://www.booking.com/hotel/nl/conscious-the-tire-station.html?affiliate_id=!AFFILIATE_ID!&checkin=!START_DATE!&checkout=!END_DATE!&group_adults=2&no_rooms=1"},"..."],"metadata":{"next_page":"..."}},"id":"paths/~1accommodations~1search/post/responses/200/content/application~1json/example"},"paths/~1accommodations~1availability/post/requestBody/content/application~1json/example":{"value":{"accommodations":[10004],"booker":{"country":"nl","platform":"desktop"},"checkin":"!START_DATE!","checkout":"!END_DATE!","extras":["extra_charges"],"filters":{"meal_plan":"breakfast_included","cancellation_type":"free_cancellation"},"guests":{"number_of_adults":2,"number_of_rooms":1}},"id":"paths/~1accommodations~1availability/post/requestBody/content/application~1json/example"},"paths/~1accommodations~1availability/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":10004,"currency":{"accommodation":"EUR","booker":"EUR"},"deep_link_url":"booking://hotel/10004?affiliate_id=!AFFILIATE_ID!&checkin=!START_DATE!&checkout=!END_DATE!","products":[{"id":"1000420_358188572_2_0_0","bundle":null,"deal":null,"inventory":{"third_party":false,"type":"sell"},"maximum_occupancy":{"adults":2,"children":null,"total":2},"number_available":3,"policies":{"cancellation":{"free_cancellation_until":"!START_DATE-2!T00:00:00+00:00","type":"free_cancellation","schedule":[{"from":"now","price":{"accommodation_currency":0,"booker_currency":0}},{"from":"!START_DATE-2!T00:00:00+00:00","price":{"accommodation_currency":1189.2,"booker_currency":1189.2}}]},"meal_plan":{"meals":[],"plan":"no_plan"},"payment":{"timings":["pay_at_the_property"]}},"price":{"base":{"accommodation_currency":1189.2,"booker_currency":1189.2},"chargeable_online":{"accommodation_currency":1302.7,"booker_currency":1302.7},"charges":[{"charge":21,"condition":null,"included_in":{"display":true,"chargeable_online":true},"mode":"percentage","percentage":9,"total_amount":{"accommodation_currency":107.07,"booker_currency":107.07},"unit_amount":null},{"charge":22,"condition":null,"included_in":{"display":true,"chargeable_online":false},"mode":"percentage","percentage":7,"total_amount":{"accommodation_currency":83.27,"booker_currency":83.27},"unit_amount":null},{"charge":142,"condition":null,"included_in":{"display":true,"chargeable_online":true},"mode":"per_person_per_night","percentage":null,"total_amount":{"accommodation_currency":6,"booker_currency":6},"unit_amount":{"accommodation_currency":3,"booker_currency":3}}],"display":{"accommodation_currency":1385.97,"booker_currency":1385.97},"total":{"accommodation_currency":1385.97,"booker_currency":1385.97}},"room":"1000420"},"..."],"recommendation":{"price":{"base":{"accommodation_currency":1081.49,"booker_currency":1081.49},"chargeable_online":{"accommodation_currency":1260.52,"booker_currency":1260.52},"charges":[{"charge":21,"total_amount":{"accommodation_currency":97.34,"booker_currency":97.34},"condition":null,"included_in":{"display":true,"chargeable_online":true}},{"charge":22,"total_amount":{"accommodation_currency":75.7,"booker_currency":75.7},"condition":null,"included_in":{"display":true,"chargeable_online":true}},{"charge":142,"total_amount":{"accommodation_currency":6,"booker_currency":6},"condition":null,"included_in":{"display":true,"chargeable_online":true}}],"display":{"accommodation_currency":1260.52,"booker_currency":1260.52},"total":{"accommodation_currency":1260.52,"booker_currency":1260.52}},"products":[{"id":"1000420_95127794_2_0_0","children":[],"number_of_adults":2,"price":{"base":{"accommodation_currency":1081.49,"booker_currency":1081.49},"chargeable_online":{"accommodation_currency":1260.52,"booker_currency":1260.52},"charges":[{"charge":21,"total_amount":{"accommodation_currency":97.34,"booker_currency":97.34},"condition":null,"included_in":{"display":true,"chargeable_online":true}},{"charge":22,"total_amount":{"accommodation_currency":75.7,"booker_currency":75.7},"condition":null,"included_in":{"display":true,"chargeable_online":true}},{"charge":142,"total_amount":{"accommodation_currency":6,"booker_currency":6},"condition":null,"included_in":{"display":true,"chargeable_online":true}}],"display":{"accommodation_currency":1260.52,"booker_currency":1260.52},"total":{"accommodation_currency":1260.52,"booker_currency":1260.52}}}]},"url":"https://www.booking.com/hotel/nl/toren.html?aid=!AFFILIATE_ID!&checkin=!START_DATE!&checkout=!END_DATE!&no_rooms=1&group_adults=2"}]},"id":"paths/~1accommodations~1availability/post/responses/200/content/application~1json/example"},"paths/~1accommodations~1chains/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":3,"brands":[{"id":1018,"name":"Campanile"},"..."],"name":"Louvre Hotels Group"},"..."]},"id":"paths/~1accommodations~1chains/post/responses/200/content/application~1json/example"},"paths/~1accommodations~1constants/post/requestBody/content/application~1json/example":{"value":{"languages":["en-gb","zh-cn"]},"id":"paths/~1accommodations~1constants/post/requestBody/content/application~1json/example"},"paths/~1accommodations~1constants/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":{"accommodation_facilities":[{"id":2,"facility_type":16,"name":{"en-gb":"Parking","zh-cn":"停车场"}},"..."],"accommodation_themes":[{"id":1,"name":{"en-gb":"Apartments","zh-cn":"公寓"}},"..."],"accommodation_types":[{"id":201,"name":{"en-gb":"Apartment","zh-cn":"公寓"}},"..."],"bed_types":[{"id":1,"description":{"en-gb":"90-130 cm wide","zh-cn":"宽 90-130 厘米"},"description_imperial":{"en-gb":"35-51 inches wide","zh-cn":"宽 35-51 英寸"},"name":{"en-gb":"Single bed(s)","zh-cn":"单人床"}},"..."],"charge_types":[{"id":0,"name":{"en-gb":"service charge","zh-cn":"服务费"}},"..."],"facility_types":[{"id":1,"name":{"en-gb":"General","zh-cn":"综合设施"}},"..."],"review_scores":[{"maximum_score":2.9,"minimum_score":2,"name":{"en-gb":"very poor","zh-cn":"非常差"}},"..."],"room_facilities":[{"id":1,"facility_type":7,"name":{"en-gb":"Coffee/Tea maker","zh-cn":"沏茶/咖啡设备"}},"..."],"room_types":[{"id":1,"name":{"en-gb":"Apartment","zh-cn":"公寓"}},"..."]}},"id":"paths/~1accommodations~1constants/post/responses/200/content/application~1json/example"},"paths/~1accommodations~1details/post/requestBody/content/application~1json/example":{"value":{"accommodations":[10004],"extras":["bundles","description","facilities","payment","photos","policies","rooms"],"languages":["en-gb","zh-cn"]},"id":"paths/~1accommodations~1details/post/requestBody/content/application~1json/example"},"paths/~1accommodations~1details/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":10004,"accommodation_status":"open","accommodation_type":204,"brands":[],"bundles":[{"id":12345,"value_adds":[{"type":"high_speed_internet","description":{"en-gb":["High speed internet throughout your stay."]}}]}],"checkin_checkout_times":{"checkin_from":"15:00:00","checkin_to":null,"checkout_from":"07:00:00","checkout_to":"12:00:00"},"currency":"EUR","description":{"important_information":{"en-gb":"The credit card that has been used to book a non-refundable rate, will be charged on the day of booking and needs to be presented upon check-in. In case the credit card owner is not traveling with you, an online payment link will be sent to prepay your stay.\n\nPlease note that the hotel pre-authorizes your credit card with the amount for the first night, 8 days prior to arrival. This is not a payment and this only applies to flexible rates.\n\nParking in Amsterdam is challenging, there are parking garages near to the hotel or a valet service is possible to arrange upon request. Charges are applicable. Please contact the hotel ahead of time for information","zh-cn":"酒店将在预订当天收取用于支付不退款房价的信用卡，客人需在办理入住手续时出示该信用卡。如果信用卡持有人未与客人同行，酒店将发送在线付款链接以预付客人的住宿费用。\n\n请注意，酒店将在客人抵达前8天通过其信用卡预授权第一晚的房费。这不是付款，这仅适用于变化的利率。\n\n在阿姆斯特丹（Amsterdam）停车很有挑战性，酒店附近有停车库，或者可应要求为客人安排代客泊车服务，收费适用。请提前联系酒店以获取信息。"},"license_numbers":[],"text":{"en-gb":"The Pavilions Amsterdam, The Toren features elegant accommodation alongside the famous Keizersgracht canal, around the corner from the Anne Frank House. It offers elegant rooms with flat-screen TVs with digital entertainment system.\n\nEach air-conditioned room at the Toren has an en suite bathroom with a bathtub. They have classic decorations such as chandeliers and ceiling paintings. Tea/coffee making facilities and a complimentary mini bar are also provided in every room.\n\nIn the morning, guests can enjoy a delightful breakfast buffet in the elegant breakfast room with views of the Keizersgracht. The trendy hotel bar serves refreshing drinks during the day.\n\nWestermarkt Tram Stop is less than 250 metres from the hotel. Dam Square and the Royal Palace are a 10-minute walk away.","zh-cn":"The Pavilions Amsterdam, The Toren酒店位于安妮弗兰克之家（Anne Frank House）拐角处，毗邻著名的Keizersgracht运河，提供典雅的住宿。酒店提供带平板电视和数字娱乐系统的典雅客房。\n\nToren酒店的每间空调客房均配有带浴缸的独立浴室。客房拥有典雅的装饰，如吊灯和天花板画。每间客房还提供沏茶/咖啡设施和免费迷你吧。\n\n早晨，客人可在典雅的早餐室享用可口的自助早餐，并欣赏Keizersgracht的景色。时髦的酒店酒吧白天提供清凉饮料。\n\n酒店距离韦斯特马克特电车站（Westermarkt Tram Stop）不到250米，距离水坝广场（Dam Square）和皇宫（Royal Palace）有10分钟的步行路程。"},"trader":{"address":{"address_line":"Prinsengract 153","city":"Amsterdam","country":"nl","post_code":"94571"},"email":"test@test.test","name":"Test Test","registration_number":"123456788","telephone":"+123456789","trade_register":"hjdfvhfjd","trader_verified":true}},"facilities":[{"id":5,"attributes":[]},"..."],"is_genius":true,"location":{"address":{"en-us":"Keizersgracht 164"},"city":-2140479,"coordinates":{"latitude":52.375858,"longitude":4.886006},"country":"nl","districts":[145,3024,9173],"postal_code":"1015 CZ","regions":[1010,2776]},"long_stay_friendly":false,"meal_prices":{"breakfast":20,"dinner":null,"lunch":null},"name":{"en-us":"The Pavilions Amsterdam, The Toren"},"number_of_rooms":11,"payment":{"amex_cvc_required":false,"cvc_required":true,"domestic_no_cc":false,"methods":{"cash":true,"cards":[1,2,3],"virtual_cards":[1,2,3]},"timings":["pay_at_the_property"]},"photos":[{"main_photo":true,"tags":["Neighbourhood"],"url":{"large":"https://q-xx.bstatic.com/xdata/images/hotel/max1280/243931754.jpg?k=a1fea83a088f20b8f8a0e68ac06cb0090a093808f6e2a129bfb990165a0009f3&o=","standard":"https://q-xx.bstatic.com/xdata/images/hotel/max500/243931754.jpg?k=a1fea83a088f20b8f8a0e68ac06cb0090a093808f6e2a129bfb990165a0009f3&o=","thumbnail":"https://q-xx.bstatic.com/xdata/images/hotel/100x100/243931754.jpg?k=a1fea83a088f20b8f8a0e68ac06cb0090a093808f6e2a129bfb990165a0009f3&o=","thumbnail_large":"https://q-xx.bstatic.com/xdata/images/hotel/300x300/243931754.jpg?k=a1fea83a088f20b8f8a0e68ac06cb0090a093808f6e2a129bfb990165a0009f3&o="}},"..."],"policies":{"cots_and_extra_beds":[{"age":{"from":0,"to":2},"mode":"per_night","price":0,"type":"crib"}],"damage":{"amount":50,"currency":"EUR","deposit":{"collect":{"date":{"days_offset":0,"reference_date":"checkin"},"payment_method":"credit_card"},"refund":{"date":{"days_offset":0,"reference_date":"checkout"},"payment_method":"credit_card"}}},"maximum_checkin_age":null,"minimum_checkin_age":18,"minimum_guest_age":0,"pets":{"allowed":"no","charge_mode":null}},"price_category":"$$$$","programmes":{"travel_proud":false,"sustainable_offerings":{"certifications":[{"name":"Green Key"}]}},"ranking":123456,"rating":{"number_of_reviews":930,"preferred":true,"review_score":9,"stars":4,"stars_type":"official"},"rooms":[{"id":"1000420","attributes":["non_smoking"],"bed_options":[{"bed_configurations":[{"id":"1000420-1","configuration":[{"bed_type":6,"number_of_beds":1}]},{"id":"1000420-2","configuration":[{"bed_type":1,"number_of_beds":2}]}],"has_bathroom":true,"is_bedroom":true}],"cots_and_extra_beds":{"are_allowed_together":false,"maximum_number_of_cots":0,"maximum_number_of_extra_beds":0},"description":{"en-gb":"This room features decor with rich colours and original features. It is located in the annex building, 8 houses away from the main building. It is internally positioned, overlooking a small courtyard."},"facilities":[1,"..."],"maximum_occupancy":{"adults":2,"children":1},"name":{"en-gb":"Standard Double or Twin Room","zh-cn":"标准双人或双床间 "},"number_of_rooms":{"bathrooms":1,"bedrooms":1,"living_rooms":0},"photos":[{"tags":["Neighbourhood"],"url":{"large":"https://q-xx.bstatic.com/xdata/images/hotel/max1280/243931754.jpg?k=a1fea83a088f20b8f8a0e68ac06cb0090a093808f6e2a129bfb990165a0009f3&o=","standard":"https://q-xx.bstatic.com/xdata/images/hotel/max500/243931754.jpg?k=a1fea83a088f20b8f8a0e68ac06cb0090a093808f6e2a129bfb990165a0009f3&o=","thumbnail":"https://q-xx.bstatic.com/xdata/images/hotel/100x100/243931754.jpg?k=a1fea83a088f20b8f8a0e68ac06cb0090a093808f6e2a129bfb990165a0009f3&o=","thumbnail_large":"https://q-xx.bstatic.com/xdata/images/hotel/300x300/243931754.jpg?k=a1fea83a088f20b8f8a0e68ac06cb0090a093808f6e2a129bfb990165a0009f3&o="}},"..."],"room_type":9,"size":18},"..."],"spoken_languages":["de","en-gb","fr","nl"],"themes":[6,"..."],"url":{"web":"https://www.booking.com/hotel/nl/toren.html?affiliate_id=!AFFILIATE_ID!","app":"booking://hotel/10004?affiliate_id=!AFFILIATE_ID!"},"work_friendly":false}],"metadata":{"next_page":null}},"id":"paths/~1accommodations~1details/post/responses/200/content/application~1json/example"},"paths/~1accommodations~1details~1changes/post/requestBody/content/application~1json/example":{"value":{"last_change":"!START_DATE!T12:00:00+00:00","filters":{"countries":["nl","es","in"]}},"id":"paths/~1accommodations~1details~1changes/post/requestBody/content/application~1json/example"},"paths/~1accommodations~1details~1changes/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":{"changes":{"changed":[100,101,102],"closed":{"fraud":[],"permanently":[107,108],"temporarily":[105]},"opened":[111,112]},"from":"!START_DATE!T12:00:00+00:00","next":"!START_DATE!T12:24:42+00:00","total_changes":8}},"id":"paths/~1accommodations~1details~1changes/post/responses/200/content/application~1json/example"},"paths/~1accommodations~1reviews/post/requestBody/content/application~1json/example":{"value":{"accommodations":[10004],"languages":["en-gb"]},"id":"paths/~1accommodations~1reviews/post/requestBody/content/application~1json/example"},"paths/~1accommodations~1reviews/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":10004,"reviews":[{"id":2130645894,"date":"2023-04-12","language":"en-gb","negative":"front entrance is not clean (\nbreakfast was served not like a buffet, every time you have to ask a waiter to bring additional food.","positive":"beautiful hôtel in the central area","reviewer":{"country":"ch","name":"Svetlana","travel_purpose":"leisure","type":"couple"},"score":9,"summary":"Fantastic hotel with kind personal who are providing hospitality and excellent service.","text_meets_guidelines":true},"..."],"url":"https://www.booking.com/hotel/nl/toren.html?aid=!AFFILIATE_ID!#tab-reviews"}],"metadata":{"next_page":"..."}},"id":"paths/~1accommodations~1reviews/post/responses/200/content/application~1json/example"},"paths/~1accommodations~1reviews~1scores/post/requestBody/content/application~1json/example":{"value":{"accommodations":[10004],"languages":["en-gb"]},"id":"paths/~1accommodations~1reviews~1scores/post/requestBody/content/application~1json/example"},"paths/~1accommodations~1reviews~1scores/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":10004,"breakdown":{"cleanliness":{"number_of_reviews":243,"score":9.27},"comfort":{"number_of_reviews":242,"score":9.26},"facilities":{"number_of_reviews":242,"score":8.84},"free_wifi":{"number_of_reviews":24,"score":8.75},"location":{"number_of_reviews":242,"score":9.59},"staff":{"number_of_reviews":243,"score":9.63},"value_for_money":{"number_of_reviews":243,"score":8.25}},"distribution":{"1":{"number_of_reviews":1,"percentage":0.41},"2":{"number_of_reviews":0,"percentage":0},"3":{"number_of_reviews":2,"percentage":0.82},"4":{"number_of_reviews":2,"percentage":0.82},"5":{"number_of_reviews":5,"percentage":2.06},"6":{"number_of_reviews":3,"percentage":1.23},"7":{"number_of_reviews":18,"percentage":7.41},"8":{"number_of_reviews":41,"percentage":16.87},"9":{"number_of_reviews":67,"percentage":27.57},"10":{"number_of_reviews":104,"percentage":42.8}},"number_of_reviews":243,"score":8.9,"url":"https://www.booking.com/hotel/nl/toren.html?aid=!AFFILIATE_ID!#tab-reviews"}]},"id":"paths/~1accommodations~1reviews~1scores/post/responses/200/content/application~1json/example"},"paths/~1accommodations~1third-party-suppliers/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":101,"name":"Example Supplier","company_address":"123 Example Street, 1000 Amsterdam, Netherlands"},{"id":102,"name":"Another Supplier","company_address":null}]},"id":"paths/~1accommodations~1third-party-suppliers/post/responses/200/content/application~1json/example"},"paths/~1accommodations~1third-party-suppliers/post/responses/500/content/application~1json/examples/internal_error":{"value":{"request_id":"01kjan66dedrpbwv4m1966dzw3","errors":[{"id":"500","message":"Internal server error. Try again later or contact support."}]},"key":"internal_error","summary":"Generic server error","id":"paths/~1accommodations~1third-party-suppliers/post/responses/500/content/application~1json/examples/internal_error"},"paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByAirport":{"value":{"booker":{"country":"nl"},"currency":"EUR","driver":{"age":36},"filters":{"transmission_type":"automatic","mileage_type":"limited","depot_location_type":"in_terminal","fuel_types":["hybrid","petrol_or_diesel"],"price":{"minimum":125.2,"maximum":300},"rating":{"minimum_review_score":8}},"route":{"pickup":{"datetime":"2026-11-05T11:05:00","location":{"airport":"AMS"}},"dropoff":{"datetime":"2026-11-10T11:05:00","location":{"airport":"AMS"}}}},"key":"searchByAirport","summary":"Search example by airport.","id":"paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByAirport"},"paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByCoordinatesWithResponseLimit":{"value":{"booker":{"country":"nl"},"currency":"EUR","driver":{"age":36},"maximum_results":10,"filters":{"transmission_type":"automatic","mileage_type":"limited","depot_location_type":"in_terminal","fuel_types":["hybrid","petrol_or_diesel"],"price":{"minimum":125.2,"maximum":300},"rating":{"minimum_review_score":8}},"route":{"pickup":{"datetime":"2026-11-05T11:05:00","location":{"coordinates":{"latitude":52.309456,"longitude":4.762266}}},"dropoff":{"datetime":"2026-11-10T11:05:00","location":{"coordinates":{"latitude":52.309456,"longitude":4.762266}}}}},"key":"searchByCoordinatesWithResponseLimit","summary":"Search example by coordinates and max response limit up to 10 products.","id":"paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByCoordinatesWithResponseLimit"},"paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByPaymentInput":{"value":{"booker":{"country":"nl"},"currency":"EUR","driver":{"age":36},"payment":{"timings":["pay_online_now"]},"route":{"pickup":{"datetime":"2026-11-05T11:05:00","location":{"city":-2140479}},"dropoff":{"datetime":"2026-11-10T11:05:00","location":{"city":-2140479}}}},"key":"searchByPaymentInput","summary":"Search example by payment timing.","id":"paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByPaymentInput"},"paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByCityIdWithSorting":{"value":{"booker":{"country":"nl"},"currency":"EUR","driver":{"age":36},"filters":{"transmission_type":"automatic","mileage_type":"limited","depot_location_type":"in_terminal","fuel_types":["hybrid","petrol_or_diesel"],"price":{"minimum":125.2,"maximum":300},"rating":{"minimum_review_score":8}},"route":{"pickup":{"datetime":"2026-11-05T11:05:00","location":{"city":-2140479}},"dropoff":{"datetime":"2026-11-10T11:05:00","location":{"city":-2140479}}},"sort":{"by":"price"}},"key":"searchByCityIdWithSorting","summary":"Search example by city id and sorting by price.","id":"paths/~1cars~1search/post/requestBody/content/application~1json/examples/searchByCityIdWithSorting"},"paths/~1cars~1search/post/responses/200/content/application~1json/example":{"value":{"request_id":"01h00fr9y7qkbxtc6kyv97j49z","data":[{"car":122655,"offer":803765581,"categories":["large","suvs"],"policies":{"cancellation":{"type":"free_cancellation","details":{"context":"before_pickup","duration":"P7D"}},"damage_excess":{"amount":3000,"currency":"EUR"},"deposit":{"amount":1500,"currency":"EUR"},"insurance_package":"basic","fuel":"return_same","mileage":{"amount":12.54,"currency":"EUR","distance_limit":200,"distance_unit":"kilometers","type":"limited"},"payment":{"timing":"pay_online_now"},"theft_excess":{"amount":3000,"currency":"EUR"}},"price":{"total":121.9,"currency":"EUR","credit_card_required":false,"extra_charges":[{"charge":"aged_driver_fee","total_amount":21.9},{"charge":"one_way_fee","total_amount":50}]},"route":{"pickup":{"depot":112314,"depot_location_type":"in_terminal"},"dropoff":{"depot":112314,"depot_location_type":"in_terminal"}},"insurance":{"name":"Full Protection","id":"999","price":{"amount":144.7,"currency":"EUR"}},"special_offer":"upgrade","supplier":7455,"url":{"app":"booking://page","web":"https://example.com"},"estimated_commission":{"amount":12.5,"currency":"GBP"}}],"metadata":{"next_page":"eyJhbGciOiJIUzI1NiJ9.eyJwIjp7Im1heGltdW1fcmVzdWx0cyI6MTAsIm9mZnNldCI6MTB9LCJhdWQiOiJDQVJTX1NVUFBMSUVSUyIsImV4cCI6MTY4MzY0NzMwNX0.y7NmH48mm7lImd2WxsHdotj6n-dVQAzJCGCnIJCKy3A","total_results":122},"search_token":"eyJhbGciOiJIUzI1NiJ9.eyJwIjp7ImJvb2tlciI6eyJjb3VudHJ5IjoidXMifX0sImF1ZCI6Ii9ob3RlbHMvc2VhcmNoIiwiZXhwIjoxNzUwMDAwMDAwfQ.XYZ123AbcDefGHIjklMNOpqrsTUVwxYZ456789"},"id":"paths/~1cars~1search/post/responses/200/content/application~1json/example"},"paths/~1cars~1search/post/responses/400/content/application~1json/examples/missing_parameter":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"missing_parameter","message":"Parameter 'booker' is missing."}]},"key":"missing_parameter","summary":"Missing parameter","id":"paths/~1cars~1search/post/responses/400/content/application~1json/examples/missing_parameter"},"paths/~1cars~1search/post/responses/400/content/application~1json/examples/invalid_parameter":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_parameter","message":"Parameter 'pickup.datetime' is invalid. 'pickup.datetime' should not be in past."}]},"key":"invalid_parameter","summary":"Malformed request","id":"paths/~1cars~1search/post/responses/400/content/application~1json/examples/invalid_parameter"},"paths/~1cars~1search/post/responses/500/content/application~1json/examples/internal_error":{"value":{"request_id":"01kjan66dedrpbwv4m1966dzw3","errors":[{"id":"500","message":"Internal server error. Try again later or contact support."}]},"key":"internal_error","summary":"Generic server error","id":"paths/~1cars~1search/post/responses/500/content/application~1json/examples/internal_error"},"paths/~1cars~1constants/post/requestBody/content/application~1json/examples/allConstants":{"value":{"languages":["de","en-gb"]},"key":"allConstants","summary":"Example request for all constants","id":"paths/~1cars~1constants/post/requestBody/content/application~1json/examples/allConstants"},"paths/~1cars~1constants/post/requestBody/content/application~1json/examples/specificConstants":{"value":{"constants":["customer_services","fuel_policies"],"languages":["en-gb","fr","de"]},"key":"specificConstants","summary":"Example request for specific constants","id":"paths/~1cars~1constants/post/requestBody/content/application~1json/examples/specificConstants"},"paths/~1cars~1constants/post/responses/200/content/application~1json/example":{"value":{"request_id":"01jpvx9va93ghgwxq7zypagvdr","data":{"car_categories":[{"id":"carriers","name":{"de":"Großraumfahrzeug","en-gb":"People carrier"}},{"id":"compact_suv","name":{"de":"Kompaktklasse-SUV","en-gb":"Compact SUV"}},{"id":"convertible","name":{"de":"Cabrio","en-gb":"Convertible"}},{"id":"estate","name":{"de":"Kombi","en-gb":"Estate"}},{"id":"large","name":{"de":"Groß","en-gb":"Large"}},{"id":"large_suv","name":{"de":"Großer SUV","en-gb":"Full-size SUV"}},{"id":"medium","name":{"de":"Mittelklasse","en-gb":"Medium"}},{"id":"midsize_suv","name":{"de":"Mittelgroßer SUV","en-gb":"Midsize SUV"}},{"id":"pickup","name":{"de":"Pickup","en-gb":"Pickup"}},{"id":"premium","name":{"de":"Premium","en-gb":"Premium"}},{"id":"small","name":{"de":"Klein","en-gb":"Small"}},{"id":"suvs","name":{"de":"SUV","en-gb":"SUV"}}],"customer_services":[{"id":"email","name":{"de":"customer.service-de@cars.booking.com","en-gb":"customer.service@cars.booking.com"}}],"depot_services":[{"id":"meet_greet","name":{"de":"Meet & Greet","en-gb":"Meet & Greet"}},{"id":"shuttle","name":{"de":"Shuttlebus","en-gb":"Shuttle Bus"}}],"depot_types":[{"id":"airport_hotel","name":{"de":"Airport-Hotel","en-gb":"Airport hotel"}},{"id":"car_rental_centre","name":{"de":"Mietwagenstation","en-gb":"Car rental centre"}},{"id":"downtown","name":{"de":"Innenstadt","en-gb":"Downtown"}},{"id":"in_terminal","name":{"de":"Im Terminal","en-gb":"In terminal"}},{"id":"meet_greet","name":{"de":"Meet & Greet","en-gb":"Meet & Greet"}},{"id":"outside_terminal","name":{"de":"Außerhalb des Terminals","en-gb":"Outside of terminal"}},{"id":"shuttle_bus","name":{"de":"Shuttlebus","en-gb":"Shuttle bus"}},{"id":"trainstation","name":{"de":"Bahnhof","en-gb":"Train station"}}],"extras":[{"id":"additional_driver","name":{"de":"Zusätzlicher Fahrer","en-gb":"Additional driver"}},{"id":"baby_seat","name":{"de":"Babyschale","en-gb":"Baby seat"}},{"id":"bluetooth_handsfree_kit","name":{"de":"Bluetooth-Freisprecheinrichtung","en-gb":"Bluetooth hands-free kit"}},{"id":"booster_seat","name":{"de":"Kindersitzerhöhung","en-gb":"Child booster seat"}},{"id":"child_booster_seat","name":{"de":"Kindersitzerhöhung","en-gb":"Child booster seat"}},{"id":"child_seat","name":{"de":"Kindersitz","en-gb":"Child seat"}},{"id":"child_seat_isofix","name":{"de":"ISOFIX","en-gb":"ISOFIX"}},{"id":"etc_card_electronic_toll_collection_card","name":{"de":"ETC","en-gb":"ETC"}},{"id":"excess_protection","name":{"de":"Geringere Selbstbeteiligung","en-gb":"Reduced excess"}},{"id":"fast_track","name":{"de":"Express-Zugang","en-gb":"Queue jump"}},{"id":"gps","name":{"de":"Navi","en-gb":"GPS"}},{"id":"infant_seat","name":{"de":"Babyschale","en-gb":"Baby seat"}},{"id":"luggage_rack","name":{"de":"Gepäckträger","en-gb":"Luggage rack"}},{"id":"personal_travel_assistant","name":{"de":"Persönlicher Reiseassistent","en-gb":"Personal travel assistant"}},{"id":"queue_jump","name":{"de":"Express-Zugang","en-gb":"Queue jump"}},{"id":"roof_rack","name":{"de":"Dachgepäckträger","en-gb":"Roof rack"}},{"id":"ski_box","name":{"de":"Skibox","en-gb":"Ski box"}},{"id":"ski_rack","name":{"de":"Skiträger","en-gb":"Ski rack"}},{"id":"skierized_equipment","name":{"de":"Winterausstattung","en-gb":"Winter sports equipment"}},{"id":"snow_chains","name":{"de":"Schneeketten","en-gb":"Snow chains"}},{"id":"snow_tyres","name":{"de":"Winterreifen","en-gb":"Snow tyres"}},{"id":"wifi_mobile","name":{"de":"WLAN-Router","en-gb":"Wifi router"}},{"id":"wifi_router","name":{"de":"WLAN-Router","en-gb":"Wifi router"}}],"special_offers":[{"id":"one_additional_driver","name":{"de":"1 zusätzlicher Fahrer inbegriffen","en-gb":"1 additional driver included"}},{"id":"two_additional_drivers","name":{"de":"2 zusätzliche Fahrer inbegriffen","en-gb":"2 additional drivers included"}},{"id":"three_additional_drivers","name":{"de":"3 zusätzliche Fahrer inbegriffen","en-gb":"3 additional drivers included"}},{"id":"all_additional_drivers","name":{"de":"Alle zusätzlichen Fahrer inbegriffen","en-gb":"All additional drivers included"}},{"id":"gps","name":{"de":"Navi inbegriffen","en-gb":"GPS included"}},{"id":"baby_or_child_seat","name":{"de":"Babyschale / Kindersitz inbegriffen","en-gb":"Baby/child seat included"}},{"id":"priority_pickup","name":{"de":"Priority-Abholung inbegriffen","en-gb":"Priority pick-up included"}},{"id":"wifi_device","name":{"de":"WLAN inbegriffen","en-gb":"Wifi included"}},{"id":"sim_card","name":{"de":"SIM-Karte inbegriffen","en-gb":"SIM card included"}},{"id":"upgrade","name":{"de":"Upgrade auf die nächste Fahrzeuggruppe inbegriffen","en-gb":"Upgrade to the next car group included"}},{"id":"black_friday","name":{"de":"Black Friday","en-gb":"Black Friday"}},{"id":"getaway_deal","name":{"de":"Kurztrip-Angebot","en-gb":"Getaway deal"}},{"id":"mobile_rate","name":{"de":"Handypreis","en-gb":"Mobile rate"}}],"fuel_policies":[{"id":"free_tank","name":{"de":"Kostenlose Tankfüllung","en-gb":"Free tank"}},{"id":"prepay_no_refunds","name":{"de":"Vorab-Einkauf","en-gb":"Pre-purchase (non-refundable)"}},{"id":"prepay_part_refunds","name":{"de":"Vorab-Einkauf (Teilerstattung)","en-gb":"Pre-purchase (partial refund)"}},{"id":"prepay_refunds","name":{"de":"Vorab-Einkauf","en-gb":"Pre-purchase (refundable)"}},{"id":"return_same","name":{"de":"Gleiche Tankfüllung","en-gb":"Like for like"}},{"id":"return_same_or_prepay_no_refunds","name":{"de":"Gleiche Tankfüllung","en-gb":"Like for like"}},{"id":"return_same_preauth","name":{"de":"Gleiche Tankfüllung (Vorabbuchung)","en-gb":"Like for like (pre-authorisation)"}},{"id":"unlimited","name":{"de":"Unbegrenzte Kilometer","en-gb":"Unlimited mileage"}}],"fuel_types":[{"id":"diesel","name":{"de":"Diesel","en-gb":"Diesel"}},{"id":"electric","name":{"de":"Rein elektrisch","en-gb":"Fully electric"}},{"id":"ethanol","name":{"de":"Ethanol","en-gb":"Ethanol"}},{"id":"hybrid","name":{"de":"Hybrid","en-gb":"Hybrid"}},{"id":"hydrogen","name":{"de":"Wasserstoff","en-gb":"Hydrogen"}},{"id":"lpg","name":{"de":"Autogas","en-gb":"LPG"}},{"id":"multi_fuel","name":{"de":"Mehrstoff","en-gb":"Multi Fuel"}},{"id":"petrol","name":{"de":"Benzin","en-gb":"Petrol"}},{"id":"plug_in_hybrid","name":{"de":"Plug-in-Hybrid","en-gb":"Plug-in hybrid"}},{"id":"unspecified","name":{"de":"Nicht angegeben","en-gb":"Unspecified"}}],"general":[{"id":"airport","name":{"de":"Flughafen (im Terminal)","en-gb":"Airport (in terminal)"}},{"id":"air_conditioning","name":{"de":"Klimaanlage","en-gb":"Air Conditioning"}},{"id":"before_pickup","name":{"de":"Kostenlose Stornierung vor der Abholung","en-gb":"Free cancellation before pick-up"}},{"id":"each_per_rental","name":{"de":"Jeder pro Miete","en-gb":"Each per rental"}},{"id":"free_cancellation","name":{"de":"Kostenlose Stornierung","en-gb":"Free cancellation"}},{"id":"kilometers","name":{"de":"km","en-gb":"km"}},{"id":"limited","name":{"de":"Begrenzt","en-gb":"Limited"}},{"id":"miles","name":{"de":"Meilen","en-gb":"miles"}},{"id":"n_large_bag","name":{"de":"N großer Koffer","en-gb":"N Large bag"}},{"id":"n_large_bags","name":{"de":"N große Koffer","en-gb":"N Large bags"}},{"id":"n_small_bag","name":{"de":"N kleiner Koffer","en-gb":"N Small bag"}},{"id":"n_small_bags","name":{"de":"N kleine Koffer","en-gb":"N Small bags"}},{"id":"per_rental","name":{"de":"Pro Miete","en-gb":"Per rental"}}],"payment_timings":[{"id":"pay_partial_online_now","name":{"de":"Teils jetzt zahlen, teils später","en-gb":"Pay part now, part later"}},{"id":"pay_online_now","name":{"de":"Jetzt zahlbar","en-gb":"Pay now"}},{"id":"pay_at_pickup","name":{"de":"Zahlbar bei der Abholung","en-gb":"Pay at pick-up"}}],"protection_levels":[{"id":"basic","name":{"de":"Basis","en-gb":"Basic"}},{"id":"zero_excess","name":{"de":"Kein Eigenanteil","en-gb":"Zero excess"}}],"review_scores":[{"id":"cleanliness","name":{"de":"Sauberkeit","en-gb":"Cleanliness"}},{"id":"condition","name":{"de":"Fahrzeugzustand","en-gb":"Car condition"}},{"id":"drop_off_speed","name":{"de":"Abgabegeschwindigkeit","en-gb":"Drop-off speed"}},{"id":"friendliness","name":{"de":"Hilfsbereitschaft","en-gb":"Helpfulness"}},{"id":"location","name":{"de":"Lage","en-gb":"Location"}},{"id":"pick_up_speed","name":{"de":"Abholgeschwindigkeit","en-gb":"Pick-up speed"}},{"id":"value_for_money","name":{"de":"Preis-Leistungs-Verhältnis","en-gb":"Value for money"}}],"transmission":[{"id":"automatic","name":{"de":"Automatik","en-gb":"Automatic"}},{"id":"manual","name":{"de":"Schaltgetriebe","en-gb":"Manual"}}]}},"id":"paths/~1cars~1constants/post/responses/200/content/application~1json/example"},"paths/~1cars~1constants/post/responses/400/content/application~1json/examples/invalid_parameter":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_parameter","message":"Parameter 'constants[0]' is invalid."}]},"key":"invalid_parameter","summary":"Malformed request","id":"paths/~1cars~1constants/post/responses/400/content/application~1json/examples/invalid_parameter"},"paths/~1cars~1constants/post/responses/500/content/application~1json/examples/internal_error":{"value":{"request_id":"01kjan66dedrpbwv4m1966dzw3","errors":[{"id":"500","message":"Internal server error. Try again later or contact support."}]},"key":"internal_error","summary":"Generic server error","id":"paths/~1cars~1constants/post/responses/500/content/application~1json/examples/internal_error"},"paths/~1cars~1depots/post/requestBody/content/application~1json/example":{"value":{"last_modified":"2026-03-01T11:05:00+00:00","maximum_results":100,"languages":["en-gb","nl"]},"id":"paths/~1cars~1depots/post/requestBody/content/application~1json/example"},"paths/~1cars~1depots/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":5944,"contact":{"email":"depot@test.booking.com","telephone":"+31882847620"},"city":-2140479,"pickup":{"instructions":{"en-gb":"Collect your vehicle at the rental counter in the arrivals hall.","nl":"Haal uw voertuig op bij de verhuurbalie in de aankomsthal."},"working_hours":{"monday":[{"closing_time":"21:00:00","opening_time":"07:00:00"}],"tuesday":[{"closing_time":"12:00:00","opening_time":"07:00:00"},{"closing_time":"21:00:00","opening_time":"14:00:00"}],"wednesday":[{"closing_time":"21:00:00","opening_time":"07:00:00"}],"thursday":[{"closing_time":"21:00:00","opening_time":"07:00:00"}],"friday":[{"closing_time":"21:00:00","opening_time":"07:00:00"}],"saturday":[{"closing_time":"21:00:00","opening_time":"07:00:00"}],"sunday":[{"closing_time":"21:00:00","opening_time":"07:00:00"}]}},"location":{"address":"5 Aankomstpassage","airport":"AMS","coordinates":{"latitude":52.309456,"longitude":4.762266},"country":"nl","depot_location_type":"airport_hotel","name":{"en-gb":"Amsterdam Airport Schiphol - Terminal 3","nl":"Amsterdam Luchthaven Schiphol - Terminal 3"},"post_code":"1118 AX"},"dropoff":{"instructions":{"en-gb":"The procedure for returning the vehicle will be explained to you at the rental counter.","nl":"De procedure voor het inleveren van de auto zal worden toegelicht aan de balie."},"working_hours":{"monday":[{"closing_time":"21:00:00","opening_time":"07:00:00"}],"tuesday":[{"closing_time":"12:00:00","opening_time":"07:00:00"},{"closing_time":"21:00:00","opening_time":"14:00:00"}],"wednesday":[{"closing_time":"21:00:00","opening_time":"07:00:00"}],"thursday":[{"closing_time":"21:00:00","opening_time":"07:00:00"}],"friday":[{"closing_time":"21:00:00","opening_time":"07:00:00"}],"saturday":[{"closing_time":"21:00:00","opening_time":"07:00:00"}],"sunday":[{"closing_time":"21:00:00","opening_time":"07:00:00"}]}},"services":["shuttle"],"supplier":47,"ratings":{"number_of_reviews":120,"score":8.7}}],"metadata":{"next_page":null}},"id":"paths/~1cars~1depots/post/responses/200/content/application~1json/example"},"paths/~1cars~1depots/post/responses/400/content/application~1json/examples/invalid_parameter":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_parameter","message":"Parameter 'last_modified' is invalid. last_modified value must not be earlier than 7 days ago."}]},"key":"invalid_parameter","summary":"Malformed request","id":"paths/~1cars~1depots/post/responses/400/content/application~1json/examples/invalid_parameter"},"paths/~1cars~1depots/post/responses/500/content/application~1json/examples/internal_error":{"value":{"request_id":"01kjan66dedrpbwv4m1966dzw3","errors":[{"id":"500","message":"An unexpected error occurred while processing the request. Please try again later or contact support if the issue persists."}]},"key":"internal_error","summary":"Generic server error","id":"paths/~1cars~1depots/post/responses/500/content/application~1json/examples/internal_error"},"paths/~1cars~1depots~1reviews~1scores/post/requestBody/content/application~1json/example":{"value":{"maximum_results":10},"id":"paths/~1cars~1depots~1reviews~1scores/post/requestBody/content/application~1json/example"},"paths/~1cars~1depots~1reviews~1scores/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":5944,"breakdown":{"cleanliness":{"score":8.7},"condition":{"score":8.7},"drop_off_speed":{"score":8.7},"friendliness":{"score":null},"likeliness_rent_again":{"score":8.7},"location":{"score":8.7},"pick_up_speed":{"score":8.7},"value_for_money":{"score":8.7}},"number_of_reviews":105,"score":9.1}],"metadata":{"next_page":null}},"id":"paths/~1cars~1depots~1reviews~1scores/post/responses/200/content/application~1json/example"},"paths/~1cars~1depots~1reviews~1scores/post/responses/400/content/application~1json/examples/invalid_parameter":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_parameter","message":"Parameter 'maximum_results' is invalid."}]},"key":"invalid_parameter","summary":"Malformed request","id":"paths/~1cars~1depots~1reviews~1scores/post/responses/400/content/application~1json/examples/invalid_parameter"},"paths/~1cars~1depots~1reviews~1scores/post/responses/500/content/application~1json/examples/internal_error":{"value":{"request_id":"01kjan66dedrpbwv4m1966dzw3","errors":[{"id":"500","message":"Internal server error. Try again later or contact support."}]},"key":"internal_error","summary":"Generic server error","id":"paths/~1cars~1depots~1reviews~1scores/post/responses/500/content/application~1json/examples/internal_error"},"paths/~1cars~1details/post/requestBody/content/application~1json/example":{"value":{"last_modified":"2026-04-01T11:05:00+00:00","maximum_results":100},"id":"paths/~1cars~1details/post/requestBody/content/application~1json/example"},"paths/~1cars~1details/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":37715,"capacity":{"bags":{"large":1,"small":1},"doors":"4/2","seats":"4+2"},"country":"es","features":["air_conditioning","all_wheel_drive"],"image":"https://example.com/image.jpg","make":"Hyundai","model":"Elantra","specification":{"code":"ECAR","description":"economy","fuel":"petrol","transmission":"automatic"},"supplier":423}],"metadata":{"next_page":null}},"id":"paths/~1cars~1details/post/responses/200/content/application~1json/example"},"paths/~1cars~1details/post/responses/400/content/application~1json/examples/invalid_parameter":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_parameter","message":"Parameter 'last_modified' is invalid. last_modified value must not be earlier than 7 days ago."}]},"key":"invalid_parameter","summary":"Malformed request","id":"paths/~1cars~1details/post/responses/400/content/application~1json/examples/invalid_parameter"},"paths/~1cars~1details/post/responses/500/content/application~1json/examples/internal_error":{"value":{"request_id":"01kjan66dedrpbwv4m1966dzw3","errors":[{"id":"500","message":"Internal server error. Try again later or contact support."}]},"key":"internal_error","summary":"Generic server error","id":"paths/~1cars~1details/post/responses/500/content/application~1json/examples/internal_error"},"paths/~1cars~1suppliers/post/requestBody/content/application~1json/example":{"value":{"suppliers":[62]},"id":"paths/~1cars~1suppliers/post/requestBody/content/application~1json/example"},"paths/~1cars~1suppliers/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":62,"name":"Budget","logo":"https://example.com/path_to_the_logo.jpeg"}],"metadata":{"next_page":null,"total_results":1}},"id":"paths/~1cars~1suppliers/post/responses/200/content/application~1json/example"},"paths/~1cars~1suppliers/post/responses/400/content/application~1json/examples/invalid_parameter":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_parameter","message":"Parameter 'suppliers' is invalid."}]},"key":"invalid_parameter","summary":"Malformed request","id":"paths/~1cars~1suppliers/post/responses/400/content/application~1json/examples/invalid_parameter"},"paths/~1cars~1suppliers/post/responses/500/content/application~1json/examples/internal_error":{"value":{"request_id":"01kjan66dedrpbwv4m1966dzw3","errors":[{"id":"500","message":"Internal server error. Try again later or contact support."}]},"key":"internal_error","summary":"Generic server error","id":"paths/~1cars~1suppliers/post/responses/500/content/application~1json/examples/internal_error"},"paths/~1common~1locations~1airports/post/requestBody/content/application~1json/example":{"value":{"country":"nl","languages":["en-gb","zh-cn"]},"id":"paths/~1common~1locations~1airports/post/requestBody/content/application~1json/example"},"paths/~1common~1locations~1airports/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":"AMS","name":{"en-gb":"Schiphol Airport","zh-cn":"史基浦机场"}},"..."],"metadata":{"next_page":null}},"id":"paths/~1common~1locations~1airports/post/responses/200/content/application~1json/example"},"paths/~1common~1locations~1cities/post/requestBody/content/application~1json/example":{"value":{"country":"nl","languages":["en-gb","zh-cn"]},"id":"paths/~1common~1locations~1cities/post/requestBody/content/application~1json/example"},"paths/~1common~1locations~1cities/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":-2156821,"name":{"zh-cn":"兹沃勒"},"coordinates":{"latitude":52.378281,"longitude":4.90007}},"..."],"metadata":{"next_page":"..."}},"id":"paths/~1common~1locations~1cities/post/responses/200/content/application~1json/example"},"paths/~1common~1locations~1countries/post/requestBody/content/application~1json/example":{"value":{"languages":["en-gb","zh-cn"]},"id":"paths/~1common~1locations~1countries/post/requestBody/content/application~1json/example"},"paths/~1common~1locations~1countries/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":"ad","name":{"en-gb":"Andorra","zh-cn":"安道尔"}},"..."],"metadata":{"next_page":"..."}},"id":"paths/~1common~1locations~1countries/post/responses/200/content/application~1json/example"},"paths/~1common~1locations~1districts/post/requestBody/content/application~1json/example":{"value":{"city":-2140479,"languages":["en-gb","zh-cn"]},"id":"paths/~1common~1locations~1districts/post/requestBody/content/application~1json/example"},"paths/~1common~1locations~1districts/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":145,"name":{"en-gb":"Amsterdam City Centre","zh-cn":"阿姆斯特丹市中心"},"coordinates":{"latitude":52.378281,"longitude":4.90007}},"..."],"metadata":{"next_page":null}},"id":"paths/~1common~1locations~1districts/post/responses/200/content/application~1json/example"},"paths/~1common~1locations~1landmarks/post/requestBody/content/application~1json/example":{"value":{"city":-2140479,"languages":["en-gb","zh-cn"]},"id":"paths/~1common~1locations~1landmarks/post/requestBody/content/application~1json/example"},"paths/~1common~1locations~1landmarks/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":1,"coordinates":{"latitude":52.378281,"longitude":4.90007},"name":{"en-gb":"Amsterdam Central Station","zh-cn":"阿姆斯特丹中央车站"}},"..."],"metadata":{"next_page":"..."}},"id":"paths/~1common~1locations~1landmarks/post/responses/200/content/application~1json/example"},"paths/~1common~1locations~1regions/post/requestBody/content/application~1json/example":{"value":{"country":"nl","languages":["en-gb","zh-cn"]},"id":"paths/~1common~1locations~1regions/post/requestBody/content/application~1json/example"},"paths/~1common~1locations~1regions/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":1003,"name":{"en-gb":"Drenthe","zh-cn":"德伦特省"}},"..."],"metadata":{"next_page":null}},"id":"paths/~1common~1locations~1regions/post/responses/200/content/application~1json/example"},"paths/~1common~1payments~1cards/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":1,"name":"American Express"},"..."]},"id":"paths/~1common~1payments~1cards/post/responses/200/content/application~1json/example"},"paths/~1common~1payments~1currencies/post/requestBody/content/application~1json/example":{"value":{"languages":["en-gb","zh-cn"]},"id":"paths/~1common~1payments~1currencies/post/requestBody/content/application~1json/example"},"paths/~1common~1payments~1currencies/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":"AED","name":{"en-gb":"U.A.E. dirham","zh-cn":"阿联酋迪拉姆"}},"..."]},"id":"paths/~1common~1payments~1currencies/post/responses/200/content/application~1json/example"},"paths/~1common~1languages/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":"ar","name":"العربية"},"..."]},"id":"paths/~1common~1languages/post/responses/200/content/application~1json/example"},"paths/~1orders~1preview/post/requestBody/content/application~1json/examples/accommodation_example":{"value":{"currency":"EUR","accommodation":{"id":6745031,"booker":{"country":"nl","platform":"mobile","travel_purpose":"leisure","user_groups":["authenticated"]},"checkin":"!START_DATE!","checkout":"!END_DATE!","products":[{"id":"674503106_275710478_0_2_0","allocation":{"number_of_adults":1,"children":[8]}},{"id":"674503113_275710486_0_1_0","allocation":{"number_of_adults":1,"children":[]}}]}},"key":"accommodation_example","summary":"Preview input for accommodation","id":"paths/~1orders~1preview/post/requestBody/content/application~1json/examples/accommodation_example"},"paths/~1orders~1preview/post/requestBody/content/application~1json/examples/car_example":{"value":{"currency":"EUR","car":{"offer":123456789,"search_token":"eyJhbGciOiJIUzI1NiJ9.eyJwIjp7ImJvb2tlciI6eyJjb3VudHJ5IjoidXMifX0sImF1ZCI6Ii9ob3RlbHMvc2VhcmNoIiwiZXhwIjoxNzUwMDAwMDAwfQ.XYZ123AbcDefGHIjklMNOpqrsTUVwxYZ456789","products":[{"id":"001234567890","amount":1}],"insurance":{"quote_reference":"38ddeef-a7fb-4e24-a1e2-66fc3af23d76#1t0juiba8h6n2"}}},"key":"car_example","summary":"Preview input for car","id":"paths/~1orders~1preview/post/requestBody/content/application~1json/examples/car_example"},"paths/~1orders~1preview/post/responses/200/content/application~1json/examples/accommodation_example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":{"accommodation":{"id":6745031,"currency":{"accommodation":"EUR","booker":null},"general_policies":{"payment":{"pay_online_now":{"dates":[{"at":"!TODAY!","price":{"accommodation_currency":177.65,"booker_currency":null}}],"method_required":false,"methods":{"airplus":true,"cards":[1,2,3],"wallet":true}},"pay_online_later":{"dates":[{"at":"!TODAY!","price":{"accommodation_currency":0,"booker_currency":null}},{"at":"!START_DATE-2!","price":{"accommodation_currency":177.65,"booker_currency":null}},{"at":"!START_DATE!","price":{"accommodation_currency":0,"booker_currency":null}}],"method_required":false,"methods":{"airplus":true,"cards":[1,2,3,5],"wallet":true}},"pay_at_the_property":{"dates":[{"at":"!TODAY!","price":{"accommodation_currency":0,"booker_currency":null}},{"at":"!START_DATE!","price":{"accommodation_currency":177.65,"booker_currency":null}}],"method_required":true,"methods":{"airplus":true,"cards":[1,2],"wallet":false}}}},"price":{"base":{"accommodation_currency":100,"booker_currency":null},"chargeable_online":{"accommodation_currency":117.41,"booker_currency":null},"charges":[{"charge":142,"condition":null,"included_in":{"display":true,"chargeable_online":true},"total_amount":{"accommodation_currency":6,"booker_currency":null}},{"charge":21,"condition":null,"included_in":{"display":true,"chargeable_online":true},"total_amount":{"accommodation_currency":11.41,"booker_currency":null}},{"charge":22,"condition":null,"included_in":{"display":true,"chargeable_online":false},"total_amount":{"accommodation_currency":5.59,"booker_currency":null}}],"display":{"accommodation_currency":123,"booker_currency":null},"total":{"accommodation_currency":123,"booker_currency":null}},"products":[{"id":"1000420_278556531_2_0_0","bundle":null,"deal":null,"inventory":{"third_party":false,"type":"sell"},"policies":{"cancellation":[{"from":"now","price":{"accommodation_currency":0,"booker_currency":null}},{"from":"!START_DATE-2!T22:00:00+00:00","price":{"accommodation_currency":177.65,"booker_currency":null}}],"meal_plan":{"meals":[],"plan":"no_plan"}},"price":{"base":{"accommodation_currency":155.96,"booker_currency":null},"chargeable_online":{"accommodation_currency":172.88,"booker_currency":null},"charges":[{"charge":142,"condition":null,"included_in":{"display":true,"chargeable_online":true},"mode":"per_person_per_night","percentage":null,"total_amount":{"accommodation_currency":6,"booker_currency":null},"unit_amount":{"accommodation_currency":3,"booker_currency":null}},{"charge":21,"condition":null,"included_in":{"display":true,"chargeable_online":false},"mode":"percentage","percentage":9,"total_amount":{"accommodation_currency":14.04,"booker_currency":null},"unit_amount":null},{"charge":22,"condition":null,"included_in":{"display":true,"chargeable_online":true},"mode":"percentage","percentage":7,"total_amount":{"accommodation_currency":10.92,"booker_currency":null},"unit_amount":null}],"display":{"accommodation_currency":186.92,"booker_currency":null},"total":{"accommodation_currency":186.92,"booker_currency":null}}},{"id":"tpi-1000420_95127794_2_0_0","deal":null,"inventory":{"third_party":true,"type":"sell"},"policies":{"cancellation":[{"from":"now","price":{"accommodation_currency":170,"booker_currency":null}}],"meal_plan":{"meals":[],"plan":"no_plan"}},"price":{"base":{"accommodation_currency":162.98,"booker_currency":null},"chargeable_online":null,"charges":[{"charge":3,"condition":30,"included_in":{"display":false,"chargeable_online":null},"mode":"per_stay","percentage":null,"total_amount":{"accommodation_currency":10,"booker_currency":null},"unit_amount":null},{"charge":142,"included_in":{"display":true,"chargeable_online":null},"mode":"per_person_per_night","percentage":null,"total_amount":{"accommodation_currency":6,"booker_currency":null},"unit_amount":{"accommodation_currency":3,"booker_currency":null},"condition":null},{"charge":21,"condition":null,"included_in":{"display":true,"chargeable_online":null},"mode":"percentage","percentage":9,"total_amount":{"accommodation_currency":14.67,"booker_currency":null},"unit_amount":null},{"charge":22,"condition":null,"included_in":{"display":true,"chargeable_online":null},"mode":"percentage","percentage":7,"total_amount":{"accommodation_currency":11.41,"booker_currency":null},"unit_amount":null}],"display":{"accommodation_currency":195.06,"booker_currency":null},"total":{"accommodation_currency":195.06,"booker_currency":null}}}]},"order_token":"..."}},"key":"accommodation_example","summary":"Preview output for accommodation","id":"paths/~1orders~1preview/post/responses/200/content/application~1json/examples/accommodation_example"},"paths/~1orders~1preview/post/responses/200/content/application~1json/examples/car_example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":{"car":{"offer":123456789,"currency":{"booker":"EUR","payment":"EUR"},"price":{"base":{"display":{"value":129.99,"currency":"EUR","timing":"pay_online_now"},"pay":{"value":129.99,"currency":"EUR","timing":"pay_online_now"}},"extra_charges":{"non_conditional":[{"charge_type":"one_way_fee","amount":{"display":{"value":15,"currency":"EUR"},"pay":{"value":15,"currency":"EUR","timing":"pay_online_now"}}}]},"products":[{"id":"10000000006012","type":"baby_seat","selected_quantity":1,"mode":"per_rental","price":{"unit_amount":{"display":{"value":25,"currency":"EUR"},"pay":{"value":25,"currency":"EUR","timing":"pay_online_now"}},"total_amount":{"display":{"value":25,"currency":"EUR"},"pay":{"value":25,"currency":"EUR","timing":"pay_online_now"}}}},{"id":"10000000006012","type":"additional_driver","selected_quantity":5,"mode":"per_day","price":{"unit_amount":{"display":{"value":8,"currency":"EUR"},"pay":{"value":7,"currency":"USD","timing":"pay_online_now"}},"total_amount":{"display":{"value":40,"currency":"EUR"},"pay":{"value":35,"currency":"USD","timing":"pay_online_now"}}}}],"total":{"value":209.99,"currency":"EUR","timing":"pay_online_now"}},"policies":{"cancellation":{"details":{"context":"before_pickup","duration":"PT48H"},"type":"free_cancellation"},"damage_excess":{"amount":{"display":{"value":1000,"currency":"EUR","timing":"pay_at_pickup"},"pay":{"value":1000,"currency":"EUR","timing":"pay_at_pickup"}}},"deposit":{"amount":{"display":{"value":200,"currency":"EUR","timing":"pay_at_pickup"},"pay":{"value":200,"currency":"EUR","timing":"pay_at_pickup"}}},"fuel_policy":"return_same","mileage":{"distance_limit":300,"distance_unit":"kilometers","amount":null,"currency":null,"type":"limited"},"payment":{"dates":[{"at":"2025-11-01","amount":{"display":{"value":129.99,"currency":"EUR","timing":"pay_online_now"},"pay":{"value":129.99,"currency":"EUR","timing":"pay_online_now"}}}]},"theft_excess":{"amount":{"display":{"value":1500,"currency":"EUR","timing":"pay_at_pickup"},"pay":{"value":1500,"currency":"EUR","timing":"pay_at_pickup"}}}},"insurance":{"quote_reference":"38ddeef-a7fb-4e24-a1e2-66fc3af23d76#1t0juiba8h6n2","name":"Full Protection","id":"999","price":{"display":{"value":45,"currency":"EUR"},"pay":{"value":45,"currency":"EUR","timing":"pay_online_now"}},"coverage_amount":{"value":60000,"currency":"EUR"},"documents":[{"name":"policy_document","url":"https://staging.rentalcover.com/en/pds"},{"name":"ipid","url":"https://files.rentalcover.com/ipids.pdf"}]}},"order_token":"sample-order-token-1234"}},"key":"car_example","summary":"Preview output for car","id":"paths/~1orders~1preview/post/responses/200/content/application~1json/examples/car_example"},"paths/~1orders~1preview/post/responses/400/content/application~1json/examples/invalid_car_offer":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_request","message":"Offer 123 is invalid"}]},"key":"invalid_car_offer","summary":"Invalid offer ID","id":"paths/~1orders~1preview/post/responses/400/content/application~1json/examples/invalid_car_offer"},"paths/~1orders~1preview/post/responses/400/content/application~1json/examples/invalid_request":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_request","message":"Invalid request parameters. Check required fields and their formats."}]},"key":"invalid_request","summary":"Malformed request","id":"paths/~1orders~1preview/post/responses/400/content/application~1json/examples/invalid_request"},"paths/~1orders~1preview/post/responses/500/content/application~1json/examples/internal_error":{"value":{"request_id":"01kjan66dedrpbwv4m1966dzw3","errors":[{"id":"500","message":"Internal server error. Try again later or contact support."}]},"key":"internal_error","summary":"Generic server error","id":"paths/~1orders~1preview/post/responses/500/content/application~1json/examples/internal_error"},"paths/~1orders~1create/post/requestBody/content/application~1json/example":{"value":{"accommodation":{"label":"Sample label","products":[{"id":"333","bed_configuration":"123456","guests":[{"email":"test.name@booking.com","name":"Test Name"}]}],"remarks":{"estimated_arrival_time":{"hour":12},"special_requests":"We will need an extra cot."}},"booker":{"address":{"address_line":"Road-1, house-2","city":"Amsterdam","country":"nl","post_code":"11111"},"company":"Booking B.V","email":"test.name@booking.com","language":"en-gb","name":{"first_name":"Test","last_name":"Name"},"telephone":"12345678"},"order_token":"sample-token","payment":{"card":{"cardholder":"Test Name","cvc":"111","expiry_date":"2030-10","number":"23333333333333"},"include_receipt":true,"method":"card","timing":"pay_at_the_property"}},"id":"paths/~1orders~1create/post/requestBody/content/application~1json/example"},"paths/~1orders~1create/post/responses/200/content/application~1json/examples/accommodation_example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","order":"509430129718799","data":{"accommodation":{"pincode":"0000","reservation":"12345678","third_party_inventory":{"checkin_number":"123456789","confirmation_number":"12345678912345678912"}},"payment":{"receipt_url":"https://secure.booking.com/payment_receipt.html?bn=0000000000&pincode=0000&lang=en"}}},"key":"accommodation_example","summary":"Accommodation order creation output","id":"paths/~1orders~1create/post/responses/200/content/application~1json/examples/accommodation_example"},"paths/~1orders~1create/post/responses/200/content/application~1json/examples/car_example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":{"car":{"reservation_id":"89423719","status":"Processing"}}},"key":"car_example","summary":"Car order creation output","id":"paths/~1orders~1create/post/responses/200/content/application~1json/examples/car_example"},"paths/~1orders~1create/post/responses/400/content/application~1json/examples/expired_token":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"expired_token","message":"Token 'order_token' has expired."}]},"key":"expired_token","summary":"Order token expired","id":"paths/~1orders~1create/post/responses/400/content/application~1json/examples/expired_token"},"paths/~1orders~1create/post/responses/400/content/application~1json/examples/invalid_token":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_token","message":"Token 'order_token' is invalid."}]},"key":"invalid_token","summary":"Invalid token","id":"paths/~1orders~1create/post/responses/400/content/application~1json/examples/invalid_token"},"paths/~1orders~1create/post/responses/403/content/application~1json/examples/sandbox_blocked":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"sandbox_blocked","message":"The /orders/create endpoint for cars is not available in the sandbox. Use the production environment instead."}]},"key":"sandbox_blocked","summary":"Endpoint not available in the sandbox environment","id":"paths/~1orders~1create/post/responses/403/content/application~1json/examples/sandbox_blocked"},"paths/~1orders~1create/post/responses/409/content/application~1json/examples/order_unavailable":{"value":{"request_id":"01kkxmx797zvybfxfsy8byzj8z","errors":[{"id":"order_unavailable","message":"Order has unavailable items: vehicle '123456789' for this order is unavailable."}]},"key":"order_unavailable","summary":"Order unavailable error","id":"paths/~1orders~1create/post/responses/409/content/application~1json/examples/order_unavailable"},"paths/~1orders~1create/post/responses/409/content/application~1json/examples/duplicate_car_reservation":{"value":{"request_id":"01kkxn37vb2e2x5957j5vj9ghr","errors":[{"id":"duplicate_request","message":"This reservation already exists for the submitted request. Use the returned reservation ID to retrieve the booking via /orders/details/cars/live and check its status (booked or processed). Do not retry the request.","reservation":"982045031"}]},"key":"duplicate_car_reservation","summary":"Duplicate car reservation error","id":"paths/~1orders~1create/post/responses/409/content/application~1json/examples/duplicate_car_reservation"},"paths/~1orders~1create/post/responses/500/content/application~1json/examples/internal_error":{"value":{"request_id":"01kjan66dedrpbwv4m1966dzw3","errors":[{"id":"500","message":"Internal server error. Try again later or contact support."}]},"key":"internal_error","summary":"Generic server error","id":"paths/~1orders~1create/post/responses/500/content/application~1json/examples/internal_error"},"paths/~1orders~1details/post/requestBody/content/application~1json/examples/byCreated":{"value":{"created":{"from":"2026-03-26T02:00:00+00:00","to":"2026-03-28T02:00:00+00:00"},"currency":"EUR","maximum_results":20,"sort":{"by":"created","direction":"descending"},"extras":["payment"]},"key":"byCreated","summary":"Filter by creation date","id":"paths/~1orders~1details/post/requestBody/content/application~1json/examples/byCreated"},"paths/~1orders~1details/post/requestBody/content/application~1json/examples/byUpdated":{"value":{"updated":{"from":"2026-03-26T02:00:00+00:00","to":"2026-03-28T02:00:00+00:00"},"currency":"EUR","maximum_results":20,"sort":{"by":"updated","direction":"descending"},"extras":["payment"]},"key":"byUpdated","summary":"Filter by last updated date","id":"paths/~1orders~1details/post/requestBody/content/application~1json/examples/byUpdated"},"paths/~1orders~1details/post/requestBody/content/application~1json/examples/byStart":{"value":{"start":{"from":"2026-04-01","to":"2026-04-07"},"currency":"EUR","services":["accommodations","cars"]},"key":"byStart","summary":"Filter by start date","id":"paths/~1orders~1details/post/requestBody/content/application~1json/examples/byStart"},"paths/~1orders~1details/post/requestBody/content/application~1json/examples/byEnd":{"value":{"end":{"from":"2026-04-01","to":"2026-04-07"},"currency":"EUR","maximum_results":20},"key":"byEnd","summary":"Filter by end date","id":"paths/~1orders~1details/post/requestBody/content/application~1json/examples/byEnd"},"paths/~1orders~1details/post/requestBody/content/application~1json/examples/byOrders":{"value":{"orders":["509430129718799","509430129718800"],"currency":"EUR","extras":["payment"]},"key":"byOrders","summary":"Filter by order IDs","id":"paths/~1orders~1details/post/requestBody/content/application~1json/examples/byOrders"},"paths/~1orders~1details/post/requestBody/content/application~1json/examples/byReservations":{"value":{"reservations":["12345677","76543210"],"currency":"EUR"},"key":"byReservations","summary":"Filter by reservation IDs","id":"paths/~1orders~1details/post/requestBody/content/application~1json/examples/byReservations"},"paths/~1orders~1details/post/requestBody/content/application~1json/examples/byPage":{"value":{"page":"eyJvZmZzZXQiOjIwLCJsaW1pdCI6MjB9","extras":["payment"]},"key":"byPage","summary":"Paginate through results","id":"paths/~1orders~1details/post/requestBody/content/application~1json/examples/byPage"},"paths/~1orders~1details/post/responses/200/content/application~1json/examples/accommodation":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":"509430129718799","accommodations":{"inventory":{"third_party":false,"type":"sell"},"location":{"address":"111 Street Road","city":20089219,"country":"us"},"name":"Test Booking Hotel USA","number_of_guests":2,"reservation":"12345677","stay_probability":0.12},"affiliate":111111,"attractions":null,"booker":{"address":{"city":"Amsterdam","country":"nl"},"email":"johndoe@booking.com","language":"en-gb","name":{"first_name":"John","last_name":"Doe"},"platform":"mobile","telephone":"+100000000","travel_purpose":"business"},"cars":null,"commission":{"actual_commission_amount":{"booker_currency":17.5,"product_currency":20.6},"actual_percentage":null,"estimated_commission_amount":{"booker_currency":null,"product_currency":null}},"created":"2025-11-28T02:00:00+00:00","currencies":{"booker":"EUR","product":"USD"},"end":"2026-03-28T02:00:00+00:00","flights":null,"label":"brand-us_mobile-spring_campaign","loyalty_reward":[{"amount":15,"currency":"USD","eligible":true,"fulfillment_at":"2026-04-10","fulfillment_by":"partner","loyalty_data":[{"name":"Email Id","value":"john_doe@booking.com"},{"name":"Loyalty ID","value":"10101010"}],"type":"point"}],"price":{"commissionable_price":{"booker_currency":160,"product_currency":188.32},"total_price":{"booker_currency":170.01,"product_currency":200.1}},"start":"2026-03-21T02:00:00+00:00","status":"booked","taxis":null,"updated":"2025-11-28T02:00:00+00:00"}],"metadata":{"next_page":null,"total_results":1}},"key":"accommodation","summary":"Accommodation order","id":"paths/~1orders~1details/post/responses/200/content/application~1json/examples/accommodation"},"paths/~1orders~1details/post/responses/200/content/application~1json/examples/car":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":"5011111111111111","accommodations":null,"affiliate":111111,"attractions":null,"booker":{"address":{"city":"Amsterdam","country":"nl"},"email":"johndoe@booking.com","language":"en-gb","name":{"first_name":"John","last_name":"Doe"},"platform":"mobile","telephone":"+100000000","travel_purpose":"business"},"cars":{"pickup_location":{"city":"San Francisco","country":"us"},"dropoff_location":{"city":"Los Angeles","country":"us"},"payment":{"timing":"pay_at_pickup"},"reservation":"CAR-99887766"},"commission":{"actual_commission_amount":{"booker_currency":17.5,"product_currency":20.6},"actual_percentage":null,"estimated_commission_amount":{"booker_currency":null,"product_currency":null}},"created":"2025-11-28T02:00:00+00:00","currencies":{"booker":"EUR","product":"USD"},"end":"2026-03-28T02:00:00+00:00","flights":null,"label":"brand-us_mobile-spring_campaign","loyalty_reward":[{"amount":15,"currency":"USD","eligible":true,"fulfillment_at":"2026-04-10","fulfillment_by":"partner","loyalty_data":[{"name":"Email Id","value":"john_doe@booking.com"},{"name":"Loyalty ID","value":"10101010"}],"type":"point"}],"price":{"commissionable_price":{"booker_currency":160,"product_currency":188.32},"total_price":{"booker_currency":170.01,"product_currency":200.1}},"start":"2026-03-21T02:00:00+00:00","status":"booked","taxis":null,"updated":"2025-11-28T02:00:00+00:00"}],"metadata":{"next_page":null,"total_results":1}},"key":"car","summary":"Car rental order","id":"paths/~1orders~1details/post/responses/200/content/application~1json/examples/car"},"paths/~1orders~1details/post/responses/200/content/application~1json/examples/mixed":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":"509430129718799","accommodations":{"name":"Test Booking Hotel USA","reservation":"12345677","number_of_guests":2},"cars":null,"flights":null,"attractions":null,"taxis":null,"status":"booked"},{"id":"5011111111111111","accommodations":null,"cars":{"reservation":"CAR-99887766","pickup_location":{"city":"San Francisco","country":"us"},"dropoff_location":{"city":"Los Angeles","country":"us"}},"flights":null,"attractions":null,"taxis":null,"status":"booked"}],"metadata":{"total_results":2,"next_page":null}},"key":"mixed","summary":"Mixed accommodation and car orders","description":"Example showing that a single response can contain orders from multiple travel services. Each order includes only the object corresponding to its travel service.","id":"paths/~1orders~1details/post/responses/200/content/application~1json/examples/mixed"},"paths/~1orders~1details~1accommodations/post/requestBody/content/application~1json/examples/byOrders":{"value":{"currency":"USD","extras":["policies","extra_charges"],"orders":["509430129718799","509430129718800"]},"key":"byOrders","summary":"Retrieve by order IDs","id":"paths/~1orders~1details~1accommodations/post/requestBody/content/application~1json/examples/byOrders"},"paths/~1orders~1details~1accommodations/post/requestBody/content/application~1json/examples/byReservations":{"value":{"currency":"USD","extras":["policies","extra_charges"],"reservations":["2321873123","4666773123"]},"key":"byReservations","summary":"Retrieve by reservation IDs","id":"paths/~1orders~1details~1accommodations/post/requestBody/content/application~1json/examples/byReservations"},"paths/~1orders~1details~1accommodations/post/responses/200/content/application~1json/examples/default":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":"509430129718799","accommodation":123456,"accommodation_details":{"email":"test_hotel@booking.com","location":{"address":"111 Street Road","city":20089219,"coordinates":{"latitude":11.923274,"longitude":-92.716188},"country":"us","post_code":"NY 1234"},"name":"Test Booking Hotel USA","telephone":"+19876543210"},"accommodation_order_references":["12345","ABED2312"],"booker":{"external_account":"13610217","platform":"mobile"},"cancellation_details":{"at":"2025-12-09T00:00:00+00:00","fee":{"accommodation_currency":170.01,"booker_currency":186.87},"original_total_price":{"accommodation_currency":170.01,"booker_currency":186.87}},"checkin":"2025-12-10","checkout":"2025-12-18","commission":{"actual_amount":null,"actual_percentage":null,"estimated_amount":{"accommodation_currency":17.5,"booker_currency":19.23}},"credit_slip_number":"hsnl1223445","currency":{"accommodation":"EUR","booker":"USD"},"inventory":{"third_party":false,"type":"sell"},"key_collection_information":[{"additional_instructions":"The keys are in a keybox located next to the front door.","alternate_location":{"address":"abc","city":"bdweb","postal_code":"1015XX"},"checkin_method":"someone_will_meet","key_location":"at_the_property"}],"label":"One123","pin_code":"1234","price":{"commissionable":{"accommodation_currency":164.01,"booker_currency":180.27},"total":{"accommodation_currency":170.01,"booker_currency":186.87}},"products":[{"allocation":{"adults":2,"children":[3,4,5],"guests":5},"guests":[{"email":"test.name@booking.com","name":"Test Name"}],"policies":{"cancellation":[{"from":null,"price":{"accommodation_currency":170.01,"booker_currency":186.87}}],"meal_plan":{"meals":["breakfast"],"plan":"breakfast_included"},"smoking_preference":"non-smoking"},"price":{"base":{"accommodation_currency":170.01,"booker_currency":186.87},"display":{"accommodation_currency":200.97,"booker_currency":220.9},"charges":[{"charge":142,"mode":"per_person_per_night","percentage":null,"total_amount":{"accommodation_currency":6,"booker_currency":6.6},"unit_amount":{"accommodation_currency":3,"booker_currency":3.3},"condition":null,"included_in":{"display":true}},{"charge":21,"mode":"percentage","percentage":9,"total_amount":{"accommodation_currency":14.04,"booker_currency":15.43},"unit_amount":null,"condition":null,"included_in":{"display":true}},{"charge":22,"mode":"percentage","percentage":7,"total_amount":{"accommodation_currency":10.92,"booker_currency":12},"unit_amount":null,"condition":null,"included_in":{"display":true}}],"total":{"accommodation_currency":200.97,"booker_currency":220.9}},"room":"12345","room_details":{"name":"Double Deluxe Room"},"room_reservation":"1234567890","status":"booked"}],"remarks":"We will need an extra cot. Need room on higher floor","reservation":"12345678","status":"booked","stay_probability":0.12}]},"key":"default","summary":"Accommodation order details response","id":"paths/~1orders~1details~1accommodations/post/responses/200/content/application~1json/examples/default"},"paths/~1orders~1details~1cars/post/requestBody/content/application~1json/example":{"value":{"currency":"USD","extras":["policies"],"reservations":["11223344"]},"id":"paths/~1orders~1details~1cars/post/requestBody/content/application~1json/example"},"paths/~1orders~1details~1cars/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":"123456789","affiliate":1234567,"commission":{"actual_amount":{"depot_currency":45.5,"booker_currency":66.34},"actual_percentage":0.25,"estimated_amount":{"depot_currency":45.5,"booker_currency":66.34}},"currency":{"depot":"EUR","booker":"USD"},"dropoff":{"date":"2025-10-18T00:00:00"},"label":"One123","pickup":{"date":"2025-10-15T00:00:00"},"price":{"commissionable":{"depot_currency":170.01,"booker_currency":186.87},"total":{"depot_currency":170.01,"booker_currency":186.87}},"products":[{"policies":{"payment":{"timing":"pay_online_now"}},"price":{"base":{"depot_currency":170.01,"booker_currency":186.87},"total":{"depot_currency":170.01,"booker_currency":186.87}},"status":"booked"}],"status":"booked"}]},"id":"paths/~1orders~1details~1cars/post/responses/200/content/application~1json/example"},"paths/~1orders~1details~1cars/post/responses/400/content/application~1json/examples/missing_parameter":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"missing_parameter","message":"One of the following parameters is missing: 'orders' and 'reservations'."}]},"key":"missing_parameter","summary":"Missing parameter","id":"paths/~1orders~1details~1cars/post/responses/400/content/application~1json/examples/missing_parameter"},"paths/~1orders~1details~1cars/post/responses/400/content/application~1json/examples/invalid_parameter":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_parameter","message":"Parameter 'currency' is invalid. 'US' is not an ISO 4217 code."}]},"key":"invalid_parameter","summary":"Malformed request","id":"paths/~1orders~1details~1cars/post/responses/400/content/application~1json/examples/invalid_parameter"},"paths/~1orders~1details~1cars/post/responses/500/content/application~1json/examples/internal_error":{"value":{"request_id":"01kjan66dedrpbwv4m1966dzw3","errors":[{"id":"500","message":"Internal server error. Try again later or contact support."}]},"key":"internal_error","summary":"Generic server error","id":"paths/~1orders~1details~1cars/post/responses/500/content/application~1json/examples/internal_error"},"paths/~1orders~1details~1flights/post/responses/200/content/application~1json/example":{"value":{"data":[{"id":"ORDER_ID","reservation":"RESERVATION_ID","currency":{"booker":"EUR","order":"USD"},"itineraries":[{"departure":{"airport":"CAI","date_time":"2024-03-01T07:00:00+00:00"},"arrival":{"airport":"LXR","date_time":"2024-03-01T08:10:00+00:00"}}],"label":"SAMPLE LABEL","price":{"order_currency":212.86,"booker_currency":197.87},"status":"booked"}]},"id":"paths/~1orders~1details~1flights/post/responses/200/content/application~1json/example"},"paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/accommodation_example":{"value":{"order":"509430129718799","accommodation":{"reservation":"1234567890","reason":"My travel dates have changed and I need to book a different property."}},"key":"accommodation_example","summary":"Cancel input for accommodation","id":"paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/accommodation_example"},"paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/car_example":{"value":{"car":{"reservation":"1234567890","reason":"My travel plans have changed and I no longer need this car rental.","booker":{"country":"nl"}}},"key":"car_example","summary":"Cancel input for car","id":"paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/car_example"},"paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/insurance_example":{"value":{"insurance":{"car":{"reservation":"1234567890","policy_reference":"38df45ff-a6fb-4e24-a1d2-66fc3af23d76","booker":{"country":"nl"}}}},"key":"insurance_example","summary":"Cancel input for car insurance","id":"paths/~1orders~1cancel/post/requestBody/content/application~1json/examples/insurance_example"},"paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/accommodations_cancel_output":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":{"status":"successful"}},"key":"accommodations_cancel_output","summary":"Accommodation cancellation","id":"paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/accommodations_cancel_output"},"paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/car_processing_output":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":{"status":"processing"}},"key":"car_processing_output","summary":"Car rental cancellation.","id":"paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/car_processing_output"},"paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/insurance_processing_output":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":{"status":"processing"}},"key":"insurance_processing_output","summary":"Car insurance cancellation.","id":"paths/~1orders~1cancel/post/responses/200/content/application~1json/examples/insurance_processing_output"},"paths/~1orders~1cancel/post/responses/403/content/application~1json/examples/sandbox_blocked":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"sandbox_blocked","message":"The /orders/cancel endpoint for cars is not available in the sandbox. Use the production environment instead."}]},"key":"sandbox_blocked","summary":"Endpoint not available in the sandbox environment","id":"paths/~1orders~1cancel/post/responses/403/content/application~1json/examples/sandbox_blocked"}},"securitySchemeStore":{"BearerAuth":{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}},"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}]},"options":{"feedback":{"hide":true,"settings":{"label":""}},"corsProxyUrl":"https://cors.redoc.ly","hideSidebar":true,"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/demand/docs/open-api/3.2/demand-api.json?download"},{"url":"/_bundle/demand/docs/open-api/3.2/demand-api.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Booking.com Demand API","summary":"The Booking.com Demand API enables Affiliate Partners to access Booking.com's travel inventory, including accommodations, car rentals, and flights. The version 3.2 introduces several improvements and breaking changes from version 3.1, including updates to **price structures**, inclusion of **Attractions and taxis in orders/details** for post-booking reporting, and other structural enhancements.\n\n- The API follows REST principles and returns data in **JSON** format.\n- You can access endpoints via **HTTPS POST** requests.\n\nAuthentication: Use your Affiliate ID and token credentials to use these endpoints.\n\n[Check the Try out guide!](/demand/docs/getting-started/try-out-the-api)"}},"baseSlug":"/demand/docs/open-api/3.2/demand-api","routesMapping":{}}