{
  "openapi": "3.1.0",
  "info": {
    "title": "Rosedell Estate public discovery API",
    "version": "2.0.0",
    "description": "Read-only property discovery, provisional availability and itemized non-binding estimates. No holds, booking execution, payment, cancellation, guest identity or door access. All stays require host approval; Unit C remains inquiry-only. Unknown availability never means open dates. Query parameters must match the documented exact set without duplicates. No authentication required. No CORS grant. Responses are no-store. Follow guestHandoffUrl for traveler review and inquiry submission. The catalog workflow reports whether separately authenticated guest-delegated requests and the hosted first-time permission flow are enabled. Calendar evidence and nextAction distinguish known conflicts, fresh checks with no known conflicts, and incomplete/stale checks. They do not upgrade unknown date coverage to verified availability."
  },
  "servers": [
    {
      "url": "https://rosedellestate.com/api/guest/v2"
    }
  ],
  "paths": {
    "/properties": {
      "get": {
        "operationId": "listProperties",
        "summary": "Read public property facts and current approved rules.",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Read public property facts and current approved rules.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Catalog"
                }
              }
            }
          },
          "400": {
            "description": "Malformed or unsupported query parameters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "60 requests per minute per client IP shared across these endpoints; no queue.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "Wait this many seconds before retrying.",
                "schema": {
                  "type": "integer",
                  "example": 60
                }
              }
            }
          }
        }
      }
    },
    "/properties/{unit}": {
      "get": {
        "operationId": "getProperty",
        "summary": "Read one public property.",
        "parameters": [
          {
            "name": "unit",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "a",
                "b",
                "c"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Read one public property.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PropertyResponse"
                }
              }
            }
          },
          "400": {
            "description": "Malformed or unsupported query parameters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "60 requests per minute per client IP shared across these endpoints; no queue.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "Wait this many seconds before retrying.",
                "schema": {
                  "type": "integer",
                  "example": 60
                }
              }
            }
          },
          "404": {
            "description": "Unknown property ID.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/properties/{unit}/availability": {
      "get": {
        "operationId": "getAvailability",
        "summary": "Read provisional availability, never a reservation.",
        "parameters": [
          {
            "name": "unit",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "a",
                "b",
                "c"
              ]
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "description": "Inclusive first night, no earlier than today in America/Los_Angeles.",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "description": "Exclusive final date. Window is 1\u201362 nights and within the next two years. This is a calendar window, not a permissible stay length.",
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Read provisional availability, never a reservation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AvailabilityResponse"
                }
              }
            }
          },
          "400": {
            "description": "Malformed or unsupported query parameters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "60 requests per minute per client IP shared across these endpoints; no queue.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "Wait this many seconds before retrying.",
                "schema": {
                  "type": "integer",
                  "example": 60
                }
              }
            }
          },
          "404": {
            "description": "Unknown property ID.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Availability unavailable. Never interpret a failure as open dates.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "Wait this many seconds before retrying.",
                "schema": {
                  "type": "integer",
                  "example": 60
                }
              }
            }
          }
        }
      }
    },
    "/openapi.json": {
      "get": {
        "operationId": "getContract",
        "summary": "Read this versioned contract.",
        "responses": {
          "200": {
            "description": "OpenAPI 3.1 contract.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Query parameters are not supported.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "Wait this many seconds before retrying.",
                "schema": {
                  "type": "integer",
                  "example": 60
                }
              }
            }
          }
        }
      }
    },
    "/properties/{unit}/estimate": {
      "get": {
        "operationId": "estimateStay",
        "summary": "Estimate nights, discount and cleaning with current availability and a guest handoff.",
        "parameters": [
          {
            "name": "unit",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "a",
                "b",
                "c"
              ]
            }
          },
          {
            "name": "arrival",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date"
            },
            "description": "Inclusive arrival, today or later in America/Los_Angeles."
          },
          {
            "name": "departure",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date"
            },
            "description": "Exclusive checkout date, within two years and 2\u201329 nights after arrival."
          },
          {
            "name": "guests",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 6
            },
            "description": "Must also fit the selected unit capacity."
          }
        ],
        "responses": {
          "200": {
            "description": "Itemized estimate including unknown/unavailable date states; never a reservation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StayEstimate"
                }
              }
            }
          },
          "400": {
            "description": "Malformed or unsupported query parameters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "60 requests per minute per client IP shared across these endpoints; no queue.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "Wait this many seconds before retrying.",
                "schema": {
                  "type": "integer",
                  "example": 60
                }
              }
            }
          },
          "404": {
            "description": "Unknown property ID.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Current pricing or inventory cannot be evaluated. No booking or price guarantee; honor Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "Wait this many seconds before retrying.",
                "schema": {
                  "type": "integer",
                  "example": 60
                }
              }
            }
          }
        },
        "description": "Non-binding estimate for 2\u201329 nights within two years, constrained to property capacity. Uses existing pricing and inventory readers and writes nothing. C remains inquiry-only. Unknown coverage may be sent for host review; unavailable dates have no handoff. Guest acceptance, identity and payment happen separately after host approval. No personal information or credentials in URLs."
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "apiVersion": {
            "type": "string",
            "const": "2"
          },
          "code": {
            "type": "string",
            "enum": [
              "invalid_query",
              "invalid_window",
              "unknown_property",
              "rate_limited",
              "availability_unavailable",
              "invalid_stay",
              "pricing_unavailable"
            ]
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "apiVersion",
          "code",
          "message"
        ]
      },
      "Rules": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "version": {
            "type": "string"
          },
          "maxGuests": {
            "type": "integer"
          },
          "minNights": {
            "type": "integer"
          },
          "maxNights": {
            "type": "integer"
          },
          "bufferNights": {
            "type": "integer"
          }
        },
        "required": [
          "version",
          "maxGuests",
          "minNights",
          "maxNights",
          "bufferNights"
        ]
      },
      "Policies": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "timeZone": {
            "type": "string",
            "const": "America/Los_Angeles"
          },
          "checkInLocalTime": {
            "type": "string"
          },
          "checkOutLocalTime": {
            "type": "string"
          },
          "petsAllowed": {
            "type": "boolean"
          },
          "smokingAllowed": {
            "type": "boolean"
          },
          "version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "bookingTerms": {
            "anyOf": [
              {
                "type": "string",
                "description": "Versioned general information, not contractual offer terms or runtime booking authority. The accepted host offer controls the reservation."
              },
              {
                "type": "null"
              }
            ]
          },
          "information": {
            "$ref": "#/components/schemas/PolicyInformation"
          }
        },
        "required": [
          "timeZone",
          "checkInLocalTime",
          "checkOutLocalTime",
          "petsAllowed",
          "smokingAllowed",
          "version",
          "bookingTerms",
          "information"
        ]
      },
      "Photo": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "description": {
            "type": "string"
          }
        },
        "required": [
          "url",
          "description"
        ]
      },
      "Property": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "id": {
            "type": "string",
            "enum": [
              "a",
              "b",
              "c"
            ]
          },
          "name": {
            "type": "string"
          },
          "headline": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "location": {
            "type": "string"
          },
          "maxGuests": {
            "type": "integer"
          },
          "sleeping": {
            "type": "string"
          },
          "accessNote": {
            "type": "string"
          },
          "amenities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "photos": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Photo"
            }
          },
          "publicUrl": {
            "type": "string",
            "format": "uri"
          },
          "inquiryUrl": {
            "type": "string",
            "format": "uri"
          },
          "availabilityUrl": {
            "type": "string",
            "format": "uri"
          },
          "inquiryOnly": {
            "type": "boolean"
          },
          "requiresHostReview": {
            "type": "boolean",
            "const": true
          },
          "approvedRules": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Rules"
              },
              {
                "type": "null"
              }
            ]
          },
          "policies": {
            "$ref": "#/components/schemas/Policies"
          },
          "estimateUrl": {
            "type": "string",
            "format": "uri",
            "description": "GET with exactly arrival, departure and guests query parameters. Non-binding estimate, not an offer."
          },
          "facts": {
            "$ref": "#/components/schemas/PropertyFacts"
          }
        },
        "required": [
          "id",
          "name",
          "headline",
          "description",
          "location",
          "maxGuests",
          "sleeping",
          "accessNote",
          "amenities",
          "photos",
          "publicUrl",
          "inquiryUrl",
          "availabilityUrl",
          "inquiryOnly",
          "requiresHostReview",
          "approvedRules",
          "policies",
          "estimateUrl",
          "facts"
        ]
      },
      "Catalog": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "apiVersion": {
            "type": "string",
            "const": "2"
          },
          "readOnly": {
            "type": "boolean",
            "const": true
          },
          "bookingSupported": {
            "type": "boolean",
            "const": false
          },
          "contractUrl": {
            "type": "string",
            "format": "uri"
          },
          "contactEmail": {
            "type": "string",
            "format": "email"
          },
          "properties": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Property"
            }
          },
          "workflow": {
            "$ref": "#/components/schemas/Workflow"
          }
        },
        "required": [
          "apiVersion",
          "readOnly",
          "bookingSupported",
          "contractUrl",
          "contactEmail",
          "properties",
          "workflow"
        ]
      },
      "PropertyResponse": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "apiVersion": {
            "type": "string",
            "const": "2"
          },
          "readOnly": {
            "type": "boolean",
            "const": true
          },
          "bookingSupported": {
            "type": "boolean",
            "const": false
          },
          "property": {
            "$ref": "#/components/schemas/Property"
          }
        },
        "required": [
          "apiVersion",
          "readOnly",
          "bookingSupported",
          "property"
        ]
      },
      "Day": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "date": {
            "type": "string",
            "format": "date"
          },
          "state": {
            "type": "string",
            "enum": [
              "unavailable",
              "available_to_request",
              "unknown"
            ],
            "description": "Legacy state: available_to_request requires substantiated date coverage and remains provisional. unknown never means open, even when evidence is no_known_conflicts."
          },
          "evidence": {
            "type": "string",
            "enum": [
              "known_conflict",
              "no_known_conflicts",
              "not_checked"
            ],
            "description": "Known conflict takes precedence. no_known_conflicts requires fresh source data and complete local inventory; it does not establish source date coverage or guarantee availability. not_checked means incomplete/stale/missing evidence. Treat absent evidence as not_checked."
          },
          "nextAction": {
            "type": "string",
            "enum": [
              "choose_other_dates",
              "request_host_review",
              "retry_or_contact_host"
            ],
            "description": "Known conflict: choose_other_dates. Fresh complete check with no known conflict: request_host_review. Incomplete or stale check: retry_or_contact_host. No action authorizes a reservation."
          }
        },
        "required": [
          "date",
          "state",
          "evidence",
          "nextAction"
        ]
      },
      "Calendar": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "unit": {
            "type": "string",
            "enum": [
              "a",
              "b",
              "c"
            ]
          },
          "start": {
            "type": "string",
            "format": "date"
          },
          "end": {
            "type": "string",
            "format": "date"
          },
          "days": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Day"
            }
          },
          "dataStatus": {
            "type": "string",
            "enum": [
              "current",
              "partial"
            ]
          },
          "lastUpdatedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "coverageStart": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Inclusive start of substantiated source date coverage only, or null. Freshness/no_known_conflicts does not establish a coverage horizon."
          },
          "coverageEnd": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Exclusive end of substantiated source date coverage only, or null. Never infer this from the requested window."
          },
          "requiresHostReview": {
            "type": "boolean",
            "const": true
          },
          "inquiryOnly": {
            "type": "boolean"
          },
          "evidence": {
            "type": "string",
            "enum": [
              "known_conflict",
              "no_known_conflicts",
              "not_checked"
            ],
            "description": "Known conflict takes precedence. no_known_conflicts requires fresh source data and complete local inventory; it does not establish source date coverage or guarantee availability. not_checked means incomplete/stale/missing evidence. Treat absent evidence as not_checked."
          },
          "nextAction": {
            "type": "string",
            "enum": [
              "choose_other_dates",
              "request_host_review",
              "retry_or_contact_host"
            ],
            "description": "Known conflict: choose_other_dates. Fresh complete check with no known conflict: request_host_review. Incomplete or stale check: retry_or_contact_host. No action authorizes a reservation."
          }
        },
        "required": [
          "unit",
          "start",
          "end",
          "days",
          "dataStatus",
          "lastUpdatedAt",
          "coverageStart",
          "coverageEnd",
          "requiresHostReview",
          "inquiryOnly",
          "evidence",
          "nextAction"
        ]
      },
      "AvailabilityResponse": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "apiVersion": {
            "type": "string",
            "const": "2"
          },
          "readOnly": {
            "type": "boolean",
            "const": true
          },
          "bookingSupported": {
            "type": "boolean",
            "const": false
          },
          "provisional": {
            "type": "boolean",
            "const": true
          },
          "timeZone": {
            "type": "string",
            "const": "America/Los_Angeles"
          },
          "calendar": {
            "$ref": "#/components/schemas/Calendar"
          }
        },
        "required": [
          "apiVersion",
          "readOnly",
          "bookingSupported",
          "provisional",
          "timeZone",
          "calendar"
        ]
      },
      "Workflow": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "mode": {
            "type": "string",
            "const": "host_approved_request_to_book"
          },
          "guideUrl": {
            "type": "string",
            "format": "uri"
          },
          "guestHandoffSupported": {
            "type": "boolean",
            "const": true
          },
          "delegatedRequestsEnabled": {
            "type": "boolean"
          },
          "delegatedContractUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "firstTimeGuestDelegationSupported": {
            "type": "boolean",
            "description": "True only while delegated requests, first-time guest permission and configured verification email are enabled. The guest must verify their email in the same browser and explicitly approve the exact stay. This is not agent-issued authority or booking execution."
          },
          "firstTimeGuestDelegationUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri",
            "description": "Canonical hosted human permission page, or null when unavailable. Append exactly unit, arrival, departure and guests for the proposed stay. No name, email, verification code or delegation key belongs in this URL. The guest enters contact details, verifies email and explicitly approves the exact stay before privately sharing a scoped credential. An agent must never submit those human approval steps."
          },
          "readOnlyStatusAccessSupported": {
            "type": "boolean",
            "description": "Whether a signed-in guest can separately allow, renew or revoke 30-day read-only status access for an existing inquiry or its reservation, including requests originally submitted by the guest. Submission remains limited to its original 24-hour permission. Renewal preserves the same request and replaces only the status key."
          },
          "statusPermissionUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri",
            "description": "Canonical human Guest Messages sign-in page, or null while unavailable. The guest selects the existing stay and approves/renews status permission themselves. No credential or request ID belongs in this URL."
          },
          "agentPaymentSupported": {
            "type": "boolean",
            "const": false
          },
          "leadGuestIdentityRequired": {
            "type": "boolean",
            "const": true
          },
          "hostApprovalRequired": {
            "type": "boolean",
            "const": true
          }
        },
        "required": [
          "mode",
          "guideUrl",
          "guestHandoffSupported",
          "delegatedRequestsEnabled",
          "delegatedContractUrl",
          "firstTimeGuestDelegationSupported",
          "firstTimeGuestDelegationUrl",
          "agentPaymentSupported",
          "leadGuestIdentityRequired",
          "hostApprovalRequired"
        ],
        "description": "Current capabilities. Returning guests can delegate from an authenticated confirmed reservation while delegated requests are enabled. First-time guests can use the separately gated hosted email-verification and exact-stay permission flow when firstTimeGuestDelegationSupported is true. No guest credential is exposed by discovery. Public readOnly/bookingSupported fields describe these GET operations, not the separate request pilot."
      },
      "EstimateNight": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "date": {
            "type": "string",
            "format": "date"
          },
          "amount": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Integer US cents."
          }
        },
        "required": [
          "date",
          "amount"
        ],
        "description": "One occupied night after any weekly discount; checkout day is excluded."
      },
      "EstimateFee": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "label": {
            "type": "string"
          },
          "amount": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Integer US cents."
          }
        },
        "required": [
          "label",
          "amount"
        ]
      },
      "EstimatePrice": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "currency": {
            "type": "string",
            "const": "USD"
          },
          "pricingVersion": {
            "type": "string"
          },
          "nights": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EstimateNight"
            }
          },
          "nightlySubtotalBeforeDiscountCents": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Integer US cents."
          },
          "weeklyDiscountCents": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Integer US cents."
          },
          "nightlySubtotalCents": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Integer US cents."
          },
          "fees": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EstimateFee"
            }
          },
          "totalCents": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Integer US cents."
          }
        },
        "required": [
          "currency",
          "pricingVersion",
          "nights",
          "nightlySubtotalBeforeDiscountCents",
          "weeklyDiscountCents",
          "nightlySubtotalCents",
          "fees",
          "totalCents"
        ],
        "description": "Uses the same rate calculation as host offers. Total is discounted accommodation plus cleaning and listed fees. Host-approved offer terms supersede this estimate."
      },
      "StayEstimate": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "apiVersion": {
            "type": "string",
            "const": "2"
          },
          "readOnly": {
            "type": "boolean",
            "const": true
          },
          "bookingSupported": {
            "type": "boolean",
            "const": false
          },
          "bindingOffer": {
            "type": "boolean",
            "const": false
          },
          "hostReviewRequired": {
            "type": "boolean",
            "const": true
          },
          "inquiryOnly": {
            "type": "boolean"
          },
          "unit": {
            "type": "string",
            "enum": [
              "a",
              "b",
              "c"
            ]
          },
          "arrival": {
            "type": "string",
            "format": "date"
          },
          "departure": {
            "type": "string",
            "format": "date"
          },
          "guests": {
            "type": "integer",
            "minimum": 1,
            "maximum": 6
          },
          "timeZone": {
            "type": "string",
            "const": "America/Los_Angeles"
          },
          "calculatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "refreshAfter": {
            "type": "string",
            "format": "date-time",
            "description": "Re-fetch after this time. Not a price lock, inventory hold or offer expiry."
          },
          "price": {
            "$ref": "#/components/schemas/EstimatePrice"
          },
          "policies": {
            "$ref": "#/components/schemas/Policies"
          },
          "calendar": {
            "$ref": "#/components/schemas/Calendar"
          },
          "availabilityState": {
            "type": "string",
            "enum": [
              "unavailable",
              "unknown",
              "available_to_request"
            ],
            "description": "Legacy state derived from the calendar. unknown stays unknown even with no_known_conflicts evidence. A price calculation never proves availability."
          },
          "nextStep": {
            "type": "string",
            "enum": [
              "choose_other_dates",
              "request_host_review",
              "retry_or_contact_host"
            ],
            "description": "Known conflict: choose_other_dates. Fresh complete check with no known conflict: request_host_review. Incomplete or stale check: retry_or_contact_host. No action authorizes a reservation."
          },
          "guestHandoffUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri",
            "description": "Canonical prefilled inquiry URL for guest review/contact, with only unit/dates/count. Null for known unavailable dates. May be present for unknown/not_checked dates only to contact the host; not proof of availability. GET creates no records."
          },
          "availabilityEvidence": {
            "type": "string",
            "enum": [
              "known_conflict",
              "no_known_conflicts",
              "not_checked"
            ],
            "description": "Known conflict takes precedence. no_known_conflicts requires fresh source data and complete local inventory; it does not establish source date coverage or guarantee availability. not_checked means incomplete/stale/missing evidence. Treat absent evidence as not_checked."
          }
        },
        "required": [
          "apiVersion",
          "readOnly",
          "bookingSupported",
          "bindingOffer",
          "hostReviewRequired",
          "inquiryOnly",
          "unit",
          "arrival",
          "departure",
          "guests",
          "timeZone",
          "calculatedAt",
          "refreshAfter",
          "price",
          "policies",
          "calendar",
          "availabilityState",
          "nextStep",
          "guestHandoffUrl",
          "availabilityEvidence"
        ]
      },
      "PolicyInformation": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "version": {
            "type": "string"
          },
          "scope": {
            "type": "string",
            "enum": [
              "general_booking_information",
              "inquiry_only_information"
            ]
          },
          "informationalRules": {
            "$ref": "#/components/schemas/Rules"
          },
          "cancellation": {
            "$ref": "#/components/schemas/CancellationInformation"
          },
          "payment": {
            "$ref": "#/components/schemas/PaymentInformation"
          },
          "damagePolicy": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "termsAuthority": {
            "type": "string"
          },
          "responsibilities": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "version",
          "scope",
          "informationalRules",
          "cancellation",
          "payment",
          "damagePolicy",
          "termsAuthority",
          "responsibilities"
        ],
        "description": "General owner-approved guidance. Informational rules never substitute for configured approvedRules or a frozen accepted offer. Unit C has no online checkout or established contracting/payment/access authority."
      },
      "CancellationInformation": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "fullRefundDaysBeforeArrival": {
            "type": "integer",
            "enum": [
              14,
              30
            ]
          },
          "fullRefundPercent": {
            "type": "integer",
            "const": 100
          },
          "partialRefundDaysBeforeArrival": {
            "type": "integer",
            "const": 7
          },
          "partialRefundPercent": {
            "type": "integer",
            "const": 50
          },
          "laterRefundPercent": {
            "type": "integer",
            "const": 0
          },
          "deadlineLocalTime": {
            "type": "string",
            "const": "16:00"
          },
          "timeZone": {
            "type": "string",
            "const": "America/Los_Angeles"
          },
          "includesAccommodation": {
            "type": "boolean",
            "const": true
          },
          "includesCleaningFee": {
            "type": "boolean",
            "const": true
          },
          "confirmationGraceHours": {
            "type": "integer",
            "const": 24
          },
          "graceMinimumDaysBeforeCheckIn": {
            "type": "integer",
            "const": 7
          },
          "summary": {
            "type": "string"
          }
        },
        "required": [
          "fullRefundDaysBeforeArrival",
          "fullRefundPercent",
          "partialRefundDaysBeforeArrival",
          "partialRefundPercent",
          "laterRefundPercent",
          "deadlineLocalTime",
          "timeZone",
          "includesAccommodation",
          "includesCleaningFee",
          "confirmationGraceHours",
          "graceMinimumDaysBeforeCheckIn",
          "summary"
        ],
        "description": "Calendar-day thresholds measured at property-local 4 pm, including DST. A/C full refund at 14 days; B at 30 days. The separate eligible confirmation grace period is included."
      },
      "PaymentInformation": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "mode": {
            "type": "string",
            "enum": [
              "host_approved_offer",
              "inquiry_only"
            ]
          },
          "summary": {
            "type": "string"
          },
          "immediate": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ImmediatePaymentInformation"
              },
              {
                "type": "null"
              }
            ]
          },
          "deferred": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DeferredPaymentInformation"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "mode",
          "summary",
          "immediate",
          "deferred"
        ],
        "description": "Possible host-selected arrangements, not a payment entitlement or current offer. C has null immediate/deferred options."
      },
      "ImmediatePaymentInformation": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "dueWithinHoursAfterHostApproval": {
            "type": "integer",
            "const": 24
          },
          "summary": {
            "type": "string"
          }
        },
        "required": [
          "dueWithinHoursAfterHostApproval",
          "summary"
        ]
      },
      "DeferredPaymentInformation": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "version": {
            "type": "string"
          },
          "requiresHostSelection": {
            "type": "boolean",
            "const": true
          },
          "acceptanceWindowHours": {
            "type": "integer",
            "const": 24
          },
          "dueCalendarDaysBeforeArrival": {
            "type": "integer",
            "const": 35
          },
          "dueLocalTime": {
            "type": "string",
            "const": "16:00"
          },
          "timeZone": {
            "type": "string",
            "const": "America/Los_Angeles"
          },
          "automaticSavedCardCharge": {
            "type": "boolean",
            "const": false
          },
          "summary": {
            "type": "string"
          }
        },
        "required": [
          "version",
          "requiresHostSelection",
          "acceptanceWindowHours",
          "dueCalendarDaysBeforeArrival",
          "dueLocalTime",
          "timeZone",
          "automaticSavedCardCharge",
          "summary"
        ],
        "description": "Host-offered reserve-now/pay-later only. The accepted offer supplies the exact deadline; agreed amendments may change it. No guaranteed eligibility, automatic charge or automatic grace period."
      },
      "PropertyFacts": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "address": {
            "$ref": "#/components/schemas/PropertyAddress"
          },
          "geo": {
            "$ref": "#/components/schemas/PropertyGeoCoordinates"
          },
          "bedrooms": {
            "type": "integer",
            "minimum": 0
          },
          "bathrooms": {
            "type": "integer",
            "minimum": 0
          },
          "beds": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PropertyBed"
            }
          },
          "checkInLocalTime": {
            "type": "string",
            "const": "16:00"
          },
          "checkOutLocalTime": {
            "type": "string",
            "const": "11:00"
          },
          "timeZone": {
            "type": "string",
            "const": "America/Los_Angeles"
          }
        },
        "required": [
          "address",
          "bedrooms",
          "bathrooms",
          "beds",
          "checkInLocalTime",
          "checkOutLocalTime",
          "timeZone"
        ]
      },
      "PropertyGeoCoordinates": {
        "type": "object",
        "additionalProperties": true,
        "description": "Verified WGS84 building location. Units A and B share the Carriage House point, separate from the mansion; Unit C is in Selah. Six decimal places indicate published precision, not survey accuracy.",
        "properties": {
          "latitude": {
            "type": "number",
            "minimum": -90,
            "maximum": 90
          },
          "longitude": {
            "type": "number",
            "minimum": -180,
            "maximum": 180
          }
        },
        "required": [
          "latitude",
          "longitude"
        ]
      },
      "PropertyAddress": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "streetAddress": {
            "type": "string"
          },
          "locality": {
            "type": "string"
          },
          "region": {
            "type": "string"
          },
          "postalCode": {
            "type": "string"
          },
          "country": {
            "type": "string"
          }
        },
        "required": [
          "streetAddress",
          "locality",
          "region",
          "postalCode",
          "country"
        ]
      },
      "PropertyBed": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "type": {
            "type": "string"
          },
          "count": {
            "type": "integer",
            "minimum": 1
          }
        },
        "required": [
          "type",
          "count"
        ]
      }
    }
  },
  "externalDocs": {
    "description": "Agent-assisted booking guide",
    "url": "https://rosedellestate.com/agents"
  }
}