---
title: "Retrieve property health for the provider context"
method: POST
path: "/properties/health"
tags: ["Property Health"]
---

# Retrieve property health for the provider context

`POST /properties/health`

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.

## Request body

- PropertyHealthRequest — Request payload for retrieving property health for the provider context.
  - `filterBy` PropertyHealthFilter[] — Optional filters for narrowing property health results. `field` must be one of the supported enum values, for example `STATUS_CURRENT_STATUS`. Multiple filters are combined with AND semantics. Supported fields: `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`, `COMPLIANCE_KYP_STATUS`, `COMPLIANCE_DSA_STATUS`, `AVAILABILITY_RISK`, `AVAILABILITY_BOOKABLE_UNTIL_DATE`, `AVAILABILITY_BOOKABLE_PERIOD`, `DATA_AS_OF`. String and enum fields support `EQUALS` and `NOT_EQUALS`. Numeric, date, and date-time fields also support `GREATER_THAN`, `GREATER_THAN_OR_EQUALS`, `LESS_THAN`, and `LESS_THAN_OR_EQUALS`. Values are strings and must match the field type, for example `1000123`, `30`, `Open`, `NO_RISK`, `2026-12-31`, or `2026-01-01T00:00:00Z`. Day-count fields such as `STATUS_TIME_IN_STATUS_DAYS` and `AVAILABILITY_BOOKABLE_PERIOD` are represented as integer day counts.
    - `field` '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' | 'COMPLIANCE_KYP_STATUS' | 'COMPLIANCE_DSA_STATUS' | 'AVAILABILITY_RISK' | 'AVAILABILITY_BOOKABLE_UNTIL_DATE' | 'AVAILABILITY_BOOKABLE_PERIOD' | 'DATA_AS_OF', required — Supported property health field enum to filter on, for example `STATUS_CURRENT_STATUS`, `PROPERTY_INFO_CURRENCY_CODE`, `AVAILABILITY_RISK`, `AVAILABILITY_BOOKABLE_UNTIL_DATE`, `PROPERTY_ID`, or `DATA_AS_OF`.
    - `operator` 'EQUALS' | 'NOT_EQUALS' | 'GREATER_THAN' | 'GREATER_THAN_OR_EQUALS' | 'LESS_THAN' | 'LESS_THAN_OR_EQUALS', required — Comparison operators for filtering.
    - `value` string, required — Value to compare against, encoded as a string. Use the selected field's response value format: integer for `PROPERTY_ID`, ISO-8601 date for `AVAILABILITY_BOOKABLE_UNTIL_DATE`, ISO-8601 offset date-time for `STATUS_STATUS_CHANGED_AT` and `DATA_AS_OF`, enum names such as `NO_RISK`, integer day counts for fields such as `STATUS_TIME_IN_STATUS_DAYS`, or regular string values such as `EUR`.

## Response `200`

Successful response containing property health records.

- PropertyHealthResponse — Response payload containing property health records.
  - `properties` PropertyHealthData[], required — List of property health records matching the request.
    - `status` Status, required — Current status details for a property.
      - `currentStatus` string, nullable — Current property status. Possible values include `Open`, `New - Pending Opening`, `Ready to Open`, `Closed - By Your Request`, `Auto-Closed - No Availability`, `Registration - Action Required`, and other property statuses.
      - `statusChangedAt` string, date-time, nullable — Timestamp when the current status started.
      - `statusDescription` string, nullable — Status description.
      - `timeInStatusDays` integer, nullable — Number of days the property has been in the current status.
    - `compliance` Compliance — Compliance-related status information for the property.
      - `kypStatus` string, required — Know Your Partner (KYP) status returned by the compliance source. Example values include `APPROVED` and other KYP lifecycle statuses.
      - `dsaStatus` string, required — Digital Services Act (DSA) compliance status returned by the compliance source. Example values include `REQUESTED` and other DSA lifecycle statuses.
    - `availability` Availability — Availability-related health signals for the property.
      - `risk` 'HIGH_RISK' | 'MEDIUM_RISK' | 'LOW_RISK' | 'NO_RISK', required — Availability risk categories based on the property's bookable-until window.
      - `bookableUntilDate` string, date, required — Last date currently available for booking.
      - `bookablePeriod` integer, required — Number of days until the property becomes unavailable.
      - `reason` string, required — Explains how the property's future bookable period maps to the availability risk. The value is derived from `risk`: `HIGH_RISK` means the property is bookable for 7 days or less, `MEDIUM_RISK` for 30 days or less, `LOW_RISK` for 60 days or less, and `NO_RISK` for more than 60 days.
    - `propertyId` integer, required — Booking.com property identifier.
    - `propertyInfo` PropertyInfo, required — Basic property information.
      - `propertyName` string, required — Property name.
      - `currencyCode` string, required — Currency code.
    - `reservations` Reservations — Reservation counts for the property.
      - `gross` integer, required — Gross hotel reservation count.
      - `cancelled` integer, required — Cancelled hotel reservation count.
      - `net` integer, required — Net hotel reservation count.
    - `dataAsOf` string, date-time, required — Timestamp indicating when this snapshot was generated.
  - `meta` ApiResponseMeta, required — Response metadata.
    - `ruid` string, required — Request unique identifier.

## Other responses

- `400` — Invalid request payload.
- `401` — Missing or invalid authentication credentials.
- `403` — Caller is authenticated but not authorized for the requested provider context.
- `404` — No property health data found for the provider context.
- `429` — Too many requests. Rate limiting is enforced by the API gateway or proxy.
- `500` — Unexpected internal server error.

---

[API](https://skmtc.net/booking/apis/property-health-api.md) · [All operations](https://skmtc.net/booking/apis/property-health-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/booking/property-health-api/revisions/10108bb9c804/schema)