{"items":[{"type":"link","label":"Booking.com Demand API","link":"/demand/docs/open-api/3.2-beta/demand-api","routeSlug":"/demand/docs/open-api/3.2-beta/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-beta/demand-api.json?download"},{"kind":"download","label":"demand-api.yaml","url":"/_bundle/demand/docs/open-api/3.2-beta/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-Beta)","showPageActions":true},{"nodeType":"markdoc","content":[{"$$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":"Beta version – experimental endpoints"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API version is "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"currently in Beta"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and is offered to a limited set of pilot affiliate partners. Access is granted on request via your Booking.com account manager."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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":"Important:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This API is "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"under active development"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Endpoints, request/response structures, and functionality may change without prior notice. Specifications are updated frequently during the pilot phase."},"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":"Consult the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/whats-new/changelog"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Changelog"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the latest updates."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All requests "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"require authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" using your Affiliate ID and token credentials."},"children":[]}]}]}]}]}],"sectionId":"/demand/docs/open-api/3.2-beta/demand-api"}]}]}},{"type":"separator","label":"Travel services","content":null},{"type":"group","label":"Accommodation","link":"/demand/docs/open-api/3.2-beta/demand-api/accommodations","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/accommodations","items":[{"label":"Search","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/accommodations/accommodations/search","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/accommodations/accommodations/availability","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/accommodations/accommodations/chains","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/accommodations/accommodations/constants","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/accommodations/accommodations/details","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/accommodations/accommodations/details/changes","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/accommodations/accommodations/reviews","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/accommodations/accommodations/reviews/scores","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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":"Smart search","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/accommodations/accommodations/smart-search","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/accommodations/accommodations/smart-search","metadata":{"seo":{"title":"Smart search","description":"Use this endpoint to search for accommodations using a natural language query combined with structured travel criteria such as dates, guests, location, and sorting preferences. The search_query field accepts free-text input describing the traveller’s intent, preferences, or desired accommodation features. Structured parameters such as checkin, checkout, guests, and location filters are used to refine and constrain the search results."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/accommodations/smart-search","name":"Smart search","isWebhook":false,"pointer":"/paths/~1accommodations~1smart-search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Smart 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 using a natural language query combined with structured travel criteria such as dates, guests, location, and sorting preferences. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"search_query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field accepts free-text input describing the traveller’s intent, preferences, or desired accommodation features. Structured parameters such as "},"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":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"guests"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and location filters are used to refine and constrain the search 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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1accommodations~1smart-search/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/smartSearchInput","exampleIds":["paths/~1accommodations~1smart-search/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/smartSearchInput","exampleIds":["paths/~1accommodations~1smart-search/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1accommodations~1smart-search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/accommodations/smart-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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/smartSearchInput","exampleIds":["paths/~1accommodations~1smart-search/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/accommodations/smart-search","href":"accommodations/accommodations/smart-search","openApiOperationId":"/accommodations/smart-search","summary":"Smart search"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/smartSearchInput","exampleIds":["paths/~1accommodations~1smart-search/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/smartSearchInput","exampleIds":["paths/~1accommodations~1smart-search/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/smartSearchOutput","exampleIds":["paths/~1accommodations~1smart-search/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/smartSearchOutput","exampleIds":["paths/~1accommodations~1smart-search/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1accommodations~1smart-search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/smartSearchOutput","exampleIds":["paths/~1accommodations~1smart-search/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/smartSearchOutput","exampleIds":["paths/~1accommodations~1smart-search/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/accommodations/smart-search"},{"label":"Third-party suppliers","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/accommodations/accommodations/third-party-suppliers","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_507"}},"schemaId":"schema_507","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_507"}},"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_507","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_507"}},"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/smart-search","summary":"Smart search","prefix":{"name":"post","color":"post"},"badges":[],"link":"/accommodations/accommodations/smart-search","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":"Attractions","link":"/demand/docs/open-api/3.2-beta/demand-api/attractions","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/attractions","items":[{"label":"Search attractions","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/attractions/search","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/attractions/search","metadata":{"seo":{"title":"Search attractions","description":"Use this endpoint to search for attractions based on a single search criterion, such as attraction IDs, cities, countries, or geographic coordinates."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/search","name":"Search attractions","isWebhook":false,"pointer":"/paths/~1attractions~1search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search attractions","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 search for attractions based on a single search criterion, such as attraction IDs, cities, countries, or geographic coordinates."},{"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1attractions~1search/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/attractionsSearchInput","exampleIds":["paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-attractions","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-cities","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-countries","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-coordinates","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-with-filters"]}},"schemaId":"components/schemas/attractionsSearchInput","exampleIds":["paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-attractions","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-cities","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-countries","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-coordinates","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-with-filters"],"pointer":"/paths/~1attractions~1search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/attractions/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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/attractionsSearchInput","exampleIds":["paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-attractions","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-cities","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-countries","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-coordinates","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-with-filters"]}},"responseCodes":["200"],"pointer":"/attractions/search","href":"attractions/search","openApiOperationId":"/search","summary":"Search attractions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/attractionsSearchInput","exampleIds":["paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-attractions","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-cities","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-countries","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-coordinates","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-with-filters"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/attractionsSearchInput","exampleIds":["paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-attractions","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-cities","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-countries","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-coordinates","paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-with-filters"]}},"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/attractionsSearchOutput","exampleIds":["paths/~1attractions~1search/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/attractionsSearchOutput","exampleIds":["paths/~1attractions~1search/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1attractions~1search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/attractionsSearchOutput","exampleIds":["paths/~1attractions~1search/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/attractionsSearchOutput","exampleIds":["paths/~1attractions~1search/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/attractions/search"},{"label":"Attraction details","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/attractions/attractions/details","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/attractions/attractions/details","metadata":{"seo":{"title":"Attraction details","description":"Use this endpoint to retrieve static information about attractions such as name, description, address, URL, etc. Note: This endpoint does not return any pricing information."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/attractions/details","name":"Attraction details","isWebhook":false,"pointer":"/paths/~1attractions~1details/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Attraction 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 static information about attractions such as name, description, address, URL, etc. "},"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":" This endpoint does not return any pricing information."},"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1attractions~1details/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/attractionsInput","exampleIds":["paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-attractions","paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-cities","paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-countries"]}},"schemaId":"components/schemas/attractionsInput","exampleIds":["paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-attractions","paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-cities","paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-countries"],"pointer":"/paths/~1attractions~1details/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/attractions/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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/attractionsInput","exampleIds":["paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-attractions","paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-cities","paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-countries"]}},"responseCodes":["200","400","401","500"],"pointer":"/attractions/details","href":"attractions/attractions/details","openApiOperationId":"/attractions/details","summary":"Attraction details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/attractionsInput","exampleIds":["paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-attractions","paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-cities","paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-countries"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/attractionsInput","exampleIds":["paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-attractions","paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-cities","paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-countries"]}},"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/attractionsOutput","exampleIds":["paths/~1attractions~1details/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/attractionsOutput","exampleIds":["paths/~1attractions~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"}},"schemaId":"components/schemas/error_response"},{"code":"401","description":"Authentication failed or the API key is invalid.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response"}},"schemaId":"components/schemas/error_response"},{"code":"500","description":"An unexpected error occurred on the server.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response"}},"schemaId":"components/schemas/error_response"}],"pointer":"/paths/~1attractions~1details/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/attractionsOutput","exampleIds":["paths/~1attractions~1details/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/attractionsOutput","exampleIds":["paths/~1attractions~1details/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/error_response","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response"}}},{"code":"401","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":"/attractions/details"},{"label":"Attraction Reviews","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/attractions/attractions/reviews","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/attractions/attractions/reviews","metadata":{"seo":{"title":"Attraction Reviews","description":"Retrieves reviews for a specific attraction. The reviews returned can be filtered and sorted, with the option to limit the number of reviews per attraction by specifying the \"rows\" parameter.Note: The scores reflect all traveller feedback across Booking.com and may not directly correspond to the experiences of your own customers. If you choose to display or use these ratings and reviews, you are responsible for ensuring that your travellers understand what these scores represent."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/attractions/reviews","name":"Attraction Reviews","isWebhook":false,"pointer":"/paths/~1attractions~1reviews/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Attraction 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":"Retrieves reviews for a specific attraction. The reviews returned can be filtered and sorted, with the option to limit the number of reviews per attraction by specifying the \"rows\" parameter."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"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":" The scores reflect all traveller feedback across Booking.com and may not directly correspond to the experiences of your own customers. If you choose to display or use these ratings and reviews, you are responsible for ensuring that your travellers understand 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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1attractions~1reviews/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/schemas-input","exampleIds":["paths/~1attractions~1reviews/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/schemas-input","exampleIds":["paths/~1attractions~1reviews/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1attractions~1reviews/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/attractions/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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/schemas-input","exampleIds":["paths/~1attractions~1reviews/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/attractions/reviews","href":"attractions/attractions/reviews","openApiOperationId":"/attractions/reviews","summary":"Attraction Reviews"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/schemas-input","exampleIds":["paths/~1attractions~1reviews/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/schemas-input","exampleIds":["paths/~1attractions~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/schemas-output","exampleIds":["paths/~1attractions~1reviews/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/schemas-output","exampleIds":["paths/~1attractions~1reviews/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1attractions~1reviews/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/schemas-output","exampleIds":["paths/~1attractions~1reviews/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/schemas-output","exampleIds":["paths/~1attractions~1reviews/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/attractions/reviews"},{"label":"Attraction Review Scores","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/attractions/attractions/reviews/scores","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/attractions/attractions/reviews/scores","metadata":{"seo":{"title":"Attraction Review Scores","description":"Returns detailed review scores for specific attractions."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/attractions/reviews/scores","name":"Attraction Review Scores","isWebhook":false,"pointer":"/paths/~1attractions~1reviews~1scores/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Attraction Review Scores","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns detailed review scores for specific attractions."},{"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1attractions~1reviews~1scores/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/reviewScores_input","exampleIds":["paths/~1attractions~1reviews~1scores/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/reviewScores_input","exampleIds":["paths/~1attractions~1reviews~1scores/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1attractions~1reviews~1scores/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/attractions/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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/reviewScores_input","exampleIds":["paths/~1attractions~1reviews~1scores/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/attractions/reviews/scores","href":"attractions/attractions/reviews/scores","openApiOperationId":"/attractions/reviews/scores","summary":"Attraction Review Scores"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/reviewScores_input","exampleIds":["paths/~1attractions~1reviews~1scores/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/reviewScores_input","exampleIds":["paths/~1attractions~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/reviewScores_output","exampleIds":["paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/typical-attractions","paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/few-reviews","paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/no-reviews"]}},"schemaId":"components/schemas/reviewScores_output","exampleIds":["paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/typical-attractions","paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/few-reviews","paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/no-reviews"]}],"pointer":"/paths/~1attractions~1reviews~1scores/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/reviewScores_output","exampleIds":["paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/typical-attractions","paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/few-reviews","paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/no-reviews"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/reviewScores_output","exampleIds":["paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/typical-attractions","paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/few-reviews","paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/no-reviews"]}}}],"examples":[]}]}]}]},"httpPath":"/attractions/reviews/scores"},{"label":"Attraction constants","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/attractions/constants","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/attractions/constants","metadata":{"seo":{"title":"Attraction constants","description":"Returns localised attraction constants, including category and subcategory metadata."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"constants","name":"Attraction constants","isWebhook":false,"pointer":"/paths/~1attractions~1constants/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Attraction 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":"Returns localised attraction constants, including category and subcategory metadata."},"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":"Use this endpoint to retrieve and cache the category ID-to-name mapping before performing attraction searches with category filters."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call this endpoint during initial integration or periodically to refresh cached values."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To retrieve all constants, send an empty request body."},"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1attractions~1constants/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/constants_input","exampleIds":["paths/~1attractions~1constants/post/requestBody/content/application~1json/examples/english"]}},"schemaId":"components/schemas/constants_input","exampleIds":["paths/~1attractions~1constants/post/requestBody/content/application~1json/examples/english"],"pointer":"/paths/~1attractions~1constants/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/attractions/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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/constants_input","exampleIds":["paths/~1attractions~1constants/post/requestBody/content/application~1json/examples/english"]}},"responseCodes":["200"],"pointer":"/attractions/constants","href":"attractions/constants","openApiOperationId":"constants","summary":"Attraction constants"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/constants_input","exampleIds":["paths/~1attractions~1constants/post/requestBody/content/application~1json/examples/english"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/constants_input","exampleIds":["paths/~1attractions~1constants/post/requestBody/content/application~1json/examples/english"]}},"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 localised attraction category constants.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/attractions_constants_output","exampleIds":["paths/~1attractions~1constants/post/responses/200/content/application~1json/examples/single_language","paths/~1attractions~1constants/post/responses/200/content/application~1json/examples/multi_language"]}},"schemaId":"components/schemas/attractions_constants_output","exampleIds":["paths/~1attractions~1constants/post/responses/200/content/application~1json/examples/single_language","paths/~1attractions~1constants/post/responses/200/content/application~1json/examples/multi_language"]}],"pointer":"/paths/~1attractions~1constants/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/attractions_constants_output","exampleIds":["paths/~1attractions~1constants/post/responses/200/content/application~1json/examples/single_language","paths/~1attractions~1constants/post/responses/200/content/application~1json/examples/multi_language"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/attractions_constants_output","exampleIds":["paths/~1attractions~1constants/post/responses/200/content/application~1json/examples/single_language","paths/~1attractions~1constants/post/responses/200/content/application~1json/examples/multi_language"]}}}],"examples":[]}]}]}]},"httpPath":"/attractions/constants"}],"content":{"contentType":"group","meta":{"name":"Attractions"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Attractions","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/attractions/search","summary":"Search attractions","prefix":{"name":"post","color":"post"},"badges":[],"link":"/attractions/search","deprecated":false},{"title":"/attractions/details","summary":"Attraction details","prefix":{"name":"post","color":"post"},"badges":[],"link":"/attractions/attractions/details","deprecated":false},{"title":"/attractions/reviews","summary":"Attraction Reviews","prefix":{"name":"post","color":"post"},"badges":[],"link":"/attractions/attractions/reviews","deprecated":false},{"title":"/attractions/reviews/scores","summary":"Attraction Review Scores","prefix":{"name":"post","color":"post"},"badges":[],"link":"/attractions/attractions/reviews/scores","deprecated":false},{"title":"/attractions/constants","summary":"Attraction constants","prefix":{"name":"post","color":"post"},"badges":[],"link":"/attractions/constants","deprecated":false}]}]}]}]}},{"type":"group","label":"Car rentals","link":"/demand/docs/open-api/3.2-beta/demand-api/cars","routeSlug":"/demand/docs/open-api/3.2-beta/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-beta/demand-api/cars/search","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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 availability","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/cars/availability","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/cars/availability","metadata":{"seo":{"title":"Car availability","description":"Retrieve availability details for a specific car rental offer, including final pricing, available insurance options, and optional extras (such as an additional driver or child seat) that can be added to the order."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/availability","name":"Car availability","isWebhook":false,"pointer":"/paths/~1cars~1availability/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Car availability","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieve availability details for a specific car rental offer, including final pricing, available insurance options, and optional extras (such as an additional driver or child seat) that can be added to the order."},{"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1cars~1availability/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cars_availability_input","exampleIds":["paths/~1cars~1availability/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/cars_availability_input","exampleIds":["paths/~1cars~1availability/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1cars~1availability/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cars/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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/cars_availability_input","exampleIds":["paths/~1cars~1availability/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","500"],"pointer":"/cars/availability","href":"cars/availability","openApiOperationId":"/availability","summary":"Car availability"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/cars_availability_input","exampleIds":["paths/~1cars~1availability/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cars_availability_input","exampleIds":["paths/~1cars~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":"Availability details retrieved successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cars_availability_output","exampleIds":["paths/~1cars~1availability/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/cars_availability_output","exampleIds":["paths/~1cars~1availability/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~1availability/post/responses/400/content/application~1json/examples/invalid_offer","paths/~1cars~1availability/post/responses/400/content/application~1json/examples/expired_token","paths/~1cars~1availability/post/responses/400/content/application~1json/examples/invalid_token"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1availability/post/responses/400/content/application~1json/examples/invalid_offer","paths/~1cars~1availability/post/responses/400/content/application~1json/examples/expired_token","paths/~1cars~1availability/post/responses/400/content/application~1json/examples/invalid_token"]},{"code":"500","description":"Internal Server Error. The request failed due to a server-side issue. Please retry or contact support if the issue persists.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1availability/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1availability/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1cars~1availability/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/cars_availability_output","exampleIds":["paths/~1cars~1availability/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cars_availability_output","exampleIds":["paths/~1cars~1availability/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1availability/post/responses/400/content/application~1json/examples/invalid_offer","paths/~1cars~1availability/post/responses/400/content/application~1json/examples/expired_token","paths/~1cars~1availability/post/responses/400/content/application~1json/examples/invalid_token"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1availability/post/responses/400/content/application~1json/examples/invalid_offer","paths/~1cars~1availability/post/responses/400/content/application~1json/examples/expired_token","paths/~1cars~1availability/post/responses/400/content/application~1json/examples/invalid_token"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1availability/post/responses/500/content/application~1json/examples/internal_error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1availability/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/cars/availability"},{"label":"Car constants","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/cars/constants","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/cars/depots","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/cars/depotscores","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/cars/details","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/cars/suppliers","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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"},{"label":"Retrieve terms and conditions.","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/cars/terms-and-conditions","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/cars/terms-and-conditions","metadata":{"seo":{"title":"Retrieve terms and conditions.","description":"Use this endpoint to retrieve the terms and conditions for a specific car during the pre-booking process. The response includes structured content in the requested language."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"terms-and-conditions","name":"Retrieve terms and conditions.","isWebhook":false,"pointer":"/paths/~1cars~1terms-and-conditions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve terms and conditions.","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 terms and conditions for a specific car during the pre-booking process. The response includes structured content in the requested language."},{"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1cars~1terms-and-conditions/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cars_terms_and_conditions_input","exampleIds":["paths/~1cars~1terms-and-conditions/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/cars_terms_and_conditions_input","exampleIds":["paths/~1cars~1terms-and-conditions/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1cars~1terms-and-conditions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cars/terms-and-conditions","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/cars_terms_and_conditions_input","exampleIds":["paths/~1cars~1terms-and-conditions/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","500"],"pointer":"/cars/terms-and-conditions","href":"cars/terms-and-conditions","openApiOperationId":"terms-and-conditions","summary":"Retrieve terms and conditions."},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/cars_terms_and_conditions_input","exampleIds":["paths/~1cars~1terms-and-conditions/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/cars_terms_and_conditions_input","exampleIds":["paths/~1cars~1terms-and-conditions/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_terms_and_conditions_output","exampleIds":["paths/~1cars~1terms-and-conditions/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/cars_terms_and_conditions_output","exampleIds":["paths/~1cars~1terms-and-conditions/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~1terms-and-conditions/post/responses/400/content/application~1json/examples/invalid_offer"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1terms-and-conditions/post/responses/400/content/application~1json/examples/invalid_offer"]},{"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~1terms-and-conditions/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1terms-and-conditions/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1cars~1terms-and-conditions/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/cars_terms_and_conditions_output","exampleIds":["paths/~1cars~1terms-and-conditions/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/cars_terms_and_conditions_output","exampleIds":["paths/~1cars~1terms-and-conditions/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1terms-and-conditions/post/responses/400/content/application~1json/examples/invalid_offer"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1terms-and-conditions/post/responses/400/content/application~1json/examples/invalid_offer"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1terms-and-conditions/post/responses/500/content/application~1json/examples/internal_error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1cars~1terms-and-conditions/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/cars/terms-and-conditions"}],"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/availability","summary":"Car availability","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cars/availability","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},{"title":"/cars/terms-and-conditions","summary":"Retrieve terms and conditions.","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cars/terms-and-conditions","deprecated":false}]}]}]}]}},{"type":"separator","label":"Common","content":null},{"type":"group","label":"Autocomplete","link":"/demand/docs/open-api/3.2-beta/demand-api/commonautocomplete","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/commonautocomplete","items":[{"label":"Retrieve autocomplete suggestions","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/commonautocomplete/common/autocomplete","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/commonautocomplete/common/autocomplete","metadata":{"seo":{"title":"Retrieve autocomplete suggestions","description":"Returns ranked suggestions based on the free-text query, destination popularity, and the provided context. This endpoint is designed for real-time \"as-you-type\" autocomplete experiences.\\n\\nSupports prefix matching with basic typo tolerance and is optimised for low-latency search.\\n\\nYou can optionally restrict results by destination type using filters.types.\\n\\nEach suggestion includes a destination identifier, localised name, and geographic context."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/common/autocomplete","name":"Retrieve autocomplete suggestions","isWebhook":false,"pointer":"/paths/~1common~1autocomplete/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve autocomplete suggestions","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":"Returns ranked suggestions based on the free-text query, destination popularity, and the provided context. This endpoint is designed for real-time \"as-you-type\" autocomplete experiences.\\n\\nSupports prefix matching with basic typo tolerance and is optimised for low-latency search.\\n\\nYou can optionally restrict results by destination type using filters.types.\\n\\nEach suggestion includes a destination identifier, localised name, and geographic context."},"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1common~1autocomplete/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/autoCompleteInput","exampleIds":["paths/~1common~1autocomplete/post/requestBody/content/application~1json/examples/default"]}},"schemaId":"components/schemas/autoCompleteInput","exampleIds":["paths/~1common~1autocomplete/post/requestBody/content/application~1json/examples/default"],"pointer":"/paths/~1common~1autocomplete/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/common/autocomplete","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/autoCompleteInput","exampleIds":["paths/~1common~1autocomplete/post/requestBody/content/application~1json/examples/default"]}},"responseCodes":["200","400","500"],"pointer":"/common/autocomplete","href":"commonautocomplete/common/autocomplete","openApiOperationId":"/common/autocomplete","summary":"Retrieve autocomplete suggestions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/autoCompleteInput","exampleIds":["paths/~1common~1autocomplete/post/requestBody/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/autoCompleteInput","exampleIds":["paths/~1common~1autocomplete/post/requestBody/content/application~1json/examples/default"]}},"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 with ranked suggestions.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/autoCompleteOutput","exampleIds":["paths/~1common~1autocomplete/post/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/autoCompleteOutput","exampleIds":["paths/~1common~1autocomplete/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 (for example, query too short or invalid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filters.types"},"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_response"}},"schemaId":"components/schemas/error_response"},{"code":"500","description":"Internal server error."}],"pointer":"/paths/~1common~1autocomplete/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/autoCompleteOutput","exampleIds":["paths/~1common~1autocomplete/post/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/autoCompleteOutput","exampleIds":["paths/~1common~1autocomplete/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"}],"examples":[]}]}]}]},"httpPath":"/common/autocomplete"}],"content":{"contentType":"group","meta":{"name":"Common/autocomplete"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Autocomplete","showPageActions":true},{"nodeType":"markdoc","content":"Use this endpoint to retrieve ranked suggestions based on a free-text query. Designed for real-time \"as-you-type\" autocomplete experiences."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/common/autocomplete","summary":"Retrieve autocomplete suggestions","prefix":{"name":"post","color":"post"},"badges":[],"link":"/commonautocomplete/common/autocomplete","deprecated":false}]}]}]}]}},{"type":"group","label":"Locations","link":"/demand/docs/open-api/3.2-beta/demand-api/commonlocations","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/commonlocations","items":[{"label":"Airports","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/commonlocations/common/locations/airports","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/commonlocations/common/locations/cities","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/commonlocations/common/locations/countries","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/commonlocations/common/locations/districts","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/commonlocations/common/locations/landmarks","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/commonlocations/common/locations/regions","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/commonpayments","routeSlug":"/demand/docs/open-api/3.2-beta/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-beta/demand-api/commonpayments/common/payments/cards","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/commonpayments/common/payments/currencies","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/commonlanguages","routeSlug":"/demand/docs/open-api/3.2-beta/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-beta/demand-api/commonlanguages/common/languages","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/orders","routeSlug":"/demand/docs/open-api/3.2-beta/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-beta/demand-api/orders/orders/preview","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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-beta/demand-api/orders/create","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/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":"/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_506","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/create_beta_input","exampleIds":["paths/~1orders~1create/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1create/post/requestBody/content/application~1json/examples/car_example"]}},"schemaId":"components/schemas/create_beta_input","exampleIds":["paths/~1orders~1create/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1create/post/requestBody/content/application~1json/examples/car_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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/create_beta_input","exampleIds":["paths/~1orders~1create/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1create/post/requestBody/content/application~1json/examples/car_example"]}},"responseCodes":["200","400","409","500"],"pointer":"/orders/create","href":"orders/create","openApiOperationId":"/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/create_beta_input","exampleIds":["paths/~1orders~1create/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1create/post/requestBody/content/application~1json/examples/car_example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/create_beta_input","exampleIds":["paths/~1orders~1create/post/requestBody/content/application~1json/examples/accommodation_example","paths/~1orders~1create/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":"The order was successfully created. The response includes the reservation details.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/create_beta_output","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/create_beta_output","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/missing_parameter"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/400/content/application~1json/examples/missing_parameter"]},{"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/server_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/500/content/application~1json/examples/server_error"]}],"pointer":"/paths/~1orders~1create/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/create_beta_output","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/create_beta_output","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/missing_parameter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/400/content/application~1json/examples/missing_parameter"]}}},{"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/server_error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1create/post/responses/500/content/application~1json/examples/server_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-beta/demand-api/orders/orders/details","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_508","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_508","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_508","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_508","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_508","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-beta/demand-api/orders/orders/details/accommodations","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_509","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_509","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_509","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_509","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_509","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-beta/demand-api/orders/orders/details/cars","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_510","exampleIds":["paths/~1orders~1details~1cars/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_510","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_510","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_510","exampleIds":["paths/~1orders~1details~1cars/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_510","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-beta/demand-api/orders/orders/details/flights","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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":"Car order terms & conditions","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/orders/cars-terms-and-conditions","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/orders/cars-terms-and-conditions","metadata":{"seo":{"title":"Car order terms & conditions","description":"Retrieve the full, structured terms and conditions for one or more car rental orders."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"cars-terms-and-conditions","name":"Car order terms & conditions","isWebhook":false,"pointer":"/paths/~1orders~1details~1cars~1terms-and-conditions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Car order terms & conditions","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 the full, structured terms and conditions for one or more car rental orders."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response contains "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hierarchical legal content"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" organised into chapters containing nested sections, clauses, sub-clauses, and clause options."},"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":"Use cases"},"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":"-Displaying full rental contract details to travellers."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-Providing terms and conditions on order detail pages."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-Recreating the booking voucher terms section."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-Supporting legal and compliance requirements."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Notes:"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-Include at least one order ID. Invalid IDs will return null."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-Language defaults to English if not specified or unsupported. Language uses an ISO 639-1 language code (for example en-gb)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-You can optionally filter the response to return only voucher-required terms."},"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1orders~1details~1cars~1terms-and-conditions/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/orders_cars_terms_and_conditions_input","exampleIds":["paths/~1orders~1details~1cars~1terms-and-conditions/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/orders_cars_terms_and_conditions_input","exampleIds":["paths/~1orders~1details~1cars~1terms-and-conditions/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1orders~1details~1cars~1terms-and-conditions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/orders/details/cars/terms-and-conditions","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/orders_cars_terms_and_conditions_input","exampleIds":["paths/~1orders~1details~1cars~1terms-and-conditions/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","500"],"pointer":"/orders/details/cars/terms-and-conditions","href":"orders/cars-terms-and-conditions","openApiOperationId":"cars-terms-and-conditions","summary":"Car order terms & conditions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/orders_cars_terms_and_conditions_input","exampleIds":["paths/~1orders~1details~1cars~1terms-and-conditions/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/orders_cars_terms_and_conditions_input","exampleIds":["paths/~1orders~1details~1cars~1terms-and-conditions/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 containing terms and conditions for requested orders. Invalid IDs return null.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/orders_cars_terms_and_conditions_output","exampleIds":["paths/~1orders~1details~1cars~1terms-and-conditions/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/orders_cars_terms_and_conditions_output","exampleIds":["paths/~1orders~1details~1cars~1terms-and-conditions/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~1terms-and-conditions/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1orders~1details~1cars~1terms-and-conditions/post/responses/400/content/application~1json/examples/invalid_parameter"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars~1terms-and-conditions/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1orders~1details~1cars~1terms-and-conditions/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~1terms-and-conditions/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars~1terms-and-conditions/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1orders~1details~1cars~1terms-and-conditions/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/orders_cars_terms_and_conditions_output","exampleIds":["paths/~1orders~1details~1cars~1terms-and-conditions/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/orders_cars_terms_and_conditions_output","exampleIds":["paths/~1orders~1details~1cars~1terms-and-conditions/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars~1terms-and-conditions/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1orders~1details~1cars~1terms-and-conditions/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~1terms-and-conditions/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1orders~1details~1cars~1terms-and-conditions/post/responses/400/content/application~1json/examples/invalid_parameter"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars~1terms-and-conditions/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~1terms-and-conditions/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/orders/details/cars/terms-and-conditions"},{"label":"Retrieve Car rental FAQs","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/orders/cars/faqs","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/orders/cars/faqs","metadata":{"seo":{"title":"Retrieve Car rental FAQs","description":"Returns a list of frequently asked questions (FAQs) and their answers related to car rentals. You can request one or more preferred languages using the languages parameter. If content is not available in any of the requested languages, the response defaults to English."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/cars/FAQs","name":"Retrieve Car rental FAQs","isWebhook":false,"pointer":"/paths/~1orders~1details~1cars~1faq/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve Car rental FAQs","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a list of frequently asked questions (FAQs) and their answers related to car rentals. You can request one or more preferred languages using the languages parameter.\nIf content is not available in any of the requested languages, the response defaults to English."},{"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1orders~1details~1cars~1faq/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FaqInput","exampleIds":["paths/~1orders~1details~1cars~1faq/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/FaqInput","exampleIds":["paths/~1orders~1details~1cars~1faq/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1orders~1details~1cars~1faq/post/requestBody","description":"Request parameters to retrieve FAQs"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/orders/details/cars/faq","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/FaqInput","exampleIds":["paths/~1orders~1details~1cars~1faq/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","500"],"pointer":"/orders/details/cars/faq","href":"orders/cars/faqs","openApiOperationId":"/cars/FAQs","summary":"Retrieve Car rental FAQs"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/FaqInput","exampleIds":["paths/~1orders~1details~1cars~1faq/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FaqInput","exampleIds":["paths/~1orders~1details~1cars~1faq/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 containing the list of FAQs and corresponding answers, returned in each requested language where available.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FaqOutput","exampleIds":["paths/~1orders~1details~1cars~1faq/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/FaqOutput","exampleIds":["paths/~1orders~1details~1cars~1faq/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~1faq/post/responses/400/content/application~1json/examples/invalid_parameter"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars~1faq/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~1faq/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars~1faq/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1orders~1details~1cars~1faq/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/FaqOutput","exampleIds":["paths/~1orders~1details~1cars~1faq/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FaqOutput","exampleIds":["paths/~1orders~1details~1cars~1faq/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars~1faq/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~1faq/post/responses/400/content/application~1json/examples/invalid_parameter"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars~1faq/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~1faq/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/orders/details/cars/faq"},{"label":"Live Car order details","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/orders/details/cars/live","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/orders/details/cars/live","metadata":{"seo":{"title":"Live Car order details","description":"Returns enriched, live car order details for a specific reservation, including vehicle, supplier, pricing, insurance, policy, and driver information."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/details/cars/live","name":"Live Car order details","isWebhook":false,"pointer":"/paths/~1orders~1details~1cars~1live/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Live Car order details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns enriched, live car order details for a specific reservation, including vehicle, supplier, pricing, insurance, policy, and driver information.\n\nThis endpoint is currently available as a beta feature for evaluation and testing purposes.\n\nThe endpoint is temporary and will be deprecated once its functionality is incorporated into the primary /orders/details/cars endpoint."},{"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1orders~1details~1cars~1live/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_511","exampleIds":["paths/~1orders~1details~1cars~1live/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_511","exampleIds":["paths/~1orders~1details~1cars~1live/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1orders~1details~1cars~1live/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/orders/details/cars/live","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_511","exampleIds":["paths/~1orders~1details~1cars~1live/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","500"],"pointer":"/orders/details/cars/live","href":"orders/details/cars/live","openApiOperationId":"/details/cars/live","summary":"Live Car order details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"schema_511","exampleIds":["paths/~1orders~1details~1cars~1live/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_511","exampleIds":["paths/~1orders~1details~1cars~1live/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":"Live car order details retrieved successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ordersDetailsCarsOutput","exampleIds":["paths/~1orders~1details~1cars~1live/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/ordersDetailsCarsOutput","exampleIds":["paths/~1orders~1details~1cars~1live/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~1live/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1orders~1details~1cars~1live/post/responses/400/content/application~1json/examples/invalid_parameter"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars~1live/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1orders~1details~1cars~1live/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~1live/post/responses/500/content/application~1json/examples/internal_error"]}},"schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars~1live/post/responses/500/content/application~1json/examples/internal_error"]}],"pointer":"/paths/~1orders~1details~1cars~1live/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ordersDetailsCarsOutput","exampleIds":["paths/~1orders~1details~1cars~1live/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ordersDetailsCarsOutput","exampleIds":["paths/~1orders~1details~1cars~1live/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars~1live/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1orders~1details~1cars~1live/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~1live/post/responses/400/content/application~1json/examples/missing_parameter","paths/~1orders~1details~1cars~1live/post/responses/400/content/application~1json/examples/invalid_parameter"]}}},{"code":"500","schemaId":"components/schemas/error_response","exampleIds":["paths/~1orders~1details~1cars~1live/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~1live/post/responses/500/content/application~1json/examples/internal_error"]}}}],"examples":[]}]}]}]},"httpPath":"/orders/details/cars/live"},{"label":"Modify an order","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/orders/orders/modify","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_512"}},"schemaId":"schema_512","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_512"}},"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_512","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_512"}},"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_513"}},"schemaId":"schema_513"}],"pointer":"/paths/~1orders~1modify/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_513","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_513"}}}],"examples":[]}]}]}]},"httpPath":"/orders/modify"},{"label":"Preview order modification","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/orders/orders/modify/preview","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/orders/orders/modify/preview","metadata":{"seo":{"title":"Preview order modification","description":"Preview whether a requested modification can be applied to an order and retrieve the expected cost impact before confirming the change."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"/orders/modify/preview","name":"Preview order modification","isWebhook":false,"pointer":"/paths/~1orders~1modify~1preview/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Preview order modification","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":"Preview whether a requested modification can be applied to an order and retrieve the expected cost impact before confirming the change."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to:"},"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":"Check if the requested modification can be applied."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Review the updated total cost (for accommodation changes)."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: This endpoint does not apply any changes to the order."},"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1orders~1modify~1preview/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_514","exampleIds":["paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/accommodation_dates_example","paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/accommodation_room_example","paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/payment_card_example"]}},"schemaId":"schema_514","exampleIds":["paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/accommodation_dates_example","paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/accommodation_room_example","paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/payment_card_example"],"pointer":"/paths/~1orders~1modify~1preview/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/orders/modify/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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_514","exampleIds":["paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/accommodation_dates_example","paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/accommodation_room_example","paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/payment_card_example"]}},"responseCodes":["200","400","500"],"pointer":"/orders/modify/preview","href":"orders/orders/modify/preview","openApiOperationId":"/orders/modify/preview","summary":"Preview order modification"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"schema_514","exampleIds":["paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/accommodation_dates_example","paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/accommodation_room_example","paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/payment_card_example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_514","exampleIds":["paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/accommodation_dates_example","paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/accommodation_room_example","paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/payment_card_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 preview response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_515"}},"schemaId":"schema_515"},{"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":"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~1modify~1preview/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_515","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_515"}}},{"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/modify/preview"},{"label":"Cancel a travel service","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/orders/orders/cancel","routeSlug":"/demand/docs/open-api/3.2-beta/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_506","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_506"}],"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/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/details/cars/terms-and-conditions","summary":"Car order terms & conditions","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/cars-terms-and-conditions","deprecated":false},{"title":"/orders/details/cars/faq","summary":"Retrieve Car rental FAQs","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/cars/faqs","deprecated":false},{"title":"/orders/details/cars/live","summary":"Live Car order details","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/details/cars/live","deprecated":false},{"title":"/orders/modify","summary":"Modify an order","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/orders/modify","deprecated":false},{"title":"/orders/modify/preview","summary":"Preview order modification","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/orders/modify/preview","deprecated":false},{"title":"/orders/cancel","summary":"Cancel a travel service","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/orders/cancel","deprecated":false}]}]}]}]}},{"type":"separator","label":"Messaging","content":null},{"type":"group","label":"Messages","link":"/demand/docs/open-api/3.2-beta/demand-api/messages","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/messages","items":[{"label":"Send a message","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/messages/send","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/messages/send","metadata":{"seo":{"title":"Send a message","description":"Use this endpoint to send a message to a conversation. You can include plain text and optionally attach a file using an attachment ID from a previous upload."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"send","name":"Send a message","isWebhook":false,"pointer":"/paths/~1messages~1send/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Send a message","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 send a message to a conversation. You can include plain text and optionally attach a file using an attachment ID from a previous upload."},{"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1messages~1send/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/send_input","exampleIds":["paths/~1messages~1send/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/send_input","exampleIds":["paths/~1messages~1send/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1messages~1send/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/messages/send","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/send_input","exampleIds":["paths/~1messages~1send/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/messages/send","href":"messages/send","openApiOperationId":"send","summary":"Send a message"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/send_input","exampleIds":["paths/~1messages~1send/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/send_input","exampleIds":["paths/~1messages~1send/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/send_output","exampleIds":["paths/~1messages~1send/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/send_output","exampleIds":["paths/~1messages~1send/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1messages~1send/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/send_output","exampleIds":["paths/~1messages~1send/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/send_output","exampleIds":["paths/~1messages~1send/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/messages/send"},{"label":"Retrieve latest messages","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/messages/latest","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/messages/latest","metadata":{"seo":{"title":"Retrieve latest messages","description":"Use this endpoint to fetch the most recent messages, including messages sent by both the property and the guest. By default, up to 100 messages are returned in reverse chronological order (newest first)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"latest","name":"Retrieve latest messages","isWebhook":false,"pointer":"/paths/~1messages~1latest/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve latest messages","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 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"fetch the most recent messages"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", including messages sent by both the property and the guest. By default, up to "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"100 messages"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are returned in reverse chronological order (newest first)."},"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":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Synchronising message threads"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" between your system and the Booking.com platform."},"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":"Polling for updates"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to detect new messages since your last 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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1messages~1latest/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/latest_input","exampleIds":["paths/~1messages~1latest/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/latest_input","exampleIds":["paths/~1messages~1latest/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1messages~1latest/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/messages/latest","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/latest_input","exampleIds":["paths/~1messages~1latest/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/messages/latest","href":"messages/latest","openApiOperationId":"latest","summary":"Retrieve latest messages"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/latest_input","exampleIds":["paths/~1messages~1latest/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/latest_input","exampleIds":["paths/~1messages~1latest/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/latest_output","exampleIds":["paths/~1messages~1latest/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/latest_output","exampleIds":["paths/~1messages~1latest/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1messages~1latest/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/latest_output","exampleIds":["paths/~1messages~1latest/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/latest_output","exampleIds":["paths/~1messages~1latest/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/messages/latest"},{"label":"Confirm message receipt","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/messages/confirm","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/messages/confirm","metadata":{"seo":{"title":"Confirm message receipt","description":"Use this endpoint to confirm receipt of messages. Confirmation is required in order to receive new messages from POST /messages/latest."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"confirm","name":"Confirm message receipt","isWebhook":false,"pointer":"/paths/~1messages~1latest~1confirm/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Confirm message receipt","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 confirm receipt of messages. Confirmation is required in order to receive new messages from POST /messages/latest."},{"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1messages~1latest~1confirm/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/confirm_input","exampleIds":["paths/~1messages~1latest~1confirm/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/confirm_input","exampleIds":["paths/~1messages~1latest~1confirm/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1messages~1latest~1confirm/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/messages/latest/confirm","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/confirm_input","exampleIds":["paths/~1messages~1latest~1confirm/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/messages/latest/confirm","href":"messages/confirm","openApiOperationId":"confirm","summary":"Confirm message receipt"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/confirm_input","exampleIds":["paths/~1messages~1latest~1confirm/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/confirm_input","exampleIds":["paths/~1messages~1latest~1confirm/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/confirm_output","exampleIds":["paths/~1messages~1latest~1confirm/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/confirm_output","exampleIds":["paths/~1messages~1latest~1confirm/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1messages~1latest~1confirm/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/confirm_output","exampleIds":["paths/~1messages~1latest~1confirm/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/confirm_output","exampleIds":["paths/~1messages~1latest~1confirm/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/messages/latest/confirm"},{"label":"Retrieve attachment metadata","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/messages/metadata","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/messages/metadata","metadata":{"seo":{"title":"Retrieve attachment metadata","description":"Use this endpoint to get basic information about an uploaded file, such as its name, type, and size."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"metadata","name":"Retrieve attachment metadata","isWebhook":false,"pointer":"/paths/~1messages~1attachments~1metadata/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve attachment metadata","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 get basic information about an uploaded file, such as its name, type, and size."},{"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1messages~1attachments~1metadata/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/download_input","exampleIds":["paths/~1messages~1attachments~1metadata/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/download_input","exampleIds":["paths/~1messages~1attachments~1metadata/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1messages~1attachments~1metadata/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/messages/attachments/metadata","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/download_input","exampleIds":["paths/~1messages~1attachments~1metadata/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/messages/attachments/metadata","href":"messages/metadata","openApiOperationId":"metadata","summary":"Retrieve attachment metadata"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/download_input","exampleIds":["paths/~1messages~1attachments~1metadata/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/download_input","exampleIds":["paths/~1messages~1attachments~1metadata/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/metadata_output","exampleIds":["paths/~1messages~1attachments~1metadata/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/metadata_output","exampleIds":["paths/~1messages~1attachments~1metadata/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1messages~1attachments~1metadata/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/metadata_output","exampleIds":["paths/~1messages~1attachments~1metadata/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/metadata_output","exampleIds":["paths/~1messages~1attachments~1metadata/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/messages/attachments/metadata"}],"content":{"contentType":"group","meta":{"name":"Messages"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Messages","showPageActions":true},{"nodeType":"markdoc","content":"This API collection enables two-way communication between guests and properties. Use these endpoints to send and receive messages, include attachments, follow conversations, and more."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/messages/send","summary":"Send a message","prefix":{"name":"post","color":"post"},"badges":[],"link":"/messages/send","deprecated":false},{"title":"/messages/latest","summary":"Retrieve latest messages","prefix":{"name":"post","color":"post"},"badges":[],"link":"/messages/latest","deprecated":false},{"title":"/messages/latest/confirm","summary":"Confirm message receipt","prefix":{"name":"post","color":"post"},"badges":[],"link":"/messages/confirm","deprecated":false},{"title":"/messages/attachments/metadata","summary":"Retrieve attachment metadata","prefix":{"name":"post","color":"post"},"badges":[],"link":"/messages/metadata","deprecated":false}]}]}]}]}},{"type":"group","label":"Conversations","link":"/demand/docs/open-api/3.2-beta/demand-api/conversations","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/conversations","items":[{"label":"Retrieve a conversation","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/conversations/conversations","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/conversations/conversations","metadata":{"seo":{"title":"Retrieve a conversation","description":"Use this endpoint to retrieve a conversation available to the authenticated user."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"conversations","name":"Retrieve a conversation","isWebhook":false,"pointer":"/paths/~1messages~1conversations/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a conversation","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 a conversation available to the authenticated user."},{"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1messages~1conversations/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/conversations_input","exampleIds":["paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/0"]}},"schemaId":"components/schemas/conversations_input","exampleIds":["paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/0"],"pointer":"/paths/~1messages~1conversations/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/messages/conversations","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/conversations_input","exampleIds":["paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/0"]}},"responseCodes":["200"],"pointer":"/messages/conversations","href":"conversations/conversations","openApiOperationId":"conversations","summary":"Retrieve a conversation"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/conversations_input","exampleIds":["paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/0"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/conversations_input","exampleIds":["paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/0"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Conversation retrieved successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/conversations_output","exampleIds":["paths/~1messages~1conversations/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/conversations_output","exampleIds":["paths/~1messages~1conversations/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1messages~1conversations/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/conversations_output","exampleIds":["paths/~1messages~1conversations/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/conversations_output","exampleIds":["paths/~1messages~1conversations/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/messages/conversations"}],"content":{"contentType":"group","meta":{"name":"Conversations"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Conversations","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/messages/conversations","summary":"Retrieve a conversation","prefix":{"name":"post","color":"post"},"badges":[],"link":"/conversations/conversations","deprecated":false}]}]}]}]}},{"type":"group","label":"Attachments","link":"/demand/docs/open-api/3.2-beta/demand-api/attachments","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/attachments","items":[{"label":"Upload attachment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/attachments/upload","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/attachments/upload","metadata":{"seo":{"title":"Upload attachment","description":"Use this endpoint to upload a file to be used as a message attachment. The response includes an attachment ID to reference when sending messages."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"upload","name":"Upload attachment","isWebhook":false,"pointer":"/paths/~1messages~1attachments~1upload/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Upload attachment","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 upload a file to be used as a message attachment. The response includes an attachment ID to reference when sending messages."},{"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1messages~1attachments~1upload/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/upload_input","exampleIds":["paths/~1messages~1attachments~1upload/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/upload_input","exampleIds":["paths/~1messages~1attachments~1upload/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1messages~1attachments~1upload/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/messages/attachments/upload","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/upload_input","exampleIds":["paths/~1messages~1attachments~1upload/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/messages/attachments/upload","href":"attachments/upload","openApiOperationId":"upload","summary":"Upload attachment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/upload_input","exampleIds":["paths/~1messages~1attachments~1upload/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/upload_input","exampleIds":["paths/~1messages~1attachments~1upload/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/upload_output","exampleIds":["paths/~1messages~1attachments~1upload/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/upload_output","exampleIds":["paths/~1messages~1attachments~1upload/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1messages~1attachments~1upload/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/upload_output","exampleIds":["paths/~1messages~1attachments~1upload/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/upload_output","exampleIds":["paths/~1messages~1attachments~1upload/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/messages/attachments/upload"},{"label":"Download attachment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/open-api/3.2-beta/demand-api/attachments/download","routeSlug":"/demand/docs/open-api/3.2-beta/demand-api/attachments/download","metadata":{"seo":{"title":"Download attachment","description":"Use this endpoint to retrieve a file that was attached to a message. The response includes the file in a base64-encoded format."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"download","name":"Download attachment","isWebhook":false,"pointer":"/paths/~1messages~1attachments~1download/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Download attachment","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 a file that was attached to a message. The response includes the file in a base64-encoded format."},{"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_506","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1messages~1attachments~1download/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/download_input","exampleIds":["paths/~1messages~1attachments~1download/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/download_input","exampleIds":["paths/~1messages~1attachments~1download/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1messages~1attachments~1download/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/messages/attachments/download","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_506"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/download_input","exampleIds":["paths/~1messages~1attachments~1download/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/messages/attachments/download","href":"attachments/download","openApiOperationId":"download","summary":"Download attachment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.2"},{"url":"https://demandapi-sandbox.booking.com/3.2"}],"schemaId":"components/schemas/download_input","exampleIds":["paths/~1messages~1attachments~1download/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/download_input","exampleIds":["paths/~1messages~1attachments~1download/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/download_output","exampleIds":["paths/~1messages~1attachments~1download/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/download_output","exampleIds":["paths/~1messages~1attachments~1download/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1messages~1attachments~1download/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/download_output","exampleIds":["paths/~1messages~1attachments~1download/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/download_output","exampleIds":["paths/~1messages~1attachments~1download/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/messages/attachments/download"}],"content":{"contentType":"group","meta":{"name":"Attachments"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Attachments","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/messages/attachments/upload","summary":"Upload attachment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/attachments/upload","deprecated":false},{"title":"/messages/attachments/download","summary":"Download attachment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/attachments/download","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/smartSearchInput":{"id":"components/schemas/smartSearchInput","kind":"json-schema","title":"AccommodationsSmartSearchInput","data":{"title":"AccommodationsSmartSearchInput","type":"object","properties":{"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"},"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"},"search_query":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Natural language query describing the traveller’s accommodation preferences, intent, or desired experience. The query is interpreted semantically and may match accommodation features, amenities, location context, property types, traveller intent, or ranking signals."},"children":[]}]}]}],"type":"string","minLength":3,"maxLength":300},"sort":{"description":"Controls how accommodation results are ordered in the response.","type":"object","properties":{"by":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Primary sorting strategy applied to the search results. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"distance"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"coordinates"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to rank accommodations by proximity."},"children":[]}]}]}],"type":"string","enum":["distance","price","review_score","stars"]},"direction":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sort direction applied to the selected sorting strategy. Descending order is not supported when sorting by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"distance"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string","enum":["ascending","descending"]}}}},"required":["booker","checkin","checkout","guests","search_query"]}},"components/schemas/smartSearchOutput":{"id":"components/schemas/smartSearchOutput","kind":"json-schema","title":"AccommodationsSmartSearchOutput","data":{"title":"AccommodationsSmartSearchOutput","description":"Search results matching the traveller query and structured search criteria.","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","null"]}}}}}},"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/coordinatesInput":{"id":"components/schemas/coordinatesInput","kind":"json-schema","title":"coordinatesInput","data":{"description":"Geographic coordinates used to search for attractions near a specific location.","type":"object","properties":{"latitude":{"description":"Latitude of the location.","type":"number","format":"double","minimum":-90,"maximum":90,"example":52.3676},"longitude":{"description":"Longitude of the location.","type":"number","format":"double","minimum":-180,"maximum":180,"example":4.9041},"radius":{"description":"Maximum distance in kilometers from the specified coordinates. Defaults to 10 km if not provided.","type":"number","format":"double","default":10,"exclusiveMinimum":0}},"required":["latitude","longitude"]}},"components/schemas/pricing_currencyId":{"id":"components/schemas/pricing_currencyId","kind":"json-schema","title":"pricing_currencyId","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217 currency code. The list of supported currencies can be retrieved from "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/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":[]}]}]}],"type":"string","pattern":"[A-Z]{3}"}},"components/schemas/datesInput":{"id":"components/schemas/datesInput","kind":"json-schema","title":"datesInput","data":{"description":"Date range used to search for attraction availability.","type":"object","properties":{"start_date":{"description":"Start date of the availability period, in ISO 8601 date format (YYYY-MM-DD).","type":"string","format":"date"},"end_date":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"End date of the availability period, in ISO 8601 date format (YYYY-MM-DD). Can be the same as start_date for single-day attractions."},"children":[]}]}]}],"type":"string","format":"date"}},"required":["start_date","end_date"]}},"components/schemas/filtersInput":{"id":"components/schemas/filtersInput","kind":"json-schema","title":"filtersInput","data":{"description":"Optional filters to narrow down attraction search results.","type":"object","properties":{"rating":{"type":"object","description":"Filters based on guest review ratings.","properties":{"minimum_review_score":{"description":"Minimum average guest review score, on a scale from 0 to 5.","type":"number","format":"double","minimum":0,"maximum":5},"minimum_review_count":{"description":"Minimum number of guest reviews required for an attraction to be included.","type":"integer","format":"int64","minimum":0}}},"supported_languages":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter results by supported languages. Uses "},"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 codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in lowercase, for example \"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":"array","items":{"type":"string","pattern":"^[a-z]{2}(-[a-z]{2})?$"}},"categories":{"description":"Filter results by one or more attraction category IDs. Only attractions that match at least one of the specified categories are returned. If an invalid or unsupported category ID is provided, the search response will contain no results.","type":"array","items":{"type":"string","enum":["PTTV32SGqJEv","PTTV3YDywxmN","PTTV3bWrrud5","PTTV3cuXCgPo","PTTV3jCHmADM","PTTV3t1Fvjp9","PTTV3y2qdlBL"],"x-enumDescriptions":{"PTTV32SGqJEv":"Tours","PTTV3YDywxmN":"Services and rentals","PTTV3bWrrud5":"Workshops and classes","PTTV3cuXCgPo":"Museums, arts and culture","PTTV3jCHmADM":"Nature and outdoor","PTTV3t1Fvjp9":"Entertainment and tickets","PTTV3y2qdlBL":"Food and drink"}}}}}},"components/schemas/sort":{"id":"components/schemas/sort","kind":"json-schema","title":"sort","data":{"description":"Sorting options that control the order of the search results.","type":"object","properties":{"by":{"description":"Defines how the search results are sorted.","type":"string","enum":["highest_review_score","highest_weighted_review_score","lowest_price_first","most_popular","nearest_location","trending"],"x-enumDescriptions":{"highest_review_score":"Shows products with the highest average review score first.","highest_weighted_review_score":"Orders products by a weighted review score. A product's priority increases with a higher rating, with the weight based on the number of reviews it has.","lowest_price_first":"Displays products with the lowest price first.","most_popular":"Orders products based on the highest number of reservations in the last 30 days.","nearest_location":"When using the coordinates search criterion, displays products closest to the provided search coordinates first.","trending":"Orders products based on predicted scores from a machine learning model."}}}}},"components/schemas/SearchBase":{"id":"components/schemas/SearchBase","kind":"json-schema","title":"SearchBase","data":{"type":"object","properties":{"attractions":{"description":"List of attraction IDs to search for. When provided, results are limited to these specific attractions.","type":"array","items":{"type":"string"},"minimum":1,"maximum":100},"cities":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search for attractions located in one or more cities. Use city IDs obtained from "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/open-api/demand-api/commonlocations/common/locations/cities"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/common/location/cities"},"children":[]}]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/locations_cityId"},"minimum":1,"maximum":5},"coordinates":{"$ref":"#/components/schemas/coordinatesInput"},"countries":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search for attractions located in one or more countries. Use ISO 3166-1 alpha-2 country codes obtained from "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/demand/docs/open-api/demand-api/commonlocations/common/locations/countries"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/common/locations/countries"},"children":[]}]}]}]}],"type":"array","items":{"type":"string","pattern":"^[a-z]{2}$","example":"nl"},"minimum":1,"maximum":3},"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 ISO 4217 currency code that defines the currency used for pricing in the response, for example: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"EUR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". n/See "},"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":" for the full list of supported currencies."},"children":[]}]}]}],"$ref":"#/components/schemas/pricing_currencyId"},"dates":{"$ref":"#/components/schemas/datesInput"},"filters":{"$ref":"#/components/schemas/filtersInput"},"page":{"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. Omit this parameter on the first request and use the value returned in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"metadata.next_page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for subsequent pages."},"children":[]}]}]}],"type":"string"},"rows":{"$ref":"#/components/schemas/maximumResults","default":20},"sort":{"$ref":"#/components/schemas/sort"}},"required":["currency","dates"]}},"components/schemas/attractionsSearchInput":{"id":"components/schemas/attractionsSearchInput","kind":"json-schema","title":"attractionsSearchInput","data":{"oneOf":[{"title":"Search by Attractions","allOf":[{"$ref":"#/components/schemas/SearchBase"},{"type":"object","required":["attractions"],"properties":{"cities":false,"countries":false,"coordinates":false}}]},{"title":"Search by Cities","allOf":[{"$ref":"#/components/schemas/SearchBase"},{"type":"object","required":["cities"],"properties":{"attractions":false,"countries":false,"coordinates":false}}]},{"title":"Search by Countries","allOf":[{"$ref":"#/components/schemas/SearchBase"},{"type":"object","required":["countries"],"properties":{"attractions":false,"cities":false,"coordinates":false}}]},{"title":"Search by Coordinates","allOf":[{"$ref":"#/components/schemas/SearchBase"},{"type":"object","required":["coordinates"],"properties":{"attractions":false,"cities":false,"countries":false}}]}]}},"components/schemas/attractionId":{"id":"components/schemas/attractionId","kind":"json-schema","title":"attractionId","data":{"description":"Uniquely identifies an attraction.","type":"string"}},"components/schemas/pricing_monetaryAmount":{"id":"components/schemas/pricing_monetaryAmount","kind":"json-schema","title":"pricing_monetaryAmount","data":{"type":"number","multipleOf":0.01,"exclusiveMinimum":0}},"components/schemas/attractionPrice":{"id":"components/schemas/attractionPrice","kind":"json-schema","title":"attractionPrice","data":{"description":"Pricing information for the cheapest available adult offer for the attraction.","type":"object","properties":{"currency":{"description":"Currency in which the price is returned.","$ref":"#/components/schemas/pricing_currencyId"},"total":{"$ref":"#/components/schemas/pricing_monetaryAmount"}}}},"components/schemas/urls":{"id":"components/schemas/urls","kind":"json-schema","title":"urls","data":{"type":"object","description":"Platform-specific URLs for viewing this item.","example":{"app":{"detail":"booking://attractions/product?slug=prvlvlwpbs1m-moco-museum-amsterdam-official-tickets&aid=956509","search_results":"booking://attractions/searchresults?ufi=-2140479&pinned_product_id=PRvlvlWPbS1M&aid=956509"},"web":{"detail":"https://www.booking.com/attractions/nl/prvlvlwpbs1m-moco-museum-amsterdam-official-tickets.en-gb.html?selected_currency=EUR&aid=956509","search_results":"https://www.booking.com/attractions/searchresults/nl/amsterdam.en-gb.html?dest_id=-2140479&pinned_product=PRvlvlWPbS1M&selected_currency=EUR&aid=956509"}},"properties":{"app":{"type":"object","properties":{"detail":{"description":"URL to view the attraction detail page in the app.","type":"string","format":"uri"},"search_results":{"description":"URL to view the attraction within search results in the app.","type":"string","format":"uri"}}},"web":{"type":"object","properties":{"detail":{"description":"URL to view the attraction detail page on the website.","type":"string","format":"uri"},"search_results":{"description":"URL to view the attraction within the website search results page.","type":"string","format":"uri"}}}}}},"components/schemas/attraction":{"id":"components/schemas/attraction","kind":"json-schema","title":"attraction","data":{"type":"object","description":"Basic information about an attraction returned by the search.","properties":{"id":{"description":"Unique identifier of the attraction.","$ref":"#/components/schemas/attractionId"},"free_cancellation":{"description":"Indicates whether the attraction offers free cancellation.","type":"boolean"},"price":{"$ref":"#/components/schemas/attractionPrice"},"urls":{"$ref":"#/components/schemas/urls"}}}},"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/attractionsSearchOutput":{"id":"components/schemas/attractionsSearchOutput","kind":"json-schema","title":"attractionsSearchOutput","data":{"type":"object","description":"Response object containing the list of matching attractions, pagination metadata, and a unique request identifier.","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/attraction"}},"metadata":{"$ref":"#/components/schemas/metadata"},"request_id":{"$ref":"#/components/schemas/requestId"}}}},"components/schemas/DetailsBase":{"id":"components/schemas/DetailsBase","kind":"json-schema","title":"AttractionsDetailsBase","data":{"title":"AttractionsDetailsBase","type":"object","properties":{"attractions":{"description":"List of attraction IDs to retrieve details for.","type":"array","items":{"$ref":"#/components/schemas/attractionId"},"minItems":1,"maxItems":100},"cities":{"description":"Search by city ID. Retrieve the full list of supported cities IDs from the /common/location/cities endpoint.","type":"array","minItems":1,"maxItems":5,"items":{"$ref":"#/components/schemas/locations_cityId"}},"countries":{"description":"Search by country code. Retrieve the full list of supported country codes from the /common/locations/countries endpoint. Maximum 3 countries per request.","type":"array","minItems":1,"maxItems":3,"items":{"type":"string","pattern":"^[a-z]{2}$","example":"nl"}},"languages":{"description":"The language in which attraction details are returned. Must be an IETF BCP 47 language code (e.g., 'fr').","type":"array","items":{"type":"string","pattern":"[a-z]{2}(-[a-z]{2})?"},"maxItems":1,"default":["en-gb"]},"page":{"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":"metadata.next_page"},"children":[]}]}]}],"type":"string"},"rows":{"$ref":"#/components/schemas/maximumResults","default":20,"minimum":10,"maximum":500}}}},"components/schemas/attractionsInput":{"id":"components/schemas/attractionsInput","kind":"json-schema","title":"AttractionsDetailsInput","data":{"title":"AttractionsDetailsInput","oneOf":[{"title":"Query by Attractions","allOf":[{"$ref":"#/components/schemas/DetailsBase"},{"type":"object","required":["attractions"],"properties":{"cities":false,"countries":false}}]},{"title":"Query by Cities","allOf":[{"$ref":"#/components/schemas/DetailsBase"},{"type":"object","required":["cities"],"properties":{"attractions":false,"countries":false}}]},{"title":"Query by Countries","allOf":[{"$ref":"#/components/schemas/DetailsBase"},{"type":"object","required":["countries"],"properties":{"attractions":false,"cities":false}}]}]}},"components/schemas/attractionImage":{"id":"components/schemas/attractionImage","kind":"json-schema","title":"AttractionsImageOutput","data":{"title":"AttractionsImageOutput","description":"Image information.","type":"object","properties":{"url":{"description":"URL of the image.","type":"string","format":"uri"}}}},"components/schemas/attractionCoordinates":{"id":"components/schemas/attractionCoordinates","kind":"json-schema","title":"AttractionsCoordinatesOutput","data":{"title":"AttractionsCoordinatesOutput","description":"Geographic coordinates.","type":"object","properties":{"latitude":{"description":"The latitude.","type":"number"},"longitude":{"description":"The longitude.","type":"number"}}}},"components/schemas/attractionLocation":{"id":"components/schemas/attractionLocation","kind":"json-schema","title":"AttractionsLocationOutput","data":{"title":"AttractionsLocationOutput","description":"Location details for the attraction.","type":"object","properties":{"address":{"description":"The address.","type":"string"},"city":{"$ref":"#/components/schemas/locations_cityId"},"coordinates":{"$ref":"#/components/schemas/attractionCoordinates"},"country":{"$ref":"#/components/schemas/locations_countryId"},"post_code":{"description":"The post code.","type":"string"},"type":{"description":"The type of location.","type":"string","enum":["arrival","attraction","departure","entrance","guest_pickup","meeting","pickup"],"x-enumDescriptions":["arrival: The location where the tour or experience ends.","attraction: The location where the experience takes place or can be accessed, such as a landmark, shop, museum, or restaurant.","departure: The location where the tour or experience starts, typically for day trips or multi-stop tours.","entrance: The entrance point for an attraction when it has multiple access points or entry locations.",[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"guest_pickup: The location where travellers are collected before the tour or experience begins."},"children":[]}]}]}],"meeting: The designated meeting point for participants before starting the experience, often used for guided tours.","pickup: The location where travellers can collect their tickets before joining the experience."]}}}},"components/schemas/localisedString":{"id":"components/schemas/localisedString","kind":"json-schema","title":"localisedString","data":{"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/details_rating":{"id":"components/schemas/details_rating","kind":"json-schema","title":"AttractionsDetailsRatingOutput","data":{"title":"AttractionsDetailsRatingOutput","description":"User rating information.","type":"object","properties":{"number_of_reviews":{"description":"Number of ratings.","type":"integer","minimum":0},"score":{"description":"Average rating value.","type":"number","minimum":0,"maximum":5}}}},"components/schemas/attractionDetails":{"id":"components/schemas/attractionDetails","kind":"json-schema","title":"AttractionsDetailsDataOutput","data":{"title":"AttractionsDetailsDataOutput","description":"All static information related to an attraction.","type":"object","properties":{"id":{"description":"Uniquely identifies the attraction.","$ref":"#/components/schemas/attractionId"},"badges":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Badges that indicate notable selling points of the attraction. Examples include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"best_seller"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"guest_pickup"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"type":"string","enum":["best_seller","direct_admission","free_cancellation","guest_pickup","itinerary_duration","itinerary_private_tour","itinerary_skip_the_line","new_product","service_animals_allowed"]}},"categories":{"description":"Categories to which the attraction belongs.","type":"array","items":{"type":"string","enum":["tours","travel_services_rental","workshop_classes","museums_arts_culture","nature_outdoor","entertainment_tickets","food_drinks"]}},"duration":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Estimated time spent in attraction (ISO 8601 duration format).  Example: PT2H = 2 hours."},"children":[]}]}]}],"type":"string","example":"PT2H","pattern":"^P(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$"},"photos":{"description":"Images of the attraction.","type":"array","items":{"$ref":"#/components/schemas/attractionImage"}},"locations":{"description":"Location information for the attraction.","type":"array","items":{"$ref":"#/components/schemas/attractionLocation"}},"long_description":{"description":"Detailed description of the attraction.","$ref":"#/components/schemas/localisedString"},"name":{"description":"The attraction's display name.","$ref":"#/components/schemas/localisedString"},"ratings":{"$ref":"#/components/schemas/details_rating"},"supported_languages":{"description":"List of languages this attraction is available in. For example: A city tour available in Spanish and German.","type":"array","items":{"type":"string","pattern":"[a-z]{2}(-[a-z]{2})?"}},"urls":{"$ref":"#/components/schemas/urls"}}}},"components/schemas/attractionsOutput":{"id":"components/schemas/attractionsOutput","kind":"json-schema","title":"AttractionsDetailsOutput","data":{"title":"AttractionsDetailsOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/attractionDetails"}},"metadata":{"$ref":"#/components/schemas/metadata"}}}},"components/schemas/schemas-input":{"id":"components/schemas/schemas-input","kind":"json-schema","title":"AttractionsReviewsInput","data":{"title":"AttractionsReviewsInput","type":"object","properties":{"attraction":{"description":"Uniquely identifies an attraction to retrieve reviews for.","$ref":"#/components/schemas/attractionId"},"language":{"description":"The language for reviews content. IETF BCP 47 language code.","type":"string","pattern":"[a-z]{2}(-[a-z]{2})?"},"page":{"$ref":"#/components/schemas/page"},"rows":{"description":"The maximum number of results to return per page.","type":"integer","multipleOf":10,"minimum":10,"maximum":100,"default":10}},"required":["attraction"]}},"components/schemas/review":{"id":"components/schemas/review","kind":"json-schema","title":"AttractionsReviewDataOutput","data":{"title":"AttractionsReviewDataOutput","description":"List of reviews for the requested attraction.","type":"object","properties":{"attraction":{"description":"Unique identifier of the attraction.","$ref":"#/components/schemas/attractionId"},"id":{"description":"Unique identifier of the review.","type":"string"},"author":{"description":"Name of the review author.","type":"string"},"author_country_code":{"description":"ISO 3166 country code of the review author.","$ref":"#/components/schemas/locations_countryId"},"rating":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Rating given in the review (1–5 scale)."},"children":[]}]}]}],"type":"integer","minimum":1,"maximum":5},"text":{"description":"Text content of the review.","type":"string"},"language":{"description":"Language of the review content. IETF BCP 47 language code.","type":"string","pattern":"[a-z]{2}(-[a-z]{2})?"},"date":{"description":"Date when the review was submitted.","type":"string","format":"date"}}}},"components/schemas/schemas-output":{"id":"components/schemas/schemas-output","kind":"json-schema","title":"AttractionsReviewsOutput","data":{"title":"AttractionsReviewsOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/review"}},"metadata":{"$ref":"#/components/schemas/metadata"}}}},"components/schemas/reviewScores_input":{"id":"components/schemas/reviewScores_input","kind":"json-schema","title":"AttractionsScoresInput","data":{"title":"AttractionsScoresInput","type":"object","properties":{"attractions":{"description":"Uniquely identifies attractions to retrieve review scores for.","type":"array","items":{"$ref":"#/components/schemas/attractionId"},"minItems":1,"maxItems":1}},"required":["attractions"]}},"components/schemas/scoreDetail":{"id":"components/schemas/scoreDetail","kind":"json-schema","title":"AttractionsScoreDetail","data":{"title":"AttractionsScoreDetail","type":"object","properties":{"number_of_reviews":{"description":"Number of reviews contributing to this score.","type":"integer","minimum":0},"score":{"description":"Average score for this category.","type":"number","minimum":0,"maximum":5,"example":4.5}}}},"components/schemas/reviewScores_breakdown":{"id":"components/schemas/reviewScores_breakdown","kind":"json-schema","title":"AttractionsScoresBreakdown","data":{"title":"AttractionsScoresBreakdown","description":"Detailed breakdown of review scores for different aspects of the attraction.","type":"object","properties":{"easy_to_access":{"description":"Accessibility rating based on location, transport, and convenience","$ref":"#/components/schemas/scoreDetail"},"facilities_rating":{"description":"Assessment of facilities such as restrooms, seating areas, or amenities","$ref":"#/components/schemas/scoreDetail"},"quality_of_service":{"description":"Rating of staff professionalism, kindness, and helpfulness.","$ref":"#/components/schemas/scoreDetail"},"value_of_experience":{"description":"Users' perception of the overall value for money.","$ref":"#/components/schemas/scoreDetail"}}}},"components/schemas/attractionScore":{"id":"components/schemas/attractionScore","kind":"json-schema","title":"AttractionScore","data":{"title":"AttractionScore","type":"object","properties":{"id":{"description":"The unique identifier of the attraction.","$ref":"#/components/schemas/attractionId"},"breakdown":{"$ref":"#/components/schemas/reviewScores_breakdown"}},"required":["id","breakdown"]}},"components/schemas/reviewScores_output":{"id":"components/schemas/reviewScores_output","kind":"json-schema","title":"AttractionsScoresOutput","data":{"title":"AttractionsScoresOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/attractionScore"}}}}},"components/schemas/constants_input":{"id":"components/schemas/constants_input","kind":"json-schema","title":"AttractionsConstantsInput","data":{"title":"AttractionsConstantsInput","type":"object","properties":{"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 used to localise category names. Each category name is returned as an object keyed by language code."},"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":"If a requested language is not available, it may be omitted from the response."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If not provided, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"en-gb"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is used by default."},"children":[]}]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/languageId"},"maxItems":50,"default":["en-gb"],"example":["es"]}}}},"components/schemas/attractionCategory":{"id":"components/schemas/attractionCategory","kind":"json-schema","title":"AttractionCategory","data":{"title":"AttractionCategory","type":"object","properties":{"id":{"description":"The unique identifier of the category.","type":"string","example":"PTTV32SGqJEv"},"name":{"description":"The display name of the category translated into the requested languages, keyed by language code.","$ref":"#/components/schemas/translatedString"},"parent":{"description":"The unique identifier of the parent category. Null for root categories. Use this field to reconstruct the category hierarchy.","type":["string","null"],"example":null}},"required":["id","name"]}},"components/schemas/attractions_constants_output":{"id":"components/schemas/attractions_constants_output","kind":"json-schema","title":"AttractionsConstantsOutput","data":{"title":"AttractionsConstantsOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"categories":{"type":"array","items":{"$ref":"#/components/schemas/attractionCategory"}}}}}}},"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/schemas-sort":{"id":"components/schemas/schemas-sort","kind":"json-schema","title":"schemas-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/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/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_availability_input":{"id":"components/schemas/cars_availability_input","kind":"json-schema","title":"cars_availability_input","data":{"type":"object","properties":{"offer":{"$ref":"#/components/schemas/offerId"},"search_token":{"type":"string","description":"The encoded search token obtained from the search results. This token is car-specific and essential for maintaining state between search and availability checks."},"currency":{"$ref":"#/components/schemas/currencyId"},"language":{"description":"Optional IETF language tag (e.g., 'en-gb', 'fr'). Controls the language of legal insurance documents (IPID and policy document).\nDefaults to 'en-gb' if the requested language is unavailable or not specified.\n\n Note: If mandatory insurance documents are unavailable in English, the insurance object is omitted.","$ref":"#/components/schemas/languageId"}},"required":["offer","search_token","currency"]}},"components/schemas/availability_cancellationOutput":{"id":"components/schemas/availability_cancellationOutput","kind":"json-schema","title":"availability_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/availability_mileageOutput":{"id":"components/schemas/availability_mileageOutput","kind":"json-schema","title":"availability_mileageOutput","data":{"description":"The mileage policy that applies to this product.","type":"object","properties":{"distance_limit":{"description":"The maximum distance allowed before additional charges 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"]},"amount":{"description":"The amount that must be paid if the distance limit is exceeded.","anyOf":[{"$ref":"#/components/schemas/monetaryAmount"},{"type":"null"}]},"currency":{"description":"The currency of the amount that must be paid if the distance limit is exceeded.","anyOf":[{"$ref":"#/components/schemas/currencyId"},{"type":"null"}]},"type":{"description":"The type of mileage policy applied.","type":"string","enum":["limited","unlimited"]}}}},"components/schemas/availability_paymentOutput":{"id":"components/schemas/availability_paymentOutput","kind":"json-schema","title":"availability_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"]}}}},"components/schemas/availability_policiesOutput":{"id":"components/schemas/availability_policiesOutput","kind":"json-schema","title":"availability_policiesOutput","data":{"description":"The policies that apply to this product.","type":"object","properties":{"cancellation":{"$ref":"#/components/schemas/availability_cancellationOutput"},"damage_excess":{"type":"object","properties":{"amount":{"description":"The maximum amount a traveller may be charged for damages to the car during the rental period, as specified by the rental agreement.","anyOf":[{"$ref":"#/components/schemas/monetaryAmount"},{"type":"null"}]}}},"deposit":{"type":"object","properties":{"amount":{"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":[]}]}]}],"anyOf":[{"$ref":"#/components/schemas/monetaryAmount"},{"type":"null"}]}}},"insurance_package":{"description":"The supplier insurance package that applies to this product.","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/availability_mileageOutput"},"payment":{"$ref":"#/components/schemas/availability_paymentOutput"},"theft_excess":{"type":"object","properties":{"amount":{"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.","anyOf":[{"$ref":"#/components/schemas/monetaryAmount"},{"type":"null"}]}}}}}},"components/schemas/chargeTypeIdOutput":{"id":"components/schemas/chargeTypeIdOutput","kind":"json-schema","title":"chargeTypeIdOutput","data":{"description":"The type of this charge.","type":"string"}},"components/schemas/chargeOutput":{"id":"components/schemas/chargeOutput","kind":"json-schema","title":"chargeOutput","data":{"description":"Defines the charge, including the type of charge and its total amount.","type":"object","properties":{"charge":{"$ref":"#/components/schemas/chargeTypeIdOutput"},"total_amount":{"description":"The total price for this charge.","$ref":"#/components/schemas/monetaryAmount"}}}},"components/schemas/priceOutput":{"id":"components/schemas/priceOutput","kind":"json-schema","title":"priceOutput","data":{"description":"The price that applies to this vehicle.","type":"object","properties":{"base":{"description":"The base price of the vehicle.","$ref":"#/components/schemas/monetaryAmount"},"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"]},"total":{"description":"The total price of the vehicle.","$ref":"#/components/schemas/monetaryAmount"},"extra_charges":{"description":"The charge breakdown. Includes taxes and fees included in the drive away price.","type":"array","items":{"$ref":"#/components/schemas/chargeOutput"}}}}},"components/schemas/carMonetaryAmount":{"id":"components/schemas/carMonetaryAmount","kind":"json-schema","title":"carMonetaryAmount","data":{"description":"A monetary amount with currency code.","type":"object","properties":{"value":{"description":"The numeric value of the amount.","type":"number","format":"double"},"currency":{"description":"The currency code.","$ref":"#/components/schemas/currencyId"}}}},"components/schemas/carMonetaryAmountWithTiming":{"id":"components/schemas/carMonetaryAmountWithTiming","kind":"json-schema","title":"carMonetaryAmountWithTiming","data":{"description":"A monetary amount with currency code and the timing of payment. Use timing to indicate whether the amount is paid online now, partially online, or at pickup.","type":"object","properties":{"value":{"description":"The numeric value of the amount.","type":"number","format":"double"},"currency":{"description":"The currency code.","$ref":"#/components/schemas/currencyId"},"timing":{"description":"The payment timing.","type":"string","enum":["pay_online_now","pay_partial_online_now","pay_at_pickup"]}}}},"components/schemas/carsPriceOutput":{"id":"components/schemas/carsPriceOutput","kind":"json-schema","title":"carsPriceOutput","data":{"description":"Price object containing the amount shown to the traveller (display) and the actual payment amount (pay) with timing information.","type":"object","properties":{"display":{"description":"The price displayed to the traveller, including applicable taxes or fees.","$ref":"#/components/schemas/carMonetaryAmount"},"pay":{"description":"The actual payment amount and timing. Indicates whether the amount is paid online now, partially online, or at pickup.","$ref":"#/components/schemas/carMonetaryAmountWithTiming"}}}},"components/schemas/productPriceOutput":{"id":"components/schemas/productPriceOutput","kind":"json-schema","title":"productPriceOutput","data":{"description":"Pricing information for the product, including display price and payment details.","type":"object","properties":{"unit_amount":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The price for a single unit of this product. Use mode to determine if it’s per day or per rental."},"children":[]}]}]}],"$ref":"#/components/schemas/carsPriceOutput"}}}},"components/schemas/productOutput":{"id":"components/schemas/productOutput","kind":"json-schema","title":"productOutput","data":{"description":"Detailed information about optional extras available for the vehicle, including pricing, availability, and calculation rules.","type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the product."},"type":{"type":"string","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":[]}]}]}],"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."}},"maximum_available":{"type":"number","format":"integer","description":"Maximum number of units of this product that can be selected per booking."},"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","each_per_rental","per_day","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":"The 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":"The 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":"The price is charged per unit for the full rental period. Total cost = unit price × quantity."},"children":[]}]}]}],"per_rental":"The price is charged once for the entire rental period, regardless of quantity or duration."}},"price":{"$ref":"#/components/schemas/productPriceOutput"}}}},"components/schemas/dealOutput":{"id":"components/schemas/dealOutput","kind":"json-schema","title":"dealOutput","data":{"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/availability_routePointOutput":{"id":"components/schemas/availability_routePointOutput","kind":"json-schema","title":"availability_routePointOutput","data":{"description":"Defines the product pick up / drop off route point.","type":"object","properties":{"depot":{"description":"The identifier of the depot used for pick up or drop off.","$ref":"#/components/schemas/depots_depotId"},"depot_location_type":{"description":"The type of location for the depot.","type":"string","enum":["in_terminal","car_rental_centre","outside_terminal","airport_hotel","shuttle_bus","meet_greet","trainstation","downtown"]}}}},"components/schemas/availability_routeOutput":{"id":"components/schemas/availability_routeOutput","kind":"json-schema","title":"availability_routeOutput","data":{"description":"Defines the actual route associated with the product.","type":"object","properties":{"dropoff":{"description":"Defines the product drop off route point.","$ref":"#/components/schemas/availability_routePointOutput"},"pickup":{"description":"Defines the product pick up route point.","$ref":"#/components/schemas/availability_routePointOutput"}}}},"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/availability_insuranceOutput":{"id":"components/schemas/availability_insuranceOutput","kind":"json-schema","title":"availability_insuranceOutput","data":{"description":"Detailed third-party insurance quote for this car rental. Returned only for eligible partner configurations (e.g., partners with a signed insurance contract), and when insurance is available for the selected offer (null if not available).\nThis object represents a bookable insurance product and includes pricing, coverage, and policy documentation.","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/cars_availability_output":{"id":"components/schemas/cars_availability_output","kind":"json-schema","title":"cars_availability_output","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"offer":{"$ref":"#/components/schemas/offerId"},"currency":{"$ref":"#/components/schemas/currencyId"},"policies":{"$ref":"#/components/schemas/availability_policiesOutput"},"price":{"$ref":"#/components/schemas/priceOutput"},"products":{"type":"array","description":"A list of optional extras (e.g. child seats, GPS) available for this vehicle.","items":{"$ref":"#/components/schemas/productOutput"}},"deal":{"$ref":"#/components/schemas/dealOutput"},"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 is 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"]},"supplier":{"type":"number","format":"integer","description":"The unique identifier for the car rental supplier."},"route":{"$ref":"#/components/schemas/availability_routeOutput"},"insurance":{"$ref":"#/components/schemas/availability_insuranceOutput"},"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/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/cars_terms_and_conditions_input":{"id":"components/schemas/cars_terms_and_conditions_input","kind":"json-schema","title":"cars_terms_and_conditions_input","data":{"properties":{"offer":{"$ref":"#/components/schemas/offerId"},"currency":{"description":"The currency in ISO 4217 format (e.g., USD, EUR, GBP)","example":"USD","type":"string"},"language":{"description":"The language code (ISO 639-1 format) in which to return the terms and conditions.","$ref":"#/components/schemas/languageId"},"search_token":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The pre-booking search_token used to fetch terms and conditions for a specific car rental offer. The search_token is returned by the search endpoint."},"children":[]}]}]}],"type":"string"}},"required":["offer","currency","search_token"],"type":"object"}},"components/schemas/terms":{"id":"components/schemas/terms","kind":"json-schema","title":"terms","data":{"description":"The terms and conditions section.","type":["array","null"],"items":{"description":"A chapter in the terms and conditions document. Chapters contain one or more sections.","type":"object","properties":{"title":{"description":"Title of the chapter.","type":"string"},"type":{"description":"Identifies this element as a chapter.","enum":["chapter"],"type":"string"},"children":{"description":"List of sections contained within this chapter.","type":"array","items":{"description":"A section that belongs to this chapter.","type":"object","properties":{"title":{"description":"Title of the section.","type":"string"},"type":{"description":"Identifies this element as a section.","enum":["section"],"type":"string"},"children":{"description":"List of clauses contained within this section.","type":"array","items":{"description":"A clause that belongs to this section.","type":"object","properties":{"title":{"description":"Title of the clause.","type":"string"},"type":{"description":"Identifies this element as a clause.","enum":["clause"],"type":"string"},"children":{"description":"List of sub-clauses contained within this clause.","type":"array","items":{"description":"A sub-clause that belongs to this clause.","type":"object","properties":{"type":{"description":"Identifies this element as a sub-clause.","enum":["sub_clause"],"type":"string"},"children":{"description":"List of clause options contained within this sub-clause.","type":"array","items":{"description":"A clause option that belongs to this sub-clause.","type":"object","properties":{"text":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Text content of the clause option with safe HTML formatting tags (e.g., "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"<strong>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"<a>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"<ul>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") and entities (e.g., "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"&euro;"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"&ndash;"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]}],"type":"string"},"type":{"description":"Identifies this element as a clause option.","enum":["clause_option"],"type":"string"}}}}}}}}}}}}}}}}},"components/schemas/cars_terms_and_conditions_output":{"id":"components/schemas/cars_terms_and_conditions_output","kind":"json-schema","title":"cars_terms_and_conditions_output","data":{"properties":{"data":{"type":"object","description":"Terms and conditions content translated in the requested language, if specified.","properties":{"key_info":{"type":"object","description":"High-level information about the car rental.","properties":{"common":{"properties":{"credit_cards_allowed":{"description":"Indicates whether the supplier accepts credit cards for the car rental deposit.","type":"boolean"},"debit_cards_allowed":{"description":"Indicates whether the supplier accepts debit cards for the car rental deposit.","type":"boolean"},"driver_age":{"description":"This is the driver age included in the car rental search request.","type":"integer"},"insurance_available":{"description":"Indicates whether insurance is available for the rental.","type":"boolean"},"rental_duration":{"description":"The duration of the rental in days.","type":"integer","minimum":1}},"type":"object"},"damage_excess":{"description":"The damage excess section.","properties":{"content":{"description":"The content of the damage excess section.","items":{"type":"string"},"type":"array"},"excess_value":{"description":"The value of the damage excess.","type":"string"},"subtitle":{"description":"The subtitle of the damage excess section.","type":"string"},"title":{"description":"The title of the damage excess section.","type":"string"}},"type":"object"},"deposit":{"description":"General information about the deposit.","properties":{"accepted_cards":{"description":"The accepted cards for the deposit.","items":{"properties":{"title":{"description":"The title of the card.","type":"string"},"type":{"description":"The type of card.","type":"string"}},"type":"object"},"type":"array"},"accepted_cards_title":{"description":"The title of the accepted cards section.","type":"string"},"content":{"description":"The content of the deposit section.","items":{"type":"string"},"type":"array"},"subtitle":{"description":"The subtitle of the deposit section.","type":"string"},"title":{"description":"The title of the deposit section.","type":"string"}},"type":"object"},"disclaimers":{"description":"The disclaimers section.","items":{"type":"string"},"type":"array"},"driver_and_license":{"description":"The driver and license section.","properties":{"needed_items":{"description":"What you need in order to rent a car.","items":{"type":"string"},"type":"array"},"title":{"description":"The title of the driver and license section.","type":"string"},"top_text":{"description":"The top text of the driver and license section.","type":"string"}},"type":"object"},"mileage":{"description":"The mileage section.","properties":{"content":{"description":"The content of the mileage section.","type":"string"},"subtitle":{"description":"The subtitle of the mileage section.","type":"string"},"title":{"description":"The title of the mileage section.","type":"string"}},"type":"object"}}},"terms":{"$ref":"#/components/schemas/terms"}}},"request_id":{"$ref":"#/components/schemas/requestId"}},"type":"object"}},"components/schemas/destinationType":{"id":"components/schemas/destinationType","kind":"json-schema","title":"destinationType","data":{"description":"The type of destination.","type":"string","enum":["airport","hotel","landmark","city","district","region","country"]}},"components/schemas/autoCompleteFilters":{"id":"components/schemas/autoCompleteFilters","kind":"json-schema","title":"AutoCompleteFilters","data":{"title":"AutoCompleteFilters","description":"Filters to restrict autocomplete results.","type":"object","properties":{"types":{"description":"Restricts results to the specified destination types. If omitted, all destination types are considered.","type":"array","items":{"$ref":"#/components/schemas/destinationType"}}}}},"components/schemas/autoCompleteInput":{"id":"components/schemas/autoCompleteInput","kind":"json-schema","title":"AutoCompleteInput","data":{"title":"AutoCompleteInput","type":"object","required":["query","country"],"properties":{"query":{"description":"Free-text search query used to generate suggestions. Leading and trailing whitespace is ignored. Must contain between 3 and 200 characters.","type":"string","minLength":3,"maxLength":200,"examples":["ams","amster","amsterdam"]},"language":{"description":"Language code used to localise names in the response. Only one language can be specified per request.","$ref":"#/components/schemas/languageId","default":"en-gb"},"country":{"description":"ISO 3166-1 alpha-2 country code used as the primary search context for autocomplete ranking. This field is required.","$ref":"#/components/schemas/countryId"},"filters":{"description":"Restricts results to the specified destination types. If omitted, all types are included. It should not be an empty object.","$ref":"#/components/schemas/autoCompleteFilters"}}}},"components/schemas/autoCompleteLocation":{"id":"components/schemas/autoCompleteLocation","kind":"json-schema","title":"AutoCompleteLocation","data":{"title":"AutoCompleteLocation","description":"Geographic context of the suggestion, including city, country and coordinates.","type":"object","properties":{"city":{"$ref":"#/components/schemas/cityId"},"city_name":{"$ref":"#/components/schemas/translatedString"},"coordinates":{"$ref":"#/components/schemas/dataTypes_coordinates"},"country":{"$ref":"#/components/schemas/countryId"},"country_name":{"$ref":"#/components/schemas/translatedString"}}}},"components/schemas/autoCompleteResult":{"id":"components/schemas/autoCompleteResult","kind":"json-schema","title":"AutoCompleteResultOutput","data":{"title":"AutoCompleteResultOutput","description":"Represents a single ranked autocomplete suggestion with a display name in the requested language and geographic context.","type":"object","properties":{"type":{"$ref":"#/components/schemas/destinationType"},"name":{"description":"Display name in the requested language. Only one language key is returned.","$ref":"#/components/schemas/translatedString"},"id":{"description":"The identifier of the destination. The format depends on the destination type.","type":"string"},"location":{"$ref":"#/components/schemas/autoCompleteLocation"}}}},"components/schemas/autoCompleteOutput":{"id":"components/schemas/autoCompleteOutput","kind":"json-schema","title":"AutoCompleteOutput","data":{"title":"AutoCompleteOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","items":{"$ref":"#/components/schemas/autoCompleteResult"}}}}},"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/preview_carsPriceOutput":{"id":"components/schemas/preview_carsPriceOutput","kind":"json-schema","title":"preview_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/preview_chargeTypeIdOutput":{"id":"components/schemas/preview_chargeTypeIdOutput","kind":"json-schema","title":"preview_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/preview_chargeTypeIdOutput"},"amount":{"description":"Amount for this specific charge.","$ref":"#/components/schemas/preview_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/preview_carsPriceOutput"},"total_amount":{"$ref":"#/components/schemas/preview_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/preview_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/preview_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/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/preview_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/preview_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/preview_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/preview_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-beta_product":{"id":"components/schemas/create-beta_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-beta_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/accommodation_booker":{"id":"components/schemas/accommodation_booker","kind":"json-schema","title":"AccommodationOrderCreateBookerInput","data":{"title":"AccommodationOrderCreateBookerInput","description":"The booker's information for an accommodation order.","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-beta_payment":{"id":"components/schemas/create-beta_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"}},"required":["authentication_value","eci"]}}},"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":"Card expiry date in YYYY-MM format.","type":"string"},"number":{"description":"Payment card number.","type":"string"}},"required":["cardholder","cvc","expiry_date","number"]},"include_receipt":{"description":"Set to true to include a payment receipt URL in the response when available.","type":"boolean"},"method":{"description":"The payment method to be used for this order.","type":"string","enum":["airplus","card","wallet"]},"timing":{"type":"string","description":"Payment timing for the order. Use one of the values returned in the corresponding /orders/preview response. Supported values depend on the travel service and payment configuration.","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."}}}}},"components/schemas/car":{"id":"components/schemas/car","kind":"json-schema","title":"OrderCreateCarInput","data":{"title":"OrderCreateCarInput","description":"Additional information related to the car order. Only one travel service object can be included in a request.","type":"object","properties":{"driver":{"title":"OrderCreateDriverInput","description":"Driver related information for the order.","type":"object","properties":{"address":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Driver’s address."},"children":[]}]}]}],"properties":{"address_line1":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Driver’s address line 1."},"children":[]}]}]}]},"address_line2":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Driver’s address line 2."},"children":[]}]}]}]},"city":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Driver’s city."},"children":[]}]}]}]},"country":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Driver’s country."},"children":[]}]}]}]},"postcode":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Driver’s postcode."},"children":[]}]}]}]}},"required":["address_line1","city","country","postcode"]},"email":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Driver’s email address."},"children":[]}]}]}]},"first_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Driver’s first name."},"children":[]}]}]}]},"last_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Driver’s last name."},"children":[]}]}]}]},"telephone":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Driver’s telephone number."},"children":[]}]}]}]},"title":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Driver’s honorific or title, such as “Mr”, “Ms”, “Mrs”, or “Dr”."},"children":[]}]}]}]}},"required":["email","first_name","last_name","telephone","title"]},"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 Labels and attributions guide for more details."},"children":[]}]}]}],"type":"string"}},"required":["driver"]}},"components/schemas/car_booker_address":{"id":"components/schemas/car_booker_address","kind":"json-schema","title":"CarOrderCreateBookerAddressInput","data":{"title":"CarOrderCreateBookerAddressInput","description":"The booker's billing address for a car order.","allOf":[{"$ref":"#/components/schemas/address"},{"required":["address_line","city","country","post_code"]}]}},"components/schemas/name":{"id":"components/schemas/name","kind":"json-schema","title":"OrderCreateBookerNameInput","data":{"title":"OrderCreateBookerNameInput","description":"The name of the booker.","type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"}},"required":["first_name","last_name"]}},"components/schemas/car_booker":{"id":"components/schemas/car_booker","kind":"json-schema","title":"CarOrderCreateBookerInput","data":{"title":"CarOrderCreateBookerInput","description":"The booker's information for a car order.","type":"object","properties":{"address":{"$ref":"#/components/schemas/car_booker_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":{"$ref":"#/components/schemas/name"},"telephone":{"description":"The booker's telephone number.","type":"string"}},"required":["address","email","language","name","telephone"]}},"components/schemas/car_payment":{"id":"components/schemas/car_payment","kind":"json-schema","title":"CarOrderCreatePaymentInput","data":{"title":"CarOrderCreatePaymentInput","description":"Payment information for a car rental order. Card details are required to complete the booking.","allOf":[{"$ref":"#/components/schemas/create-beta_payment"},{"required":["card","method"],"properties":{"method":{"enum":["card"],"type":"string","description":"Payment method for the car rental order."}}}]}},"components/schemas/create_beta_input":{"id":"components/schemas/create_beta_input","kind":"json-schema","title":"Order creation request","data":{"title":"Order creation request","description":"Request payload for creating an order. The required structure depends on the travel service being booked.","oneOf":[{"title":"Accommodation order creation request","description":"Use this object to create an accommodation order. Include accommodation-specific data and payment details.","type":"object","properties":{"accommodation":{"$ref":"#/components/schemas/accommodation"},"booker":{"$ref":"#/components/schemas/accommodation_booker"},"order_token":{"description":"Token returned by /orders/preview containing the data required to create the order.","type":"string"},"payment":{"allOf":[{"$ref":"#/components/schemas/create-beta_payment"},{"required":["timing"]}]}},"required":["accommodation","booker","order_token","payment"]},{"title":"Car rental order creation request","description":"Use this object to create a car rental order. Include car rental booker information and payment details.","type":"object","properties":{"car":{"$ref":"#/components/schemas/car"},"booker":{"$ref":"#/components/schemas/car_booker"},"order_token":{"description":"Token returned by /orders/preview containing the data required to create the order.","type":"string"},"payment":{"$ref":"#/components/schemas/car_payment"}},"required":["car","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-beta_paymentOutput":{"id":"components/schemas/create-beta_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/create_beta_output":{"id":"components/schemas/create_beta_output","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-beta_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/flights_priceOutput":{"id":"components/schemas/flights_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/flights_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/orders_cars_terms_and_conditions_input":{"id":"components/schemas/orders_cars_terms_and_conditions_input","kind":"json-schema","title":"orders_cars_terms_and_conditions_input","data":{"type":"object","required":["booker","orders"],"properties":{"booker":{"type":"object","required":["country"],"description":"Information about the booker","properties":{"country":{"$ref":"#/components/schemas/countryId"}}},"language":{"description":"Optional. An ISO 639-1 language code (e.g. 'en-gb', 'es') indicating the preferred language for the terms and conditions.","$ref":"#/components/schemas/languageId"},"orders":{"type":"array","description":"An array of car rental order IDs for which to retrieve terms and conditions. Must include at least one valid ID.","items":{"type":"string","example":"765255700"},"minItems":1},"filters":{"type":"object","description":"Optional filters that control which terms and conditions are returned.","properties":{"voucher":{"type":"boolean","description":"When true, returns only the terms and conditions that must appear on the booking voucher shown to the traveller. A booking voucher is the confirmation document that the traveller must present at the car rental desk to collect the vehicle."}}}}}},"components/schemas/orders_cars_terms_and_conditions_output":{"id":"components/schemas/orders_cars_terms_and_conditions_output","kind":"json-schema","title":"orders_cars_terms_and_conditions_output","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"title":"Order terms map","type":"object","description":"Map of order IDs to their terms and conditions. Invalid or missing orders return null.","propertyNames":{"title":"Order ID (Map key)","description":"The order ID key from the request.","type":"string"},"additionalProperties":{"title":"Order terms object (Map value)","description":"Contains the terms object for this order ID or null if invalid.","type":["object","null"],"required":["terms"],"properties":{"terms":{"title":"Terms and conditions content","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Hierarchical array of terms for this order. Each item may be a chapter, section, clause, sub_clause, or clause_option."},"children":[]}]}]}],"$ref":"#/components/schemas/terms"}}}}}}},"components/schemas/FaqInput":{"id":"components/schemas/FaqInput","kind":"json-schema","title":"FaqInput","data":{"title":"FaqInput","type":"object","description":"Input parameters for retrieving car rental FAQs","properties":{"languages":{"type":"array","description":"Required. One or more preferred language codes expressed as IETF language tags (for example, en-gb, es). The API returns FAQs in each requested language where available. If content is not available for a requested language, the response defaults to English.","items":{"type":"string"},"minItems":1,"maxItems":50}},"required":["languages"]}},"components/schemas/Faq":{"id":"components/schemas/Faq","kind":"json-schema","title":"Faq","data":{"title":"Faq","type":"object","description":"A map containing a question translated in each of the requested languages and answers for that specific question, translated in each of the requested languages. ","properties":{"question":{"type":"object","additionalProperties":{"type":"string"},"description":"Map of IETF language tags to the translated question strings. Each key is a language code (e.g., en-gb, fr), and the value is the corresponding translation of the question."},"answers":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Map of IETF language tags to arrays of translated answer paragraphs. Each key is a language code (e.g., en-gb, fr), and the value is an array of strings representing the paragraphs of the answer."}},"required":["question","answers"]}},"components/schemas/FaqOutput":{"id":"components/schemas/FaqOutput","kind":"json-schema","title":"FaqOutput","data":{"title":"FaqOutput","type":"object","description":"Response object containing the set of frequently asked questions (FAQs) returned for the request.","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","description":"Container for the FAQ results.","properties":{"faqs":{"description":"List of FAQ items, each containing a question and its corresponding answer.","type":"array","items":{"$ref":"#/components/schemas/Faq"}}},"required":["faqs"]}},"required":["request_id","data"]}},"components/schemas/supplierOutput":{"id":"components/schemas/supplierOutput","kind":"json-schema","title":"SupplierOutput","data":{"title":"SupplierOutput","description":"Car rental supplier (company) information.","type":["object","null"],"properties":{"id":{"description":"Unique identifier of the supplier.","type":["string","null"]},"name":{"description":"Name of the car rental supplier (e.g., 'Avis', 'Hertz').","type":["string","null"]},"telephone":{"description":"Contact telephone number for the pickup location.","type":["string","null"]},"confirmation_number":{"description":"Supplier's confirmation/reference number for the booking.","type":["string","null"]}}}},"components/schemas/live_carMonetaryAmount":{"id":"components/schemas/live_carMonetaryAmount","kind":"json-schema","title":"CarMonetaryAmount","data":{"title":"CarMonetaryAmount","description":"Monetary amount with currency and payment timing.","type":["object","null"],"properties":{"value":{"description":"The monetary value.","type":["number","null"],"format":"double"},"currency":{"description":"The ISO 4217 currency code (e.g., 'EUR', 'USD').","type":["string","null"]},"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"]}}}},"components/schemas/live_carsPriceOutput":{"id":"components/schemas/live_carsPriceOutput","kind":"json-schema","title":"CarsPriceOutput","data":{"title":"CarsPriceOutput","description":"Price amounts for display and payment.","type":["object","null"],"properties":{"display":{"description":"Amount displayed to the traveller, converted to the requested currency when applicable.","$ref":"#/components/schemas/live_carMonetaryAmount"},"pay":{"description":"The amount the traveller will pay in the supplier's currency.","$ref":"#/components/schemas/live_carMonetaryAmount"}}}},"components/schemas/carPriceOutput":{"id":"components/schemas/carPriceOutput","kind":"json-schema","title":"CarPriceOutput","data":{"title":"CarPriceOutput","description":"Pricing breakdown for the car rental.","type":["object","null"],"properties":{"base":{"description":"Base price of the vehicle (excluding extras), after any promotions.","$ref":"#/components/schemas/live_carsPriceOutput"},"pre_discount_base":{"description":"Base price before discount.","$ref":"#/components/schemas/live_carsPriceOutput"},"total":{"description":"List of total prices broken down by payment timing (pay now vs pay at pickup).","type":["array","null"],"items":{"$ref":"#/components/schemas/live_carsPriceOutput"}}}}},"components/schemas/live_mileageOutput":{"id":"components/schemas/live_mileageOutput","kind":"json-schema","title":"MileageOutput","data":{"title":"MileageOutput","description":"Mileage policy information.","type":["object","null"],"properties":{"distance_limit":{"description":"Maximum distance allowed when mileage is limited.","type":["number","null"],"format":"double"},"distance_unit":{"description":"Unit of distance measurement.","type":["string","null"],"enum":["kilometers","miles"]},"amount":{"description":"Cost per unit of distance if mileage is limited.","type":["number","null"],"format":"double"},"currency":{"description":"Currency for the mileage overage charge.","type":["string","null"]},"type":{"description":"Type of mileage policy.","type":["string","null"],"enum":["limited","unlimited"]}}}},"components/schemas/cancellationScheduleOutput":{"id":"components/schemas/cancellationScheduleOutput","kind":"json-schema","title":"CancellationScheduleOutput","data":{"title":"CancellationScheduleOutput","description":"A single cancellation period defining the conditions and any applicable fee for a specific time window.","type":["object","null"],"properties":{"from":{"description":"Start date and time of this cancellation period in ISO-8601 format.","type":"string","format":"date-time"},"to":{"description":"End date and time of this cancellation period in ISO-8601 format.","type":"string","format":"date-time"},"free_cancellation":{"description":"Indicates whether cancellation is free during this period. When true, no cancellation fee applies. In case is false and the price is null, the fee is pending and will be typically determined 48h before pickup.","type":"boolean"},"price":{"description":"Cancellation fee for this period. Null when fee has not yet been determined.","$ref":"#/components/schemas/live_carsPriceOutput"}}}},"components/schemas/live_cancellationOutput":{"id":"components/schemas/live_cancellationOutput","kind":"json-schema","title":"CancellationOutput","data":{"title":"CancellationOutput","description":"Cancellation policy information.","type":"object","properties":{"type":{"description":"Type of cancellation policy.","type":["string","null"],"enum":["free_cancellation","non_refundable"]},"schedule":{"description":"Chronological list of cancellation periods with their applicable fees. Each entry represents a contiguous time window and its cancellation conditions. Periods are ordered by start time and expressed in UTC. When present, the schedule fully describes the cancellation policy.","type":["array","null"],"items":{"$ref":"#/components/schemas/cancellationScheduleOutput"}}}}},"components/schemas/carsGeneralPoliciesOutput":{"id":"components/schemas/carsGeneralPoliciesOutput","kind":"json-schema","title":"CarsGeneralPoliciesOutput","data":{"title":"CarsGeneralPoliciesOutput","description":"General policies applicable to the car rental.","type":["object","null"],"properties":{"deposit":{"description":"Refundable security deposit required at pickup.","$ref":"#/components/schemas/live_carMonetaryAmount"},"mileage":{"description":"Mileage policy details.","$ref":"#/components/schemas/live_mileageOutput"},"fuel_policy":{"description":"Fuel policy applied to the rental.","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"]},"cancellation":{"description":"Cancellation policy details.","$ref":"#/components/schemas/live_cancellationOutput"}}}},"components/schemas/carDetailsOutput":{"id":"components/schemas/carDetailsOutput","kind":"json-schema","title":"CarDetailsOutput","data":{"title":"CarDetailsOutput","description":"Vehicle, supplier, pricing, and policy details.","type":["object","null"],"properties":{"id":{"description":"Unique identifier of the booked vehicle. Corresponds to the car field returned by /cars/search and the id field returned by /cars/details.","type":["integer","null"]},"image":{"description":"Relative path to the car image. Combine this path with the CDN base URL to retrieve the image. May be null if no image is available.","type":["string","null"]},"category":{"description":"Category of the car (e.g., 'Compact', 'SUV').","type":["string","null"]},"transmission":{"description":"Transmission type (e.g., 'Automatic', 'Manual').","type":["string","null"]},"doors":{"description":"Number of doors.","type":["string","null"]},"seats":{"description":"Number of seats.","type":["string","null"]},"air_conditioning":{"description":"Whether the car has air conditioning.","type":["boolean","null"]},"big_suitcase":{"description":"Number of large suitcases the car can accommodate.","type":["string","null"]},"small_suitcase":{"description":"Number of small suitcases the car can accommodate.","type":["string","null"]},"currency":{"description":"Currency code for pricing (e.g., 'EUR', 'USD').","type":["string","null"]},"make_and_model":{"description":"Make and model of the car (e.g., 'Toyota Corolla').","type":["string","null"]},"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 is null.","type":["string","null"]},"supplier":{"description":"Car hire supplier information.","$ref":"#/components/schemas/supplierOutput"},"price":{"description":"Pricing information for the car rental.","$ref":"#/components/schemas/carPriceOutput"},"policies":{"description":"Applicable policies including deposit, mileage, fuel, and cancellation.","$ref":"#/components/schemas/carsGeneralPoliciesOutput"}}}},"components/schemas/live_routePointOutput":{"id":"components/schemas/live_routePointOutput","kind":"json-schema","title":"RoutePointOutput","data":{"title":"RoutePointOutput","description":"Pickup or dropoff location details.","type":["object","null"],"properties":{"datetime":{"description":"Pickup/dropoff date and time in ISO-8601 format.","type":["string","null"],"format":"date-time"},"location":{"description":"Pickup/dropoff location name.","type":["string","null"]},"depot_type":{"description":"Location type of the depot (e.g., 'Airport', 'Downtown').","type":["string","null"]},"depot_id":{"description":"Unique identifier of the depot.","type":["string","null"]},"instructions":{"description":"Pickup or dropoff instructions at this location.","type":["string","null"]}}}},"components/schemas/live_carProductOutput":{"id":"components/schemas/live_carProductOutput","kind":"json-schema","title":"carProductOutput","data":{"title":"carProductOutput","description":"Optional extra or service added to the car hire order. Some values may represent similar extras because suppliers use different naming conventions for the same or comparable products.","type":"object","properties":{"id":{"description":"Unique identifier for this product/extra.","type":["string","null"]},"type":{"description":"Type of extra product.","type":["string","null"],"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":"Number of this product selected/booked.","type":["integer","null"]},"mode":{"description":"Pricing mode for this product.","type":["string","null"],"enum":["each_per_day","each_per_rental","per_day","per_rental"]},"price":{"description":"Price of this extra product.","$ref":"#/components/schemas/live_carsPriceOutput"}}}},"components/schemas/driverOutput":{"id":"components/schemas/driverOutput","kind":"json-schema","title":"DriverOutput","data":{"title":"DriverOutput","description":"Details of the primary driver associated with the booking.","type":["object","null"],"properties":{"name":{"description":"Full name of the driver.","type":"string"},"email":{"description":"Email address of the driver.","type":"string","format":"email"},"telephone":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Driver’s phone number."},"children":[]}]}]}],"type":"string"}}}},"components/schemas/carInsuranceMonetaryAmount":{"id":"components/schemas/carInsuranceMonetaryAmount","kind":"json-schema","title":"CarInsuranceMonetaryAmount","data":{"title":"CarInsuranceMonetaryAmount","description":"Monetary amount with currency for insurance prices.","type":["object","null"],"properties":{"value":{"description":"The monetary value.","type":["number","null"],"format":"double"},"currency":{"description":"The ISO 4217 currency code (e.g., 'EUR', 'USD').","type":["string","null"]}}}},"components/schemas/carsInsurancePriceOutput":{"id":"components/schemas/carsInsurancePriceOutput","kind":"json-schema","title":"CarsInsurancePriceOutput","data":{"title":"CarsInsurancePriceOutput","description":"Insurance price amounts for display and payment. Payment timing is not applicable.","type":["object","null"],"properties":{"display":{"description":"Amount displayed to the traveller, converted to the requested currency when applicable.","$ref":"#/components/schemas/carInsuranceMonetaryAmount"},"pay":{"description":"The amount the traveller will pay in the supplier's currency.","$ref":"#/components/schemas/carInsuranceMonetaryAmount"}}}},"components/schemas/insuranceStatus":{"id":"components/schemas/insuranceStatus","kind":"json-schema","title":"InsuranceStatus","data":{"title":"InsuranceStatus","description":"Current status of an insurance policy.","type":"string","enum":["new","confirmed","cancelled"],"x-enumDescriptions":{"new":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The insurance policy has been created and is pending confirmation. policy_reference is omitted until the policy is issued."},"children":[]}]}]}],"confirmed":"The insurance policy is active and confirmed.","cancelled":"The insurance policy has been cancelled."}}},"components/schemas/live_insuranceDocument":{"id":"components/schemas/live_insuranceDocument","kind":"json-schema","title":"InsuranceDocument","data":{"title":"InsuranceDocument","description":"A single insurance document and its retrieval status.","type":"object","properties":{"name":{"description":"The insurance document type.","type":"string","enum":["policy_document","ipid","certificate"],"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.","certificate":"Certificate of Insurance (COI): formal proof that insurance cover is in place, issued after the policy is confirmed. It may include traveller- and policy-specific details and also serves as proof of purchase. The URL is short-lived (expires approximately 10 minutes after it is issued) and must not be cached. Call this endpoint again to obtain a fresh URL."}},"url":{"description":"URL of the insurance document when status is available; otherwise null.","type":["string","null"],"example":"https://staging.rentalcover.com/en/pds/WXXG-CVHM-INS"},"status":{"description":"Retrieval status of this document.","type":"string","enum":["available","unavailable","temporarily_unavailable"],"x-enumDescriptions":{"available":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The document was retrieved; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is populated."},"children":[]}]}]}],"unavailable":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The document is not available because it does not exist. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null. Retrying the request will not make the document available."},"children":[]}]}]}],"temporarily_unavailable":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The document could not be retrieved because the insurance policy is not yet confirmed or the downstream service was temporarily unavailable (5xx). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null. Retry the request later."},"children":[]}]}]}]}}},"required":["name","url","status"]}},"components/schemas/orderDetailsCarsInsuranceOutput":{"id":"components/schemas/orderDetailsCarsInsuranceOutput","kind":"json-schema","title":"OrderDetailsCarsInsuranceOutput","data":{"title":"OrderDetailsCarsInsuranceOutput","description":"Insurance product details associated with the booking.","type":["object","null"],"properties":{"id":{"description":"Unique identifier for the insurance type.","type":"string","example":"335"},"name":{"description":"Name of the insurance product (in English by default)","type":"string","example":"Full Protection"},"price":{"description":"Price of the insurance.","$ref":"#/components/schemas/carsInsurancePriceOutput"},"policy_reference":{"description":"Unique reference identifier for the issued insurance policy. This field is omitted while status is new and returned once the policy is issued. Use this reference when contacting customer support or requesting cancellation of the policy.","type":"string","example":"4e9d5e7c-c11d-41ee-9f77-cb2508104199"},"status":{"description":"Current status of the insurance policy.","$ref":"#/components/schemas/insuranceStatus"},"documents":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Insurance documents associated with this policy. Documents are retrieved independently, and each document reports its own retrieval status. Failure to retrieve one or more documents does not cause the request to fail. This array is always returned when an insurance object is present and always contains exactly three entries — one for each supported document type (policy_document, ipid, certificate) — even when a document could not be retrieved (in which case its url is null)."},"children":[]}]}]}],"type":"array","minItems":3,"maxItems":3,"items":{"$ref":"#/components/schemas/live_insuranceDocument"}}},"required":["documents"]}},"components/schemas/carsPostbookOutput":{"id":"components/schemas/carsPostbookOutput","kind":"json-schema","title":"CarsPostbookOutput","data":{"title":"CarsPostbookOutput","description":"Live car order details for a single reservation.","type":"object","properties":{"affiliate":{"description":"The affiliate ID used for this order.","type":"integer"},"car":{"description":"Details of the rented vehicle, including supplier, pricing and policies.","$ref":"#/components/schemas/carDetailsOutput"},"dropoff":{"description":"Drop-off location and time details.","$ref":"#/components/schemas/live_routePointOutput"},"pickup":{"description":"Pick-up location and time details.","$ref":"#/components/schemas/live_routePointOutput"},"products":{"description":"Optional ancillary services added to the car hire order (for example, additional driver, child seat, or GPS).","type":"array","items":{"$ref":"#/components/schemas/live_carProductOutput"}},"reservation":{"description":"The reservation ID for this car order.","type":"string"},"duration":{"description":"Duration of the car rental in days.","type":["integer","null"]},"driver":{"description":"Details of the primary driver associated with the booking. Only returned when PII sharing is enabled.","$ref":"#/components/schemas/driverOutput"},"status":{"description":"Current status of the car order.","type":"string","enum":["cancelled","confirmed","not_confirmed","quote","completed","processing","unknown"],"x-enumDescriptions":{"cancelled":"The order has been cancelled and is no longer active.","confirmed":"The booking is confirmed by the supplier and is active.","not_confirmed":"The order request exists but was not confirmed (still pending checks).","quote":"A price quote has been created but the booking has not been placed.","completed":"The rental has finished and the order is fully completed.","processing":"The booking is being processed and payment/final confirmation is pending.","unknown":"The booking status is unknown."}},"insurance":{"description":"Insurance products purchased as part of the car rental booking. Returns null if no insurance was purchased.","type":["array","null"],"items":{"$ref":"#/components/schemas/orderDetailsCarsInsuranceOutput"}}}}},"components/schemas/ordersDetailsCarsOutput":{"id":"components/schemas/ordersDetailsCarsOutput","kind":"json-schema","title":"OrdersDetailsCarsLiveOutput","data":{"title":"OrdersDetailsCarsLiveOutput","type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"array","description":"List of car order objects for the requested reservations.","items":{"$ref":"#/components/schemas/carsPostbookOutput"}}}}},"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/preview_orderId":{"id":"components/schemas/preview_orderId","kind":"json-schema","title":"preview_orderId","data":{"type":"string","description":"Order ID to preview modification for."}},"components/schemas/preview_dateChange":{"id":"components/schemas/preview_dateChange","kind":"json-schema","title":"preview_dateChange","data":{"type":"object","properties":{"checkin":{"type":"string","format":"date","description":"New check-in date in ISO 8601 format (YYYY-MM-DD)."},"checkout":{"type":"string","format":"date","description":"New checkout date in ISO 8601 format (YYYY-MM-DD). Must be after the checkin date."}},"required":["checkin","checkout"]}},"components/schemas/preview_roomChange":{"id":"components/schemas/preview_roomChange","kind":"json-schema","title":"preview_roomChange","data":{"type":"object","properties":{"room_reservation":{"type":"string","description":"Identifier of the room reservation to be modified."},"allocation":{"type":"object","properties":{"number_of_adults":{"type":"integer","description":"Number of adults for the room."}}},"guests":{"description":"Guest information for the room.","type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Guest name"}}}},"smoking_preference":{"type":"string","description":"Smoking preference for the room","enum":["no_preference","non_smoking","smoking"]}},"required":["room_reservation"]}},"components/schemas/preview_accommodationChange":{"id":"components/schemas/preview_accommodationChange","kind":"json-schema","title":"preview_accommodationChange","data":{"type":"object","properties":{"reservation":{"type":"string","description":"Identifier of the specific reservation to be modified within the order."},"type":{"description":"Type of accommodation modification to apply.","type":"string","enum":["dates","room"]},"change":{"description":"Details of the change. Must match the type of modification specified.","oneOf":[{"title":"DateChange","$ref":"#/components/schemas/preview_dateChange"},{"title":"RoomChange","$ref":"#/components/schemas/preview_roomChange"}]}},"required":["reservation","type","change"]}},"components/schemas/accommodationModificationPreviewInput":{"id":"components/schemas/accommodationModificationPreviewInput","kind":"json-schema","title":"accommodationModificationPreviewInput","data":{"type":"object","description":"This is the preview input for accommodation modifications.","properties":{"order":{"$ref":"#/components/schemas/preview_orderId"},"modification":{"type":"object","properties":{"accommodation":{"$ref":"#/components/schemas/preview_accommodationChange"}},"required":["accommodation"]}},"required":["order","modification"]}},"components/schemas/preview_cardDetails":{"id":"components/schemas/preview_cardDetails","kind":"json-schema","title":"preview_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","pattern":"^[0-9]{4}-(0[1-9]|1[0-2])$","description":"Card expiry date in YYYY-MM format.","example":"2026-04"},"number":{"type":"string","description":"Card number"}},"required":["cardholder","cvc","expiry_date","number"]}},"components/schemas/preview_paymentChange":{"id":"components/schemas/preview_paymentChange","kind":"json-schema","title":"preview_paymentChange","data":{"type":"object","properties":{"type":{"description":"Type of payment change to apply.","type":"string","enum":["card"]},"change":{"$ref":"#/components/schemas/preview_cardDetails"}},"required":["type","change"]}},"components/schemas/paymentModificationPreviewInput":{"id":"components/schemas/paymentModificationPreviewInput","kind":"json-schema","title":"paymentModificationPreviewInput","data":{"type":"object","description":"This is the preview input for payment modifications.","properties":{"order":{"$ref":"#/components/schemas/preview_orderId"},"modification":{"type":"object","properties":{"payment":{"$ref":"#/components/schemas/preview_paymentChange"}},"required":["payment"]}},"required":["order","modification"]}},"components/schemas/accommodationModificationPreviewOutput":{"id":"components/schemas/accommodationModificationPreviewOutput","kind":"json-schema","title":"accommodationModificationPreviewOutput","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"modifiable":{"type":"boolean","description":"Indicates whether the requested modification can be applied."},"reason":{"type":"string","description":"Explanation of why the modification cannot be applied. Only present when modifiable is false."},"price":{"type":"object","description":"Price information for the modification. Only present when modifiable is true and the modification type is dates.","properties":{"currency":{"$ref":"#/components/schemas/currencyId"},"current":{"type":"object","description":"Current price of the order before modification.","properties":{"amount":{"type":"number","format":"double","description":"Current total cost amount."}},"required":["amount"]},"new":{"type":"object","description":"New price of the order after modification.","properties":{"amount":{"type":"number","format":"double","description":"New total cost amount after applying the modification."}},"required":["amount"]}},"required":["currency","current","new"]}},"required":["modifiable"]}}}},"components/schemas/paymentModificationPreviewOutput":{"id":"components/schemas/paymentModificationPreviewOutput","kind":"json-schema","title":"paymentModificationPreviewOutput","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"modifiable":{"type":"boolean","description":"Whether the payment modification is possible"}},"required":["modifiable"]}}}},"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"]}]}}}}}},"components/schemas/conversation":{"id":"components/schemas/conversation","kind":"json-schema","title":"conversation","data":{"description":"A unique identifier for the conversation thread.","type":"string"}},"components/schemas/common_accommodation":{"id":"components/schemas/common_accommodation","kind":"json-schema","title":"common_accommodation","data":{"type":"string","description":"The unique identifier of the property"}},"components/schemas/attachment":{"id":"components/schemas/attachment","kind":"json-schema","title":"attachment","data":{"type":"string","description":"The unique identifier of the attachment"}},"components/schemas/send_input":{"id":"components/schemas/send_input","kind":"json-schema","title":"send_input","data":{"type":"object","required":["accommodation","conversation","content"],"properties":{"conversation":{"type":"string","description":"The unique identifier of the conversation","$ref":"#/components/schemas/conversation"},"accommodation":{"type":"string","description":"The unique identifier of the property","$ref":"#/components/schemas/common_accommodation"},"content":{"type":"string","description":"The body of the message."},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/attachment"}}}}},"components/schemas/message":{"id":"components/schemas/message","kind":"json-schema","title":"message","data":{"description":"A unique identifier for the message.","type":"string"}},"components/schemas/send_output":{"id":"components/schemas/send_output","kind":"json-schema","title":"send_output","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"message":{"$ref":"#/components/schemas/message"}}}}}},"components/schemas/latest_input":{"id":"components/schemas/latest_input","kind":"json-schema","title":"latest_input","data":{}},"components/schemas/common_reservation":{"id":"components/schemas/common_reservation","kind":"json-schema","title":"common_reservation","data":{"type":"string","description":"The unique identifier of the reservation"}},"components/schemas/latest_conversation":{"id":"components/schemas/latest_conversation","kind":"json-schema","title":"latest_conversation","data":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the conversation","$ref":"#/components/schemas/conversation"},"accommodation":{"type":"string","description":"The unique identifier of the property","$ref":"#/components/schemas/common_accommodation"},"reservation":{"type":"string","description":"The unique identifier of the reservation","$ref":"#/components/schemas/common_reservation"}}}},"components/schemas/latest_metadata":{"id":"components/schemas/latest_metadata","kind":"json-schema","title":"latest_metadata","data":{"type":"object","properties":{"type":{"description":"Specifies the conversation participant type.","type":"string","enum":["guest","property"]},"name":{"description":"The display name of the participant (e.g., guest or property name).","type":"string"}}}},"components/schemas/sender":{"id":"components/schemas/sender","kind":"json-schema","title":"sender","data":{"type":"object","properties":{"participant":{"description":"A unique identifier for the conversation participant.","type":"string"},"metadata":{"type":"object","$ref":"#/components/schemas/latest_metadata"}}}},"components/schemas/timestamp":{"id":"components/schemas/timestamp","kind":"json-schema","title":"timestamp","data":{"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 the message is sent. Format: YYYY-MM-DDTHH:mm:ss+00:00"},"children":[]}]}]}],"type":"string","format":"date-time"}},"components/schemas/latest_message":{"id":"components/schemas/latest_message","kind":"json-schema","title":"latest_message","data":{"type":"object","properties":{"conversation":{"type":"object","$ref":"#/components/schemas/latest_conversation"},"content":{"type":"string","description":"The body of the message."},"id":{"$ref":"#/components/schemas/message"},"sender":{"type":"object","$ref":"#/components/schemas/sender"},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/attachment"}},"timestamp":{"$ref":"#/components/schemas/timestamp"}}}},"components/schemas/latest_output":{"id":"components/schemas/latest_output","kind":"json-schema","title":"latest_output","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"messages":{"type":"array","description":"List of recent messages in reverse chronological order.","items":{"$ref":"#/components/schemas/latest_message"}}}}}}},"components/schemas/confirm_input":{"id":"components/schemas/confirm_input","kind":"json-schema","title":"ConfirmMessageReceiptRequest","data":{"title":"ConfirmMessageReceiptRequest","type":"object","properties":{"messages":{"type":"array","items":{"$ref":"#/components/schemas/message"}}}}},"components/schemas/confirm_output":{"id":"components/schemas/confirm_output","kind":"json-schema","title":"confirm_output","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"confirmedMessages":{"type":"array","items":{"$ref":"#/components/schemas/message"}}}}},"components/schemas/conversations_input":{"id":"components/schemas/conversations_input","kind":"json-schema","title":"RetrieveConversationRequest","data":{"title":"RetrieveConversationRequest","type":"object","required":["accommodation"],"properties":{"accommodation":{"type":"string","description":"The unique identifier of the property"},"conversation":{"description":"Uniquely identifies the conversation.","$ref":"#/components/schemas/conversation"},"reservation":{"type":"string","description":"Unique identifier of the reservation associated with this conversation.","$ref":"#/components/schemas/common_reservation"}},"oneOf":[{"required":["conversation"]},{"required":["reservation"]}]}},"components/schemas/conversations_message":{"id":"components/schemas/conversations_message","kind":"json-schema","title":"conversations_message","data":{"type":"object","required":["id","sender","content","timestamp"],"properties":{"id":{"type":"string","description":"Unique identifier of the message."},"sender":{"description":"Unique identifier of the sender (either property or guest).","type":"string"},"content":{"type":"string","description":"Message content in plain text."},"attachments":{"type":"array","description":"List of attachment IDs included with the message (if any).","items":{"type":"string"}},"timestamp":{"$ref":"#/components/schemas/timestamp"}}}},"components/schemas/conversations_metadata":{"id":"components/schemas/conversations_metadata","kind":"json-schema","title":"conversations_metadata","data":{"type":"object","properties":{"type":{"description":"Type of the metadata","type":"string","enum":["guest","property"]},"name":{"description":"Uniquely identifies the metadata.","type":"string"}}}},"components/schemas/participants":{"id":"components/schemas/participants","kind":"json-schema","title":"participants","data":{"type":"object","required":["id","metadata"],"properties":{"id":{"type":"string","description":"Unique identifier of the participant."},"metadata":{"type":"object","$ref":"#/components/schemas/conversations_metadata"}}}},"components/schemas/conversations_conversation":{"id":"components/schemas/conversations_conversation","kind":"json-schema","title":"conversations_conversation","data":{"type":"object","required":["id","messages","participants"],"properties":{"id":{"type":"string","description":"Unique identifier of the conversation."},"reservation":{"type":"string","description":"The unique identifier of the reservation","$ref":"#/components/schemas/common_reservation"},"messages":{"description":"Chronological list of messages in the conversation.","type":"array","items":{"$ref":"#/components/schemas/conversations_message"}},"participants":{"type":"array","description":"List of participants in the conversation, including guest and property.","items":{"$ref":"#/components/schemas/participants"}}}}},"components/schemas/conversations_output":{"id":"components/schemas/conversations_output","kind":"json-schema","title":"conversations_output","data":{"type":"object","required":["request_id","data"],"properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","required":["conversation"],"properties":{"conversation":{"type":"object","$ref":"#/components/schemas/conversations_conversation"}}}}}},"components/schemas/upload_input":{"id":"components/schemas/upload_input","kind":"json-schema","title":"upload_input","data":{"type":"object","required":["conversation","accommodation","file_size","file_name","file_type","file_content"],"properties":{"conversation":{"type":"string","description":"The unique identifier of the conversation","$ref":"#/components/schemas/conversation"},"accommodation":{"type":"string","description":"The unique identifier of the property","$ref":"#/components/schemas/common_accommodation"},"file_size":{"description":"The file size in bytes.","type":"integer","format":"int64","maximum":1048576},"file_name":{"description":"The original file name including extension.","type":"string"},"file_type":{"description":"The MIME type of the attachment (supported formats: PNG, JPEG, JPG).","type":"string"},"file_content":{"description":"Base64-encoded content of the attachment.","type":"string","contentEncoding":"base64"}}}},"components/schemas/upload_output":{"id":"components/schemas/upload_output","kind":"json-schema","title":"upload_output","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"attachment":{"type":"string","description":"The unique identifier of the attachment","$ref":"#/components/schemas/attachment"}}}}}},"components/schemas/download_input":{"id":"components/schemas/download_input","kind":"json-schema","title":"download_input","data":{"type":"object","properties":{"conversation":{"type":"string","description":"The unique identifier of the conversation","$ref":"#/components/schemas/conversation"},"accommodation":{"type":"string","description":"The unique identifier of the property","$ref":"#/components/schemas/common_accommodation"},"attachment":{"type":"string","description":"The unique identifier of the attachment","$ref":"#/components/schemas/attachment"}}}},"components/schemas/download_output":{"id":"components/schemas/download_output","kind":"json-schema","title":"download_output","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"conversation":{"type":"string","description":"The unique identifier of the conversation","$ref":"#/components/schemas/conversation"},"file_content":{"type":"string","description":"The content of the attachment","contentEncoding":"base64"},"attachment":{"type":"string","description":"The unique identifier of the attachment","$ref":"#/components/schemas/attachment"}}}}}},"components/schemas/metadata_input":{"id":"components/schemas/metadata_input","kind":"json-schema","title":"metadata_input","data":{"type":"object","properties":{"conversation":{"type":"string","description":"The unique identifier of the conversation","$ref":"#/components/schemas/conversation"},"accommodation":{"type":"string","description":"The unique identifier of the property","$ref":"#/components/schemas/common_accommodation"},"attachment":{"type":"string","description":"The unique identifier of the attachment","$ref":"#/components/schemas/attachment"}}}},"components/schemas/metadata_metadata":{"id":"components/schemas/metadata_metadata","kind":"json-schema","title":"metadata_metadata","data":{"type":"object","properties":{"file_size":{"description":"The size of the attachment (up to 1MB)","type":"integer","format":"int64","maximum":1048576},"file_name":{"description":"The original file name.","type":"string"},"file_type":{"description":"The MIME type of the attachment. Note only the following image formats are supported: PNG, JPEG, and JPG.","type":"string"}}}},"components/schemas/metadata_output":{"id":"components/schemas/metadata_output","kind":"json-schema","title":"metadata_output","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"metadata":{"$ref":"#/components/schemas/metadata_metadata"}}}}}},"schema_506":{"kind":"json-schema","data":{"type":"integer"},"id":"schema_506"},"schema_507":{"kind":"json-schema","data":{"type":"object","additionalProperties":false,"properties":{}},"id":"schema_507"},"schema_508":{"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_508"},"schema_509":{"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_509"},"schema_510":{"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_510"},"schema_511":{"kind":"json-schema","data":{"type":"object","properties":{"currency":{"$ref":"#/components/schemas/currencyId"},"reservations":{"type":"array","description":"List of reservation IDs to retrieve live car order details for. Currently limited to a single reservation per request.","items":{"type":"string"},"maxItems":1,"minItems":1},"booker":{"description":"Information about the person who made the booking. Required for car order details.","type":"object","properties":{"country":{"$ref":"#/components/schemas/countryId"}},"required":["country"]}},"required":["reservations","booker"]},"id":"schema_511"},"schema_512":{"kind":"json-schema","data":{"oneOf":[{"title":"AccommodationModification","$ref":"#/components/schemas/accommodationModificationInput"},{"title":"PaymentModification","$ref":"#/components/schemas/paymentModificationInput"}]},"id":"schema_512"},"schema_513":{"kind":"json-schema","data":{"oneOf":[{"title":"AccommodationModificationResponse","$ref":"#/components/schemas/accommodationModificationOutput"},{"title":"PaymentModificationResponse","$ref":"#/components/schemas/paymentModificationOutput"}]},"id":"schema_513"},"schema_514":{"kind":"json-schema","data":{"oneOf":[{"title":"AccommodationModificationPreview","$ref":"#/components/schemas/accommodationModificationPreviewInput"},{"title":"PaymentModificationPreview","$ref":"#/components/schemas/paymentModificationPreviewInput"}]},"id":"schema_514"},"schema_515":{"kind":"json-schema","data":{"oneOf":[{"title":"AccommodationModificationPreviewResponse","$ref":"#/components/schemas/accommodationModificationPreviewOutput"},{"title":"PaymentModificationPreviewResponse","$ref":"#/components/schemas/paymentModificationPreviewOutput"}]},"id":"schema_515"}},"exampleStore":{"components/examples/example-1":{"id":"components/examples/example-1","value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":"PRTcWzDlwXjP","breakdown":{"easy_to_access":{"number_of_reviews":182,"score":4.5},"facilities_rating":{"number_of_reviews":160,"score":4.7},"quality_of_service":{"number_of_reviews":175,"score":4.6},"value_of_experience":{"number_of_reviews":187,"score":4.8}}}]},"summary":"Typical attraction"},"components/examples/example-2":{"id":"components/examples/example-2","value":{"request_id":"01fr9ez700exycb98w90w5r9si","data":[{"id":"PRTcWzDlwXjP","breakdown":{"easy_to_access":{"number_of_reviews":4,"score":4.1},"facilities_rating":{"number_of_reviews":3,"score":4.2},"quality_of_service":{"number_of_reviews":4,"score":3.8},"value_of_experience":{"number_of_reviews":5,"score":4}}}]},"summary":"Attraction with few reviews"},"components/examples/example-3":{"id":"components/examples/example-3","value":{"request_id":"01fr9ez700exycb98w90w5r9sj","data":[{"id":"PRTcWzDlwXjP","breakdown":{"easy_to_access":{"number_of_reviews":0,"score":0},"facilities_rating":{"number_of_reviews":0,"score":0},"quality_of_service":{"number_of_reviews":0,"score":0},"value_of_experience":{"number_of_reviews":0,"score":0}}}]},"summary":"New attraction with no reviews"},"components/examples/input":{"id":"components/examples/input"},"components/examples/output":{"id":"components/examples/output"},"components/examples/examples-output":{"id":"components/examples/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~1smart-search/post/requestBody/content/application~1json/example":{"value":{"booker":{"country":"nl","platform":"desktop"},"checkin":"!START_DATE!","checkout":"!END_DATE!","city":-2140479,"guests":{"number_of_adults":2,"number_of_rooms":1},"search_query":"hotel with pool near the beach"},"id":"paths/~1accommodations~1smart-search/post/requestBody/content/application~1json/example"},"paths/~1accommodations~1smart-search/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}}],"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}],"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":"123456789569"}},"id":"paths/~1accommodations~1smart-search/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/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-attractions":{"value":{"currency":"EUR","attractions":["PR0dwCIbnsiU","AFd2wcIjMauX"],"dates":{"start_date":"2026-09-18","end_date":"2026-09-20"},"rows":50,"sort":{"by":"most_popular"}},"key":"search-by-attractions","summary":"Search by attractions","id":"paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-attractions"},"paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-cities":{"value":{"currency":"EUR","cities":[-2140479,-2154955],"dates":{"start_date":"2026-10-01","end_date":"2026-10-07"},"rows":50,"sort":{"by":"most_popular"}},"key":"search-by-cities","summary":"Search by cities","id":"paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-cities"},"paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-countries":{"value":{"currency":"USD","countries":["nl","fr"],"dates":{"start_date":"2026-11-15","end_date":"2026-11-30"},"rows":50,"sort":{"by":"most_popular"}},"key":"search-by-countries","summary":"Search by countries","id":"paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-countries"},"paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-coordinates":{"value":{"currency":"GBP","coordinates":{"latitude":51.509865,"longitude":-0.118092,"radius":10},"dates":{"start_date":"2026-12-24","end_date":"2026-12-26"},"rows":50,"sort":{"by":"most_popular"}},"key":"search-by-coordinates","summary":"Search by coordinates","id":"paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-by-coordinates"},"paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-with-filters":{"value":{"currency":"EUR","countries":["nl","fr"],"dates":{"start_date":"2026-12-24","end_date":"2026-12-26"},"filters":{"rating":{"minimum_review_score":4.5,"minimum_review_count":50},"supported_languages":["en-gb","es"],"categories":["PTTV32SGqJEv","PTTV3cuXCgPo"]}},"key":"search-with-filters","summary":"Search with filters","id":"paths/~1attractions~1search/post/requestBody/content/application~1json/examples/search-with-filters"},"paths/~1attractions~1search/post/responses/200/content/application~1json/example":{"value":{"data":[{"id":"PRahAzWtTraa","free_cancellation":true,"price":{"currency":"EUR","total":20},"urls":{"app":{"detail":"booking://attractions/product?slug=prahazwttraa-heineken-experience-amsterdam&aid=956509","search_results":"booking://attractions/searchresults?ufi=-2140479&pinned_product_id=PRahAzWtTraa&aid=956509"},"web":{"detail":"https://www.booking.com/attractions/nl/prahazwttraa-heineken-experience-amsterdam.en-gb.html?selected_currency=EUR&aid=956509","search_results":"https://www.booking.com/attractions/searchresults/nl/amsterdam.en-gb.html?pinned_product=PRahAzWtTraa&aid=956509"}}},{"id":"PRAmdacCwQLH","free_cancellation":false,"price":{"currency":"EUR","total":15.5},"urls":{"app":{"detail":"booking://attractions/product?slug=pramdaccwqlh-madame-tussauds-ticket&aid=956509","search_results":"booking://attractions/searchresults?ufi=-2140479&pinned_product_id=PRAmdacCwQLH&aid=956509"},"web":{"detail":"https://www.booking.com/attractions/nl/pramdaccwqlh-madame-tussauds-ticket.en-gb.html?selected_currency=EUR&aid=956509","search_results":"https://www.booking.com/attractions/searchresults/nl/amsterdam.en-gb.html?pinned_product=PRAmdacCwQLH&aid=956509"}}},{"id":"PRNQsDG3swdK","free_cancellation":true,"price":{"currency":"EUR","total":27.99},"urls":{"app":{"detail":"booking://attractions/product?slug=prnqsdg3swdk-full-day-dutch-countryside-tour-with-canal-cruise&aid=956509","search_results":"booking://attractions/searchresults?ufi=-2140479&pinned_product_id=PRNQsDG3swdK&aid=956509"},"web":{"detail":"https://www.booking.com/attractions/nl/prnqsdg3swdk-full-day-dutch-countryside-tour-with-canal-cruise.en-gb.html?selected_currency=EUR&aid=956509","search_results":"https://www.booking.com/attractions/searchresults/nl/amsterdam.en-gb.html?pinned_product=PRNQsDG3swdK&aid=956509"}}}],"metadata":{"next_page":"eyJhbGciOiJIUzI1NiJ9.eyJwIjp7ImN1cnJlbmN5IjoiRVVSIiwicXVlcnkiOnsiY291bnRyaWVzIjpbIm5sIiwiZnIiXSwiY29vcmRpbmF0ZXMiOnsibGF0aXR1ZGUiOjUyLjM3LCJsb25naXR1ZGUiOjQuOTAsIm1heF9kaXN0YW5jZV9rbSI6MTAwLjAwfSwic3RhcnRfZGF0ZSI6IjIwMjUtMDktMjEiLCJlbmRfZGF0ZSI6IjIwMjUtMDktMjIiLCJzdXBwb3J0ZWRfbGFuZ3VhZ2VzIjpbIm5sIl0sIm1pbl9yYXRpbmciOjQuMDAsIm1pbl9yZXZpZXdfY291bnQiOjV9LCJvcmRlcl9ieSI6Im1hdGNoX3Njb3JlIiwicGFnZV9udW1iZXIiOjJ9LCJhdWQiOiIvYXR0cmFjdGlvbnMvc2VhcmNoIiwiZXhwIjoxNzU3Mzc0MzI0fQ.JUU7kbuwiCaS4n_SZANA577BvZWdqDDQizU8q6fTrg0","total_results":128},"request_id":"01fr9ez700exycb98w90w5r9sh"},"id":"paths/~1attractions~1search/post/responses/200/content/application~1json/example"},"paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-attractions":{"value":{"attractions":["PRTcWzDlwXjP","PRahAzWtTraa","PRAmdacCwQLH"],"languages":["en-gb"],"rows":50},"key":"query-by-attractions","summary":"query-by-attractions","id":"paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-attractions"},"paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-cities":{"value":{"cities":[-2156821,-2140479],"languages":["en-gb"],"rows":50},"key":"query-by-cities","summary":"query-by-cities","id":"paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-cities"},"paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-countries":{"value":{"countries":["nl","be"],"languages":["en-gb"],"rows":50},"key":"query-by-countries","summary":"query-by-countries","id":"paths/~1attractions~1details/post/requestBody/content/application~1json/examples/query-by-countries"},"paths/~1attractions~1details/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":"PRTcWzDlwXjP","badges":["best_seller"],"categories":["museums_arts_culture"],"duration":"PT2H","photos":[{"url":"https://cf.bstatic.com/xdata/images/xphoto/500x375/170335205.jpg"}],"locations":[{"address":"Museumstraat 1","city":-2140479,"coordinates":{"latitude":52.360043,"longitude":4.885177},"country":"nl","post_code":"1071XX","type":"attraction"}],"long_description":{"en-gb":"Discover Dutch art and history at the Rijksmuseum, home to masterpieces by Rembrandt and Vermeer."},"name":{"en-gb":"Rijksmuseum Admission"},"ratings":{"number_of_reviews":3250,"score":4.8},"supported_languages":["en-gb","en-us","nl"],"urls":{"app":{"detail":"booking://attractions/product?slug=pr0dwcibnsiu-rijksmuseum-admission&aid=956509","search_results":"booking://attractions/searchresults?ufi=-2140479&pinned_product_id=PR0dwCIbnsiU&aid=956509"},"web":{"detail":"https://www.booking.com/attractions/nl/pr0dwcibnsiu-rijksmuseum-admission.html?aid=956509","search_results":"https://www.booking.com/attractions/searchresults/nl/amsterdam.en-gb.html?pinned_product=PR0dwCIbnsiU&aid=956509"}}}],"metadata":{"next_page":"eyJhbGciOiJIUzI1NiJ9.eyJwIjp7ImN1cnJlbmN5IjoiRVVSIiwicXVlcnkiOnsiY291bnRyaWVzIjpbIm5sIiwiZnIiXSwiY29vcmRpbmF0ZXMiOnsibGF0aXR1ZGUiOjUyLjM3LCJsb25naXR1ZGUiOjQuOTAsIm1heF9kaXN0YW5jZV9rbSI6MTAwLjAwfSwic3RhcnRfZGF0ZSI6IjIwMjUtMDktMjEiLCJlbmRfZGF0ZSI6IjIwMjUtMDktMjIiLCJzdXBwb3J0ZWRfbGFuZ3VhZ2VzIjpbIm5sIl0sIm1pbl9yYXRpbmciOjQuMDAsIm1pbl9yZXZpZXdfY291bnQiOjV9LCJvcmRlcl9ieSI6Im1hdGNoX3Njb3JlIiwicGFnZV9udW1iZXIiOjJ9LCJhdWQiOiIvYXR0cmFjdGlvbnMvc2VhcmNoIiwiZXhwIjoxNzU3Mzc0MzI0fQ.JUU7kbuwiCaS4n_SZANA577BvZWdqDDQizU8q6fTrg0","total_results":128}},"id":"paths/~1attractions~1details/post/responses/200/content/application~1json/example"},"paths/~1attractions~1reviews/post/requestBody/content/application~1json/example":{"value":{"attraction":"PRTcWzDlwXjP","language":"en-gb","rows":10},"id":"paths/~1attractions~1reviews/post/requestBody/content/application~1json/example"},"paths/~1attractions~1reviews/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"attraction":"PRTcWzDlwXjP","id":"review123456","author":"John D.","author_country_code":"us","rating":5,"text":"Amazing experience at the museum. The artwork is incredible and the building itself is an architectural masterpiece.","language":"en-gb","date":"2025-08-15"},{"attraction":"PR0dwCIbnsiU","id":"review789012","author":"Maria S.","author_country_code":"es","rating":4,"text":"Very good museum with impressive collections. Would recommend allowing more time than suggested to see everything.","language":"en-gb","date":"2025-07-22"}],"metadata":{"next_page":"NextPageToken123","total_results":243}},"id":"paths/~1attractions~1reviews/post/responses/200/content/application~1json/example"},"paths/~1attractions~1reviews~1scores/post/requestBody/content/application~1json/example":{"value":{"attractions":["PRTcWzDlwXjP"]},"id":"paths/~1attractions~1reviews~1scores/post/requestBody/content/application~1json/example"},"paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/typical-attractions":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"id":"PRTcWzDlwXjP","breakdown":{"easy_to_access":{"number_of_reviews":182,"score":4.5},"facilities_rating":{"number_of_reviews":160,"score":4.7},"quality_of_service":{"number_of_reviews":175,"score":4.6},"value_of_experience":{"number_of_reviews":187,"score":4.8}}}]},"key":"typical-attractions","summary":"Typical attraction","id":"paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/typical-attractions"},"paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/few-reviews":{"value":{"request_id":"01fr9ez700exycb98w90w5r9si","data":[{"id":"PRTcWzDlwXjP","breakdown":{"easy_to_access":{"number_of_reviews":4,"score":4.1},"facilities_rating":{"number_of_reviews":3,"score":4.2},"quality_of_service":{"number_of_reviews":4,"score":3.8},"value_of_experience":{"number_of_reviews":5,"score":4}}}]},"key":"few-reviews","summary":"Attraction with few reviews","id":"paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/few-reviews"},"paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/no-reviews":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sj","data":[{"id":"PRTcWzDlwXjP","breakdown":{"easy_to_access":{"number_of_reviews":0,"score":0},"facilities_rating":{"number_of_reviews":0,"score":0},"quality_of_service":{"number_of_reviews":0,"score":0},"value_of_experience":{"number_of_reviews":0,"score":0}}}]},"key":"no-reviews","summary":"New attraction with no reviews","id":"paths/~1attractions~1reviews~1scores/post/responses/200/content/application~1json/examples/no-reviews"},"paths/~1attractions~1constants/post/requestBody/content/application~1json/examples/english":{"value":{"languages":["en-gb"]},"key":"english","summary":"Request with English language","id":"paths/~1attractions~1constants/post/requestBody/content/application~1json/examples/english"},"paths/~1attractions~1constants/post/responses/200/content/application~1json/examples/single_language":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":{"categories":[{"id":"PTTV32SGqJEv","name":{"en-gb":"Tours"},"parent":null},{"id":"PTTV3cuXCgPo","name":{"en-gb":"Museums, arts & culture"},"parent":null},{"id":"PTTV3Etlc9Eu","name":{"en-gb":"Walking & hiking tours"},"parent":"PTTV32SGqJEv"}]}},"key":"single_language","summary":"Response with default language (en-gb)","id":"paths/~1attractions~1constants/post/responses/200/content/application~1json/examples/single_language"},"paths/~1attractions~1constants/post/responses/200/content/application~1json/examples/multi_language":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":{"categories":[{"id":"PTTV32SGqJEv","name":{"en-gb":"Tours","es":"Tours"},"parent":null},{"id":"PTTV3cuXCgPo","name":{"en-gb":"Museums, arts & culture","es":"Museos, arte y cultura"},"parent":null},{"id":"PTTV3Etlc9Eu","name":{"en-gb":"Walking & hiking tours","es":"Tours a pie y de senderismo"},"parent":"PTTV32SGqJEv"}]}},"key":"multi_language","summary":"Response with multiple languages","id":"paths/~1attractions~1constants/post/responses/200/content/application~1json/examples/multi_language"},"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~1availability/post/requestBody/content/application~1json/example":{"value":{"offer":740171366,"search_token":"eyJhbGciOiJIUzI1NiJ9.eyJwIjp7InNlYXJjaF9rZXkiOiJleUprY21sMlpYSnpRV2RsSWpvek5pd2laSEp2Y0U5bVprUmhkR1ZVYVcxbElqb2lNakF5TlMwd09TMHlNRlF4TVRvd05Ub3dNQ0lzSW1SeWIzQlBabVpNYjJOaGRHbHZiaUk2SWsxQlRpSXNJbVJ5YjNCUFptWk1iMk5oZEdsdmJsUjVjR1VpT2lKSlFWUkJJaXdpY0dsamExVndSR0YwWlZScGJXVWlPaUl5TURJMUxUQTVMVEU0VkRFeE9qQTFPakF3SWl3aWNHbGphMVZ3VEc5allYUnBiMjRpT2lKTlFVNGlMQ0p3YVdOclZYQk1iMk5oZEdsdmJsUjVjR1VpT2lKSlFWUkJJaXdpY21WdWRHRnNSSFZ5WVhScGIyNUpia1JoZVhNaU9qSXNJbk5sY25acFkyVkdaV0YwZFhKbGN5STZXeUpUVlZCUVVrVlRVMTlFU1ZKRlExUmZVRUZaWDB4UFEwRk1YMVpGU0VsRFRFVlRJbDE5IiwiYm9va2VyIjp7ImNvdW50cnkiOiJnYiJ9fSwiYXVkIjoiL2NhcnMvYXZhaWxhYmlsaXR5IiwiZXhwIjoxNzUzMTA2MDg2fQ.t8VrrJhUAvbAwIK_bO5cNAIB5Z_UfcolMEsGzlq3-eo","currency":"GBP","language":"en-gb"},"id":"paths/~1cars~1availability/post/requestBody/content/application~1json/example"},"paths/~1cars~1availability/post/responses/200/content/application~1json/example":{"value":{"request_id":"01k1deq3e5b41da80f28yybhz0","data":{"offer":740171366,"currency":"GBP","policies":{"cancellation":{"type":"free_cancellation","details":{"context":"before_pickup","duration":"PT48H"}},"damage_excess":{"amount":1500},"deposit":{"amount":1500},"insurance_package":"inclusive","payment":{"timing":"pay_online_now"},"fuel":"return_same","mileage":{"distance_limit":200,"distance_unit":"miles","amount":0.3,"currency":"GBP","type":"limited"},"theft_excess":{"amount":1500}},"price":{"base":74.4,"total":194.4,"credit_card_required":false,"extra_charges":[{"charge":"aged_driver_fee","total_amount":120}]},"products":[{"id":"14383444201010","type":"additional_driver","maximum_available":3,"mode":"each_per_rental","price":{"unit_amount":{"display":{"value":20,"currency":"GBP"},"pay":{"value":20,"currency":"GBP","timing":"pay_at_pickup"}}}},{"id":"14383470981010","type":"baby_seat","maximum_available":2,"mode":"each_per_rental","price":{"unit_amount":{"display":{"value":33.98,"currency":"GBP"},"pay":{"value":33.98,"currency":"GBP","timing":"pay_at_pickup"}}}},{"id":"14383497761010","type":"child_booster_seat","maximum_available":2,"mode":"each_per_rental","price":{"unit_amount":{"display":{"value":21.98,"currency":"GBP"},"pay":{"value":21.98,"currency":"GBP","timing":"pay_at_pickup"}}}},{"id":"14383524541010","type":"child_seat","maximum_available":2,"mode":"each_per_rental","price":{"unit_amount":{"display":{"value":33.98,"currency":"GBP"},"pay":{"value":33.98,"currency":"GBP","timing":"pay_at_pickup"}}}},{"id":"14383551321010","type":"gps","maximum_available":1,"mode":"per_rental","price":{"unit_amount":{"display":{"value":31.98,"currency":"GBP"},"pay":{"value":31.98,"currency":"GBP","timing":"pay_at_pickup"}}}}],"deal":null,"special_offer":"upgrade","supplier":3486,"route":{"dropoff":{"depot":243816,"depot_location_type":"meet_greet"},"pickup":{"depot":243816,"depot_location_type":"meet_greet"}},"insurance":{"quote_reference":"38ddeef-a7fb-4e24-a1e2-66fc3af23d76#1t0juiba8h6n2","name":"Full Protection","id":"999","price":{"display":{"value":114.24,"currency":"GBP"},"pay":{"value":114.24,"currency":"EUR","timing":"pay_online_now"}},"coverage_amount":{"value":60000,"currency":"EUR"},"documents":[{"name":"policy_document","url":"https://staging.rentalcover.com/pds"},{"name":"ipid","url":"https://files.rentalcover.com/ipids/uploads/staging/document.pdf"}]},"estimated_commission":{"amount":12.5,"currency":"GBP"}}},"id":"paths/~1cars~1availability/post/responses/200/content/application~1json/example"},"paths/~1cars~1availability/post/responses/400/content/application~1json/examples/invalid_offer":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_request","message":"Offer 123 is invalid"}]},"key":"invalid_offer","summary":"Invalid offer ID","id":"paths/~1cars~1availability/post/responses/400/content/application~1json/examples/invalid_offer"},"paths/~1cars~1availability/post/responses/400/content/application~1json/examples/expired_token":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"expired_token","message":"Token 'search_token' has expired."}]},"key":"expired_token","summary":"Search token expired","id":"paths/~1cars~1availability/post/responses/400/content/application~1json/examples/expired_token"},"paths/~1cars~1availability/post/responses/400/content/application~1json/examples/invalid_token":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_token","message":"Token 'search_token' is invalid."}]},"key":"invalid_token","summary":"Invalid token","id":"paths/~1cars~1availability/post/responses/400/content/application~1json/examples/invalid_token"},"paths/~1cars~1availability/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~1availability/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/~1cars~1terms-and-conditions/post/requestBody/content/application~1json/example":{"value":{"offer":123456789,"currency":"USD","language":"en-us","search_token":"eyJkcml2ZXJzQWdlIjozMCwiZHJvcE9mZkRhdGVUaW1lIjo"},"id":"paths/~1cars~1terms-and-conditions/post/requestBody/content/application~1json/example"},"paths/~1cars~1terms-and-conditions/post/responses/200/content/application~1json/example":{"value":{"data":{"key_info":{"common":{"credit_cards_allowed":true,"debit_cards_allowed":true,"driver_age":25,"insurance_available":true,"rental_duration":3},"damage_excess":{"content":["This is the maximum amount you'll pay if the car's bodywork gets damaged or stolen"],"excess_value":"$1000","subtitle":"Your liability in case of damage","title":"Damage excess"},"deposit":{"accepted_cards":[{"title":"Visa credit card","type":"VISA"}],"accepted_cards_title":"Accepted payment methods","content":["A security deposit of $200 will be required at pick-up"],"subtitle":"Required at pick-up","title":"Security deposit"},"disclaimers":["All information is subject to local supplier terms and conditions"],"driver_and_license":{"needed_items":["Valid driver's license","Credit card in main driver's name"],"title":"Driver requirements","top_text":"Required documents for pick-up"},"mileage":{"content":"Unlimited mileage included","subtitle":"Distance included","title":"Mileage"}},"terms":[{"children":[{"children":[{"children":[{"children":[{"text":"Driver must be <b>at least 25 years of age</b> to rent this vehicle.","type":"clause_option"}],"type":"sub_clause"}],"title":"Age restrictions","type":"clause"}],"title":"Driver requirements","type":"section"}],"title":"Rental agreement","type":"chapter"}]},"request_id":"01fr9ez700exycb98w90w5r9sh"},"id":"paths/~1cars~1terms-and-conditions/post/responses/200/content/application~1json/example"},"paths/~1cars~1terms-and-conditions/post/responses/400/content/application~1json/examples/invalid_offer":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_request","message":"Offer 123 is invalid"}]},"key":"invalid_offer","summary":"Invalid offer ID","id":"paths/~1cars~1terms-and-conditions/post/responses/400/content/application~1json/examples/invalid_offer"},"paths/~1cars~1terms-and-conditions/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~1terms-and-conditions/post/responses/500/content/application~1json/examples/internal_error"},"paths/~1common~1autocomplete/post/requestBody/content/application~1json/examples/default":{"key":"default","summary":"default","id":"paths/~1common~1autocomplete/post/requestBody/content/application~1json/examples/default"},"paths/~1common~1autocomplete/post/responses/200/content/application~1json/examples/default":{"key":"default","summary":"default","id":"paths/~1common~1autocomplete/post/responses/200/content/application~1json/examples/default"},"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/examples/accommodation_example":{"value":{"accommodation":{"label":"Sample label","products":[{"id":"333","bed_configuration":"123456","guests":[{"email":"john.doe@booking.com","name":"John Doe"}]}],"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":"john.doe@booking.com","language":"en-gb","name":{"first_name":"John","last_name":"Doe"},"telephone":"12345678"},"order_token":"sample-token","payment":{"card":{"cardholder":"John Doe","cvc":"111","expiry_date":"2030-10","number":"23333333333333"},"include_receipt":true,"method":"card","timing":"pay_online_now"}},"key":"accommodation_example","summary":"Create accommodation order with pay online now","id":"paths/~1orders~1create/post/requestBody/content/application~1json/examples/accommodation_example"},"paths/~1orders~1create/post/requestBody/content/application~1json/examples/car_example":{"value":{"car":{"driver":{"email":"john.doe@booking.com","first_name":"John","last_name":"Doe","telephone":"12345678","title":"Mr"}},"booker":{"address":{"address_line":"Road-1, house-2","city":"Amsterdam","country":"nl","post_code":"11111"},"company":"Booking B.V","email":"john.doe@booking.com","language":"en-gb","name":{"first_name":"John","last_name":"Doe"},"telephone":"12345678"},"order_token":"sample-token","payment":{"card":{"cardholder":"John Doe","cvc":"111","expiry_date":"2030-10","number":"23333333333333"},"include_receipt":false,"method":"card","timing":"pay_at_pickup"}},"key":"car_example","summary":"Create car rental order with pay at pickup","id":"paths/~1orders~1create/post/requestBody/content/application~1json/examples/car_example"},"paths/~1orders~1create/post/responses/200/content/application~1json/examples/accommodation_example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":{"order":"509430129718799","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/missing_parameter":{"value":{"request_id":"01kkc2ft6g1ayfk2zfpfvsxpnh","errors":[{"id":"missing_parameter","message":"Parameter 'car.booker.email' is missing."}]},"key":"missing_parameter","summary":"Missing parameter error","id":"paths/~1orders~1create/post/responses/400/content/application~1json/examples/missing_parameter"},"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/server_error":{"value":{"request_id":"01kjan66dedrpbwv4m1966dzw3","errors":[{"id":"500","message":"Internal server error. Try again later or contact support."}]},"key":"server_error","summary":"Generic server error","id":"paths/~1orders~1create/post/responses/500/content/application~1json/examples/server_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~1details~1cars~1terms-and-conditions/post/requestBody/content/application~1json/example":{"value":{"booker":{"country":"gb"},"language":"en-gb","orders":["765255700","invalid_order"],"filters":{"voucher":true}},"id":"paths/~1orders~1details~1cars~1terms-and-conditions/post/requestBody/content/application~1json/example"},"paths/~1orders~1details~1cars~1terms-and-conditions/post/responses/200/content/application~1json/example":{"value":{"request_id":"123456789","data":{"765255700":{"terms":[{"type":"chapter","title":"Rental agreement","children":[{"type":"section","title":"Driver requirements","children":[{"type":"clause","title":"Age restrictions","children":[{"type":"sub_clause","children":[{"type":"clause_option","text":"Driver must be <b>at least 25 years of age</b> to rent this vehicle."}]}]}]}]}]},"invalid_order":{"terms":null}}},"id":"paths/~1orders~1details~1cars~1terms-and-conditions/post/responses/200/content/application~1json/example"},"paths/~1orders~1details~1cars~1terms-and-conditions/post/responses/400/content/application~1json/examples/missing_parameter":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"missing_parameter","message":"Parameter 'orders' is missing."}]},"key":"missing_parameter","summary":"Missing parameter","id":"paths/~1orders~1details~1cars~1terms-and-conditions/post/responses/400/content/application~1json/examples/missing_parameter"},"paths/~1orders~1details~1cars~1terms-and-conditions/post/responses/400/content/application~1json/examples/invalid_parameter":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_parameter","message":"Parameter 'language' is invalid."}]},"key":"invalid_parameter","summary":"Malformed request","id":"paths/~1orders~1details~1cars~1terms-and-conditions/post/responses/400/content/application~1json/examples/invalid_parameter"},"paths/~1orders~1details~1cars~1terms-and-conditions/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~1terms-and-conditions/post/responses/500/content/application~1json/examples/internal_error"},"paths/~1orders~1details~1cars~1faq/post/requestBody/content/application~1json/example":{"value":{"languages":["en-gb","fr","de","es"]},"id":"paths/~1orders~1details~1cars~1faq/post/requestBody/content/application~1json/example"},"paths/~1orders~1details~1cars~1faq/post/responses/200/content/application~1json/example":{"value":{"request_id":"123456789","data":{"faqs":[{"question":{"de":"Was ist, wenn ich meine Buchungsbestätigung nicht erhalten habe?","fr":"Que dois-je faire si je n'ai pas reçu ma confirmation de réservation ?","en-gb":"What if I haven’t received my booking confirmation?","es":"¿Qué hago si no he recibido la confirmación de mi reserva?"},"answers":{"de":["Die meisten Buchungen werden sofort bestätigt. Bitte überprüfen Sie Ihren Spam-Ordner, wenn Sie nichts in Ihrem Posteingang finden.","Sie können den Status Ihrer Buchung jederzeit online einsehen:","Wenn Sie die App benutzen, tippen Sie unten auf dem Bildschirm auf „Buchungen“.","Wenn Sie die Webseite verwenden, vergewissern Sie sich, dass Sie angemeldet sind und sich auf der Seite „Mietwagen“ befinden. Klicken Sie dann oben auf „Buchung bearbeiten“.","Wie ist der Status?","Wenn Sie feststellen, dass Ihre Buchung noch nicht bestätigt ist, ist sie noch in Bearbeitung – wir schicken Ihnen eine E-Mail, sobald sie bestätigt ist. Im unwahrscheinlichen Fall, dass wir auf Probleme stoßen, werden wir Sie so schnell wie möglich benachrichtigen."],"fr":["La plupart des réservations sont immédiatement confirmées. Si vous n'avez pas reçu d'e-mail de confirmation, veuillez vérifier vos spams. ","Vous pouvez aussi vérifier le statut de votre réservation en ligne :","Sur l'appli, appuyez sur « Réservations » en bas de l'écran.","Sur le site Internet, connectez-vous à votre compte et rendez-vous sur la page « Voitures de location ». Ensuite, cliquez sur « Gérer la réservation ».","Quel est le statut de ma réservation ?","Si vous voyez que votre réservation n'est pas encore confirmée, cela signifie qu'elle est en cours de traitement. Nous vous enverrons un e-mail dès qu'elle sera confirmée. Dans l'éventualité où votre réservation rencontrerait un problème, nous vous en informerons dans les meilleurs délais."],"en-gb":["Most bookings are confirmed straight away, so please check your spam folder if there’s nothing in your inbox. ","You can always check the status of your booking online:","If you’re using the app, tap ‘Bookings’ at the bottom of the screen.","If you’re using the website, make sure you’re signed in and on the ‘Car rentals’ page - then hit ‘Manage booking’ at the top.","What’s the status?","If you find that your booking isn’t confirmed yet, we’re working on it - and we’ll email you as soon as it is. In the unlikely event that we run into any problems, we’ll let you know as soon as we can."],"es":["La mayoría de las reservas se confirman al momento, así que si no la tienes en la bandeja de entrada, mira en la carpeta de spam.","Puedes consultar online el estado de tu reserva siempre que quieras:","Si utilizas la app, dale a \"Reservas\" en la parte de abajo de la pantalla.","Si utilizas la web, comprueba que has iniciado sesión y después ve a la página de \"Alquiler de coches\" y dale a \"Gestionar la reserva\" en la parte de arriba.","¿Cuál es el estado?","Si ves que la reserva aún no está confirmada es que estamos gestionándola. Te enviaremos un e-mail en cuanto lo sepamos. Si hubiera algún problema, te lo haremos saber lo antes posible."]}}]}},"id":"paths/~1orders~1details~1cars~1faq/post/responses/200/content/application~1json/example"},"paths/~1orders~1details~1cars~1faq/post/responses/400/content/application~1json/examples/invalid_parameter":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_parameter","message":"Parameter 'languages[0]' is invalid."}]},"key":"invalid_parameter","summary":"Malformed request","id":"paths/~1orders~1details~1cars~1faq/post/responses/400/content/application~1json/examples/invalid_parameter"},"paths/~1orders~1details~1cars~1faq/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~1faq/post/responses/500/content/application~1json/examples/internal_error"},"paths/~1orders~1details~1cars~1live/post/requestBody/content/application~1json/example":{"value":{"currency":"USD","reservations":["11223344"],"booker":{"country":"nl"}},"id":"paths/~1orders~1details~1cars~1live/post/requestBody/content/application~1json/example"},"paths/~1orders~1details~1cars~1live/post/responses/200/content/application~1json/example":{"value":{"request_id":"01fr9ez700exycb98w90w5r9sh","data":[{"affiliate":1234567,"reservation":"11223344","duration":3,"status":"confirmed","pickup":{"datetime":"2025-10-15T10:00:00","location":"Dublin Airport","depot_type":"Airport","depot_id":"12345","instructions":"Proceed to shuttle bus zone 3."},"dropoff":{"datetime":"2025-10-18T10:00:00","location":"Dublin Airport","depot_type":"Airport","depot_id":"12345","instructions":"Follow signs to car rental return area."},"driver":{"name":"John Doe","email":"john.doe@example.com","telephone":"+15558675309"},"car":{"id":803765581,"image":"images/car_images/web/toyota/corolla_lrg.jpg","category":"Compact","transmission":"Automatic","doors":"4","seats":"5","air_conditioning":true,"big_suitcase":"2","small_suitcase":"1","currency":"EUR","make_and_model":"Toyota Corolla","special_offer":"Baby/child seat included","supplier":{"id":"SUP123","name":"Avis","telephone":"+353 1 800 123456","confirmation_number":"ZYX987"},"price":{"base":{"display":{"value":110,"currency":"USD"},"pay":{"value":100,"currency":"EUR","timing":"pay_online_now"}},"pre_discount_base":{"display":{"value":132,"currency":"USD"},"pay":{"value":120,"currency":"EUR","timing":"pay_online_now"}},"total":[{"display":{"value":110,"currency":"USD"},"pay":{"value":100,"currency":"EUR","timing":"pay_online_now"}},{"display":{"value":0,"currency":"USD"},"pay":{"value":0,"currency":"EUR","timing":"pay_at_pickup"}}]},"policies":{"deposit":{"value":500,"currency":"EUR","timing":"pay_at_pickup"},"mileage":{"type":"unlimited"},"fuel_policy":"return_same","cancellation":{"type":"free_cancellation","schedule":[{"from":"2025-10-14T10:00:00Z","to":"2025-10-17T09:59:59Z","free_cancellation":true,"price":null},{"from":"2025-10-17T10:00:00Z","to":"2025-10-19T10:00:00Z","free_cancellation":false,"price":{"display":{"value":25,"currency":"USD"},"pay":{"value":22.73,"currency":"EUR"}}}]}}},"products":[{"id":"14383444951010","type":"additional_driver","selected_quantity":1,"mode":"each_per_rental","price":{"display":{"value":16.49,"currency":"USD"},"pay":{"value":14.99,"currency":"EUR","timing":"pay_at_pickup"}}}],"insurance":[{"id":"335","name":"RentalCover Full Protection","price":{"display":{"value":32.63,"currency":"USD"},"pay":{"value":28.01,"currency":"EUR"}},"policy_reference":"1a8192e7-cc40-41a0-9bc1-801d95dc0c23","status":"confirmed","documents":[{"name":"policy_document","url":"https://staging.rentalcover.com/en/pds/WXXG-CVHM-INS","status":"available"},{"name":"ipid","url":null,"status":"unavailable"},{"name":"certificate","url":"https://cars.booking.com/protection-documents/document/signed/certificate/46e710cb-b3d9-415a-bcc5-00ea1c920389","status":"available"}]}]}]},"id":"paths/~1orders~1details~1cars~1live/post/responses/200/content/application~1json/example"},"paths/~1orders~1details~1cars~1live/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: 'reservations'."}]},"key":"missing_parameter","summary":"Missing parameter","id":"paths/~1orders~1details~1cars~1live/post/responses/400/content/application~1json/examples/missing_parameter"},"paths/~1orders~1details~1cars~1live/post/responses/400/content/application~1json/examples/invalid_parameter":{"value":{"request_id":"01kjan7r7yvff5yg95gxy1cjhy","errors":[{"id":"invalid_parameter","message":"Parameter 'reservations' is invalid."}]},"key":"invalid_parameter","summary":"Malformed request","id":"paths/~1orders~1details~1cars~1live/post/responses/400/content/application~1json/examples/invalid_parameter"},"paths/~1orders~1details~1cars~1live/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~1live/post/responses/500/content/application~1json/examples/internal_error"},"paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/accommodation_dates_example":{"value":{"order":"6520081014","modification":{"accommodation":{"reservation":"6187285715","type":"dates","change":{"checkin":"2026-04-19","checkout":"2026-04-21"}}}},"key":"accommodation_dates_example","summary":"Preview accommodation date change","id":"paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/accommodation_dates_example"},"paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/accommodation_room_example":{"value":{"order":"6520081014","modification":{"accommodation":{"reservation":"6187285715","type":"room","change":{"room_reservation":"9876543210","allocation":{"number_of_adults":2},"guests":[{"name":"John Doe"},{"name":"Jane Doe"}],"smoking_preference":"non_smoking"}}}},"key":"accommodation_room_example","summary":"Preview accommodation room change","id":"paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/accommodation_room_example"},"paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/payment_card_example":{"value":{"order":"6520081014","modification":{"payment":{"type":"card","change":{"cardholder":"John Doe","number":"4111111111111111","expiry_date":"2027-12","cvc":"123"}}}},"key":"payment_card_example","summary":"Preview payment card change","id":"paths/~1orders~1modify~1preview/post/requestBody/content/application~1json/examples/payment_card_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"},"paths/~1messages~1send/post/requestBody/content/application~1json/example":{"value":{"conversation":"8586a789-44f4-5521-9f27-f5efd097cba6","accommodation":6819547,"content":"Hello! This is my first message","attachments":["c325f460-1dc6-11f0-80f0-8d0908786f77"]},"id":"paths/~1messages~1send/post/requestBody/content/application~1json/example"},"paths/~1messages~1send/post/responses/200/content/application~1json/example":{"value":{"request_id":"cdb0b154-2eae-481b-8fee-fb2725296e1f","data":{"message":"3164e570-19e0-11f0-baca-e5019c8df435"}},"id":"paths/~1messages~1send/post/responses/200/content/application~1json/example"},"paths/~1messages~1latest/post/requestBody/content/application~1json/example":{"value":{},"id":"paths/~1messages~1latest/post/requestBody/content/application~1json/example"},"paths/~1messages~1latest/post/responses/200/content/application~1json/example":{"value":{"request_id":"0248d85a-17e0-44b3-a37c-7d4b5c03f58b","data":{"messages":[{"conversation":{"id":"b2364f9b-6466-599a-a947-0d35cff4f492","reservation":"4439608993","accommodation":"5589515"},"content":"Hello Pega, welcome to CS Training Test Hotel Sloterdijk 10! We’re very happy to have you with us.\\nYour check-in date is : Tuesday 5 August 2025\\nYour check-in time is : 00:00 \\nNumber of nights: 3\\n\nWe hope you have a pleasant trip and enjoy your stay with us.\\n\nBest regards,\nThe CS Training Test Hotel Sloterdijk 10 Team.","id":"52100000-2be9-11f0-bced-bdc849c480b6","sender":{"participant":"930d9af8-2390-5e43-a4d7-235b52a30a14","metadata":{"type":"property","name":"CS Training Test Hotel Sloterdijk 10"}},"attachments":[],"timestamp":"2025-05-08T08:49:15.000Z"}]}},"id":"paths/~1messages~1latest/post/responses/200/content/application~1json/example"},"paths/~1messages~1latest~1confirm/post/requestBody/content/application~1json/example":{"value":{"messages":["8586a789-44f4-5521-9f27-f5efd097cba"]},"id":"paths/~1messages~1latest~1confirm/post/requestBody/content/application~1json/example"},"paths/~1messages~1latest~1confirm/post/responses/200/content/application~1json/example":{"value":{"request_id":"cdb0b154-2eae-481b-8fee-fb2725296e1f","confirmedMessages":["8586a789-44f4-5521-9f27-f5efd097cba"]},"id":"paths/~1messages~1latest~1confirm/post/responses/200/content/application~1json/example"},"paths/~1messages~1attachments~1metadata/post/requestBody/content/application~1json/example":{"value":{"conversation":"8586a789-44f4-5521-9f27-f5efd097cba6","accommodation":6819547,"attachment":"9635be40-1dc6-11f0-8893-0130f0cdef6d"},"id":"paths/~1messages~1attachments~1metadata/post/requestBody/content/application~1json/example"},"paths/~1messages~1attachments~1metadata/post/responses/200/content/application~1json/example":{"value":{"request_id":"fec1a9bb-9c85-42fc-a109-3707e1ed4de7","data":{"metadata":{"file_size":92620,"file_name":"1ce51916-d8de-4144-a4be-265ccae5df9d.jpg","file_type":"image/jpeg"}}},"id":"paths/~1messages~1attachments~1metadata/post/responses/200/content/application~1json/example"},"paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/0":{"key":"0","summary":"0","id":"paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/0"},"paths/~1messages~1conversations/post/responses/200/content/application~1json/example":{"value":{"request_id":"7889a8c0-aa43-494c-863d-72d2306849c1","data":{"conversation":{"id":"c3cc6522-aa63-559d-99f1-94efdd527c3c","reservation":"4338284887","messages":[{"id":"af3d7fd0-1c50-11f0-81cd-6d243d208da3","sender":"6c22a16d-a3bd-5f5b-82d9-ce1030f21b1f","content":"Thank you for choosing Demand API Messaging Test Hotel...","attachments":[],"timestamp":"2025-04-18T12:28:51.149Z"}],"participants":[{"id":"5dba2525-2c49-5d2c-91cc-7195526c0c7a","metadata":{"type":"guest"}},{"id":"6c22a16d-a3bd-5f5b-82d9-ce1030f21b1f","metadata":{"type":"property","name":"6819547"}}]}}},"id":"paths/~1messages~1conversations/post/responses/200/content/application~1json/example"},"paths/~1messages~1attachments~1upload/post/requestBody/content/application~1json/example":{"value":{"accommodation":6819547,"conversation":"8586a789-44f4-5521-9f27-f5efd097cba6","file_size":17580,"file_name":"a3e062a0-3e6b-4592-9df2-64cf83688084.jpg","file_type":"image/jpeg","file_content":"/9j/4AAQSkZJRgABAQACWAJYAAD/2wCEAAgGBgc"},"id":"paths/~1messages~1attachments~1upload/post/requestBody/content/application~1json/example"},"paths/~1messages~1attachments~1upload/post/responses/200/content/application~1json/example":{"value":{"request_id":"c249e7b6-be70-411b-bcb7-0c2d49313199","data":{"attachment":"695b7f90-2c08-11f0-9cee-134ca9b067d1"}},"id":"paths/~1messages~1attachments~1upload/post/responses/200/content/application~1json/example"},"paths/~1messages~1attachments~1download/post/requestBody/content/application~1json/example":{"value":{"conversation":"8586a789-44f4-5521-9f27-f5efd097cba6","accommodation":6819547,"attachment":"9635be40-1dc6-11f0-8893-0130f0cdef6d"},"id":"paths/~1messages~1attachments~1download/post/requestBody/content/application~1json/example"},"paths/~1messages~1attachments~1download/post/responses/200/content/application~1json/example":{"value":{"request_id":"773e2c0d-1ab3-449b-b88a-3d6b5ce09ae7","data":{"conversation":"8586a789-44f4-5521-9f27-f5efd097cba6","file_content":"/9j/4AAQSkZJRgABAQACWAJYAAD/2wCEAAgGBgc","attachment":"9635be40-1dc6-11f0-8893-0130f0cdef6d"}},"id":"paths/~1messages~1attachments~1download/post/responses/200/content/application~1json/example"}},"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-beta/demand-api.json?download"},{"url":"/_bundle/demand/docs/open-api/3.2-beta/demand-api.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Booking.com Demand API","summary":"**Beta version – experimental endpoints**\n\nThis API version is **currently in Beta** and is offered to a limited set of pilot affiliate partners. Access is granted on request via your Booking.com account manager.\n\n> ⚠️ **Important:** This API is **under active development**. Endpoints, request/response structures, and functionality may change without prior notice. Specifications are updated frequently during the pilot phase.\n\n- Consult the [Changelog](/demand/docs/whats-new/changelog) for the latest updates.\n- All requests **require authentication** using your Affiliate ID and token credentials."}},"baseSlug":"/demand/docs/open-api/3.2-beta/demand-api","routesMapping":{}}