{"items":[{"type":"link","label":"Property Health API","link":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification","routeSlug":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification","content":{"contentType":"overview","meta":{"name":"Property Health API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"property-health-api-specification.json","url":"/_bundle/connectivity/docs/openapispecs/property-health-api/property-health-api-specification.json?download"},{"kind":"download","label":"property-health-api-specification.yaml","url":"/_bundle/connectivity/docs/openapispecs/property-health-api/property-health-api-specification.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"externallink","title":"URL","titleTranslationKey":"info.contact.url","label":"https://connect.booking.com","url":"https://connect.booking.com"},{"kind":"email","title":"Connectivity Support","email":"connectivity@booking.com","label":"connectivity@booking.com","withCopyButton":true,"copyContent":"connectivity@booking.com"},{"kind":"externallink","title":"License","titleTranslationKey":"info.license","label":"Copyright Booking.com. All rights reserved.","url":"https://www.booking.com"}]},{"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":"/_mock/connectivity/docs/openapispecs/property-health-api/property-health-api-specification","description":"Mock (schema only)","isMockServer":true},{"url":"https://supply-xml.booking.com/property-health-api","description":"Production Environment"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Property Health API (0.1)","showPageActions":true},{"nodeType":"markdoc","content":"Retrieve property health for provider-context and property-ID lookups."},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":"Read-only JSON API for connectivity providers to retrieve property health and status data. Use it to understand why properties are unbookable or at risk and to prioritize action across provider-accessible properties or explicit Booking.com property IDs."}],"sectionId":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification"},{"nodeType":"external-docs","url":"https://connect.booking.com/","description":"Find out more about Connectivity APIs"}],"sectionId":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification"}]}]}},{"type":"separator","label":"API Endpoints","content":null},{"type":"group","label":"Property Health","link":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/property-health","routeSlug":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/property-health","items":[{"label":"Retrieve property health for the provider context","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/property-health/getpropertyhealth","routeSlug":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/property-health/getpropertyhealth","metadata":{"seo":{"title":"Retrieve property health for the provider context","description":"Returns property health records for properties available in the authenticated provider context. The provider-context lookup returns up to 2,000 eligible properties selected by backend priority rules, prioritizing actionable health and status signals before applying deterministic property ID ordering. The filterBy field narrows results using supported field enum values."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getPropertyHealth","name":"Retrieve property health for the provider context","isWebhook":false,"pointer":"/paths/~1properties~1health/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve property health for the provider context","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 property health records for properties available in the authenticated provider context. The provider-context lookup returns up to 2,000 eligible properties selected by backend priority rules, prioritizing actionable health and status signals before applying deterministic property ID ordering. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filterBy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field narrows results using supported field enum values."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PropertyHealthRequest","exampleIds":["paths/~1properties~1health/post/requestBody/content/application~1json/examples/NoFilters"]}},"schemaId":"components/schemas/PropertyHealthRequest","exampleIds":["paths/~1properties~1health/post/requestBody/content/application~1json/examples/NoFilters"],"pointer":"/paths/~1properties~1health/post/requestBody","description":"Provider-context property health request. Use an empty JSON object for an unfiltered lookup."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/properties/health","servers":[{"url":"/_mock/connectivity/docs/openapispecs/property-health-api/property-health-api-specification","description":"Mock (schema only)","isMockServer":true},{"url":"https://supply-xml.booking.com/property-health-api","description":"Production Environment"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/PropertyHealthRequest","exampleIds":["paths/~1properties~1health/post/requestBody/content/application~1json/examples/NoFilters"]}},"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/properties/health","href":"property-health/getpropertyhealth","openApiOperationId":"getPropertyHealth","summary":"Retrieve property health for the provider context"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/connectivity/docs/openapispecs/property-health-api/property-health-api-specification","description":"Mock (schema only)","isMockServer":true},{"url":"https://supply-xml.booking.com/property-health-api","description":"Production Environment"}],"schemaId":"components/schemas/PropertyHealthRequest","exampleIds":["paths/~1properties~1health/post/requestBody/content/application~1json/examples/NoFilters"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PropertyHealthRequest","exampleIds":["paths/~1properties~1health/post/requestBody/content/application~1json/examples/NoFilters"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response containing property health records.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PropertyHealthResponse"}},"schemaId":"components/schemas/PropertyHealthResponse"},{"code":"400","description":"Invalid request payload.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}},"schemaId":"components/schemas/ApiError"},{"code":"401","description":"Missing or invalid authentication credentials.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}},"schemaId":"components/schemas/ApiError"},{"code":"403","description":"Caller is authenticated but not authorized for the requested provider context.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}},"schemaId":"components/schemas/ApiError"},{"code":"404","description":"No property health data found for the provider context.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}},"schemaId":"components/schemas/ApiError"},{"code":"429","description":"Too many requests. Rate limiting is enforced by the API gateway or proxy.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}},"schemaId":"components/schemas/ApiError","headers":{"Retry-After":{"description":"Optional number of seconds to wait before retrying the request.","style":"simple","schema":{"type":"integer","format":"int32","minimum":0}}},"headerSchemaId":"schema_503"},{"code":"500","description":"Unexpected internal server error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}},"schemaId":"components/schemas/ApiError"}],"pointer":"/paths/~1properties~1health/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PropertyHealthResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PropertyHealthResponse"}}},{"code":"400","schemaId":"components/schemas/ApiError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}}},{"code":"401","schemaId":"components/schemas/ApiError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}}},{"code":"403","schemaId":"components/schemas/ApiError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}}},{"code":"404","schemaId":"components/schemas/ApiError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}}},{"code":"429","schemaId":"components/schemas/ApiError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}}},{"code":"500","schemaId":"components/schemas/ApiError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}}}],"examples":[]}]}]}]},"httpPath":"/properties/health"},{"label":"Retrieve property health by property IDs","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/property-health/getpropertyhealthbypropertyids","routeSlug":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/property-health/getpropertyhealthbypropertyids","metadata":{"seo":{"title":"Retrieve property health by property IDs","description":"Returns property health records for the Booking.com property IDs in propertyIds. A request can include up to 2,000 IDs. notFoundIds contains requested property IDs that could not be returned or are not linked to the machine account ID. The filterBy field narrows results using supported field enum values."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getPropertyHealthByPropertyIds","name":"Retrieve property health by property IDs","isWebhook":false,"pointer":"/paths/~1properties~1health~1by-type~1property-ids/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve property health by property IDs","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 property health records for the Booking.com property IDs in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"propertyIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A request can include up to 2,000 IDs. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"notFoundIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" contains requested property IDs that could not be returned or are not linked to the machine account ID. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filterBy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field narrows results using supported field enum values."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PropertyHealthByPropertyIdsRequest","exampleIds":["paths/~1properties~1health~1by-type~1property-ids/post/requestBody/content/application~1json/examples/PropertyIds","paths/~1properties~1health~1by-type~1property-ids/post/requestBody/content/application~1json/examples/PropertyIdsWithFilters"]}},"schemaId":"components/schemas/PropertyHealthByPropertyIdsRequest","exampleIds":["paths/~1properties~1health~1by-type~1property-ids/post/requestBody/content/application~1json/examples/PropertyIds","paths/~1properties~1health~1by-type~1property-ids/post/requestBody/content/application~1json/examples/PropertyIdsWithFilters"],"pointer":"/paths/~1properties~1health~1by-type~1property-ids/post/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Property-ID lookup request containing "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"propertyIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/properties/health/by-type/property-ids","servers":[{"url":"/_mock/connectivity/docs/openapispecs/property-health-api/property-health-api-specification","description":"Mock (schema only)","isMockServer":true},{"url":"https://supply-xml.booking.com/property-health-api","description":"Production Environment"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/PropertyHealthByPropertyIdsRequest","exampleIds":["paths/~1properties~1health~1by-type~1property-ids/post/requestBody/content/application~1json/examples/PropertyIds","paths/~1properties~1health~1by-type~1property-ids/post/requestBody/content/application~1json/examples/PropertyIdsWithFilters"]}},"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/properties/health/by-type/property-ids","href":"property-health/getpropertyhealthbypropertyids","openApiOperationId":"getPropertyHealthByPropertyIds","summary":"Retrieve property health by property IDs"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/connectivity/docs/openapispecs/property-health-api/property-health-api-specification","description":"Mock (schema only)","isMockServer":true},{"url":"https://supply-xml.booking.com/property-health-api","description":"Production Environment"}],"schemaId":"components/schemas/PropertyHealthByPropertyIdsRequest","exampleIds":["paths/~1properties~1health~1by-type~1property-ids/post/requestBody/content/application~1json/examples/PropertyIds","paths/~1properties~1health~1by-type~1property-ids/post/requestBody/content/application~1json/examples/PropertyIdsWithFilters"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PropertyHealthByPropertyIdsRequest","exampleIds":["paths/~1properties~1health~1by-type~1property-ids/post/requestBody/content/application~1json/examples/PropertyIds","paths/~1properties~1health~1by-type~1property-ids/post/requestBody/content/application~1json/examples/PropertyIdsWithFilters"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Successful response containing property health records for found and authorized property IDs. If some requested IDs could not be returned or are not linked to the machine account ID, they are returned in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"notFoundIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PropertyHealthByPropertyIdsResponse"}},"schemaId":"components/schemas/PropertyHealthByPropertyIdsResponse"},{"code":"400","description":"Invalid property-ID request payload.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}},"schemaId":"components/schemas/ApiError"},{"code":"401","description":"Missing or invalid authentication credentials for the property-ID lookup.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}},"schemaId":"components/schemas/ApiError"},{"code":"403","description":"Caller is authenticated but not allowed to use this endpoint or lacks the required authorization context.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}},"schemaId":"components/schemas/ApiError"},{"code":"404","description":"None of the requested property IDs can be returned.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}},"schemaId":"components/schemas/ApiError"},{"code":"429","description":"Too many requests. Rate limiting is enforced by the API gateway or proxy.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}},"schemaId":"components/schemas/ApiError","headers":{"Retry-After":{"description":"Optional number of seconds to wait before retrying the request.","style":"simple","schema":{"type":"integer","format":"int32","minimum":0}}},"headerSchemaId":"schema_503"},{"code":"500","description":"Unexpected internal server error during property-ID lookup.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}},"schemaId":"components/schemas/ApiError"}],"pointer":"/paths/~1properties~1health~1by-type~1property-ids/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PropertyHealthByPropertyIdsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PropertyHealthByPropertyIdsResponse"}}},{"code":"400","schemaId":"components/schemas/ApiError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}}},{"code":"401","schemaId":"components/schemas/ApiError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}}},{"code":"403","schemaId":"components/schemas/ApiError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}}},{"code":"404","schemaId":"components/schemas/ApiError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}}},{"code":"429","schemaId":"components/schemas/ApiError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}}},{"code":"500","schemaId":"components/schemas/ApiError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiError"}}}],"examples":[]}]}]}]},"httpPath":"/properties/health/by-type/property-ids"}],"content":{"contentType":"group","meta":{"name":"Property Health"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Property Health","showPageActions":true},{"nodeType":"markdoc","content":"Endpoints for retrieving property health and status data."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/properties/health","summary":"Retrieve property health for the provider context","prefix":{"name":"post","color":"post"},"badges":[],"link":"/property-health/getpropertyhealth","deprecated":false},{"title":"/properties/health/by-type/property-ids","summary":"Retrieve property health by property IDs","prefix":{"name":"post","color":"post"},"badges":[],"link":"/property-health/getpropertyhealthbypropertyids","deprecated":false}]}]}]}]}},{"type":"separator","label":"Documentation","content":null},{"type":"group","label":"About Try it","link":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/about-try-it","routeSlug":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/about-try-it","items":[{"type":"link","label":"Environment","link":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/about-try-it/environment","routeSlug":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/about-try-it/environment","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Environment"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"about-try-it/environment"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Environment"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use a test setup first. The Property Health API is read-only, but live endpoint requests still use real authorization context and return real property health data for properties available to the selected machine account."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Authentication","link":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/about-try-it/authentication","routeSlug":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/about-try-it/authentication","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Authentication"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"about-try-it/authentication"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Property Health API requests use token-based authentication. Add an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header with a Bearer JWT. Make sure the JWT belongs to a machine account that is configured for the Property Health API and has access to the test properties you use."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not use Try it with live JWTs on shared computers or in browsers with extensions that can inspect or monitor network traffic. Treat JWTs as credentials, and remove them from the browser environment after testing."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Request","link":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/about-try-it/request","routeSlug":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/about-try-it/request","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Request"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"about-try-it/request"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /properties/health"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to retrieve property health for the authenticated provider context. Send an empty JSON object for an unfiltered lookup, or include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filterBy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to narrow the returned properties."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /properties/health/by-type/property-ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to retrieve property health for specific Booking.com property IDs. Provide "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"propertyIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with up to 2,000 IDs. You can also include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filterBy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in this request to narrow the health records returned for those property IDs. The response only includes properties that can be returned for your machine account and have available health data."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Filters","link":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/about-try-it/filters","routeSlug":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/about-try-it/filters","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Filters"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"about-try-it/filters"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filters"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Add "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filterBy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to either request type to narrow the result set. Each filter contains "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"field"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"operator"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Multiple filters are combined with AND semantics. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is always sent as a string and must match the selected field format, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Open"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"NO_RISK"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2026-12-31"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2026-01-01T00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Response","link":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/about-try-it/response","routeSlug":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/about-try-it/response","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Response"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"about-try-it/response"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Successful responses include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"properties"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"meta"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Each property can include status, property information, availability, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dataAsOf"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Some fields may be missing when that data is not available for a property."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"notFoundIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is included only for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /properties/health/by-type/property-ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". It contains requested property IDs that could not be returned or are not linked to the machine account ID."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"meta.ruid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when contacting Booking.com support."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Troubleshooting","link":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/about-try-it/troubleshooting","routeSlug":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification/about-try-it/troubleshooting","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Troubleshooting"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"about-try-it/troubleshooting"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Troubleshooting"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If a request fails, check that the JWT is valid, the selected machine account is configured for the Property Health API, the property IDs belong to the expected authorization context, and the request body matches the schema. For filter errors, check that the field is supported, the operator is valid for that field type, and the value uses the documented format."},"children":[]}]}]}]}],"panels":[]}]}}],"content":{"contentType":"group","meta":{"name":"About Try it"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"About Try it","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Learn how to use the Try it feature in the Property Health API documentation."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use Try it to send test requests directly from the developer portal. When using a live endpoint, use only test properties and valid JWT credentials for a machine account that has access to those properties."},"children":[]}]}]}]}],"panels":[]}]}}],"store":{"schemaStore":{"components/schemas/PropertyHealthFilter":{"id":"components/schemas/PropertyHealthFilter","kind":"json-schema","title":"PropertyHealthFilter","data":{"type":"object","description":"Filter criteria for property health data.","example":{"field":"STATUS_CURRENT_STATUS","operator":"EQUALS","value":"Open"},"properties":{"field":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supported property health field enum to filter on, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_CURRENT_STATUS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PROPERTY_INFO_CURRENCY_CODE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AVAILABILITY_RISK"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AVAILABILITY_BOOKABLE_UNTIL_DATE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PROPERTY_ID"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DATA_AS_OF"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"enum":["PROPERTY_ID","PROPERTY_INFO_PROPERTY_NAME","PROPERTY_INFO_CURRENCY_CODE","STATUS_CURRENT_STATUS","STATUS_STATUS_CHANGED_AT","STATUS_STATUS_DESCRIPTION","STATUS_TIME_IN_STATUS_DAYS","AVAILABILITY_RISK","AVAILABILITY_BOOKABLE_UNTIL_DATE","AVAILABILITY_BOOKABLE_PERIOD","DATA_AS_OF"],"example":"STATUS_CURRENT_STATUS"},"operator":{"type":"string","description":"Comparison operators for filtering.","enum":["EQUALS","NOT_EQUALS","GREATER_THAN","GREATER_THAN_OR_EQUALS","LESS_THAN","LESS_THAN_OR_EQUALS"],"example":"EQUALS"},"value":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Value to compare against, encoded as a string. Use the selected field's response value format: integer for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PROPERTY_ID"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", ISO-8601 date for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AVAILABILITY_BOOKABLE_UNTIL_DATE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", ISO-8601 offset date-time for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_STATUS_CHANGED_AT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DATA_AS_OF"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", enum names such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"NO_RISK"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", integer day counts for fields such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_TIME_IN_STATUS_DAYS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or regular string values such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"EUR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"Open","maxLength":256,"minLength":0}},"required":["field","operator","value"]}},"components/schemas/PropertyHealthRequest":{"id":"components/schemas/PropertyHealthRequest","kind":"json-schema","title":"PropertyHealthRequest","data":{"type":"object","description":"Request payload for retrieving property health for the provider context.","properties":{"filterBy":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional filters for narrowing property health results. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"field"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be one of the supported enum values, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_CURRENT_STATUS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Multiple filters are combined with AND semantics. Supported fields: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PROPERTY_ID"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PROPERTY_INFO_PROPERTY_NAME"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PROPERTY_INFO_CURRENCY_CODE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_CURRENT_STATUS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_STATUS_CHANGED_AT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_STATUS_DESCRIPTION"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_TIME_IN_STATUS_DAYS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AVAILABILITY_RISK"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AVAILABILITY_BOOKABLE_UNTIL_DATE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AVAILABILITY_BOOKABLE_PERIOD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DATA_AS_OF"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". String and enum fields support "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"EQUALS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"NOT_EQUALS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Numeric, date, and date-time fields also support "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GREATER_THAN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GREATER_THAN_OR_EQUALS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"LESS_THAN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"LESS_THAN_OR_EQUALS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Values are strings and must match the field type, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000123"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Open"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"NO_RISK"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2026-12-31"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2026-01-01T00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Day-count fields such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_TIME_IN_STATUS_DAYS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AVAILABILITY_BOOKABLE_PERIOD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are represented as integer day counts."},"children":[]}]}]}],"example":[{"field":"STATUS_CURRENT_STATUS","operator":"EQUALS","value":"Open"},{"field":"PROPERTY_INFO_CURRENCY_CODE","operator":"EQUALS","value":"EUR"},{"field":"AVAILABILITY_BOOKABLE_UNTIL_DATE","operator":"GREATER_THAN_OR_EQUALS","value":"2026-12-31"}],"items":{"$ref":"#/components/schemas/PropertyHealthFilter"},"maxItems":10,"minItems":0}}}},"components/schemas/ApiResponseMeta":{"id":"components/schemas/ApiResponseMeta","kind":"json-schema","title":"ApiResponseMeta","data":{"type":"object","description":"Response metadata.","properties":{"ruid":{"type":"string","description":"Request unique identifier.","example":"ruid-1"}},"required":["ruid"]}},"components/schemas/Availability":{"id":"components/schemas/Availability","kind":"json-schema","title":"Availability","data":{"type":"object","description":"Availability-related health signals for the property.","properties":{"risk":{"type":"string","description":"Availability risk categories based on the property's bookable-until window.","enum":["HIGH_RISK","MEDIUM_RISK","LOW_RISK","NO_RISK"],"example":"NO_RISK"},"bookableUntilDate":{"type":"string","format":"date","description":"Last date currently available for booking.","example":"2026-12-31"},"bookablePeriod":{"type":"integer","format":"int64","description":"Number of days until the property becomes unavailable.","example":317},"reason":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Explains how the property's future bookable period maps to the availability risk. The value is derived from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"risk"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"HIGH_RISK"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means the property is bookable for 7 days or less, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"MEDIUM_RISK"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for 30 days or less, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"LOW_RISK"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for 60 days or less, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"NO_RISK"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more than 60 days."},"children":[]}]}]}],"example":"Availability is open well into the future. No action is needed if your property is open."}},"required":["bookablePeriod","bookableUntilDate","reason","risk"]}},"components/schemas/PropertyHealthData":{"id":"components/schemas/PropertyHealthData","kind":"json-schema","title":"PropertyHealthData","data":{"type":"object","description":"Health snapshot for a single property.","properties":{"status":{"$ref":"#/components/schemas/Status"},"availability":{"anyOf":[{"$ref":"#/components/schemas/Availability"},{"type":"null"}]},"propertyId":{"type":"integer","format":"int64","description":"Booking.com property identifier.","example":1000123},"propertyInfo":{"$ref":"#/components/schemas/PropertyInfo"},"dataAsOf":{"type":"string","format":"date-time","description":"Timestamp indicating when this snapshot was generated.","example":"2026-02-17T06:45:00Z"}},"required":["dataAsOf","propertyId","propertyInfo","status"]}},"components/schemas/PropertyHealthResponse":{"id":"components/schemas/PropertyHealthResponse","kind":"json-schema","title":"PropertyHealthResponse","data":{"type":"object","description":"Response payload containing property health records.","properties":{"properties":{"type":"array","description":"List of property health records matching the request.","items":{"$ref":"#/components/schemas/PropertyHealthData"}},"meta":{"$ref":"#/components/schemas/ApiResponseMeta"}},"required":["meta","properties"]}},"components/schemas/PropertyInfo":{"id":"components/schemas/PropertyInfo","kind":"json-schema","title":"PropertyInfo","data":{"type":"object","description":"Basic property information.","properties":{"propertyName":{"type":"string","description":"Property name.","example":"Canal View Hotel"},"currencyCode":{"type":"string","description":"Currency code.","example":"EUR"}},"required":["currencyCode","propertyName"]}},"components/schemas/Status":{"id":"components/schemas/Status","kind":"json-schema","title":"Status","data":{"type":"object","description":"Current status details for a property.","properties":{"currentStatus":{"anyOf":[{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Current property status. Possible values include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Open"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"New - Pending Opening"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Ready to Open"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Closed - By Your Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Auto-Closed - No Availability"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Registration - Action Required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and other property statuses."},"children":[]}]}]}],"example":"Open"},{"type":"null"}]},"statusChangedAt":{"anyOf":[{"type":"string","format":"date-time","description":"Timestamp when the current status started.","example":"2026-02-10T09:00:00Z"},{"type":"null"}]},"statusDescription":{"anyOf":[{"type":"string","description":"Status description.","example":"Your property is live and accepting bookings."},{"type":"null"}]},"timeInStatusDays":{"anyOf":[{"type":"integer","format":"int64","description":"Number of days the property has been in the current status.","example":30},{"type":"null"}]}}}},"components/schemas/ApiError":{"id":"components/schemas/ApiError","kind":"json-schema","title":"ApiError","data":{"type":"object","description":"Standard error payload returned for non-success API responses.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"VALIDATION_ERROR"},"message":{"type":"string","description":"Human-readable error message.","example":"Request validation failed."},"details":{"type":"string","description":"Optional sanitized, non-sensitive detailed error information for troubleshooting.","example":"propertyIds: size must be between 1 and 2000."},"meta":{"$ref":"#/components/schemas/ApiResponseMeta"}},"required":["code","message"]}},"components/schemas/PropertyHealthByPropertyIdsRequest":{"id":"components/schemas/PropertyHealthByPropertyIdsRequest","kind":"json-schema","title":"PropertyHealthByPropertyIdsRequest","data":{"type":"object","description":"Request payload for retrieving property health by Booking.com property IDs.","properties":{"propertyIds":{"type":"array","description":"Booking.com property IDs to retrieve. Maximum 2,000 IDs per request.","example":[1000123,1000456],"items":{"type":"integer","format":"int64"},"maxItems":2000,"minItems":1},"filterBy":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional filters for narrowing property health results. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"field"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be one of the supported enum values, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_CURRENT_STATUS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Multiple filters are combined with AND semantics. Supported fields: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PROPERTY_ID"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PROPERTY_INFO_PROPERTY_NAME"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PROPERTY_INFO_CURRENCY_CODE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_CURRENT_STATUS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_STATUS_CHANGED_AT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_STATUS_DESCRIPTION"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_TIME_IN_STATUS_DAYS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AVAILABILITY_RISK"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AVAILABILITY_BOOKABLE_UNTIL_DATE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AVAILABILITY_BOOKABLE_PERIOD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DATA_AS_OF"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". String and enum fields support "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"EQUALS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"NOT_EQUALS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Numeric, date, and date-time fields also support "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GREATER_THAN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GREATER_THAN_OR_EQUALS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"LESS_THAN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"LESS_THAN_OR_EQUALS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Values are strings and must match the field type, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000123"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Open"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"NO_RISK"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2026-12-31"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2026-01-01T00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Day-count fields such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATUS_TIME_IN_STATUS_DAYS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AVAILABILITY_BOOKABLE_PERIOD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are represented as integer day counts."},"children":[]}]}]}],"example":[{"field":"STATUS_CURRENT_STATUS","operator":"EQUALS","value":"Open"},{"field":"PROPERTY_INFO_CURRENCY_CODE","operator":"EQUALS","value":"EUR"},{"field":"AVAILABILITY_BOOKABLE_UNTIL_DATE","operator":"GREATER_THAN_OR_EQUALS","value":"2026-12-31"}],"items":{"$ref":"#/components/schemas/PropertyHealthFilter"},"maxItems":10,"minItems":0}},"required":["propertyIds"]}},"components/schemas/PropertyHealthByPropertyIdsResponse":{"id":"components/schemas/PropertyHealthByPropertyIdsResponse","kind":"json-schema","title":"PropertyHealthByPropertyIdsResponse","data":{"type":"object","description":"Response payload for property-ID property health lookups.","properties":{"properties":{"type":"array","description":"List of property health records matching the request.","items":{"$ref":"#/components/schemas/PropertyHealthData"}},"meta":{"$ref":"#/components/schemas/ApiResponseMeta"},"notFoundIds":{"type":"array","description":"Contains requested property IDs that could not be returned or are not linked to the machine account ID.","example":[999999],"items":{"type":"integer","format":"int64"}}},"required":["meta","properties"]}},"schema_503":{"kind":"json-schema","data":{"type":"object","properties":{"Retry-After":{"type":"integer","format":"int32","minimum":0,"description":"Optional number of seconds to wait before retrying the request."}}},"id":"schema_503"}},"exampleStore":{"paths/~1properties~1health/post/requestBody/content/application~1json/examples/NoFilters":{"value":{},"key":"NoFilters","summary":"Provider-context lookup","description":"NoFilters","id":"paths/~1properties~1health/post/requestBody/content/application~1json/examples/NoFilters"},"paths/~1properties~1health~1by-type~1property-ids/post/requestBody/content/application~1json/examples/PropertyIds":{"value":{"propertyIds":[1000123,1000456]},"key":"PropertyIds","summary":"Lookup by property IDs","description":"PropertyIds","id":"paths/~1properties~1health~1by-type~1property-ids/post/requestBody/content/application~1json/examples/PropertyIds"},"paths/~1properties~1health~1by-type~1property-ids/post/requestBody/content/application~1json/examples/PropertyIdsWithFilters":{"value":{"propertyIds":[1000123,1000456],"filterBy":[{"field":"STATUS_CURRENT_STATUS","operator":"EQUALS","value":"Open"},{"field":"AVAILABILITY_RISK","operator":"EQUALS","value":"NO_RISK"}]},"key":"PropertyIdsWithFilters","summary":"Lookup by property IDs with filters","description":"PropertyIdsWithFilters","id":"paths/~1properties~1health~1by-type~1property-ids/post/requestBody/content/application~1json/examples/PropertyIdsWithFilters"}},"securitySchemeStore":{"BearerAuth":{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}},"servers":[{"url":"/_mock/connectivity/docs/openapispecs/property-health-api/property-health-api-specification","isMockServer":true,"description":"Mock (schema only)"},{"url":"https://supply-xml.booking.com/property-health-api","description":"Production Environment"}]},"options":{"feedback":{"hide":true,"settings":{"label":""}},"corsProxyUrl":"https://cors.redoc.ly","pagination":"section","hideSidebar":true,"mockServer":{"url":"/_mock/connectivity/docs/openapispecs/property-health-api/property-health-api-specification","position":"first","description":"Mock (schema only)","off":false},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/connectivity/docs/openapispecs/property-health-api/property-health-api-specification.json?download"},{"url":"/_bundle/connectivity/docs/openapispecs/property-health-api/property-health-api-specification.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Property Health API","description":"Read-only JSON API for connectivity providers to retrieve property health and status data. Use it to understand why properties are unbookable or at risk and to prioritize action across provider-accessible properties or explicit Booking.com property IDs.","summary":"Retrieve property health for provider-context and property-ID lookups."}},"baseSlug":"/connectivity/docs/openapispecs/property-health-api/property-health-api-specification","routesMapping":{}}