{"items":[{"type":"link","label":"Connect API","link":"/metasearch/connect-api/open-api","routeSlug":"/metasearch/connect-api/open-api","content":{"contentType":"overview","meta":{"name":"Connect API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"open-api.json","url":"/_bundle/metasearch/connect-api/open-api.json?download"},{"kind":"download","label":"open-api.yaml","url":"/_bundle/metasearch/connect-api/open-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://metasearch-connect-api.booking.com","description":"Production URL"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Connect API (1.2.1)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":"Partner Connect API Service"}],"sectionId":"/metasearch/connect-api/open-api"}],"sectionId":"/metasearch/connect-api/open-api"}]}]}},{"type":"group","label":"Reports","link":"/metasearch/connect-api/open-api/reports","routeSlug":"/metasearch/connect-api/open-api/reports","items":[{"label":"List conversions","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/metasearch/connect-api/open-api/reports/getconversions","routeSlug":"/metasearch/connect-api/open-api/reports/getconversions","metadata":{"seo":{"title":"List conversions","description":"This endpoint returns conversion data for bookings within a specified date range."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getConversions","name":"List conversions","isWebhook":false,"pointer":"/paths/~1reports~1conversions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List conversions","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 conversion data for bookings within a specified date range."},"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":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Conversions data is only provided for selected accounts based on contractual agreements."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exactly one date filter must be provided. The available filters are:"},"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":"booking_date_range"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Filter by the date the booking was made"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancellation_date_range"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Filter by the date the booking was cancelled"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"checkout_date_range"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Filter by the checkout date of the booking"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each date range must include both "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"from"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"to"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" dates in ISO-8601 format (YYYY-MM-DD)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Results are paginated with a default page size of 100 and a maximum of 1000 records per page."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page_token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from the response to retrieve subsequent pages."},"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 requests:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by booking date:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n  \"booking_date_range\": {\n    \"from\": \"2025-01-01\",\n    \"to\": \"2025-01-31\"\n  },\n  \"page_size\": 100\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n  \"booking_date_range\": {\n    \"from\": \"2025-01-01\",\n    \"to\": \"2025-01-31\"\n  },\n  \"page_size\": 100\n}\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by cancellation date:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n  \"cancellation_date_range\": {\n    \"from\": \"2025-01-01\",\n    \"to\": \"2025-01-31\"\n  },\n  \"page_size\": 100\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n  \"cancellation_date_range\": {\n    \"from\": \"2025-01-01\",\n    \"to\": \"2025-01-31\"\n  },\n  \"page_size\": 100\n}\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by checkout date:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n  \"checkout_date_range\": {\n    \"from\": \"2025-01-01\",\n    \"to\": \"2025-01-31\"\n  },\n  \"page_size\": 100\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n  \"checkout_date_range\": {\n    \"from\": \"2025-01-01\",\n    \"to\": \"2025-01-31\"\n  },\n  \"page_size\": 100\n}\n"},"children":[]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ConversionsRequest"}},"schemaId":"components/schemas/ConversionsRequest","pointer":"/paths/~1reports~1conversions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/reports/conversions","servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ConversionsRequest"}},"responseCodes":["200","400"],"pointer":"/reports/conversions","href":"reports/getconversions","openApiOperationId":"getConversions","summary":"List conversions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"schemaId":"components/schemas/ConversionsRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ConversionsRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ConversionsResponse"}},"schemaId":"components/schemas/ConversionsResponse"},{"code":"400","description":"Bad Request - Invalid input parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1reports~1conversions/post/responses/400/content/application~1json/examples/conflicting_filters","paths/~1reports~1conversions/post/responses/400/content/application~1json/examples/missing_filter"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1reports~1conversions/post/responses/400/content/application~1json/examples/conflicting_filters","paths/~1reports~1conversions/post/responses/400/content/application~1json/examples/missing_filter"]}],"pointer":"/paths/~1reports~1conversions/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ConversionsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ConversionsResponse"}}},{"code":"400","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1reports~1conversions/post/responses/400/content/application~1json/examples/conflicting_filters","paths/~1reports~1conversions/post/responses/400/content/application~1json/examples/missing_filter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1reports~1conversions/post/responses/400/content/application~1json/examples/conflicting_filters","paths/~1reports~1conversions/post/responses/400/content/application~1json/examples/missing_filter"]}}}],"examples":[]}]}]}]},"httpPath":"/reports/conversions"}],"content":{"contentType":"group","meta":{"name":"Reports"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reports","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/reports/conversions","summary":"List conversions","prefix":{"name":"post","color":"post"},"badges":[],"link":"/reports/getconversions","deprecated":false}]}]}]}]}},{"type":"group","label":"Inventory","link":"/metasearch/connect-api/open-api/inventory","routeSlug":"/metasearch/connect-api/open-api/inventory","items":[{"label":"List accommodation properties","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/metasearch/connect-api/open-api/inventory/streamproperties","routeSlug":"/metasearch/connect-api/open-api/inventory/streamproperties","metadata":{"seo":{"title":"List accommodation properties","description":"Returns the Booking.com property inventory as a newline-delimited JSON (NDJSON) stream, one property object per line. Each record carries static content such as names, addresses, categories, images, ratings, and policies. API consumers use it to build and refresh a local copy of the inventory."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"streamProperties","name":"List accommodation properties","isWebhook":false,"pointer":"/paths/~1inventory~1properties/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List accommodation properties","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 the Booking.com property inventory as a newline-delimited JSON (NDJSON) stream, one property object per line. Each record carries static content such as names, addresses, categories, images, ratings, and policies. API consumers use it to build and refresh a local copy of the inventory."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"inventory/streamproperties/request/parameters","deepLinkHash":"/inventory/streamproperties#inventory/streamproperties/request/parameters"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Parameters"},"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":"languages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (required): a single BCP-47 language code (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fr"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"en-gb"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Localizable fields such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"description"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"location.city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"location.province"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are returned in this language."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"updated_since"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (optional): an ISO-8601 UTC timestamp with millisecond precision (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2026-04-20T00:00:00.000Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). When set, only properties changed at or after this instant are returned (delta sync). When omitted, the full inventory is returned."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"image_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (optional): the size token applied to every image URL. One of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"thumbnail"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"thumbnail_large"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"standard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"large"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"standard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"inventory/streamproperties/request/response-protocol","deepLinkHash":"/inventory/streamproperties#inventory/streamproperties/request/response-protocol"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response protocol"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each line is one complete JSON object. A data row carries the property fields:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\"property_id\":1377102,\"name\":\"Grand Central Hotel\",\"description\":\"Featuring air-conditioned accommodation with a balcony, the property offers a private pool.\",\"category\":\"hotel\",\"number_of_rooms\":1,\"images\":[{\"url\":\"https://q-xx.bstatic.com/xdata/images/hotel/max500/681992303.jpg?k=<sig>&o=\",\"type\":\"main\"}],\"language\":\"en-gb\",\"updated_at\":\"2026-07-06T14:21:56.000Z\",\"location\":{\"country\":\"nl\",\"latitude\":52.3702,\"longitude\":4.8952,\"street_address\":\"Prins Hendrikkade 59\",\"city\":\"Amsterdam\",\"postal_code\":\"1012 AD\",\"province\":\"North Holland\"},\"ratings\":{\"star_rating\":5.0,\"is_star_rating_estimated\":false,\"guest_review_score\":8.6,\"guest_review_count\":1243},\"policies\":{\"check_in_start_time\":\"15:00\",\"check_in_end_time\":\"23:00\",\"check_out_start_time\":\"07:00\",\"check_out_end_time\":\"11:00\",\"is_instant_bookable\":true},\"links\":{\"booking_url\":\"https://www.booking.com/hotel/nl/grand-central.html?aid=343802\",\"booking_deep_link_url\":\"https://www.booking.com/hotel/nl/grand-central.html?aid=343802&utm_medium=deeplink\"},\"status\":{\"property_status\":\"open\",\"last_active_date\":\"2026-07-07\"}}\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\"property_id\":1377102,\"name\":\"Grand Central Hotel\",\"description\":\"Featuring air-conditioned accommodation with a balcony, the property offers a private pool.\",\"category\":\"hotel\",\"number_of_rooms\":1,\"images\":[{\"url\":\"https://q-xx.bstatic.com/xdata/images/hotel/max500/681992303.jpg?k=<sig>&o=\",\"type\":\"main\"}],\"language\":\"en-gb\",\"updated_at\":\"2026-07-06T14:21:56.000Z\",\"location\":{\"country\":\"nl\",\"latitude\":52.3702,\"longitude\":4.8952,\"street_address\":\"Prins Hendrikkade 59\",\"city\":\"Amsterdam\",\"postal_code\":\"1012 AD\",\"province\":\"North Holland\"},\"ratings\":{\"star_rating\":5.0,\"is_star_rating_estimated\":false,\"guest_review_score\":8.6,\"guest_review_count\":1243},\"policies\":{\"check_in_start_time\":\"15:00\",\"check_in_end_time\":\"23:00\",\"check_out_start_time\":\"07:00\",\"check_out_end_time\":\"11:00\",\"is_instant_bookable\":true},\"links\":{\"booking_url\":\"https://www.booking.com/hotel/nl/grand-central.html?aid=343802\",\"booking_deep_link_url\":\"https://www.booking.com/hotel/nl/grand-central.html?aid=343802&utm_medium=deeplink\"},\"status\":{\"property_status\":\"open\",\"last_active_date\":\"2026-07-07\"}}\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The final line is a completion marker:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\"_control\":\"complete\",\"data_row_count\":4055137}\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\"_control\":\"complete\",\"data_row_count\":4055137}\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Every line may carry a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"_control"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field that marks the line type:"},"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":"Data rows use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"_control\":\"data\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This is the default and is omitted to reduce response size, so a line with no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"_control"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field is a data row."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The final line is the completion marker, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"_control\":\"complete\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". It reports "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data_row_count"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the number of data rows emitted."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To confirm the stream is complete, match "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data_row_count"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" against the number of data rows received. If the completion marker is absent, the stream was truncated and the response must be discarded."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"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":"Preview version: temporary constraints (subject to change without notice)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint is a preview version. Only one language per request is currently supported; requesting more than one returns HTTP 400. An API consumer that needs several languages sends one request per language, in parallel."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"inventory/streamproperties/request/errors","deepLinkHash":"/inventory/streamproperties#inventory/streamproperties/request/errors"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Errors"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a JSON error body is returned for invalid input: more than one "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"languages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" entry, an unsupported "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"image_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or a malformed "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"updated_since"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PropertyStreamRequest"}},"schemaId":"components/schemas/PropertyStreamRequest","pointer":"/paths/~1inventory~1properties/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/inventory/properties","servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/PropertyStreamRequest"}},"responseCodes":["200","400"],"pointer":"/inventory/properties","href":"inventory/streamproperties","openApiOperationId":"streamProperties","summary":"List accommodation properties"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"schemaId":"components/schemas/PropertyStreamRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PropertyStreamRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"NDJSON stream. Each line is a property stream record.","mediaType":"application/x-ndjson","mediaTypes":["application/x-ndjson"],"mediaTypeContent":{"application/x-ndjson":{"schemaId":"components/schemas/PropertyStreamRecord"}},"schemaId":"components/schemas/PropertyStreamRecord"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invalid input (e.g. more than one language, unknown image_size, or a malformed updated_since timestamp)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1inventory~1properties/post/responses/400/content/application~1json/examples/Multiple languages"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1inventory~1properties/post/responses/400/content/application~1json/examples/Multiple languages"]}],"pointer":"/paths/~1inventory~1properties/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PropertyStreamRecord","mediaTypes":["application/x-ndjson"],"mediaTypeContent":{"application/x-ndjson":{"schemaId":"components/schemas/PropertyStreamRecord"}}},{"code":"400","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1inventory~1properties/post/responses/400/content/application~1json/examples/Multiple languages"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1inventory~1properties/post/responses/400/content/application~1json/examples/Multiple languages"]}}}],"examples":[]}]}]}]},"httpPath":"/inventory/properties"}],"content":{"contentType":"group","meta":{"name":"Inventory"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Inventory","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/inventory/properties","summary":"List accommodation properties","prefix":{"name":"post","color":"post"},"badges":[],"link":"/inventory/streamproperties","deprecated":false}]}]}]}]}},{"type":"group","label":"demand-api-v2-compatible","link":"/metasearch/connect-api/open-api/demand-api-v2-compatible","routeSlug":"/metasearch/connect-api/open-api/demand-api-v2-compatible","items":[{"label":"List accommodation reviews","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotelsreviews","routeSlug":"/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotelsreviews","metadata":{"seo":{"title":"List accommodation reviews","description":"Returns reviews for specified hotel_ids and filters. Available filters are country,language of the review, lower and upper bound of the review score, and timestamp of the last change to the review.The 'last_change' output field will only be displayed if the last_change=... input parameter is set."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getHotelsReviews","name":"List accommodation reviews","isWebhook":false,"pointer":"/paths/~1demand-api-v2-compatible~1reviews/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List accommodation 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":"Returns reviews for specified hotel_ids and filters. Available filters are country,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"language of the review, lower and upper bound of the review score, and timestamp of the last change to the review."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The 'last_change' output field will only be displayed if the last_change=... input parameter is set."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"reviewsInputDto","in":"query","schemaId":"schema_258","required":true}],"pointer":"/paths/~1demand-api-v2-compatible~1reviews/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/demand-api-v2-compatible/reviews","servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"parameters":{"path":[],"query":[{"name":"reviewsInputDto","in":"query","required":true,"schemaId":"components/schemas/ReviewsInputDto"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"responseCodes":["200","400","500"],"pointer":"/demand-api-v2-compatible/reviews","href":"demand-api-v2-compatible/gethotelsreviews","openApiOperationId":"getHotelsReviews","summary":"List accommodation reviews"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ReviewsResponseDto"},"application/xml":{"schemaId":"components/schemas/ReviewsResponseDto"}},"schemaId":"components/schemas/ReviewsResponseDto"},{"code":"400","description":"Invalid input, e.g. a missing, invalid, unknown, or conflicting parameter.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviews/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviews/get/responses/400/content/application~1json/example"]},{"code":"500","description":"An unexpected server error occurred.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviews/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviews/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1demand-api-v2-compatible~1reviews/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ReviewsResponseDto","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ReviewsResponseDto"},"application/xml":{"schemaId":"components/schemas/ReviewsResponseDto"}}},{"code":"400","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviews/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviews/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}},{"code":"500","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviews/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviews/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}}],"examples":[]}]}]}]},"httpPath":"/demand-api-v2-compatible/reviews"},{"label":"List accommodation review scores","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotelsreviewscores","routeSlug":"/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotelsreviewscores","metadata":{"seo":{"title":"List accommodation review scores","description":"Gives information about review scores for specified hotel_ids and filter.The information consists of score breakdown per reviewer_type and review questions,and overall score distribution per score value (1 - 10)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getHotelsReviewScores","name":"List accommodation review scores","isWebhook":false,"pointer":"/paths/~1demand-api-v2-compatible~1reviewScores/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List accommodation review scores","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":"Gives information about review scores for specified hotel_ids and filter."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The information consists of score breakdown per reviewer_type and review questions,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and overall score distribution per score value (1 - 10)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The available filter is input parameter reviewer_type=... ."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It allows generating review score information for just one reviewer type."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Language in which the response is rendered can be controlled with the input parameter language=..."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(default: 'en'). Setting the language will reflect on the output fields question and review_score_word."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"One additional output field can be requested with input parameter extras=review_score_word."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"reviewScoresInputDto","in":"query","schemaId":"schema_259","required":true}],"pointer":"/paths/~1demand-api-v2-compatible~1reviewScores/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_260"}],"pointer":"/paths/~1demand-api-v2-compatible~1reviewScores/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/demand-api-v2-compatible/reviewScores","servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"parameters":{"path":[],"query":[{"name":"reviewScoresInputDto","in":"query","required":true,"schemaId":"components/schemas/ReviewScoresInputDto"}],"querystring":[],"header":[{"name":"Accept","in":"header","schemaId":"schema_260"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"responseCodes":["200","400","500"],"pointer":"/demand-api-v2-compatible/reviewScores","href":"demand-api-v2-compatible/gethotelsreviewscores","openApiOperationId":"getHotelsReviewScores","summary":"List accommodation review scores"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ResponseOutputV2ReviewScoresOutputDto"}},"schemaId":"components/schemas/ResponseOutputV2ReviewScoresOutputDto"},{"code":"400","description":"Invalid input, e.g. a missing, invalid, unknown, or conflicting parameter.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviewScores/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviewScores/get/responses/400/content/application~1json/example"]},{"code":"500","description":"An unexpected server error occurred.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviewScores/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviewScores/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1demand-api-v2-compatible~1reviewScores/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ResponseOutputV2ReviewScoresOutputDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ResponseOutputV2ReviewScoresOutputDto"}}},{"code":"400","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviewScores/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviewScores/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}},{"code":"500","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviewScores/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1reviewScores/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}}],"examples":[]}]}]}]},"httpPath":"/demand-api-v2-compatible/reviewScores"},{"label":"Get details of accommodations","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotels","routeSlug":"/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotels","metadata":{"seo":{"title":"Get details of accommodations","description":"This call returns the hotel and room data. By default, only hotel_id is returned in the output."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getHotels","name":"Get details of accommodations","isWebhook":false,"pointer":"/paths/~1demand-api-v2-compatible~1hotels/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get details of accommodations","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 call returns the hotel and room data. By default, only hotel_id is returned in the output."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"One of the argument: hotel_ids, city_ids, country_ids, region_ids, district_ids, chain_ids is mandatory."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Additional data needs to be requested via extras parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The data is returned in English by default."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"hotelsInput","in":"query","schemaId":"schema_261","required":true}],"pointer":"/paths/~1demand-api-v2-compatible~1hotels/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_260"}],"pointer":"/paths/~1demand-api-v2-compatible~1hotels/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/demand-api-v2-compatible/hotels","servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"parameters":{"path":[],"query":[{"name":"hotelsInput","in":"query","required":true,"schemaId":"components/schemas/HotelsInputDto"}],"querystring":[],"header":[{"name":"Accept","in":"header","schemaId":"schema_260"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"responseCodes":["200","400","500"],"pointer":"/demand-api-v2-compatible/hotels","href":"demand-api-v2-compatible/gethotels","openApiOperationId":"getHotels","summary":"Get details of accommodations"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ResponseOutputV2HotelsOutputDto"}},"schemaId":"components/schemas/ResponseOutputV2HotelsOutputDto"},{"code":"400","description":"Invalid input, e.g. a missing, invalid, unknown, or conflicting parameter.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotels/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotels/get/responses/400/content/application~1json/example"]},{"code":"500","description":"An unexpected server error occurred.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotels/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotels/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1demand-api-v2-compatible~1hotels/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ResponseOutputV2HotelsOutputDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ResponseOutputV2HotelsOutputDto"}}},{"code":"400","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotels/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotels/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}},{"code":"500","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotels/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotels/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}}],"examples":[]}]}]}]},"httpPath":"/demand-api-v2-compatible/hotels"},{"label":"List hotel types","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/metasearch/connect-api/open-api/demand-api-v2-compatible/gethoteltypes","routeSlug":"/metasearch/connect-api/open-api/demand-api-v2-compatible/gethoteltypes","metadata":{"seo":{"title":"List hotel types","description":"This endpoint returns hotel types names and their translations. (EN is default)"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getHotelTypes","name":"List hotel types","isWebhook":false,"pointer":"/paths/~1demand-api-v2-compatible~1hotelTypes/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List hotel types","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This endpoint returns hotel types names and their translations. (EN is default)"},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"hotelTypeInputDTO","in":"query","schemaId":"schema_262","required":true}],"pointer":"/paths/~1demand-api-v2-compatible~1hotelTypes/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_263"}],"pointer":"/paths/~1demand-api-v2-compatible~1hotelTypes/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/demand-api-v2-compatible/hotelTypes","servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"parameters":{"path":[],"query":[{"name":"hotelTypeInputDTO","in":"query","required":true,"schemaId":"components/schemas/HotelTypeInputDTO"}],"querystring":[],"header":[{"name":"Accept","in":"header","schemaId":"schema_263"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"responseCodes":["200","400","500"],"pointer":"/demand-api-v2-compatible/hotelTypes","href":"demand-api-v2-compatible/gethoteltypes","openApiOperationId":"getHotelTypes","summary":"List hotel types"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ResponseOutputV2HotelTypesOutputDto"}},"schemaId":"components/schemas/ResponseOutputV2HotelTypesOutputDto"},{"code":"400","description":"Invalid input, e.g. a missing, invalid, unknown, or conflicting parameter.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelTypes/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelTypes/get/responses/400/content/application~1json/example"]},{"code":"500","description":"An unexpected server error occurred.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelTypes/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelTypes/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1demand-api-v2-compatible~1hotelTypes/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ResponseOutputV2HotelTypesOutputDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ResponseOutputV2HotelTypesOutputDto"}}},{"code":"400","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelTypes/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelTypes/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}},{"code":"500","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelTypes/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelTypes/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}}],"examples":[]}]}]}]},"httpPath":"/demand-api-v2-compatible/hotelTypes"},{"label":"List hotel theme types","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotelthemetypes","routeSlug":"/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotelthemetypes","metadata":{"seo":{"title":"List hotel theme types","description":"This endpoint returns a list of hotel theme types (in English)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getHotelThemeTypes","name":"List hotel theme types","isWebhook":false,"pointer":"/paths/~1demand-api-v2-compatible~1hotelThemeTypes/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List hotel theme types","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 hotel theme types (in English)."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"hotelThemeTypeInputDTO","in":"query","schemaId":"schema_264","required":true}],"pointer":"/paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_263"}],"pointer":"/paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/demand-api-v2-compatible/hotelThemeTypes","servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"parameters":{"path":[],"query":[{"name":"hotelThemeTypeInputDTO","in":"query","required":true,"schemaId":"components/schemas/HotelThemeTypeInputDTO"}],"querystring":[],"header":[{"name":"Accept","in":"header","schemaId":"schema_263"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"responseCodes":["200","400","500"],"pointer":"/demand-api-v2-compatible/hotelThemeTypes","href":"demand-api-v2-compatible/gethotelthemetypes","openApiOperationId":"getHotelThemeTypes","summary":"List hotel theme types"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ResponseOutputV2HotelThemeTypesOutputDto"}},"schemaId":"components/schemas/ResponseOutputV2HotelThemeTypesOutputDto"},{"code":"400","description":"Invalid input, e.g. a missing, invalid, unknown, or conflicting parameter.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/responses/400/content/application~1json/example"]},{"code":"500","description":"An unexpected server error occurred.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ResponseOutputV2HotelThemeTypesOutputDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ResponseOutputV2HotelThemeTypesOutputDto"}}},{"code":"400","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}},{"code":"500","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}}],"examples":[]}]}]}]},"httpPath":"/demand-api-v2-compatible/hotelThemeTypes"},{"label":"List facility room types","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/metasearch/connect-api/open-api/demand-api-v2-compatible/getroomfacilitytypes","routeSlug":"/metasearch/connect-api/open-api/demand-api-v2-compatible/getroomfacilitytypes","metadata":{"seo":{"title":"List facility room types","description":"This endpoint returns room facility types names and their translations (EN is default)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getRoomFacilityTypes","name":"List facility room types","isWebhook":false,"pointer":"/paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List facility room types","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This endpoint returns room facility types names and their translations (EN is default)."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"hotelFacilityInputDto","in":"query","schemaId":"schema_265","required":true}],"pointer":"/paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_263"}],"pointer":"/paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/demand-api-v2-compatible/hotelFacilityTypes","servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"parameters":{"path":[],"query":[{"name":"hotelFacilityInputDto","in":"query","required":true,"schemaId":"components/schemas/HotelFacilityInputDto"}],"querystring":[],"header":[{"name":"Accept","in":"header","schemaId":"schema_263"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"responseCodes":["200","400","500"],"pointer":"/demand-api-v2-compatible/hotelFacilityTypes","href":"demand-api-v2-compatible/getroomfacilitytypes","openApiOperationId":"getRoomFacilityTypes","summary":"List facility room types"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ResponseOutputV2HotelFacilityTypeOutputDto"}},"schemaId":"components/schemas/ResponseOutputV2HotelFacilityTypeOutputDto"},{"code":"400","description":"Invalid input, e.g. a missing, invalid, unknown, or conflicting parameter.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/responses/400/content/application~1json/example"]},{"code":"500","description":"An unexpected server error occurred.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ResponseOutputV2HotelFacilityTypeOutputDto","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ResponseOutputV2HotelFacilityTypeOutputDto"}}},{"code":"400","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}},{"code":"500","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}}],"examples":[]}]}]}]},"httpPath":"/demand-api-v2-compatible/hotelFacilityTypes"},{"label":"List available hotel rooms","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotelavailability","routeSlug":"/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotelavailability","metadata":{"seo":{"title":"List available hotel rooms","description":"This endpoint returns the cheapest available room for each hotel matching your check-in and check-out dates.You can search a specific list of up to 1000 hotels with hotel_ids, or an area with latitude, longitude and radius (the two are mutually exclusive).For each hotel you get whether the price includes breakfast or other meals and whether it can be cancelled for free.Request the room_details extra for a per-room price breakdown, and use add_filtered_rate/options to filter the results."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getHotelAvailability","name":"List available hotel rooms","isWebhook":false,"pointer":"/paths/~1demand-api-v2-compatible~1hotelAvailability/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List available hotel rooms","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 the cheapest available room for each hotel matching your check-in and check-out dates."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can search a specific list of up to 1000 hotels with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"hotel_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or an area with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"latitude"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"longitude"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"radius"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (the two are mutually exclusive)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For each hotel you get whether the price includes breakfast or other meals and whether it can be cancelled for free."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"room_details"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" extra for a per-room price breakdown, and use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"add_filtered_rate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"options"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to filter the results."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"String enum values (such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_platform"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"extras"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"options"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"add_filtered_rate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_by"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_dir"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") are case-insensitive. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"language"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" accepts the lowercase codes listed below."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"checkin","in":"query","schemaId":"schema_266","required":true},{"name":"checkout","in":"query","schemaId":"schema_267","required":true},{"name":"guest_country","in":"query","schemaId":"schema_268","required":true},{"name":"hotel_ids","in":"query","schemaId":"schema_269"},{"name":"latitude","in":"query","schemaId":"schema_270"},{"name":"longitude","in":"query","schemaId":"schema_271"},{"name":"radius","in":"query","schemaId":"schema_272"},{"name":"room1","in":"query","schemaId":"schema_273"},{"name":"no_rooms","in":"query","schemaId":"schema_274"},{"name":"currency","in":"query","schemaId":"schema_275"},{"name":"language","in":"query","schemaId":"schema_276"},{"name":"user_platform","in":"query","schemaId":"schema_277"},{"name":"genius","in":"query","schemaId":"schema_278"},{"name":"extras","in":"query","schemaId":"schema_279"},{"name":"options","in":"query","schemaId":"schema_280"},{"name":"add_filtered_rate","in":"query","schemaId":"schema_281"},{"name":"order_by","in":"query","schemaId":"schema_282"},{"name":"order_dir","in":"query","schemaId":"schema_283"},{"name":"rows","in":"query","schemaId":"schema_284"},{"name":"page","in":"query","schemaId":"schema_285"}],"pointer":"/paths/~1demand-api-v2-compatible~1hotelAvailability/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_263"}],"pointer":"/paths/~1demand-api-v2-compatible~1hotelAvailability/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/demand-api-v2-compatible/hotelAvailability","servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"parameters":{"path":[],"query":[{"name":"checkin","in":"query","required":true,"schemaId":"schema_266"},{"name":"checkout","in":"query","required":true,"schemaId":"schema_267"},{"name":"guest_country","in":"query","required":true,"example":"nl","schemaId":"schema_268"},{"name":"hotel_ids","in":"query","example":[96969],"schemaId":"schema_269"},{"name":"latitude","in":"query","schemaId":"schema_270"},{"name":"longitude","in":"query","schemaId":"schema_271"},{"name":"radius","in":"query","schemaId":"schema_272"},{"name":"room1","in":"query","schemaId":"schema_273"},{"name":"no_rooms","in":"query","schemaId":"schema_274"},{"name":"currency","in":"query","example":"EUR","schemaId":"schema_275"},{"name":"language","in":"query","schemaId":"schema_276"},{"name":"user_platform","in":"query","schemaId":"schema_277"},{"name":"genius","in":"query","schemaId":"schema_278"},{"name":"extras","in":"query","schemaId":"schema_279"},{"name":"options","in":"query","schemaId":"schema_280"},{"name":"add_filtered_rate","in":"query","schemaId":"schema_281"},{"name":"order_by","in":"query","schemaId":"schema_282"},{"name":"order_dir","in":"query","schemaId":"schema_283"},{"name":"rows","in":"query","schemaId":"schema_284"},{"name":"page","in":"query","schemaId":"schema_285"}],"querystring":[],"header":[{"name":"Accept","in":"header","schemaId":"schema_263"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"responseCodes":["200","400","500"],"pointer":"/demand-api-v2-compatible/hotelAvailability","href":"demand-api-v2-compatible/gethotelavailability","openApiOperationId":"getHotelAvailability","summary":"List available hotel rooms"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_286"}},"schemaId":"schema_286"},{"code":"400","description":"Invalid input, e.g. a missing, invalid, unknown, or conflicting parameter.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelAvailability/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelAvailability/get/responses/400/content/application~1json/example"]},{"code":"500","description":"An unexpected server error occurred.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelAvailability/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelAvailability/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1demand-api-v2-compatible~1hotelAvailability/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_286","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_286"}}},{"code":"400","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelAvailability/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelAvailability/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}},{"code":"500","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelAvailability/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1hotelAvailability/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}}],"examples":[]}]}]}]},"httpPath":"/demand-api-v2-compatible/hotelAvailability"},{"label":"List all bookable rooms at a property","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/metasearch/connect-api/open-api/demand-api-v2-compatible/getblockavailability","routeSlug":"/metasearch/connect-api/open-api/demand-api-v2-compatible/getblockavailability","metadata":{"seo":{"title":"List all bookable rooms at a property","description":"This endpoint is where you find a list of all bookable or available rooms at a property.A room can have multiple blocks, as a block is a combination of the meal, cancellation policy, occupancy and other things.You can find detailed information about one hotel per search (detail_level)which will return most of the information needed to replicate the booking.com property page."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getBlockAvailability","name":"List all bookable rooms at a property","isWebhook":false,"pointer":"/paths/~1demand-api-v2-compatible~1blockAvailability/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all bookable rooms at a property","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 is where you find a list of all bookable or available rooms at a property."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A room can have multiple blocks, as a block is a combination of the meal, cancellation policy, occupancy and other things."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can find detailed information about one hotel per search (detail_level)"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"which will return most of the information needed to replicate the booking.com property page."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you want to search multiple hotels, you can, but you get less detail."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For searching multiple hotels, it is recommended to use hotelAvailability."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"string"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"blockInput","in":"query","schemaId":"schema_287","required":true}],"pointer":"/paths/~1demand-api-v2-compatible~1blockAvailability/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_260"}],"pointer":"/paths/~1demand-api-v2-compatible~1blockAvailability/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/demand-api-v2-compatible/blockAvailability","servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"parameters":{"path":[],"query":[{"name":"blockInput","in":"query","required":true,"schemaId":"components/schemas/BlockAvailabilityInputDto"}],"querystring":[],"header":[{"name":"Accept","in":"header","schemaId":"schema_260"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}],"scopes":[]}],"responseCodes":["200","400","500"],"pointer":"/demand-api-v2-compatible/blockAvailability","href":"demand-api-v2-compatible/getblockavailability","openApiOperationId":"getBlockAvailability","summary":"List all bookable rooms at a property"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ResponseOutputV2BlockAvailabilityOutputDto"},"application/xml":{"schemaId":"components/schemas/ResponseOutputV2BlockAvailabilityOutputDto"}},"schemaId":"components/schemas/ResponseOutputV2BlockAvailabilityOutputDto"},{"code":"400","description":"Invalid input, e.g. a missing, invalid, unknown, or conflicting parameter.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1blockAvailability/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1blockAvailability/get/responses/400/content/application~1json/example"]},{"code":"500","description":"An unexpected server error occurred.","mediaType":"application/json","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1blockAvailability/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}},"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1blockAvailability/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1demand-api-v2-compatible~1blockAvailability/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ResponseOutputV2BlockAvailabilityOutputDto","mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ResponseOutputV2BlockAvailabilityOutputDto"},"application/xml":{"schemaId":"components/schemas/ResponseOutputV2BlockAvailabilityOutputDto"}}},{"code":"400","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1blockAvailability/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1blockAvailability/get/responses/400/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}},{"code":"500","schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1blockAvailability/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json","application/xml"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/V2Error","exampleIds":["paths/~1demand-api-v2-compatible~1blockAvailability/get/responses/500/content/application~1json/example"]},"application/xml":{"schemaId":"components/schemas/V2Error"}}}],"examples":[]}]}]}]},"httpPath":"/demand-api-v2-compatible/blockAvailability"}],"content":{"contentType":"group","meta":{"name":"demand-api-v2-compatible"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"demand-api-v2-compatible","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/demand-api-v2-compatible/reviews","summary":"List accommodation reviews","prefix":{"name":"get","color":"get"},"badges":[],"link":"/demand-api-v2-compatible/gethotelsreviews","deprecated":false},{"title":"/demand-api-v2-compatible/reviewScores","summary":"List accommodation review scores","prefix":{"name":"get","color":"get"},"badges":[],"link":"/demand-api-v2-compatible/gethotelsreviewscores","deprecated":false},{"title":"/demand-api-v2-compatible/hotels","summary":"Get details of accommodations","prefix":{"name":"get","color":"get"},"badges":[],"link":"/demand-api-v2-compatible/gethotels","deprecated":false},{"title":"/demand-api-v2-compatible/hotelTypes","summary":"List hotel types","prefix":{"name":"get","color":"get"},"badges":[],"link":"/demand-api-v2-compatible/gethoteltypes","deprecated":false},{"title":"/demand-api-v2-compatible/hotelThemeTypes","summary":"List hotel theme types","prefix":{"name":"get","color":"get"},"badges":[],"link":"/demand-api-v2-compatible/gethotelthemetypes","deprecated":false},{"title":"/demand-api-v2-compatible/hotelFacilityTypes","summary":"List facility room types","prefix":{"name":"get","color":"get"},"badges":[],"link":"/demand-api-v2-compatible/getroomfacilitytypes","deprecated":false},{"title":"/demand-api-v2-compatible/hotelAvailability","summary":"List available hotel rooms","prefix":{"name":"get","color":"get"},"badges":[],"link":"/demand-api-v2-compatible/gethotelavailability","deprecated":false},{"title":"/demand-api-v2-compatible/blockAvailability","summary":"List all bookable rooms at a property","prefix":{"name":"get","color":"get"},"badges":[],"link":"/demand-api-v2-compatible/getblockavailability","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/ConversionsRequest":{"id":"components/schemas/ConversionsRequest","kind":"json-schema","title":"ConversionsRequest","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request object for retrieving conversion data."},"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":"Important:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Exactly one date filter must be provided. The date filters are mutually exclusive -"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"specifying more than one will result in a 400 Bad Request error with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"conflicting_parameters"},"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":"Available date filters (choose exactly one):"},"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":"booking_date_range"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Filter by when the booking was made"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancellation_date_range"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Filter by when the booking was cancelled"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"checkout_date_range"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Filter by the checkout date"},"children":[]}]}]}]}],"oneOf":[{"required":["booking_date_range"],"properties":{"booking_date_range":{"allOf":[{"$ref":"#/components/schemas/DateRange"},{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter conversions by the date the booking was made."},"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":"Mutually exclusive"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with cancellation_date_range and checkout_date_range."},"children":[]}]}]}]}]}}},{"required":["cancellation_date_range"],"properties":{"cancellation_date_range":{"allOf":[{"$ref":"#/components/schemas/DateRange"},{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter conversions by the date the booking was cancelled. Only returns cancelled bookings."},"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":"Mutually exclusive"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with booking_date_range and checkout_date_range."},"children":[]}]}]}]}]}}},{"required":["checkout_date_range"],"properties":{"checkout_date_range":{"allOf":[{"$ref":"#/components/schemas/DateRange"},{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter conversions by the checkout date of the booking."},"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":"Mutually exclusive"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with booking_date_range and cancellation_date_range."},"children":[]}]}]}]}]}}}],"properties":{"page_size":{"type":"integer","format":"int32","description":"Number of results per page. Default is 100, maximum is 1000.","default":100,"minimum":1,"maximum":1000,"example":100},"page_token":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Token for retrieving the next page of results. Obtained from the previous response's pagination.next_page_token."},"children":[]}]}]}],"example":""}}}},"components/schemas/DateRange":{"id":"components/schemas/DateRange","kind":"json-schema","title":"DateRange","data":{"type":"object","description":"Date range for filtering conversions. Both 'from' and 'to' dates are required.","required":["from","to"],"properties":{"from":{"type":"string","format":"date","description":"Start date of the range in ISO-8601 format (YYYY-MM-DD).","example":"2025-01-01"},"to":{"type":"string","format":"date","description":"End date of the range in ISO-8601 format (YYYY-MM-DD). Must be equal to or after the 'from' date.","example":"2025-01-31"}}}},"components/schemas/ConversionsResponse":{"id":"components/schemas/ConversionsResponse","kind":"json-schema","title":"ConversionsResponse","data":{"type":"object","description":"Response object containing conversion data, pagination info, and metadata.","properties":{"conversions":{"type":"array","description":"List of conversion records matching the search criteria.","items":{"$ref":"#/components/schemas/Conversion"}},"pagination":{"$ref":"#/components/schemas/ConversionsPagination"},"metadata":{"$ref":"#/components/schemas/ConversionsMetadata"}}}},"components/schemas/Conversion":{"id":"components/schemas/Conversion","kind":"json-schema","title":"Conversion","data":{"type":"object","description":"A single conversion record representing a booking.","properties":{"booking_date":{"type":"string","format":"date-time","description":"The date and time when the booking was made (ISO 8601 datetime).","example":"2025-01-15T14:30:00Z"},"cancellation_date":{"type":"string","format":"date-time","description":"The date and time when the booking was cancelled, if applicable (ISO 8601 datetime).","example":"2025-01-16T10:00:00Z"},"booking_reference":{"type":"string","description":"Unique reference identifier for the booking.","example":"1234567890"},"checkin_date":{"type":"string","format":"date","description":"The check-in date for the booking (YYYY-MM-DD).","example":"2025-02-01"},"checkout_date":{"type":"string","format":"date","description":"The check-out date for the booking (YYYY-MM-DD).","example":"2025-02-05"},"label":{"type":"string","description":"Custom label associated with the booking, typically used for tracking campaigns or sources.","example":"campaign_xyz"},"booking_status":{"type":"string","description":"Current status of the booking.","example":"confirmed","enum":["confirmed","cancelled","no_show"]},"commission_amount":{"type":"string","description":"The commission amount for this booking.","example":"25.50"},"commission_currency":{"type":"string","description":"The currency of the commission amount (ISO 4217 currency code).","example":"EUR"},"device_type":{"type":"string","description":"The type of device used to make the booking.","example":"mobile","enum":["desktop","mobile"]}}}},"components/schemas/ConversionsPagination":{"id":"components/schemas/ConversionsPagination","kind":"json-schema","title":"ConversionsPagination","data":{"type":"object","description":"Pagination information for the conversions response.","properties":{"next_page_token":{"type":"string","description":"Token to use for retrieving the next page of results. Empty if there are no more pages.","example":"eyJwYWdlIjogMn0="},"total_results":{"type":"integer","format":"int32","description":"Total number of conversion records matching the search criteria.","example":150},"total_pages":{"type":"integer","format":"int32","description":"Total number of pages available.","example":2},"random_page_access":{"type":"boolean","description":"Indicates whether random page access is supported. If false, only sequential pagination is available.","example":false}}}},"components/schemas/ConversionsMetadata":{"id":"components/schemas/ConversionsMetadata","kind":"json-schema","title":"ConversionsMetadata","data":{"type":"object","description":"Metadata about the conversions response.","properties":{"request_id":{"type":"string","description":"Unique identifier for this request, useful for debugging and support.","example":"req_abc123xyz"},"timestamp":{"type":"string","format":"date-time","description":"The timestamp when the response was generated (ISO 8601 datetime).","example":"2025-01-19T10:30:00Z"},"result_count":{"type":"integer","format":"int32","description":"Number of conversion records returned in this response.","example":50}}}},"components/schemas/ErrorResponse":{"id":"components/schemas/ErrorResponse","kind":"json-schema","title":"ErrorResponse","data":{"type":"object","description":"Standard error response format for API errors.","properties":{"errors":{"type":"array","description":"List of errors that occurred during request processing.","items":{"$ref":"#/components/schemas/ErrorDetail"}},"request_id":{"type":"string","description":"Unique identifier for this request, useful for debugging and support.","example":"req_abc123xyz"},"account_id":{"type":"string","description":"Account ID that triggered request, useful for debugging and support.","example":"1234654"}}}},"components/schemas/ErrorDetail":{"id":"components/schemas/ErrorDetail","kind":"json-schema","title":"ErrorDetail","data":{"type":"object","description":"Details of a single error.","properties":{"id":{"type":"string","description":"Machine-readable error identifier.","example":"invalid_parameter"},"name":{"type":"string","description":"Human-readable error name.","example":"Invalid Value"},"message":{"type":"string","description":"Detailed error message explaining what went wrong.","example":"The request contains an invalid parameter."}}}},"components/schemas/ReviewsInputDto":{"id":"components/schemas/ReviewsInputDto","kind":"json-schema","title":"ReviewsInputDto","data":{"properties":{"hotel_ids":{"type":"array","description":"List of hotel ids for which reviews should be displayed.","items":{"type":"integer","format":"int32","description":"List of hotel ids for which reviews should be displayed."}},"language":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Limits reviews to those written in this language (default: 'en')."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Also sets the language of extras=review_score_word."},"children":[]}]}]}],"enum":["ar","bg","ca","cs","da","de","el","en","en-gb","en-us","es","es-ar","es-mx","et","fi","fr","he","hi","hr","hu","id","is","it","ja","ka","ko","lt","lv","ms","nl","no","pl","pt-br","pt-pt","pt","ro","ru","sk","sl","sr","sv","th","tl","tr","uk","vi","zh","zh-cn","zh-tw"]},"country":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Limits reviews to those written by bookers from the given country."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"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."},"children":[]}]}]}],"example":"nl","pattern":"^[a-z]{2}$"},"offset":{"type":"integer","format":"int32","default":0,"description":"The number of rows to offset the results by.","minimum":0},"rows":{"type":"integer","format":"int32","default":10,"description":"The maximum number of rows to return.","minimum":1},"last_change":{"type":"string","description":"Limits the reviews to those changed after the given date in Europe/Amsterdam time zone. Format: 'yyyy-MM-dd HH:mm:ss'.","example":"2025-11-20 14:05:30","pattern":"^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01]) ([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"},"score_lower_bound":{"type":"integer","format":"int32","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Limits the reviews to those having score greater or equal to this value."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Possible values are natural numbers in range [1 - 10]."},"children":[]}]}]}],"maximum":10,"minimum":1},"score_upper_bound":{"type":"integer","format":"int32","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Limits the reviews to those having score lesser or equal to this value."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Possible values are natural numbers in range [1 - 10]."},"children":[]}]}]}],"maximum":10,"minimum":1},"extras":{"type":"string","description":"Specify here what extra items of the result should be included.\n See the endpoint description for more detailed information about each extra.\n","enum":["REVIEW_SCORE_WORD"]}},"required":["hotel_ids"]}},"components/schemas/ReviewOutputDto":{"id":"components/schemas/ReviewOutputDto","kind":"json-schema","title":"ReviewOutputDto","data":{"properties":{"hotel_id":{"type":"integer","format":"int32","description":"Id of the reviewed hotel."},"average_score":{"type":"number","format":"double","description":"Average score for this review."},"country":{"type":"string","description":"Reviewer's location represented by a two-letter ISO country code."},"headline":{"type":"string","description":"Headline or summary of the review."},"hotel_url":{"type":"string","description":"URL of the hotel's page on Booking.com."},"language":{"type":"string","description":"Language that the review is in.\n Please check the \"Possible Values\" section of the documentation for the supported language codes.\n"},"pros":{"type":"string","description":"Positive comments from this review."},"cons":{"type":"string","description":"Negative comments from this review."},"review_id":{"type":"integer","format":"int64","description":"Unique ID of the review."},"date":{"type":"string","description":"Date of the review in Europe/Amsterdam time zone. Format: 'yyyy-MM-dd HH:mm:ss'.","example":"2025-11-20 14:05:30"},"last_change":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of the last change to the review in Europe/Amsterdam time zone. Returned only if 'last_change' filter is added."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Format: 'yyyy-MM-dd HH:mm:ss'."},"children":[]}]}]}],"example":"2025-11-20 15:05:30"},"text_meets_guidelines":{"type":"boolean","description":"Set to true when review meets the guidelines. The review text will be removed if it doesn't meet guidelines\n"},"author":{"$ref":"#/components/schemas/ReviewerOutputDto"},"review_score_word":{"type":"string","description":"Text version of the review score."}}}},"components/schemas/ReviewerOutputDto":{"id":"components/schemas/ReviewerOutputDto","kind":"json-schema","title":"ReviewerOutputDto","data":{"description":"Information about the author of this review.","properties":{"country":{"type":"string","description":"Two-letter ISO code of the reviewer's country."},"name":{"type":"string","description":"Reviewer's name."},"type":{"type":"string","description":"Reviewer type."}}}},"components/schemas/ReviewsResponseDto":{"id":"components/schemas/ReviewsResponseDto","kind":"json-schema","title":"ReviewsResponseDto","data":{"properties":{"meta":{"$ref":"#/components/schemas/Meta"},"result":{"type":"array","items":{"$ref":"#/components/schemas/ReviewOutputDto"}}}}},"components/schemas/ReviewScoresInputDto":{"id":"components/schemas/ReviewScoresInputDto","kind":"json-schema","title":"ReviewScoresInputDto","data":{"required":["hotel_ids"],"type":"object","properties":{"hotel_ids":{"type":"array","description":"List of hotel ids for which review score information should be displayed.","items":{"type":"integer","description":"List of hotel ids for which review score information should be displayed.","format":"int32"}},"affiliate_id":{"type":"integer","description":"Can be used to specify the affiliate id that should be used instead of the default one.","format":"int32"},"language":{"type":"string","description":"Code of the language used to render response.\nPlease check the \"Possible Values\" section of the documentation for the accepted language codes.\n","enum":["ar","bg","ca","cs","da","de","el","en","en-gb","en-us","es","es-ar","es-mx","et","fi","fr","he","hi","hr","hu","id","is","it","ja","ka","ko","lt","lv","ms","nl","no","pl","pt-br","pt-pt","pt","ro","ru","sk","sl","sr","sv","th","tl","tr","uk","vi","zh","zh-cn","zh-tw"]},"reviewer_type":{"type":"string","description":"Limits reviews to those written by specific reviewer type.","enum":["SOLO_TRAVELLER","YOUNG_COUPLE","MATURE_COUPLE","FAMILY_WITH_YOUNG_CHILDREN","FAMILY_WITH_OLDER_CHILDREN","WITH_FRIENDS","GROUP","REVIEW_CATEGORY_COUPLES","REVIEW_CATEGORY_FAMILIES","REVIEW_CATEGORY_GROUP_OF_FRIENDS","REVIEW_CATEGORY_BUSINESS_TRAVELLERS"]}}}},"components/schemas/Meta":{"id":"components/schemas/Meta","kind":"json-schema","title":"Meta","data":{"type":"object","properties":{"ruid":{"type":"string"}}}},"components/schemas/V2Error":{"id":"components/schemas/V2Error","kind":"json-schema","title":"V2Error","data":{"type":"object","description":"Standard error response format for demand-api-v2-compatible errors.","properties":{"errors":{"type":"array","description":"List of errors that occurred during request processing.","items":{"$ref":"#/components/schemas/ErrorDetail"}},"meta":{"$ref":"#/components/schemas/error_meta"}}}},"components/schemas/error_meta":{"id":"components/schemas/error_meta","kind":"json-schema","title":"error_meta","data":{"type":"object","properties":{"ruid":{"type":"string"},"account_id":{"type":"string","description":"Account ID that triggered request, useful for debugging and support.","example":"123432"}}}},"components/schemas/QuestionDto":{"id":"components/schemas/QuestionDto","kind":"json-schema","title":"QuestionDto","data":{"type":"object","properties":{"count":{"type":"integer","description":"Number of reviewers that answered the question.","format":"int32"},"question":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Localized question text. See language=... input parameter."},"children":[]}]}]}]},"question_literal":{"type":"string","description":"Question literal."},"score":{"multipleOf":0.1,"type":"number","description":"Average score that reviewers provided in response to this question.","format":"double","example":8.5}},"description":"Review scores per question."}},"components/schemas/ResponseOutputV2ReviewScoresOutputDto":{"id":"components/schemas/ResponseOutputV2ReviewScoresOutputDto","kind":"json-schema","title":"ResponseOutputV2ReviewScoresOutputDto","data":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"result":{"type":"array","items":{"$ref":"#/components/schemas/ReviewScoresOutputDto"}}}}},"components/schemas/ReviewScoresOutputDto":{"id":"components/schemas/ReviewScoresOutputDto","kind":"json-schema","title":"ReviewScoresOutputDto","data":{"type":"object","properties":{"hotel_id":{"type":"integer","description":"Id of the hotel.","format":"int64"},"hotel_url":{"type":"string","description":"URL of the hotel's page on Booking.com.","example":"https://www.booking.com/hotel/nl/amsterdam-canal-hotel.html?tab=4&aid=338734&label=hotel-472820_reviewscore"},"score_breakdown":{"type":"array","description":"A breakdown of scores per reviewer type and review question.","items":{"$ref":"#/components/schemas/ScoreBreakdown"}},"score_distribution":{"type":"array","description":"A breakdown of all review scores into buckets 1 - 10.","items":{"$ref":"#/components/schemas/ScoreDistribution"}}}}},"components/schemas/ScoreBreakdown":{"id":"components/schemas/ScoreBreakdown","kind":"json-schema","title":"ScoreBreakdown","data":{"type":"object","properties":{"average_score":{"multipleOf":0.1,"type":"number","description":"Average score from this reviewer type.","format":"double","example":8.5},"count":{"type":"integer","description":"Number of responses from this reviewer type.","format":"int32"},"question":{"type":"array","description":"Review scores per question.","items":{"$ref":"#/components/schemas/QuestionDto"}},"reviewer_type":{"type":"string","description":"Reviewer type."}},"description":"A breakdown of scores per reviewer type and review question."}},"components/schemas/ScoreDistribution":{"id":"components/schemas/ScoreDistribution","kind":"json-schema","title":"ScoreDistribution","data":{"type":"object","properties":{"count":{"type":"integer","description":"Total number of reviews in this bucket.","format":"int64","example":435},"percent":{"multipleOf":0.01,"type":"number","description":"Percent of score distribution that went into this bucket.","format":"double","example":17.76},"score":{"type":"integer","description":"The bucket's review score value (1 - 10).","format":"int32","example":10}},"description":"A breakdown of all review scores into buckets 1 - 10."}},"components/schemas/HotelsInputDto":{"id":"components/schemas/HotelsInputDto","kind":"json-schema","title":"HotelsInputDto","data":{"type":"object","properties":{"hotel_ids":{"type":"array","description":"A list of up to 1000 hotel ids.","items":{"type":"integer","description":"A list of up to 1000 hotel ids.","format":"int32"}},"language":{"type":"string","description":"The language code to return the results in.\nPlease check the \"Possible Values\" section of the documentation for the accepted language codes.\n","enum":["ar","bg","ca","cs","da","de","el","en","en-gb","en-us","es","es-ar","es-mx","et","fi","fr","he","hi","hr","hu","id","is","it","ja","ka","ko","lt","lv","ms","nl","no","pl","pt-br","pt-pt","pt","ro","ru","sk","sl","sr","sv","th","tl","tr","uk","vi","zh","zh-cn","zh-tw"]},"extras":{"type":"array","description":"Returns extra bits of information about hotels.","items":{"type":"string","description":"Returns extra bits of information about hotels.","enum":["HOTEL_INFO","ROOM_INFO","KEY_COLLECTION_INFO","HOTEL_FACILITIES","HOTEL_PHOTOS","HOTEL_DESCRIPTION"]}},"offset":{"type":"integer","description":"The number of rows to offset the results by. NOTE: this needs to be 0 or a multiple of 100.","format":"int32"},"rows":{"type":"integer","description":"The maximum number of rows to return. NOTE: this needs to be a multiple of 100.","format":"int32"}}}},"components/schemas/BedroomDto":{"id":"components/schemas/BedroomDto","kind":"json-schema","title":"BedroomDto","data":{"type":"object","properties":{"bed_configurations":{"type":"array","items":{"$ref":"#/components/schemas/BedConfigurationDto"}}}}},"components/schemas/HotelDataDto":{"id":"components/schemas/HotelDataDto","kind":"json-schema","title":"HotelDataDto","data":{"type":"object","properties":{"address":{"type":"string","description":"The street address of the hotel."},"city_id":{"type":"integer","description":"Id of the city where this property is located.","format":"int32"},"country":{"type":"string","description":"Two-letter ISO country code of the hotel."},"location":{"$ref":"#/components/schemas/CoordinatesDto"},"zip":{"type":"string","description":"Hotel ZIP code"},"currency":{"type":"string","description":"Three-letter ISO currency code for the hotel."},"checkin_checkout_times":{"$ref":"#/components/schemas/CheckinCheckoutTimesDto"},"hotel_photos":{"type":"array","description":"Photos specific information of the hotel.","items":{"$ref":"#/components/schemas/HotelPhotoDto"}},"hotel_description":{"type":"string","description":"The description text for this hotel."},"url":{"type":"string","description":"URL of the hotel's page on Booking.com."},"deep_link_url":{"type":"string","description":"Deep link mobile app URL.","example":"booking://hotel/10004?affiliate_id=956509"},"region_ids":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of region_ids that the hotel belongs to"},"children":[]}]}]}],"items":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of region_ids that the hotel belongs to"},"children":[]}]}]}],"format":"int32"}},"number_of_reviews":{"type":"integer","description":"Number of reviews for this hotel.","format":"int32"},"review_score":{"multipleOf":0.1,"type":"number","description":"Review score of this hotel.","format":"double","example":7.1},"spoken_languages":{"type":"array","description":"Languages spoken by the hotel's staff","items":{"type":"string","description":"Languages spoken by the hotel's staff"}}},"description":"Hotel specific information."}},"components/schemas/HotelPhotoDto":{"id":"components/schemas/HotelPhotoDto","kind":"json-schema","title":"HotelPhotoDto","data":{"type":"object","properties":{"main_photo":{"type":"boolean","description":"Is this the main hotel photo."},"url_original":{"type":"string","description":"Url of the photo with max width of 500 pixels."}},"description":"Photos specific information of the hotel."}},"components/schemas/HotelsOutputDto":{"id":"components/schemas/HotelsOutputDto","kind":"json-schema","title":"HotelsOutputDto","data":{"type":"object","properties":{"hotel_data":{"$ref":"#/components/schemas/HotelDataDto"},"hotel_id":{"type":"integer","description":"Unique ID to represent this hotel.","format":"int32"},"room_data":{"type":"array","description":"This block has room data for this hotel.","items":{"$ref":"#/components/schemas/RoomDataDto"}}}}},"components/schemas/ResponseOutputV2HotelsOutputDto":{"id":"components/schemas/ResponseOutputV2HotelsOutputDto","kind":"json-schema","title":"ResponseOutputV2HotelsOutputDto","data":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"result":{"type":"array","items":{"$ref":"#/components/schemas/HotelsOutputDto"}}}}},"components/schemas/RoomDataDto":{"id":"components/schemas/RoomDataDto","kind":"json-schema","title":"RoomDataDto","data":{"type":"object","properties":{"room_id":{"type":"integer","format":"int32"},"room_info":{"$ref":"#/components/schemas/RoomInfoDto"}},"description":"This block has room data for this hotel."}},"components/schemas/RoomInfoDto":{"id":"components/schemas/RoomInfoDto","kind":"json-schema","title":"RoomInfoDto","data":{"type":"object","properties":{"bathroom_count":{"type":"number","format":"double"},"bedroom_count":{"type":"number","format":"double"},"bedrooms":{"type":"array","items":{"$ref":"#/components/schemas/BedroomDto"}},"occupancy":{"$ref":"#/components/schemas/RoomOccupancyDto"},"room_size":{"$ref":"#/components/schemas/RoomSizeDto"},"room_type_id":{"type":"integer","format":"int32"}}}},"components/schemas/RoomOccupancyDto":{"id":"components/schemas/RoomOccupancyDto","kind":"json-schema","title":"RoomOccupancyDto","data":{"type":"object","properties":{"allow_cribs_and_extra_beds":{"type":"boolean"},"max_adults":{"type":"integer","format":"int32"},"max_children":{"type":"integer","format":"int32"},"max_cribs":{"type":"integer","format":"int32"},"max_extra_beds":{"type":"integer","format":"int32"},"max_occupancy":{"type":"integer","format":"int32"}}}},"components/schemas/RoomSizeDto":{"id":"components/schemas/RoomSizeDto","kind":"json-schema","title":"RoomSizeDto","data":{"type":"object","properties":{"metre_square":{"type":"number","format":"double"}}}},"components/schemas/HotelTypeInputDTO":{"id":"components/schemas/HotelTypeInputDTO","kind":"json-schema","title":"HotelTypeInputDTO","data":{"type":"object","properties":{"hotel_type_ids":{"type":"array","description":"Limit the results to these hotel types.","items":{"type":"integer","description":"Limit the results to these hotel types.","format":"int32"}},"languages":{"type":"array","description":"Limit the results to these languages.\nPlease check the \"Possible Values\" section of the documentation for the accepted language codes.\n","items":{"type":"string","description":"Limit the results to these languages.\nPlease check the \"Possible Values\" section of the documentation for the accepted language codes.\n","enum":["ar","bg","ca","cs","da","de","el","en","en-gb","en-us","es","es-ar","es-mx","et","fi","fr","he","hi","hr","hu","id","is","it","ja","ka","ko","lt","lv","ms","nl","no","pl","pt-br","pt-pt","pt","ro","ru","sk","sl","sr","sv","th","tl","tr","uk","vi","zh","zh-cn","zh-tw"]}},"offset":{"type":"integer","description":"The number of rows to offset the results by. NOTE: this needs to be 0 or a multiple of 100.","format":"int32"},"row":{"type":"integer","description":"The maximum number of rows to return. NOTE: this needs to be a multiple of 100.","format":"int32"}}}},"components/schemas/HotelTypesOutputDto":{"id":"components/schemas/HotelTypesOutputDto","kind":"json-schema","title":"HotelTypesOutputDto","data":{"type":"object","properties":{"translations":{"type":"array","items":{"$ref":"#/components/schemas/TranslationDto"}},"name":{"type":"string"},"hotel_type_id":{"type":"integer","format":"int32"}}}},"components/schemas/ResponseOutputV2HotelTypesOutputDto":{"id":"components/schemas/ResponseOutputV2HotelTypesOutputDto","kind":"json-schema","title":"ResponseOutputV2HotelTypesOutputDto","data":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"result":{"type":"array","items":{"$ref":"#/components/schemas/HotelTypesOutputDto"}}}}},"components/schemas/TranslationDto":{"id":"components/schemas/TranslationDto","kind":"json-schema","title":"TranslationDto","data":{"type":"object","properties":{"language":{"type":"string"},"name":{"type":"string"}}}},"components/schemas/HotelThemeTypeInputDTO":{"id":"components/schemas/HotelThemeTypeInputDTO","kind":"json-schema","title":"HotelThemeTypeInputDTO","data":{"type":"object","properties":{"theme_ids":{"type":"array","description":"Limit the results to these themes.","items":{"type":"integer","description":"Limit the results to these themes.","format":"int32"}},"offset":{"type":"integer","description":"The number of rows to offset the results by. NOTE: this needs to be 0 or a multiple of 100.","format":"int32"},"row":{"type":"integer","description":"The maximum number of rows to return. NOTE: this needs to be a multiple of 100.","format":"int32"}}}},"components/schemas/HotelThemeTypesOutputDto":{"id":"components/schemas/HotelThemeTypesOutputDto","kind":"json-schema","title":"HotelThemeTypesOutputDto","data":{"type":"object","properties":{"theme_id":{"type":"integer","description":"Unique ID for this theme.","format":"int32"},"name":{"type":"string","description":"Name of the theme.","example":"Beach/Seaside"}}}},"components/schemas/ResponseOutputV2HotelThemeTypesOutputDto":{"id":"components/schemas/ResponseOutputV2HotelThemeTypesOutputDto","kind":"json-schema","title":"ResponseOutputV2HotelThemeTypesOutputDto","data":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"result":{"type":"array","items":{"$ref":"#/components/schemas/HotelThemeTypesOutputDto"}}}}},"components/schemas/HotelFacilityInputDto":{"id":"components/schemas/HotelFacilityInputDto","kind":"json-schema","title":"HotelFacilityInputDto","data":{"type":"object","properties":{"facility_type_ids":{"type":"array","description":"Limit the results to these facility types.","items":{"type":"integer","description":"Limit the results to these facility types.","format":"int32"}},"hotel_facility_type_ids":{"type":"array","description":"Limit the results to these hotel facility types.","items":{"type":"integer","description":"Limit the results to these hotel facility types.","format":"int32"}},"languages":{"type":"array","description":"Limit the results to these languages.\nPlease check the \"Possible Values\" section of the documentation for the accepted language codes.\n","items":{"type":"string","description":"Limit the results to these languages.\nPlease check the \"Possible Values\" section of the documentation for the accepted language codes.\n","enum":["ar","bg","ca","cs","da","de","el","en","en-gb","en-us","es","es-ar","es-mx","et","fi","fr","he","hi","hr","hu","id","is","it","ja","ka","ko","lt","lv","ms","nl","no","pl","pt-br","pt-pt","pt","ro","ru","sk","sl","sr","sv","th","tl","tr","uk","vi","zh","zh-cn","zh-tw"]}}}}},"components/schemas/HotelFacilityTypeOutputDto":{"id":"components/schemas/HotelFacilityTypeOutputDto","kind":"json-schema","title":"HotelFacilityTypeOutputDto","data":{"type":"object","properties":{"hotel_facility_type_id":{"type":"integer","description":"Unique ID of the hotel facility type.","format":"int32"},"facility_type_id":{"type":"integer","description":"The type of facility this is, mapped from FacilityTypes.","format":"int32"},"name":{"type":"string","description":"The name of this facility type in english.","example":"Parking"},"translations":{"type":"array","description":"The fields and their translations in various languages. They are only shown if we have the translations available.","items":{"$ref":"#/components/schemas/TranslationDto"}}}}},"components/schemas/ResponseOutputV2HotelFacilityTypeOutputDto":{"id":"components/schemas/ResponseOutputV2HotelFacilityTypeOutputDto","kind":"json-schema","title":"ResponseOutputV2HotelFacilityTypeOutputDto","data":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"result":{"type":"array","items":{"$ref":"#/components/schemas/HotelFacilityTypeOutputDto"}}}}},"components/schemas/BlockAvailabilityInputDto":{"id":"components/schemas/BlockAvailabilityInputDto","kind":"json-schema","title":"BlockAvailabilityInputDto","data":{"required":["checkin","checkout","guest_cc","hotel_ids"],"type":"object","properties":{"hotel_ids":{"type":"array","description":"Hotel ID(s) to check availability for.","items":{"type":"integer","description":"Hotel ID(s) to check availability for.","format":"int32"}},"checkin":{"type":"string","description":"The arrival date.","format":"date"},"checkout":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The departure date. Must be later than {checkin}."},"children":[]}]}]}],"format":"date"},"guest_cc":{"type":"string","description":"Guest country code. Used to accurately display the best prices and price details for people from that country."},"currency":{"type":"string","description":"Returns the prices in this currency, in addition to the hotel currency."},"extras":{"type":"array","description":"The extra items for this request. See the documentation for more details about each extra.","items":{"type":"string","description":"The extra items for this request. See the documentation for more details about each extra.","enum":["ADDON_TYPE","NET_PRICE","RACK_RATES","MAX_ROOMS_IN_RESERVATION","SMOKING_STATUS","IMPORTANT_INFORMATION","ALL_EXTRA_CHARGES","ADDITIONAL_ROOM_INFO","GROUP_RECOMMENDATIONS","ROOM_TYPE_ID","CC_REQUIRED","SHOW_CONDITIONAL_CHARGES","POSTCARD_PHOTO","EXTRA_CHARGES","PHOTOS","INTERNET","IF_DOMESTIC_NO_CC","FACILITIES","EXTRA_BEDS","CANCELLATION_INFO","MEALPLANS","DEAL_LASTM","PAYMENT_TERMS","ALL_PRICES","BLOCK_PAYMENT_OPTIONS","MAX_CHILDREN_FREE_AGE","NUMBER_OF_ROOMS_LEFT","MAX_CHILDREN_FREE","POLICIES","PREPAYMENT_INFO","DEAL_FLASH","IF_NO_CC_ALLOWED","DEAL_SMART","ADDONS","ADDRESS_REQUIRED"]}},"affiliate_id":{"type":"string","description":"Application affiliate id"},"block_ids":{"type":"array","description":"Return only availability hits with these particular block IDs","example":"5555555_55555555_5_5_5,6666666_66666666_6_6_6","items":{"type":"string","description":"Return only availability hits with these particular block IDs","example":"5555555_55555555_5_5_5,6666666_66666666_6_6_6"}},"guest_ip":{"type":"string","description":"Guest IP address for determining guest country\nand showing the best price for that user and obeying laws regarding the display of taxes and fees.\n"},"guest_qty":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of guests for which blocks will be found."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The total number of guests is used for calculating city tax charges."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is specified as an array of guest numbers."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you use this parameter and make bookings through the API,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"you should also set the exact same value in the guest_quantities parameter"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for the processBooking call, otherwise per-person included charges may result in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"pricing problems, causing the booking to fail."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"NOTE: After version 2.6 either this or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"room1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" needs to be provided."},"children":[]}]}]}],"items":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of guests for which blocks will be found."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The total number of guests is used for calculating city tax charges."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is specified as an array of guest numbers."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you use this parameter and make bookings through the API,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"you should also set the exact same value in the guest_quantities parameter"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for the processBooking call, otherwise per-person included charges may result in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"pricing problems, causing the booking to fail."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"NOTE: After version 2.6 either this or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"room1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" needs to be provided."},"children":[]}]}]}],"format":"int32"}},"language":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specify the language for: block_id, policies, room texts and hotel descriptions."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: not all text is translated in all languages."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please check the \"Possible Values\" section of the documentation for the accepted language codes."},"children":[]}]}]}],"enum":["ar","bg","ca","cs","da","de","el","en","en-gb","en-us","es","es-ar","es-mx","et","fi","fr","he","hi","hr","hu","id","is","it","ja","ka","ko","lt","lv","ms","nl","no","pl","pt-br","pt-pt","pt","ro","ru","sk","sl","sr","sv","th","tl","tr","uk","vi","zh","zh-cn","zh-tw"]},"num_rooms":{"type":"integer","description":"Takes a number of rooms to put guests into","format":"int32"},"room1":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which guests to put in which rooms. Syntax: comma-separated list, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"A"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for each adult, a number in the range 0..17 for each child."},"children":[]}]}]}],"items":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which guests to put in which rooms. Syntax: comma-separated list, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"A"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for each adult, a number in the range 0..17 for each child."},"children":[]}]}]}]}},"user_platform":{"type":"string","description":"The user's platform.","enum":["ANDROID","DESKTOP","IOS","MOBILE","TABLET"]}}}},"components/schemas/BlockAvailabilityOutputDto":{"id":"components/schemas/BlockAvailabilityOutputDto","kind":"json-schema","title":"BlockAvailabilityOutputDto","data":{"type":"object","properties":{"block":{"type":"array","description":"The object containing all the relevant information for the combination of room, policy, meal and occupancy that determines the price.\"\nA block is the unique entity you book with booking.com.","items":{"$ref":"#/components/schemas/BlockOutputDto"}},"can_pay_now":{"type":"boolean","description":"Boolean value set to \"true\" if payment can be made during reservation process or \"false\" if it can not."},"checkin":{"type":"string","description":"The date that was searched for as checkin. Format: YYYY-MM-DD"},"checkout":{"type":"string","description":"The date that was searched for as checkout. Format: YYYY-MM-DD"},"direct_payment":{"type":"boolean","description":"Boolean value set to \"true\" if the direct payment is available or \"false\" if it is not."},"hotel_id":{"type":"integer","description":"Booking.com hotel ID. The unique identifier of this hotel.","format":"int64"},"hotel_url":{"type":"string","description":"URL of the hotel's page on Booking.com.","example":"https://www.booking.com/hotel/nl/toren.html"},"isFlashDeal":{"type":"boolean","writeOnly":true},"flash_deal":{"type":"boolean"}}}},"components/schemas/BlockOutputDto":{"id":"components/schemas/BlockOutputDto","kind":"json-schema","title":"BlockOutputDto","data":{"type":"object","properties":{"block_id":{"type":"string"},"breakfast_included":{"type":"boolean"}},"description":"The object containing all the relevant information for the combination of room, policy, meal and occupancy that determines the price.\"\nA block is the unique entity you book with booking.com."}},"components/schemas/ResponseOutputV2BlockAvailabilityOutputDto":{"id":"components/schemas/ResponseOutputV2BlockAvailabilityOutputDto","kind":"json-schema","title":"ResponseOutputV2BlockAvailabilityOutputDto","data":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"result":{"type":"array","items":{"$ref":"#/components/schemas/BlockAvailabilityOutputDto"}}}}},"components/schemas/Location":{"id":"components/schemas/Location","kind":"json-schema","title":"Location","data":{"description":"Geographic location of the property.","properties":{"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","example":"nl"},"latitude":{"type":"number","format":"double","description":"Latitude in decimal degrees.","example":52.3702},"longitude":{"type":"number","format":"double","description":"Longitude in decimal degrees.","example":4.8952},"street_address":{"type":"string","description":"Street address, localized to the requested language.","example":"Prins Hendrikkade 59"},"city":{"type":"string","description":"City name, localized to the requested language.","example":"Amsterdam"},"postal_code":{"type":"string","description":"Postal or ZIP code.","example":"1012 AD"},"province":{"type":"string","description":"Province or state, localized to the requested language.","example":"North Holland"}}}},"components/schemas/Image":{"id":"components/schemas/Image","kind":"json-schema","title":"Image","data":{"description":"A single property image: its CDN URL and image type (e.g. \"main\").","properties":{"url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Image URL on the Booking.com image CDN, with the requested image_size applied."},"children":[]}]}]}],"example":"https://q-xx.bstatic.com/xdata/images/hotel/max500/681992303.jpg?k=<sig>&o="},"type":{"type":"string","description":"Image type. Currently always \"main\".","example":"main"}}}},"components/schemas/Links":{"id":"components/schemas/Links","kind":"json-schema","title":"Links","data":{"description":"Partner-facing links to the property.","properties":{"booking_url":{"type":"string","description":"Partner-attributed link to the property page on Booking.com.","example":"https://www.booking.com/hotel/nl/grand-central.html?aid=343802"},"booking_deep_link_url":{"type":"string","description":"Partner-attributed deep link that opens the property in the Booking.com app.","example":"https://www.booking.com/hotel/nl/grand-central.html?aid=343802&utm_medium=deeplink"}}}},"components/schemas/Policies":{"id":"components/schemas/Policies","kind":"json-schema","title":"Policies","data":{"description":"Check-in/check-out times and bookability policies.","properties":{"check_in_start_time":{"type":"string","description":"Earliest check-in time, local to the property (HH:mm).","example":"15:00"},"check_in_end_time":{"type":"string","description":"Latest check-in time, local to the property (HH:mm).","example":"23:00"},"check_out_start_time":{"type":"string","description":"Earliest check-out time, local to the property (HH:mm).","example":"07:00"},"check_out_end_time":{"type":"string","description":"Latest check-out time, local to the property (HH:mm).","example":"11:00"},"is_instant_bookable":{"type":"boolean","description":"Whether the property can be booked instantly (no host confirmation).","example":true}}}},"components/schemas/PropertyStreamRecord":{"id":"components/schemas/PropertyStreamRecord","kind":"json-schema","title":"PropertyStreamRecord","data":{"description":"One property record emitted as one line in the NDJSON property stream.","properties":{"property_id":{"type":"integer","format":"int64","description":"Booking.com property identifier.","example":1377102},"name":{"type":"string","description":"Property name, localized to the requested language.","example":"Grand Central Hotel"},"description":{"type":"string","description":"Free-text property description, localized to the requested language. Always present.","example":"Featuring air-conditioned accommodation with a balcony, the property offers a private pool."},"category":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accommodation type of the property, as a lowercase snake_case token."},"children":[]}]}]}],"enum":["apartment","hostel","hotel","motel","resort","bed_and_breakfast","ryokan","farm_stay","holiday_park","villa","camping","boat","guest_house","inn","aparthotel","holiday_home","lodge","homestay","country_house","tented_camp","capsule_hotel","love_hotel","riad","chalet","japanese_style_business_hotel","gite","sanatorium","cruise","student_accommodation"],"example":"hotel"},"number_of_rooms":{"type":"integer","format":"int64","description":"Number of bookable rooms or units. Most inventory is single-unit (apartments and holiday homes), so 1 is the most common value.","example":1},"images":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Property images on the Booking.com image CDN, each with its URL and type. Populated for ~98.6% of properties; omitted when the property has no image."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/Image"}},"language":{"type":"string","description":"BCP-47 language code the localizable fields are returned in (echoes the request).","example":"en-gb"},"updated_at":{"type":"string","description":"ISO-8601 UTC timestamp of the last change to this property record.","example":"2026-07-06T14:21:56.000Z"},"location":{"$ref":"#/components/schemas/Location"},"ratings":{"$ref":"#/components/schemas/Ratings"},"policies":{"$ref":"#/components/schemas/Policies"},"links":{"$ref":"#/components/schemas/Links"},"status":{"$ref":"#/components/schemas/Status"}}}},"components/schemas/Ratings":{"id":"components/schemas/Ratings","kind":"json-schema","title":"Ratings","data":{"description":"Star rating and guest review aggregates.","properties":{"star_rating":{"type":"number","format":"double","description":"Official star rating from 1.0 to 5.0. Unrated properties (e.g. many apartments) use 0.0, not null.","example":5},"is_star_rating_estimated":{"type":"boolean","description":"Whether the star rating is estimated by Booking.com rather than officially assigned. Always present.","example":false},"guest_review_score":{"type":"number","format":"double","description":"Average guest review score, from 1 to 10.","example":8.6},"guest_review_count":{"type":"integer","format":"int64","description":"Number of guest reviews the score is based on.","example":1243}}}},"components/schemas/Status":{"id":"components/schemas/Status","kind":"json-schema","title":"Status","data":{"description":"Lifecycle status of the property.","properties":{"property_status":{"type":"string","description":"Lifecycle status of the property: open (bookable) or closed (not bookable).","enum":["open","closed"],"example":"open"},"last_active_date":{"type":"string","format":"date","description":"Date the property was last active in the feed, as an ISO date (YYYY-MM-DD).","example":"2026-07-07"}}}},"components/schemas/PropertyStreamRequest":{"id":"components/schemas/PropertyStreamRequest","kind":"json-schema","title":"PropertyStreamRequest","data":{"properties":{"languages":{"type":"array","description":"Exactly one BCP-47 language code. Localizable fields are returned in this language. More than one language is not currently supported and returns HTTP 400.","example":["en-gb"],"items":{"type":"string","description":"Exactly one BCP-47 language code. Localizable fields are returned in this language. More than one language is not currently supported and returns HTTP 400.","example":"[\"en-gb\"]"}},"updated_since":{"type":"string","description":"Optional ISO-8601 UTC timestamp with millisecond precision. When set, only properties changed at or after this instant are returned (delta sync); when omitted, the full inventory is returned.","example":"2026-04-20T00:00:00.000Z"},"image_size":{"type":"string","default":"standard","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Size token applied to every image URL:"},"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":"thumbnail"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 100×100, square, center-cropped"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"thumbnail_large"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 300×300, square, center-cropped"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"standard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": up to 500px on the longest side (default)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"large"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": up to 1280px on the longest side"},"children":[]}]}]}]}],"enum":["thumbnail","thumbnail_large","standard","large"]}}}},"components/schemas/BedConfigurationDto":{"id":"components/schemas/BedConfigurationDto","kind":"json-schema","title":"BedConfigurationDto","data":{"type":"object","properties":{"id":{"type":"string","description":"Uniquely identifies this bed configuration."},"configuration":{"type":"array","description":"Detail list of all different types and number of beds included in this configuration.","items":{"$ref":"#/components/schemas/BedDto"}}},"description":"Lists all alternative bed configurations that are supported."}},"components/schemas/CheckinCheckoutTimesDto":{"id":"components/schemas/CheckinCheckoutTimesDto","kind":"json-schema","title":"CheckinCheckoutTimesDto","data":{"type":"object","properties":{"checkin_from":{"$ref":"#/components/schemas/LocalTime"},"checkin_to":{"$ref":"#/components/schemas/LocalTime"},"checkout_from":{"$ref":"#/components/schemas/LocalTime"},"checkout_to":{"$ref":"#/components/schemas/LocalTime"}}}},"components/schemas/CoordinatesDto":{"id":"components/schemas/CoordinatesDto","kind":"json-schema","title":"CoordinatesDto","data":{"type":"object","properties":{"latitude":{"multipleOf":0.00001,"type":"number","description":"Latitude.","format":"double","example":52.375859},"longitude":{"multipleOf":0.00001,"type":"number","description":"Longitude.","format":"double","example":4.886006}},"description":"A signed integer number that uniquely identifies a city."}},"components/schemas/BedDto":{"id":"components/schemas/BedDto","kind":"json-schema","title":"BedDto","data":{"type":"object","properties":{"bed_type":{"type":"integer","description":"A signed integer number that uniquely identifies a bed type. Examples of bed types are: Single, Double etc.","format":"int32"},"number_of_beds":{"type":"integer","description":"Number of similar beds included in this configuration.","format":"int32"}},"description":"Detail list of all different types and number of beds included in this configuration."}},"components/schemas/LocalTime":{"id":"components/schemas/LocalTime","kind":"json-schema","title":"LocalTime","data":{"pattern":"(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]:00","type":"object","properties":{"hour":{"type":"integer","format":"int32"},"minute":{"type":"integer","format":"int32"},"second":{"type":"integer","format":"int32"},"nano":{"type":"integer","format":"int32"}},"description":"The time till when checkout can be done at this property."}},"schema_258":{"kind":"json-schema","data":{"$ref":"#/components/schemas/ReviewsInputDto"},"id":"schema_258"},"schema_259":{"kind":"json-schema","data":{"$ref":"#/components/schemas/ReviewScoresInputDto"},"id":"schema_259"},"schema_260":{"kind":"json-schema","data":{"type":"string","enum":["application/json, application/xml"]},"id":"schema_260"},"schema_261":{"kind":"json-schema","data":{"$ref":"#/components/schemas/HotelsInputDto"},"id":"schema_261"},"schema_262":{"kind":"json-schema","data":{"$ref":"#/components/schemas/HotelTypeInputDTO"},"id":"schema_262"},"schema_263":{"kind":"json-schema","data":{"type":"string","enum":["application/json"]},"id":"schema_263"},"schema_264":{"kind":"json-schema","data":{"$ref":"#/components/schemas/HotelThemeTypeInputDTO"},"id":"schema_264"},"schema_265":{"kind":"json-schema","data":{"$ref":"#/components/schemas/HotelFacilityInputDto"},"id":"schema_265"},"schema_266":{"kind":"json-schema","data":{"type":"string","description":"The arrival date.","format":"date"},"id":"schema_266"},"schema_267":{"kind":"json-schema","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The departure date. Must be later than {checkin}. Must be between 1 and 30 days after {checkin}."},"children":[]}]}]}],"format":"date"},"id":"schema_267"},"schema_268":{"kind":"json-schema","data":{"type":"string","description":"Guest country code (ISO 3166-1 alpha-2). Used to display the most accurate prices and price details for guests from that country.","example":"nl"},"id":"schema_268"},"schema_269":{"kind":"json-schema","data":{"maxItems":1000,"minItems":0,"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Limit the result to up to 1000 specific hotels that have availability for the given guests and dates."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Mutually exclusive with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"latitude"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"longitude"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": use either a hotel list or an area search, not both."},"children":[]}]}]}],"example":[96969],"items":{"type":"integer","format":"int32"}},"id":"schema_269"},"schema_270":{"kind":"json-schema","data":{"maximum":90,"minimum":-90,"multipleOf":0.00001,"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Latitude for an area search, used together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"longitude"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"radius"},"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":"Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"longitude"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; cannot be combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"hotel_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"format":"double"},"id":"schema_270"},"schema_271":{"kind":"json-schema","data":{"maximum":180,"minimum":-180,"multipleOf":0.00001,"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Longitude for an area search, used together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"latitude"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"radius"},"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":"Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"latitude"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; cannot be combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"hotel_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"format":"double"},"id":"schema_271"},"schema_272":{"kind":"json-schema","data":{"maximum":100,"minimum":15,"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search radius in km around "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"latitude"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"longitude"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Only applies to an area search. Minimum and default 15, maximum 100."},"children":[]}]}]}],"format":"double","default":15},"id":"schema_272"},"schema_273":{"kind":"json-schema","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Guests per room, as a comma-separated list: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"A"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for each adult and the age (0-17) for each child (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"A,A,5"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" = two adults and a 5-year-old)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For multi-room searches, repeat the parameter per room as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"room1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"room2"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", ... up to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"room30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"id":"schema_273"},"schema_274":{"kind":"json-schema","data":{"minimum":1,"type":"integer","description":"Splits a single guest group into this many rooms automatically. Only applied when exactly one room group is provided and the value is between 2 and the number of adults inclusive; larger values have no effect.\n","format":"int32"},"id":"schema_274"},"schema_275":{"kind":"json-schema","data":{"type":"string","description":"Return prices in this currency (ISO 4217 code).","example":"EUR"},"id":"schema_275"},"schema_276":{"kind":"json-schema","data":{"type":"string","description":"The user's language.","default":"en-gb","enum":["ar","bg","ca","cs","da","de","el","en","en-gb","en-us","es","es-ar","es-mx","et","fi","fr","he","hi","hr","hu","id","is","it","ja","ka","ko","lt","lv","ms","nl","no","pl","pt-br","pt-pt","pt","ro","ru","sk","sl","sr","sv","th","tl","tr","uk","vi","zh","zh-cn","zh-tw"]},"id":"schema_276"},"schema_277":{"kind":"json-schema","data":{"type":"string","description":"The user's platform.","enum":["ANDROID","DESKTOP","IOS","MOBILE","TABLET"]},"id":"schema_277"},"schema_278":{"kind":"json-schema","data":{"maximum":3,"minimum":0,"type":"integer","description":"Genius loyalty level (0-3) used to include Genius rates the partner is eligible for. Defaults to 0 (no Genius rates).","format":"int32","default":0},"id":"schema_278"},"schema_279":{"kind":"json-schema","data":{"type":"array","description":"The extra items for this request. See the documentation for more details about each extra.","items":{"type":"string","description":"The extra items for this request. See the documentation for more details about each extra.","enum":["HOTEL_DETAILS","HOTEL_AMENITIES","ROOM_DETAILS","ROOM_AMENITIES","ROOM_POLICIES","PAYMENT_TERMS","ADD_CHEAPEST_BREAKFAST_RATE","PPT"]}},"id":"schema_279"},"schema_280":{"kind":"json-schema","data":{"type":"array","description":"The list of options to filter the results.","items":{"type":"string","description":"The list of options to filter the results.","enum":["NO_DORMS","IS_24HR"]}},"id":"schema_280"},"schema_281":{"kind":"json-schema","data":{"type":"array","description":"The list of rates to filter the results.","items":{"type":"string","description":"The list of rates to filter the results.","enum":["BREAKFAST","FREE_CANCELLATION"]}},"id":"schema_281"},"schema_282":{"kind":"json-schema","data":{"type":"string","description":"The way to order your results. When ordering by distance, make sure to specify latitude and longitude.","default":"RANKING","enum":["DISTANCE","POPULARITY","PRICE","RANKING","REVIEW_SCORE","STARS"]},"id":"schema_282"},"schema_283":{"kind":"json-schema","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The direction you wish for your order_by parameter to be ordered in."},"children":[]}]}]}],"default":"ASC","enum":["ASC","DESC"]},"id":"schema_283"},"schema_284":{"kind":"json-schema","data":{"maximum":1000,"type":"integer","description":"The maximum number of results to return.","format":"int32"},"id":"schema_284"},"schema_285":{"kind":"json-schema","data":{"type":"string","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":[]}]}]}]},"id":"schema_285"},"schema_286":{"kind":"json-schema","data":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Meta"},"result":{"type":"array","items":{"type":"object","properties":{"hotel_id":{"type":"integer","description":"The unique identifier of this hotel.","format":"int32"},"hotel_currency_code":{"type":"string","description":"The currency code of the hotel's currency."},"price":{"multipleOf":0.01,"type":"number","description":"The display price of the room in this hotel.","format":"double","example":100},"net_price":{"multipleOf":0.01,"type":"number","description":"The net price (price without charges) of the room in this hotel.","format":"double","example":90},"rooms":{"type":"array","description":"List of available rooms. Only included when room details are requested.","items":{"type":"object","properties":{"room_name":{"type":"string"},"refundable":{"type":"boolean"},"deposit_required":{"type":"boolean"},"breakfast_included":{"type":"boolean"},"room_id":{"type":"integer","format":"int64"},"num_rooms_available_at_this_price":{"type":"integer","format":"int32"},"price":{"type":"number","format":"double"},"deal_tagging":{"type":"object","properties":{"discount_percentage":{"type":"integer","format":"int32"},"public_price":{"type":"number","format":"double"},"deal_name":{"type":"string"},"platform":{"type":"string"}}},"refundable_until":{"type":"string"},"children":{"type":"array","items":{"type":"string"}},"adults":{"type":"integer","format":"int32"},"room_type_id":{"type":"integer","format":"int64"},"net_price":{"type":"number","format":"double"},"block_id":{"type":"string"},"all_inclusive":{"type":"boolean"},"half_board":{"type":"boolean"},"full_board":{"type":"boolean"},"extra_charge":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string"},"charge_amount":{"type":"number","format":"double"},"amount":{"type":"number","format":"double"},"type":{"type":"string"},"name":{"type":"string"},"name_id":{"type":"integer","format":"int32"},"charge_price_mode":{"type":"string"},"excluded":{"type":"boolean"},"other_currency":{"type":"object","properties":{"currency":{"type":"string"},"amount":{"type":"number","format":"double"}}},"is_conditional":{"type":"boolean"}}}},"mcid":{"type":"integer","format":"int32"},"ppt":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pricing Product Tag indicating applied pricing products (e.g. G1GM = Genius L1 + Geo + Mobile)"},"children":[]}]}]}]}}}},"review_nr":{"type":"integer","description":"The number of reviews of the hotel.","format":"int32"},"stars":{"type":"string","description":"The star rating of the hotel."},"review_score":{"type":"number","description":"The review score of the hotel, in the range 1..10.","format":"double"},"review_score_word":{"type":"string","description":"The review score of the hotel in words."},"hotel_name":{"type":"string","description":"The name of the hotel."},"address":{"type":"string","description":"The address of the hotel."},"postcode":{"type":"string","description":"The postcode or zipcode of the hotel."},"country":{"type":"string","description":"The country that the hotel is located in."},"default_language":{"type":"string","description":"The default language."},"checkin_time":{"type":"object","description":"The checkin time window for a property.","properties":{"from":{"type":"string","description":"The time from when checkin starts at this property.","example":"14:00"},"until":{"type":"string","description":"The time until when checkin can be done at this property.","example":"23:00"}}},"photo":{"type":"string","description":"The url of the main photo of this hotel."},"cheapest_breakfast_rate":{"type":"object","properties":{"price":{"multipleOf":0.01,"type":"number","description":"The display price of the cheapest breakfast rate.","format":"double","example":120},"net_price":{"multipleOf":0.01,"type":"number","description":"The net price (price without charges) of the cheapest breakfast rate.","format":"double","example":110},"rooms":{"type":"array","description":"The room details for the cheapest breakfast rate.","items":{"type":"object","properties":{"room_name":{"type":"string"},"refundable":{"type":"boolean"},"deposit_required":{"type":"boolean"},"breakfast_included":{"type":"boolean"},"room_id":{"type":"integer","format":"int64"},"num_rooms_available_at_this_price":{"type":"integer","format":"int32"},"price":{"type":"number","format":"double"},"deal_tagging":{"type":"object","properties":{"discount_percentage":{"type":"integer","format":"int32"},"public_price":{"type":"number","format":"double"},"deal_name":{"type":"string"},"platform":{"type":"string"}}},"refundable_until":{"type":"string"},"children":{"type":"array","items":{"type":"string"}},"adults":{"type":"integer","format":"int32"},"room_type_id":{"type":"integer","format":"int64"},"net_price":{"type":"number","format":"double"},"block_id":{"type":"string"},"all_inclusive":{"type":"boolean"},"half_board":{"type":"boolean"},"full_board":{"type":"boolean"},"extra_charge":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string"},"charge_amount":{"type":"number","format":"double"},"amount":{"type":"number","format":"double"},"type":{"type":"string"},"name":{"type":"string"},"name_id":{"type":"integer","format":"int32"},"charge_price_mode":{"type":"string"},"excluded":{"type":"boolean"},"other_currency":{"type":"object","properties":{"currency":{"type":"string"},"amount":{"type":"number","format":"double"}}},"is_conditional":{"type":"boolean"}}}},"mcid":{"type":"integer","format":"int32"},"ppt":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pricing Product Tag indicating applied pricing products (e.g. G1GM = Genius L1 + Geo + Mobile)"},"children":[]}]}]}]}}}}}},"cheapest_filtered_rate":{"type":"object","properties":{"price":{"multipleOf":0.01,"type":"number","description":"The display price of the cheapest filtered rate.","format":"double","example":120},"net_price":{"multipleOf":0.01,"type":"number","description":"The net price (price without charges) of the cheapest filtered rate.","format":"double","example":110},"rooms":{"type":"array","description":"The room details for the cheapest filtered rate.","items":{"type":"object","properties":{"room_name":{"type":"string"},"refundable":{"type":"boolean"},"deposit_required":{"type":"boolean"},"breakfast_included":{"type":"boolean"},"room_id":{"type":"integer","format":"int64"},"num_rooms_available_at_this_price":{"type":"integer","format":"int32"},"price":{"type":"number","format":"double"},"deal_tagging":{"type":"object","properties":{"discount_percentage":{"type":"integer","format":"int32"},"public_price":{"type":"number","format":"double"},"deal_name":{"type":"string"},"platform":{"type":"string"}}},"refundable_until":{"type":"string"},"children":{"type":"array","items":{"type":"string"}},"adults":{"type":"integer","format":"int32"},"room_type_id":{"type":"integer","format":"int64"},"net_price":{"type":"number","format":"double"},"block_id":{"type":"string"},"all_inclusive":{"type":"boolean"},"half_board":{"type":"boolean"},"full_board":{"type":"boolean"},"extra_charge":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string"},"charge_amount":{"type":"number","format":"double"},"amount":{"type":"number","format":"double"},"type":{"type":"string"},"name":{"type":"string"},"name_id":{"type":"integer","format":"int32"},"charge_price_mode":{"type":"string"},"excluded":{"type":"boolean"},"other_currency":{"type":"object","properties":{"currency":{"type":"string"},"amount":{"type":"number","format":"double"}}},"is_conditional":{"type":"boolean"}}}},"mcid":{"type":"integer","format":"int32"},"ppt":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pricing Product Tag indicating applied pricing products (e.g. G1GM = Genius L1 + Geo + Mobile)"},"children":[]}]}]}]}}}}}},"hotel_url":{"type":"string","description":"URL of the property's page on Booking.com."}}}}}},"id":"schema_286"},"schema_287":{"kind":"json-schema","data":{"$ref":"#/components/schemas/BlockAvailabilityInputDto"},"id":"schema_287"}},"exampleStore":{"paths/~1reports~1conversions/post/responses/400/content/application~1json/examples/conflicting_filters":{"value":{"errors":[{"id":"conflicting_parameters","name":"Conflicting Parameters","message":"Parameters booking_date_range, cancellation_date_range are mutually exclusive."}],"request_id":"req_abc123xyz"},"key":"conflicting_filters","summary":"Multiple date filters provided","description":"Returned when more than one date filter is specified in the request","id":"paths/~1reports~1conversions/post/responses/400/content/application~1json/examples/conflicting_filters"},"paths/~1reports~1conversions/post/responses/400/content/application~1json/examples/missing_filter":{"value":{"errors":[{"id":"invalid_parameter","name":"Invalid Parameter","message":"Exactly one date filter must be specified: booking_date_range, cancellation_date_range, or checkout_date_range"}],"request_id":"req_abc123xyz"},"key":"missing_filter","summary":"No date filter provided","description":"Returned when no date filter is specified in the request","id":"paths/~1reports~1conversions/post/responses/400/content/application~1json/examples/missing_filter"},"paths/~1inventory~1properties/post/responses/400/content/application~1json/examples/Multiple languages":{"value":{"request_id":"b1a2c3d4e5f6","errors":[{"id":"invalid_parameter","name":"Invalid Value","message":"Parameter 'languages' is invalid. Only one language per request is supported (got 2)"}]},"key":"Multiple languages","summary":"Multiple languages","description":"Multiple languages","id":"paths/~1inventory~1properties/post/responses/400/content/application~1json/examples/Multiple languages"},"paths/~1demand-api-v2-compatible~1reviews/get/responses/400/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"invalid_parameter","name":"Invalid Value","message":"Parameter 'hotel_ids' is invalid."}]},"id":"paths/~1demand-api-v2-compatible~1reviews/get/responses/400/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1reviews/get/responses/500/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"server_error","name":"Internal Server Error","message":"We are experiencing technical difficulties. Please try again later."}]},"id":"paths/~1demand-api-v2-compatible~1reviews/get/responses/500/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1reviewScores/get/responses/400/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"invalid_parameter","name":"Invalid Value","message":"Parameter 'hotel_ids' is invalid."}]},"id":"paths/~1demand-api-v2-compatible~1reviewScores/get/responses/400/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1reviewScores/get/responses/500/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"server_error","name":"Internal Server Error","message":"We are experiencing technical difficulties. Please try again later."}]},"id":"paths/~1demand-api-v2-compatible~1reviewScores/get/responses/500/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1hotels/get/responses/400/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"invalid_parameter","name":"Invalid Value","message":"Parameter 'hotel_ids' is invalid."}]},"id":"paths/~1demand-api-v2-compatible~1hotels/get/responses/400/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1hotels/get/responses/500/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"server_error","name":"Internal Server Error","message":"We are experiencing technical difficulties. Please try again later."}]},"id":"paths/~1demand-api-v2-compatible~1hotels/get/responses/500/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1hotelTypes/get/responses/400/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"invalid_parameter","name":"Invalid Value","message":"Parameter 'hotel_ids' is invalid."}]},"id":"paths/~1demand-api-v2-compatible~1hotelTypes/get/responses/400/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1hotelTypes/get/responses/500/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"server_error","name":"Internal Server Error","message":"We are experiencing technical difficulties. Please try again later."}]},"id":"paths/~1demand-api-v2-compatible~1hotelTypes/get/responses/500/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/responses/400/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"invalid_parameter","name":"Invalid Value","message":"Parameter 'hotel_ids' is invalid."}]},"id":"paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/responses/400/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/responses/500/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"server_error","name":"Internal Server Error","message":"We are experiencing technical difficulties. Please try again later."}]},"id":"paths/~1demand-api-v2-compatible~1hotelThemeTypes/get/responses/500/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/responses/400/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"invalid_parameter","name":"Invalid Value","message":"Parameter 'hotel_ids' is invalid."}]},"id":"paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/responses/400/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/responses/500/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"server_error","name":"Internal Server Error","message":"We are experiencing technical difficulties. Please try again later."}]},"id":"paths/~1demand-api-v2-compatible~1hotelFacilityTypes/get/responses/500/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1hotelAvailability/get/responses/400/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"invalid_parameter","name":"Invalid Value","message":"Parameter 'hotel_ids' is invalid."}]},"id":"paths/~1demand-api-v2-compatible~1hotelAvailability/get/responses/400/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1hotelAvailability/get/responses/500/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"server_error","name":"Internal Server Error","message":"We are experiencing technical difficulties. Please try again later."}]},"id":"paths/~1demand-api-v2-compatible~1hotelAvailability/get/responses/500/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1blockAvailability/get/responses/400/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"invalid_parameter","name":"Invalid Value","message":"Parameter 'hotel_ids' is invalid."}]},"id":"paths/~1demand-api-v2-compatible~1blockAvailability/get/responses/400/content/application~1json/example"},"paths/~1demand-api-v2-compatible~1blockAvailability/get/responses/500/content/application~1json/example":{"value":{"meta":{"ruid":"b1a2c3d4e5f6","account_id":"123432"},"errors":[{"id":"server_error","name":"Internal Server Error","message":"We are experiencing technical difficulties. Please try again later."}]},"id":"paths/~1demand-api-v2-compatible~1blockAvailability/get/responses/500/content/application~1json/example"}},"securitySchemeStore":{"BearerAuth":{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"string"}},"servers":[{"url":"https://metasearch-connect-api.booking.com","description":"Production URL"}]},"options":{"feedback":{"hide":true,"settings":{"label":""}},"corsProxyUrl":"https://cors.redoc.ly","hideSidebar":true,"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/metasearch/connect-api/open-api.json?download"},{"url":"/_bundle/metasearch/connect-api/open-api.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Connect API","description":"Partner Connect API Service\n"}},"baseSlug":"/metasearch/connect-api/open-api","routesMapping":{}}