{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/august-health/json-schema/august-health-com-august-api-integrations-models-rooms-v1-room-schema.json",
  "title": "com.august.api.integrations.models.rooms.v1.Room",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/august-health-facilities-v1-api-openapi.yml#/components/schemas/com.august.api.integrations.models.rooms.v1.Room",
  "properties": {
    "admissionType": {
      "$ref": "#/$defs/com.august.protos.admissions.AdmissionsInformation.AdmissionType",
      "description": "The admission type assigned to this room."
    },
    "area": {
      "$ref": "#/$defs/com.august.api.integrations.models.common.Measurement",
      "description": "The room's floor area in square feet (permission-gated; only included when the caller has the room marketing read permission)."
    },
    "beds": {
      "description": "Configured beds for this room.",
      "items": {
        "$ref": "#/$defs/com.august.api.integrations.models.common.Bed",
        "description": "Configured beds for this room."
      },
      "type": "array"
    },
    "description": {
      "description": "Free-form marketing description of the room (permission-gated; only included when the caller has the room marketing read permission).",
      "type": "string"
    },
    "externalId": {
      "description": "The room's ID in the external system that manages the facility's rooms.",
      "type": "string"
    },
    "marketRates": {
      "description": "Active market rates for this room (permission-gated; only included when the caller has the room marketing read permission).",
      "items": {
        "$ref": "#/$defs/com.august.api.integrations.models.rooms.v1.RoomMarketRate",
        "description": "Active market rates for this room (permission-gated; only included when the caller has the room marketing read permission)."
      },
      "type": "array"
    },
    "roomId": {
      "description": "Unique identifier for the room.",
      "type": "string"
    },
    "roomName": {
      "description": "Human-readable name of the room.",
      "type": "string"
    }
  },
  "required": [
    "roomId",
    "roomName",
    "beds"
  ],
  "$defs": {
    "com.august.api.integrations.models.common.Bed": {
      "properties": {
        "externalId": {
          "description": "The bed's ID in the external system that manages the facility's rooms and beds.",
          "type": "string"
        },
        "id": {
          "description": "The bed's unique identifier.",
          "type": "string"
        },
        "name": {
          "description": "The bed's display name. Empty for single-occupancy rooms; only populated when the room's occupancy is greater than 1.",
          "type": "string"
        }
      },
      "required": [
        "id"
      ]
    },
    "com.august.api.integrations.models.common.Measurement": {
      "properties": {
        "unit": {
          "type": "string"
        },
        "value": {
          "format": "double",
          "type": "number"
        }
      },
      "required": [
        "value",
        "unit"
      ]
    },
    "com.august.api.integrations.models.rooms.v1.RoomMarketRate": {
      "properties": {
        "admissionType": {
          "$ref": "#/$defs/com.august.protos.admissions.AdmissionsInformation.AdmissionType"
        },
        "endDate": {
          "format": "date",
          "type": "string"
        },
        "occupancyType": {
          "enum": [
            "PRIVATE",
            "SHARED",
            "SECOND_OCCUPANT"
          ],
          "type": "string"
        },
        "rateCents": {
          "format": "int32",
          "type": "integer"
        },
        "startDate": {
          "format": "date",
          "type": "string"
        }
      },
      "required": [
        "occupancyType",
        "rateCents",
        "startDate"
      ]
    },
    "com.august.protos.admissions.AdmissionsInformation.AdmissionType": {
      "enum": [
        "ADMISSION_TYPE_ASSISTED_LIVING",
        "ADMISSION_TYPE_MEMORY_CARE",
        "ADMISSION_TYPE_INDEPENDENT_LIVING"
      ],
      "type": "string"
    }
  }
}