EscapeStays by Luxury Lodging

Added value: +"The smallest positive min_stay value among calendar dates returned for the requested range. It is a hint, not a guarantee that every arrival is allowed. An exact quote checks a specific stay."

Added value: +"On an unavailable result, a calendar minimum when available or the home's general policy baseline otherwise. If an exact stay is too short, get_live_quote returns MIN_STAY_NOT_MET with the applicable threshold in error.details.minimum_nights."

Previous value: -"Dollars the coupon took off the rent; 0 when none applied."New value: +"Dollars a coupon or the monthly stay discount took off the rent; 0 when none applied. nightly_subtotal is the rent after it. A stay of 28 nights or more gets 10% off its rent automatically, and a coupon replaces that only when it takes off more."

Added value: +{
+  "description": "Only when discount is above 0. The discount's name, for example \"Monthly stay discount, 10%\".",
+  "type": "string"
+}

Added value: +"The general minimum from this home's policy source. It is a baseline, not a promise that every date allows a stay this short; date-specific calendar rules can be higher. An exact quote checks the requested dates."

Previous value: -"Lodging tax. It is collected on every stay and included in the total."New value: +"Lodging tax. It is collected on every stay and included in the total; a long-stay rate can be lower, or zero where the law exempts the stay (taxes_note says why)."

Added value: +{
+  "description": "Only a long-stay rate carries this field. It is the line's name, \"Lodging tax (long-stay rate)\".",
+  "type": "string"
+}

Added value: +{
+  "description": "Only a long-stay rate carries this field. It names the taxes the stay is exempt from and any that still apply.",
+  "type": "string"
+}

Added value: +{
+  "description": "Only a long-stay rate carries this field. It is the lodging tax line's name, \"Lodging tax (long-stay rate)\".",
+  "type": "string"
+}

Added value: +{
+  "description": "Only a long-stay rate carries this field. It names the taxes this stay is exempt from and any that still apply.",
+  "type": "string"
+}

Previous value: -"Where the tax comes from: the provider's own quote, or our verified rate table for the home's jurisdiction when the provider's quote had none. Either way the tax is collected and in the total."New value: +"Where the tax comes from: the provider's own quote, our verified rate table for the home's jurisdiction when the provider's quote had none, or a long-stay rule when the stay is long enough to be exempt from some of the place's lodging taxes (lodging_tax_note says which). In every case the tax that applies is collected and in the total."

Previous value: -[
-  "provider",
-  "jurisdiction_table"
-]New value: +[
+  "provider",
+  "jurisdiction_table",
+  "long_stay_rule"
+]

Added value: +{
+  "description": "A coupon code the guest was given. Optional. When it applies, the link's signed total includes it and the link carries the code, so the website prices the stay the same way. A code that does not apply, or that nobody issued, leaves the price unchanged and is reported in coupon with its reason. A code tied to one guest's email is reported as not found. A quote does not reserve a use of a code, and the code is checked again when the guest books, so it may no longer apply then.",
+  "maxLength": 40,
+  "type": "string"
+}

Previous value: -"Where the guest completes the booking on Luxury Lodging's own site. The link a live quote returns for this stay and rate: the same home, dates, party, rate and attribution, with a freshly signed quote token (so its quote_ref differs from the quote's)."New value: +"Where the guest completes the booking on Luxury Lodging's own site. The link a live quote returns for this stay and rate: the same home, dates, party, rate, coupon and attribution, with a freshly signed quote token (so its quote_ref differs from the quote's). It names the coupon only when the coupon applied."

Added value: +{
+  "description": "What happened to the coupon_code that was sent. Only returned when one was sent. The stay's totals already include the coupon when applied is true and are the price without it when applied is false.",
+  "properties": {
+    "amount_off": {
+      "description": "Dollars taken off the stay's rent. Only when applied is true; it is already inside the totals.",
+      "type": "number"
+    },
+    "applied": {
+      "description": "True when the code took money off this stay.",
+      "type": "boolean"
+    },
+    "code": {
+      "description": "The code as sent, in upper case.",
+      "type": "string"
+    },
+    "label": {
+      "description": "What the discount is called. Only when applied is true.",
+      "type": "string"
+    },
+    "message": {
+      "description": "A sentence the guest can read about the code.",
+      "type": "string"
+    },
+    "reason": {
+      "description": "Why the code did not apply. Only when applied is false. unknown: no such code. unavailable: the code could not be checked just now.",
+      "enum": [
+        "unknown",
+        "inactive",
+        "expired",
+        "not_started",
+        "wrong_market",
+        "wrong_home",
+        "requires_attribution",
+        "no_discountable_amount",
+        "outside_offer_window",
+        "blacked_out",
+        "minimum_nights",
+        "already_used",
+        "unavailable"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "applied",
+    "message"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "A coupon code the guest was given. Optional. When it applies, the totals and every rate's total include it, and the discount appears in price_breakdown and as a negative row in quote.charges. A code that does not apply, or that nobody issued, leaves the price unchanged and is reported in coupon with its reason. A code tied to one guest's email is reported as not found. A quote does not reserve a use of a code, and the code is checked again when the guest books, so it may no longer apply then.",
+  "maxLength": 40,
+  "type": "string"
+}

Added value: +"Where the guest completes the booking on Luxury Lodging's own site, for the non-refundable rate. It names the coupon only when the coupon applied."

Added value: +{
+  "description": "What happened to the coupon_code that was sent. Only returned when one was sent. The stay's totals already include the coupon when applied is true and are the price without it when applied is false.",
+  "properties": {
+    "amount_off": {
+      "description": "Dollars taken off the stay's rent. Only when applied is true; it is already inside the totals.",
+      "type": "number"
+    },
+    "applied": {
+      "description": "True when the code took money off this stay.",
+      "type": "boolean"
+    },
+    "code": {
+      "description": "The code as sent, in upper case.",
+      "type": "string"
+    },
+    "label": {
+      "description": "What the discount is called. Only when applied is true.",
+      "type": "string"
+    },
+    "message": {
+      "description": "A sentence the guest can read about the code.",
+      "type": "string"
+    },
+    "reason": {
+      "description": "Why the code did not apply. Only when applied is false. unknown: no such code. unavailable: the code could not be checked just now.",
+      "enum": [
+        "unknown",
+        "inactive",
+        "expired",
+        "not_started",
+        "wrong_market",
+        "wrong_home",
+        "requires_attribution",
+        "no_discountable_amount",
+        "outside_offer_window",
+        "blacked_out",
+        "minimum_nights",
+        "already_used",
+        "unavailable"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "applied",
+    "message"
+  ],
+  "type": "object"
+}

Added value: +"Dollars the coupon took off the rent; 0 when none applied."

Previous value: -"The price of the stay, including cleaning, fees and taxes. Nightly rates exclude them."New value: +"The price of the stay, including cleaning, fees and taxes, and the coupon when one applied. Nightly rates exclude them."

Previous value: -"The 3.5% card processing fee, added at checkout and included in the total."New value: +"The 3.5% card processing fee, added at checkout and included in the total. It is non-refundable when a refundable-rate stay is cancelled."

Previous value: -"Every rate on offer for this stay. The first is the non-refundable rate (the same totals as the top level). When check-in is more than 30 days away a refundable rate follows: 8% more on the nightly subtotal, taxed as rent, cancellable for a full refund of everything paid until free_cancel_until. Each rate has its own booking_url."New value: +"Every rate on offer for this stay. The first is the non-refundable rate (the same totals as the top level). When check-in is more than 30 days away a refundable rate follows: 8% more on the nightly subtotal, taxed as rent, cancellable until free_cancel_until; on a cancellation by then the 3.5% card processing fee is non-refundable and everything else paid is refunded in full. Each rate has its own booking_url."

Previous value: -"Refundable rate only. The last instant, in UTC, the stay can be cancelled for a full refund."New value: +"Refundable rate only. The last instant, in UTC, the stay can be cancelled for a refund of everything paid except the 3.5% card processing fee."

Previous value: -"Number of guests."New value: +"Everyone staying, including children and infants."

Previous value: -"Whether the guest is bringing a pet."New value: +"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. Totals include the pet fee for that many pets."

Added value: +4

Added value: +0

Previous value: -"boolean"New value: +[
+  "integer",
+  "boolean"
+]

Added value: +{
+  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room",
+    "unknown"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
+  "enum": [
+    "private",
+    "shared",
+    "unknown"
+  ],
+  "type": "string"
+}

Previous value: -"Only present when from_price_per_night is null: what is and is not visible about this home's calendar. A null starting rate means neither that the home is booked out nor that it is ready to book."New value: +"Deprecated, no longer returned along with from_price_per_night."

Previous value: -"Starting nightly rate. It excludes cleaning, fees and taxes, so it is not the price of any stay. Only present on a row without stay_total. Null means no starting rate is published for this home, not that it is free; from_price_note says why."New value: +"Deprecated, no longer returned: only a row with a confirmed stay_total carries a price. Kept in this schema so existing clients still validate."

Previous value: -"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."

Previous value: -[
-  "per stay",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per night",
+  "per pet",
+  "per pet per night"
+]

Previous value: -"Number of guests."New value: +"Everyone staying, including children and infants."

Previous value: -"Whether the guest is bringing a pet; this changes the price."New value: +"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. This changes the price: some homes charge per pet or per pet per night."

Added value: +4

Added value: +0

Previous value: -"boolean"New value: +[
+  "integer",
+  "boolean"
+]

Previous value: -"A live total for one stay. When available is false only property_id, available, reason and booking_url are present."New value: +"A live total for one stay. When available is false only property_id, available, reason, booking_url and a short quote block are present."

Added value: +"How many pets this quote is for. pet_fee in price_breakdown is the fee for that many."

Added value: +4

Added value: +0

Previous value: -"boolean"New value: +"integer"

Added value: +{
+  "description": "The authoritative, machine-readable quote for this stay, for the rate stay_total prices (the non-refundable rate). Amounts ending in _minor are integer cents in `currency`. total_stay_price_minor is exactly what the guest is charged in total, including taxes and the card processing fee, and the amounts add up: total_stay_price_minor = nightly_subtotal_minor + mandatory_fees_minor + optional_fees_minor + taxes_minor + card_fee_minor - discounts_minor. When available is false only availability_status, inventory_held, checked_at, canonical_url, incomplete and missing are present. The itemised _minor amounts are null only when missing includes price_breakdown.",
+  "properties": {
+    "availability_status": {
+      "enum": [
+        "available",
+        "unavailable"
+      ],
+      "type": "string"
+    },
+    "cancellation_policy_id": {
+      "description": "The rate this quote prices; rate_options lists both.",
+      "enum": [
+        "non_refundable",
+        "refundable"
+      ],
+      "type": "string"
+    },
+    "cancellation_summary": {
+      "type": "string"
+    },
+    "canonical_url": {
+      "description": "The home's property page, not the booking link.",
+      "type": "string"
+    },
+    "card_fee_minor": {
+      "description": "The 3.5% card processing fee, added at checkout and included in the total.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "charges": {
+      "description": "Every charge, itemised. The amounts of the rows with paid_at checkout add up to total_stay_price_minor exactly; a discount row is negative.",
+      "items": {
+        "properties": {
+          "amount_minor": {
+            "type": "integer"
+          },
+          "name": {
+            "type": "string"
+          },
+          "paid_at": {
+            "description": "checkout: part of the total. outside_checkout: not part of it (the security hold).",
+            "enum": [
+              "checkout",
+              "outside_checkout"
+            ],
+            "type": "string"
+          },
+          "type": {
+            "enum": [
+              "nightly",
+              "fee",
+              "tax",
+              "discount",
+              "card_fee",
+              "security_hold",
+              "adjustment"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "name",
+          "amount_minor",
+          "paid_at"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "checked_at": {
+      "description": "When this quote was fetched, ISO 8601.",
+      "type": "string"
+    },
+    "currency": {
+      "description": "ISO 4217 code, e.g. USD.",
+      "type": "string"
+    },
+    "discounts_minor": {
+      "description": "A positive amount subtracted from the total; 0 when there is none.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "due_later_minor": {
+      "description": "The rest, charged automatically to the same card 60 days before check-in; 0 when everything is due now.",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "due_now_minor": {
+      "description": "Charged when the guest books: 50% of the total when check-in is more than 60 days away, otherwise all of it.",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "expires_at": {
+      "description": "When the quote lapses, ISO 8601; the same instant as quote_expires_at.",
+      "type": "string"
+    },
+    "incomplete": {
+      "description": "True when a required input or tax could not be determined; missing says which.",
+      "type": "boolean"
+    },
+    "inventory_held": {
+      "description": "False: a quote does not hold the home.",
+      "type": "boolean"
+    },
+    "mandatory_fees_minor": {
+      "description": "Cleaning and every other required fee.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "missing": {
+      "description": "rent_tax_rate: the provider's fee table could not be read, so the refundable rate cannot be priced. price_breakdown: the provider sent only a total. line_items_mismatch: the itemised charges add up to more than the total.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "nightly_subtotal_minor": {
+      "description": "Rent for the nights before any discount, plus the refundable-rate premium when that rate is quoted.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "nights": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "optional_fees_minor": {
+      "description": "Fees the guest chose, the pet fee for the pets in this quote.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "quote_id": {
+      "description": "Stable id for this priced stay: the same home, dates, guests, pets, rate and total give the same id; any change gives a new one. Not a hold or a reservation.",
+      "type": "string"
+    },
+    "refundable": {
+      "description": "True when the rate this quote prices can be cancelled for a refund until its free-cancellation deadline; false for the non-refundable rate.",
+      "type": "boolean"
+    },
+    "refundable_security_hold_minor": {
+      "description": "A refundable hold on the card on file, separate from the total. The home's own amount, or the standard hold when it states none.",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "tax_source": {
+      "description": "Where the tax comes from: the provider's own quote, or our verified rate table for the home's jurisdiction when the provider's quote had none. Either way the tax is collected and in the total.",
+      "enum": [
+        "provider",
+        "jurisdiction_table"
+      ],
+      "type": "string"
+    },
+    "taxes_included": {
+      "description": "True: the total includes lodging tax, which is collected on every stay.",
+      "type": "boolean"
+    },
+    "taxes_minor": {
+      "description": "Lodging tax.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "timezone": {
+      "description": "IANA zone of the home: the provider's own zone when it states one, otherwise the zone of the home's US state (timezone_source says which). Null when unknown.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "timezone_source": {
+      "enum": [
+        "listing",
+        "market",
+        "unknown"
+      ],
+      "type": "string"
+    },
+    "total_stay_price_minor": {
+      "description": "The whole price of the stay, equal to stay_total in cents.",
+      "minimum": 0,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "availability_status",
+    "inventory_held",
+    "checked_at",
+    "canonical_url",
+    "incomplete",
+    "missing"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "True when this rate can be cancelled for a refund until free_cancel_until; false when a confirmed reservation cannot be cancelled for a refund.",
+  "type": "boolean"
+}

Previous value: -[
-  "plan",
-  "stay_total",
-  "total_due_now",
-  "cancellation",
-  "booking_url"
-]New value: +[
+  "plan",
+  "refundable",
+  "stay_total",
+  "total_due_now",
+  "cancellation",
+  "booking_url"
+]

Added value: +{
+  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room",
+    "unknown"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
+  "enum": [
+    "private",
+    "shared",
+    "unknown"
+  ],
+  "type": "string"
+}

Previous value: -"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."

Previous value: -"How pet_fee applies. A per-pet-per-night fee multiplies by the nights."New value: +"How pet_fee applies. Per night multiplies by the nights; per pet by the number of pets; per pet per night by both."

Previous value: -[
-  "per stay",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per night",
+  "per pet",
+  "per pet per night"
+]

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "description": "The same stays split into whole homes and rooms, for the city alone and for the area. homes includes unknown_type; a room is not a whole home.",
+  "properties": {
+    "area": {
+      "properties": {
+        "homes": {
+          "description": "Entire homes, plus homes whose type is not recorded (unknown_type).",
+          "type": "integer"
+        },
+        "private_rooms": {
+          "type": "integer"
+        },
+        "shared_rooms": {
+          "type": "integer"
+        },
+        "total": {
+          "type": "integer"
+        },
+        "unknown_type": {
+          "description": "Counted inside homes: nothing on record says whether these are whole homes.",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "total",
+        "homes",
+        "private_rooms",
+        "shared_rooms",
+        "unknown_type"
+      ],
+      "type": "object"
+    },
+    "city": {
+      "properties": {
+        "homes": {
+          "description": "Entire homes, plus homes whose type is not recorded (unknown_type).",
+          "type": "integer"
+        },
+        "private_rooms": {
+          "type": "integer"
+        },
+        "shared_rooms": {
+          "type": "integer"
+        },
+        "total": {
+          "type": "integer"
+        },
+        "unknown_type": {
+          "description": "Counted inside homes: nothing on record says whether these are whole homes.",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "total",
+        "homes",
+        "private_rooms",
+        "shared_rooms",
+        "unknown_type"
+      ],
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "description": "Stays a search for this market returns before dates, including nearby cities (Chicago: 65 miles around the city). At least homes.",
+  "type": "integer"
+}

Added value: +{
+  "description": "The counts as a guest reads them, e.g. \"41 stays in Chicago · 47 in the Chicago area, including 13 private rooms\".",
+  "type": "string"
+}

Added value: +{
+  "description": "What the guest rents. Homes whose type is not recorded are left out and counted in accommodation_type_unknown.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room"
+  ],
+  "type": "string"
+}

Previous value: -"Amenities every returned home has, as recorded by the property manager."New value: +"Amenities every returned home has, as recorded by the property manager. The same hard filter as amenities_required, except a home with no amenity data is left out without being counted."

Added value: +{
+  "description": "Amenities that order homes when the requested sort ties, and appear in match_reasons. Homes lacking them stay in the results.",
+  "items": {
+    "enum": [
+      "pool",
+      "hot_tub",
+      "parking",
+      "wifi",
+      "kitchen",
+      "washer",
+      "pets"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Amenities every returned home has. A home whose amenity data is unavailable fails the filter and is counted in amenities_unknown.",
+  "items": {
+    "enum": [
+      "pool",
+      "hot_tub",
+      "parking",
+      "wifi",
+      "kitchen",
+      "washer",
+      "pets"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Exactly this many bedrooms; 0 is a studio. Cannot be sent together with bedrooms_min.",
+  "maximum": 100,
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "A spending limit. scope total compares amount with each home's stay total including cleaning, fees and taxes, and needs check_in and check_out. scope nightly compares it with each home's starting nightly rate, which excludes cleaning, fees and taxes. amount, currency and scope are all required.",
+  "properties": {
+    "amount": {
+      "description": "The limit, in the stated currency.",
+      "exclusiveMinimum": 0,
+      "maximum": 1000000,
+      "type": "number"
+    },
+    "currency": {
+      "description": "Only USD is supported.",
+      "enum": [
+        "USD"
+      ],
+      "type": "string"
+    },
+    "scope": {
+      "description": "total: the whole stay, with dates. nightly: the starting nightly rate, excluding fees and taxes.",
+      "enum": [
+        "total",
+        "nightly"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "amount",
+    "currency",
+    "scope"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "The next_cursor value of the previous response, valid only with the same other inputs. Returns the page after it.",
+  "type": "string"
+}

Previous value: -"Number of guests, including children."New value: +"Everyone staying, including children and infants."

Added value: +{
+  "description": "Page number, starting at 1, counted in units of page_size. Cannot be sent together with cursor.",
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "Results per page, up to 20. Takes the place of limit when both are sent.",
+  "maximum": 20,
+  "minimum": 1,
+  "type": "integer"
+}

Previous value: -"The guest is bringing a pet. Results are limited to pet-friendly homes, dated totals include the pet fee, and booking links keep the pet selection."New value: +"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. Results are limited to pet-friendly homes, dated totals include the pet fee for that many pets, and booking links keep the number of pets."

Added value: +4

Added value: +0

Previous value: -"boolean"New value: +[
+  "integer",
+  "boolean"
+]

Previous value: -"Free text place, e.g. 'Tampa', 'near Chicago downtown', a neighbourhood or a landmark."New value: +"Free text place, e.g. 'Tampa', a neighbourhood, or a landmark such as 'near McCormick Place, Chicago'. A known Chicago landmark or area (McCormick Place, Navy Pier, Wrigley Field, O'Hare Airport, the South Loop and others) returns homes within radius_miles, nearest first, with a straight-line distance. Text that names no city, state, neighbourhood or landmark is refused with INVALID_INPUT; it is not answered as an empty, complete result."

Added value: +{
+  "description": "How far from a named landmark or area to search, in whole miles, 1 to 25. Homes are included by the distance they state, to the nearest half mile. Defaults to 5 for a landmark and 3 for an area. Ignored for any other place.",
+  "maximum": 25,
+  "minimum": 1,
+  "type": "integer"
+}

Previous value: -"total_price_* needs dates and orders by the stay total; from_price_asc orders by starting nightly rate; sleeps_desc puts the largest homes first."New value: +"total_price_* needs dates and orders by the stay total; from_price_asc orders by a starting rate that is not returned, and with dates by the stay total; sleeps_desc puts the largest homes first."

Added value: +{
+  "description": "Otherwise matching homes left out of an accommodation_type search because no type is recorded for them. They are not confirmed to be another type. 0 when the filter was not sent.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Otherwise matching homes left out of an amenities_required search because no amenity data is available for them. They are not confirmed to lack the amenity. 0 when the filter was not sent.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Only returned when a budget was sent: what it was compared with.",
+  "properties": {
+    "amount": {
+      "type": "number"
+    },
+    "compared_to": {
+      "description": "stay_total includes cleaning, fees and taxes; from_price_per_night is a starting nightly rate that excludes them.",
+      "enum": [
+        "stay_total",
+        "from_price_per_night"
+      ],
+      "type": "string"
+    },
+    "currency": {
+      "type": "string"
+    },
+    "homes_not_checked": {
+      "description": "Matching homes the budget could not be checked against: unpriced for a total budget, no starting rate for a nightly one.",
+      "type": "integer"
+    },
+    "includes_fees_and_taxes": {
+      "type": "boolean"
+    },
+    "note": {
+      "type": "string"
+    },
+    "scope": {
+      "enum": [
+        "total",
+        "nightly"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "scope",
+    "amount",
+    "currency",
+    "compared_to",
+    "includes_fees_and_taxes",
+    "note"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Otherwise matching homes left out of a nightly budget search because no starting nightly rate is on record. 0 when the budget was not sent or was a total budget.",
+  "type": "integer"
+}

Added value: +{
+  "description": "The property_id of up to 30 of the homes counted in budget_unverified; each can be priced for specific dates with a live quote.",
+  "items": {
+    "type": "integer"
+  },
+  "maxItems": 30,
+  "type": "array"
+}

Added value: +{
+  "description": "complete: no matching home is unpriced, and none was left out for an unknown pet policy, accommodation type, amenity data, starting rate or position. partial: at least one is, so the results may omit a home that matches.",
+  "enum": [
+    "complete",
+    "partial"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Only on a landmark or area search: otherwise matching homes left out because no position is recorded for them, so their distance is unknown. They are not confirmed to be outside the radius.",
+  "type": "integer"
+}

Added value: +{
+  "description": "True when more results follow this page in the same ordering, within the priced sample. Homes counted in unpriced_in_time are not part of any page and have no effect on this.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "The value to send as cursor, with every other input unchanged, to get the next page. Null when has_more is false.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "How many results precede this page in the full ordering.",
+  "type": "integer"
+}

Added value: +{
+  "description": "How many results this page asked for.",
+  "type": "integer"
+}

Added value: +{
+  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room",
+    "unknown"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "available: confirmed available for the requested dates when this answer was produced. not_checked: no dates were given, so availability was not checked.",
+  "enum": [
+    "available",
+    "not_checked"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
+  "enum": [
+    "private",
+    "shared",
+    "unknown"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "When the property manager's record of this home last changed, ISO 8601, as the provider states it. Omitted when the provider gives no such time.",
+  "type": "string"
+}

Added value: +{
+  "description": "When this home's availability and price were fetched, ISO 8601. Only present on a row whose stay was priced.",
+  "type": "string"
+}

Added value: +{
+  "description": "Only on a landmark or area search: how far this home is from it, in miles, rounded to the nearest 0.5 (0.5 means under 0.5 mile), as a straight line over the ground, not a driving or walking route.",
+  "type": "number"
+}

Added value: +{
+  "description": "Only with distance_miles: how the distance was measured. straight_line is the direct distance, shorter than any route.",
+  "enum": [
+    "straight_line"
+  ],
+  "type": "string"
+}

Previous value: -"Only present when from_price_per_night is null: what is and is not visible about this home's calendar. A null starting rate means neither that the home is booked out nor that it is ready to book."New value: +"Deprecated, no longer returned along with from_price_per_night."

Previous value: -"Starting nightly rate, used to order results. It excludes cleaning, fees and taxes, so it is not the price of any stay. Only present on a row without stay_total. Null means no starting rate is published for this home, not that it is free or cheap; from_price_note says why."New value: +"Deprecated, no longer returned: only a row with a confirmed stay_total carries a price. Kept in this schema so existing clients still validate."

Added value: +{
+  "description": "Short statements of why this home passed the filters that were sent, e.g. \"2 bedrooms (exact)\" or \"has parking\". On a landmark search the first is the distance, e.g. \"1.5 mi from McCormick Place (straight line)\" or \"under 0.5 mi from McCormick Place (straight line)\". Empty when no filter was sent.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Facts about this home that could not be verified, drawn from: pet policy, amenities, accommodation type.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -[
-  "property_id",
-  "name",
-  "city",
-  "top_amenities",
-  "review_count",
-  "review_sources",
-  "highlights",
-  "booking_url"
-]New value: +[
+  "property_id",
+  "name",
+  "city",
+  "top_amenities",
+  "review_count",
+  "review_sources",
+  "highlights",
+  "booking_url",
+  "match_reasons",
+  "availability_status",
+  "missing_or_unverified"
+]

Added value: +{
+  "description": "The place actually searched and how it was read.",
+  "properties": {
+    "place": {
+      "description": "The place searched; null when no place was given and every home was searched.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "radius_miles": {
+      "description": "How far from its centre or point homes are included; given for a metro, landmark or area.",
+      "type": "number"
+    },
+    "type": {
+      "description": "metro: the metro area around the named city, within radius_miles. state: the whole state. city: homes in the named city. nearby_or_text: homes near the place or whose listing text matches it. landmark: homes within radius_miles of a named landmark, nearest first, by straight-line distance. area: the same, measured from the centre of a named area such as the South Loop.",
+      "enum": [
+        "all_homes",
+        "metro",
+        "state",
+        "city",
+        "nearby_or_text",
+        "landmark",
+        "area"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "place",
+    "type"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "NO_MATCHES: nothing matched and nothing is unknown (unpriced_in_time and pet_policy_unknown are both 0). It is a normal answer, not an error. Any other search is OK, even with no results, and unpriced_in_time and pet_policy_unknown say what is still unknown.",
+  "enum": [
+    "OK",
+    "NO_MATCHES"
+  ],
+  "type": "string"
+}

Previous value: -"Matching homes whose availability was not established for these dates, because their pet policy could not be verified, a quote failed, the request ran out of budget, or it did not reach them. They are unknown, not unavailable. `price_all_matches`, a higher `limit`, or a narrower place establishes more of them."New value: +"Matching homes whose availability was not established for these dates, because their pet policy could not be verified, a quote failed, the request ran out of budget, or it did not reach them. They are unknown, not unavailable. `price_all_matches`, a higher `limit`, or a narrower place establishes more of them. These counts cover the whole search, not one page, and the homes they count are not part of any page. A later page quotes more homes, so the count can fall."

Added value: +{
+  "description": "The property_id of up to 30 of the homes counted in unpriced_in_time; each can be priced individually with a live quote. Homes whose quote failed or timed out come first, then homes the request did not reach. A home listed here is unknown, not unavailable.",
+  "items": {
+    "type": "integer"
+  },
+  "maxItems": 30,
+  "type": "array"
+}

Previous value: -[
-  "matches",
-  "total_matching",
-  "total_matching_groups",
-  "unpriced_in_time",
-  "dates_checked",
-  "availability_note",
-  "properties"
-]New value: +[
+  "matches",
+  "total_matching",
+  "total_matching_groups",
+  "unpriced_in_time",
+  "unpriced_property_ids",
+  "dates_checked",
+  "availability_note",
+  "properties",
+  "completeness",
+  "search_scope",
+  "has_more",
+  "next_cursor"
+]

Previous value: -"Everyone staying, including children and infants."New value: +"Number of guests."

Previous value: -"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. Totals include the pet fee for that many pets."New value: +"Whether the guest is bringing a pet."

Removed value: -4

Removed value: -0

Previous value: -[
-  "integer",
-  "boolean"
-]New value: +"boolean"

Removed value: -{
-  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
-  "enum": [
-    "entire_home",
-    "private_room",
-    "shared_room",
-    "unknown"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
-  "enum": [
-    "private",
-    "shared",
-    "unknown"
-  ],
-  "type": "string"
-}

Previous value: -"Deprecated, no longer returned along with from_price_per_night."New value: +"Only present when from_price_per_night is null: what is and is not visible about this home's calendar. A null starting rate means neither that the home is booked out nor that it is ready to book."

Previous value: -"Deprecated, no longer returned: only a row with a confirmed stay_total carries a price. Kept in this schema so existing clients still validate."New value: +"Starting nightly rate. It excludes cleaning, fees and taxes, so it is not the price of any stay. Only present on a row without stay_total. Null means no starting rate is published for this home, not that it is free; from_price_note says why."

Previous value: -"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."

Previous value: -[
-  "per stay",
-  "per night",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per pet",
+  "per pet per night"
+]

Previous value: -"Everyone staying, including children and infants."New value: +"Number of guests."

Previous value: -"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. This changes the price: some homes charge per pet or per pet per night."New value: +"Whether the guest is bringing a pet; this changes the price."

Removed value: -4

Removed value: -0

Previous value: -[
-  "integer",
-  "boolean"
-]New value: +"boolean"

Previous value: -"A live total for one stay. When available is false only property_id, available, reason, booking_url and a short quote block are present."New value: +"A live total for one stay. When available is false only property_id, available, reason and booking_url are present."

Removed value: -"How many pets this quote is for. pet_fee in price_breakdown is the fee for that many."

Removed value: -4

Removed value: -0

Previous value: -"integer"New value: +"boolean"

Removed value: -{
-  "description": "The authoritative, machine-readable quote for this stay, for the rate stay_total prices (the non-refundable rate). Amounts ending in _minor are integer cents in `currency`. total_stay_price_minor is exactly what the guest is charged in total, including taxes and the card processing fee, and the amounts add up: total_stay_price_minor = nightly_subtotal_minor + mandatory_fees_minor + optional_fees_minor + taxes_minor + card_fee_minor - discounts_minor. When available is false only availability_status, inventory_held, checked_at, canonical_url, incomplete and missing are present. The itemised _minor amounts are null only when missing includes price_breakdown.",
-  "properties": {
-    "availability_status": {
-      "enum": [
-        "available",
-        "unavailable"
-      ],
-      "type": "string"
-    },
-    "cancellation_policy_id": {
-      "description": "The rate this quote prices; rate_options lists both.",
-      "enum": [
-        "non_refundable",
-        "refundable"
-      ],
-      "type": "string"
-    },
-    "cancellation_summary": {
-      "type": "string"
-    },
-    "canonical_url": {
-      "description": "The home's property page, not the booking link.",
-      "type": "string"
-    },
-    "card_fee_minor": {
-      "description": "The 3.5% card processing fee, added at checkout and included in the total.",
-      "minimum": 0,
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "charges": {
-      "description": "Every charge, itemised. The amounts of the rows with paid_at checkout add up to total_stay_price_minor exactly; a discount row is negative.",
-      "items": {
-        "properties": {
-          "amount_minor": {
-            "type": "integer"
-          },
-          "name": {
-            "type": "string"
-          },
-          "paid_at": {
-            "description": "checkout: part of the total. outside_checkout: not part of it (the security hold).",
-            "enum": [
-              "checkout",
-              "outside_checkout"
-            ],
-            "type": "string"
-          },
-          "type": {
-            "enum": [
-              "nightly",
-              "fee",
-              "tax",
-              "discount",
-              "card_fee",
-              "security_hold",
-              "adjustment"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "name",
-          "amount_minor",
-          "paid_at"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "checked_at": {
-      "description": "When this quote was fetched, ISO 8601.",
-      "type": "string"
-    },
-    "currency": {
-      "description": "ISO 4217 code, e.g. USD.",
-      "type": "string"
-    },
-    "discounts_minor": {
-      "description": "A positive amount subtracted from the total; 0 when there is none.",
-      "minimum": 0,
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "due_later_minor": {
-      "description": "The rest, charged automatically to the same card 60 days before check-in; 0 when everything is due now.",
-      "minimum": 0,
-      "type": "integer"
-    },
-    "due_now_minor": {
-      "description": "Charged when the guest books: 50% of the total when check-in is more than 60 days away, otherwise all of it.",
-      "minimum": 0,
-      "type": "integer"
-    },
-    "expires_at": {
-      "description": "When the quote lapses, ISO 8601; the same instant as quote_expires_at.",
-      "type": "string"
-    },
-    "incomplete": {
-      "description": "True when a required input or tax could not be determined; missing says which.",
-      "type": "boolean"
-    },
-    "inventory_held": {
-      "description": "False: a quote does not hold the home.",
-      "type": "boolean"
-    },
-    "mandatory_fees_minor": {
-      "description": "Cleaning and every other required fee.",
-      "minimum": 0,
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "missing": {
-      "description": "rent_tax_rate: the provider's fee table could not be read, so the refundable rate cannot be priced. price_breakdown: the provider sent only a total. line_items_mismatch: the itemised charges add up to more than the total.",
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "nightly_subtotal_minor": {
-      "description": "Rent for the nights before any discount, plus the refundable-rate premium when that rate is quoted.",
-      "minimum": 0,
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "nights": {
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "optional_fees_minor": {
-      "description": "Fees the guest chose, the pet fee for the pets in this quote.",
-      "minimum": 0,
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "quote_id": {
-      "description": "Stable id for this priced stay: the same home, dates, guests, pets, rate and total give the same id; any change gives a new one. Not a hold or a reservation.",
-      "type": "string"
-    },
-    "refundable": {
-      "description": "True when the rate this quote prices can be cancelled for a refund until its free-cancellation deadline; false for the non-refundable rate.",
-      "type": "boolean"
-    },
-    "refundable_security_hold_minor": {
-      "description": "A refundable hold on the card on file, separate from the total. The home's own amount, or the standard hold when it states none.",
-      "minimum": 0,
-      "type": "integer"
-    },
-    "tax_source": {
-      "description": "Where the tax comes from: the provider's own quote, or our verified rate table for the home's jurisdiction when the provider's quote had none. Either way the tax is collected and in the total.",
-      "enum": [
-        "provider",
-        "jurisdiction_table"
-      ],
-      "type": "string"
-    },
-    "taxes_included": {
-      "description": "True: the total includes lodging tax, which is collected on every stay.",
-      "type": "boolean"
-    },
-    "taxes_minor": {
-      "description": "Lodging tax.",
-      "minimum": 0,
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "timezone": {
-      "description": "IANA zone of the home: the provider's own zone when it states one, otherwise the zone of the home's US state (timezone_source says which). Null when unknown.",
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "timezone_source": {
-      "enum": [
-        "listing",
-        "market",
-        "unknown"
-      ],
-      "type": "string"
-    },
-    "total_stay_price_minor": {
-      "description": "The whole price of the stay, equal to stay_total in cents.",
-      "minimum": 0,
-      "type": "integer"
-    }
-  },
-  "required": [
-    "availability_status",
-    "inventory_held",
-    "checked_at",
-    "canonical_url",
-    "incomplete",
-    "missing"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "description": "True when this rate can be cancelled for a refund until free_cancel_until; false when a confirmed reservation cannot be cancelled for a refund.",
-  "type": "boolean"
-}

Previous value: -[
-  "plan",
-  "refundable",
-  "stay_total",
-  "total_due_now",
-  "cancellation",
-  "booking_url"
-]New value: +[
+  "plan",
+  "stay_total",
+  "total_due_now",
+  "cancellation",
+  "booking_url"
+]

Removed value: -{
-  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
-  "enum": [
-    "entire_home",
-    "private_room",
-    "shared_room",
-    "unknown"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
-  "enum": [
-    "private",
-    "shared",
-    "unknown"
-  ],
-  "type": "string"
-}

Previous value: -"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."

Previous value: -"How pet_fee applies. Per night multiplies by the nights; per pet by the number of pets; per pet per night by both."New value: +"How pet_fee applies. A per-pet-per-night fee multiplies by the nights."

Previous value: -[
-  "per stay",
-  "per night",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per pet",
+  "per pet per night"
+]

Removed value: -{
-  "type": "string"
-}

Removed value: -{
-  "description": "The same stays split into whole homes and rooms, for the city alone and for the area. homes includes unknown_type; a room is not a whole home.",
-  "properties": {
-    "area": {
-      "properties": {
-        "homes": {
-          "description": "Entire homes, plus homes whose type is not recorded (unknown_type).",
-          "type": "integer"
-        },
-        "private_rooms": {
-          "type": "integer"
-        },
-        "shared_rooms": {
-          "type": "integer"
-        },
-        "total": {
-          "type": "integer"
-        },
-        "unknown_type": {
-          "description": "Counted inside homes: nothing on record says whether these are whole homes.",
-          "type": "integer"
-        }
-      },
-      "required": [
-        "total",
-        "homes",
-        "private_rooms",
-        "shared_rooms",
-        "unknown_type"
-      ],
-      "type": "object"
-    },
-    "city": {
-      "properties": {
-        "homes": {
-          "description": "Entire homes, plus homes whose type is not recorded (unknown_type).",
-          "type": "integer"
-        },
-        "private_rooms": {
-          "type": "integer"
-        },
-        "shared_rooms": {
-          "type": "integer"
-        },
-        "total": {
-          "type": "integer"
-        },
-        "unknown_type": {
-          "description": "Counted inside homes: nothing on record says whether these are whole homes.",
-          "type": "integer"
-        }
-      },
-      "required": [
-        "total",
-        "homes",
-        "private_rooms",
-        "shared_rooms",
-        "unknown_type"
-      ],
-      "type": "object"
-    }
-  },
-  "type": "object"
-}

Removed value: -{
-  "description": "Stays a search for this market returns before dates, including nearby cities (Chicago: 65 miles around the city). At least homes.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "The counts as a guest reads them, e.g. \"41 stays in Chicago · 47 in the Chicago area, including 13 private rooms\".",
-  "type": "string"
-}

Removed value: -{
-  "description": "What the guest rents. Homes whose type is not recorded are left out and counted in accommodation_type_unknown.",
-  "enum": [
-    "entire_home",
-    "private_room",
-    "shared_room"
-  ],
-  "type": "string"
-}

Previous value: -"Amenities every returned home has, as recorded by the property manager. The same hard filter as amenities_required, except a home with no amenity data is left out without being counted."New value: +"Amenities every returned home has, as recorded by the property manager."

Removed value: -{
-  "description": "Amenities that order homes when the requested sort ties, and appear in match_reasons. Homes lacking them stay in the results.",
-  "items": {
-    "enum": [
-      "pool",
-      "hot_tub",
-      "parking",
-      "wifi",
-      "kitchen",
-      "washer",
-      "pets"
-    ],
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Amenities every returned home has. A home whose amenity data is unavailable fails the filter and is counted in amenities_unknown.",
-  "items": {
-    "enum": [
-      "pool",
-      "hot_tub",
-      "parking",
-      "wifi",
-      "kitchen",
-      "washer",
-      "pets"
-    ],
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Exactly this many bedrooms; 0 is a studio. Cannot be sent together with bedrooms_min.",
-  "maximum": 100,
-  "minimum": 0,
-  "type": "integer"
-}

Removed value: -{
-  "additionalProperties": false,
-  "description": "A spending limit. scope total compares amount with each home's stay total including cleaning, fees and taxes, and needs check_in and check_out. scope nightly compares it with each home's starting nightly rate, which excludes cleaning, fees and taxes. amount, currency and scope are all required.",
-  "properties": {
-    "amount": {
-      "description": "The limit, in the stated currency.",
-      "exclusiveMinimum": 0,
-      "maximum": 1000000,
-      "type": "number"
-    },
-    "currency": {
-      "description": "Only USD is supported.",
-      "enum": [
-        "USD"
-      ],
-      "type": "string"
-    },
-    "scope": {
-      "description": "total: the whole stay, with dates. nightly: the starting nightly rate, excluding fees and taxes.",
-      "enum": [
-        "total",
-        "nightly"
-      ],
-      "type": "string"
-    }
-  },
-  "required": [
-    "amount",
-    "currency",
-    "scope"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "description": "The next_cursor value of the previous response, valid only with the same other inputs. Returns the page after it.",
-  "type": "string"
-}

Previous value: -"Everyone staying, including children and infants."New value: +"Number of guests, including children."

Removed value: -{
-  "description": "Page number, starting at 1, counted in units of page_size. Cannot be sent together with cursor.",
-  "minimum": 1,
-  "type": "integer"
-}

Removed value: -{
-  "description": "Results per page, up to 20. Takes the place of limit when both are sent.",
-  "maximum": 20,
-  "minimum": 1,
-  "type": "integer"
-}

Previous value: -"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. Results are limited to pet-friendly homes, dated totals include the pet fee for that many pets, and booking links keep the number of pets."New value: +"The guest is bringing a pet. Results are limited to pet-friendly homes, dated totals include the pet fee, and booking links keep the pet selection."

Removed value: -4

Removed value: -0

Previous value: -[
-  "integer",
-  "boolean"
-]New value: +"boolean"

Previous value: -"Free text place, e.g. 'Tampa', a neighbourhood, or a landmark such as 'near McCormick Place, Chicago'. A known Chicago landmark or area (McCormick Place, Navy Pier, Wrigley Field, O'Hare Airport, the South Loop and others) returns homes within radius_miles, nearest first, with a straight-line distance. Text that names no city, state, neighbourhood or landmark is refused with INVALID_INPUT; it is not answered as an empty, complete result."New value: +"Free text place, e.g. 'Tampa', 'near Chicago downtown', a neighbourhood or a landmark."

Removed value: -{
-  "description": "How far from a named landmark or area to search, in whole miles, 1 to 25. Homes are included by the distance they state, to the nearest half mile. Defaults to 5 for a landmark and 3 for an area. Ignored for any other place.",
-  "maximum": 25,
-  "minimum": 1,
-  "type": "integer"
-}

Previous value: -"total_price_* needs dates and orders by the stay total; from_price_asc orders by a starting rate that is not returned, and with dates by the stay total; sleeps_desc puts the largest homes first."New value: +"total_price_* needs dates and orders by the stay total; from_price_asc orders by starting nightly rate; sleeps_desc puts the largest homes first."

Removed value: -{
-  "description": "Otherwise matching homes left out of an accommodation_type search because no type is recorded for them. They are not confirmed to be another type. 0 when the filter was not sent.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "Otherwise matching homes left out of an amenities_required search because no amenity data is available for them. They are not confirmed to lack the amenity. 0 when the filter was not sent.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "Only returned when a budget was sent: what it was compared with.",
-  "properties": {
-    "amount": {
-      "type": "number"
-    },
-    "compared_to": {
-      "description": "stay_total includes cleaning, fees and taxes; from_price_per_night is a starting nightly rate that excludes them.",
-      "enum": [
-        "stay_total",
-        "from_price_per_night"
-      ],
-      "type": "string"
-    },
-    "currency": {
-      "type": "string"
-    },
-    "homes_not_checked": {
-      "description": "Matching homes the budget could not be checked against: unpriced for a total budget, no starting rate for a nightly one.",
-      "type": "integer"
-    },
-    "includes_fees_and_taxes": {
-      "type": "boolean"
-    },
-    "note": {
-      "type": "string"
-    },
-    "scope": {
-      "enum": [
-        "total",
-        "nightly"
-      ],
-      "type": "string"
-    }
-  },
-  "required": [
-    "scope",
-    "amount",
-    "currency",
-    "compared_to",
-    "includes_fees_and_taxes",
-    "note"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "description": "Otherwise matching homes left out of a nightly budget search because no starting nightly rate is on record. 0 when the budget was not sent or was a total budget.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "The property_id of up to 30 of the homes counted in budget_unverified; each can be priced for specific dates with a live quote.",
-  "items": {
-    "type": "integer"
-  },
-  "maxItems": 30,
-  "type": "array"
-}

Removed value: -{
-  "description": "complete: no matching home is unpriced, and none was left out for an unknown pet policy, accommodation type, amenity data, starting rate or position. partial: at least one is, so the results may omit a home that matches.",
-  "enum": [
-    "complete",
-    "partial"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Only on a landmark or area search: otherwise matching homes left out because no position is recorded for them, so their distance is unknown. They are not confirmed to be outside the radius.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "True when more results follow this page in the same ordering, within the priced sample. Homes counted in unpriced_in_time are not part of any page and have no effect on this.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "The value to send as cursor, with every other input unchanged, to get the next page. Null when has_more is false.",
-  "type": [
-    "string",
-    "null"
-  ]
-}

Removed value: -{
-  "description": "How many results precede this page in the full ordering.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "How many results this page asked for.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
-  "enum": [
-    "entire_home",
-    "private_room",
-    "shared_room",
-    "unknown"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "available: confirmed available for the requested dates when this answer was produced. not_checked: no dates were given, so availability was not checked.",
-  "enum": [
-    "available",
-    "not_checked"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
-  "enum": [
-    "private",
-    "shared",
-    "unknown"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "When the property manager's record of this home last changed, ISO 8601, as the provider states it. Omitted when the provider gives no such time.",
-  "type": "string"
-}

Removed value: -{
-  "description": "When this home's availability and price were fetched, ISO 8601. Only present on a row whose stay was priced.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Only on a landmark or area search: how far this home is from it, in miles, rounded to the nearest 0.5 (0.5 means under 0.5 mile), as a straight line over the ground, not a driving or walking route.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Only with distance_miles: how the distance was measured. straight_line is the direct distance, shorter than any route.",
-  "enum": [
-    "straight_line"
-  ],
-  "type": "string"
-}

Previous value: -"Deprecated, no longer returned along with from_price_per_night."New value: +"Only present when from_price_per_night is null: what is and is not visible about this home's calendar. A null starting rate means neither that the home is booked out nor that it is ready to book."

Previous value: -"Deprecated, no longer returned: only a row with a confirmed stay_total carries a price. Kept in this schema so existing clients still validate."New value: +"Starting nightly rate, used to order results. It excludes cleaning, fees and taxes, so it is not the price of any stay. Only present on a row without stay_total. Null means no starting rate is published for this home, not that it is free or cheap; from_price_note says why."

Removed value: -{
-  "description": "Short statements of why this home passed the filters that were sent, e.g. \"2 bedrooms (exact)\" or \"has parking\". On a landmark search the first is the distance, e.g. \"1.5 mi from McCormick Place (straight line)\" or \"under 0.5 mi from McCormick Place (straight line)\". Empty when no filter was sent.",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Facts about this home that could not be verified, drawn from: pet policy, amenities, accommodation type.",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Previous value: -[
-  "property_id",
-  "name",
-  "city",
-  "top_amenities",
-  "review_count",
-  "review_sources",
-  "highlights",
-  "booking_url",
-  "match_reasons",
-  "availability_status",
-  "missing_or_unverified"
-]New value: +[
+  "property_id",
+  "name",
+  "city",
+  "top_amenities",
+  "review_count",
+  "review_sources",
+  "highlights",
+  "booking_url"
+]

Removed value: -{
-  "description": "The place actually searched and how it was read.",
-  "properties": {
-    "place": {
-      "description": "The place searched; null when no place was given and every home was searched.",
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "radius_miles": {
-      "description": "How far from its centre or point homes are included; given for a metro, landmark or area.",
-      "type": "number"
-    },
-    "type": {
-      "description": "metro: the metro area around the named city, within radius_miles. state: the whole state. city: homes in the named city. nearby_or_text: homes near the place or whose listing text matches it. landmark: homes within radius_miles of a named landmark, nearest first, by straight-line distance. area: the same, measured from the centre of a named area such as the South Loop.",
-      "enum": [
-        "all_homes",
-        "metro",
-        "state",
-        "city",
-        "nearby_or_text",
-        "landmark",
-        "area"
-      ],
-      "type": "string"
-    }
-  },
-  "required": [
-    "place",
-    "type"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "description": "NO_MATCHES: nothing matched and nothing is unknown (unpriced_in_time and pet_policy_unknown are both 0). It is a normal answer, not an error. Any other search is OK, even with no results, and unpriced_in_time and pet_policy_unknown say what is still unknown.",
-  "enum": [
-    "OK",
-    "NO_MATCHES"
-  ],
-  "type": "string"
-}

Previous value: -"Matching homes whose availability was not established for these dates, because their pet policy could not be verified, a quote failed, the request ran out of budget, or it did not reach them. They are unknown, not unavailable. `price_all_matches`, a higher `limit`, or a narrower place establishes more of them. These counts cover the whole search, not one page, and the homes they count are not part of any page. A later page quotes more homes, so the count can fall."New value: +"Matching homes whose availability was not established for these dates, because their pet policy could not be verified, a quote failed, the request ran out of budget, or it did not reach them. They are unknown, not unavailable. `price_all_matches`, a higher `limit`, or a narrower place establishes more of them."

Removed value: -{
-  "description": "The property_id of up to 30 of the homes counted in unpriced_in_time; each can be priced individually with a live quote. Homes whose quote failed or timed out come first, then homes the request did not reach. A home listed here is unknown, not unavailable.",
-  "items": {
-    "type": "integer"
-  },
-  "maxItems": 30,
-  "type": "array"
-}

Previous value: -[
-  "matches",
-  "total_matching",
-  "total_matching_groups",
-  "unpriced_in_time",
-  "unpriced_property_ids",
-  "dates_checked",
-  "availability_note",
-  "properties",
-  "completeness",
-  "search_scope",
-  "has_more",
-  "next_cursor"
-]New value: +[
+  "matches",
+  "total_matching",
+  "total_matching_groups",
+  "unpriced_in_time",
+  "dates_checked",
+  "availability_note",
+  "properties"
+]

Previous value: -"Number of guests."New value: +"Everyone staying, including children and infants."

Previous value: -"Whether the guest is bringing a pet."New value: +"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. Totals include the pet fee for that many pets."

Added value: +4

Added value: +0

Previous value: -"boolean"New value: +[
+  "integer",
+  "boolean"
+]

Added value: +{
+  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room",
+    "unknown"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
+  "enum": [
+    "private",
+    "shared",
+    "unknown"
+  ],
+  "type": "string"
+}

Previous value: -"Only present when from_price_per_night is null: what is and is not visible about this home's calendar. A null starting rate means neither that the home is booked out nor that it is ready to book."New value: +"Deprecated, no longer returned along with from_price_per_night."

Previous value: -"Starting nightly rate. It excludes cleaning, fees and taxes, so it is not the price of any stay. Only present on a row without stay_total. Null means no starting rate is published for this home, not that it is free; from_price_note says why."New value: +"Deprecated, no longer returned: only a row with a confirmed stay_total carries a price. Kept in this schema so existing clients still validate."

Previous value: -"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."

Previous value: -[
-  "per stay",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per night",
+  "per pet",
+  "per pet per night"
+]

Previous value: -"Number of guests."New value: +"Everyone staying, including children and infants."

Previous value: -"Whether the guest is bringing a pet; this changes the price."New value: +"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. This changes the price: some homes charge per pet or per pet per night."

Added value: +4

Added value: +0

Previous value: -"boolean"New value: +[
+  "integer",
+  "boolean"
+]

Previous value: -"A live total for one stay. When available is false only property_id, available, reason and booking_url are present."New value: +"A live total for one stay. When available is false only property_id, available, reason, booking_url and a short quote block are present."

Added value: +"How many pets this quote is for. pet_fee in price_breakdown is the fee for that many."

Added value: +4

Added value: +0

Previous value: -"boolean"New value: +"integer"

Added value: +{
+  "description": "The authoritative, machine-readable quote for this stay, for the rate stay_total prices (the non-refundable rate). Amounts ending in _minor are integer cents in `currency`. total_stay_price_minor is exactly what the guest is charged in total, including taxes and the card processing fee, and the amounts add up: total_stay_price_minor = nightly_subtotal_minor + mandatory_fees_minor + optional_fees_minor + taxes_minor + card_fee_minor - discounts_minor. When available is false only availability_status, inventory_held, checked_at, canonical_url, incomplete and missing are present. The itemised _minor amounts are null only when missing includes price_breakdown.",
+  "properties": {
+    "availability_status": {
+      "enum": [
+        "available",
+        "unavailable"
+      ],
+      "type": "string"
+    },
+    "cancellation_policy_id": {
+      "description": "The rate this quote prices; rate_options lists both.",
+      "enum": [
+        "non_refundable",
+        "refundable"
+      ],
+      "type": "string"
+    },
+    "cancellation_summary": {
+      "type": "string"
+    },
+    "canonical_url": {
+      "description": "The home's property page, not the booking link.",
+      "type": "string"
+    },
+    "card_fee_minor": {
+      "description": "The 3.5% card processing fee, added at checkout and included in the total.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "charges": {
+      "description": "Every charge, itemised. The amounts of the rows with paid_at checkout add up to total_stay_price_minor exactly; a discount row is negative.",
+      "items": {
+        "properties": {
+          "amount_minor": {
+            "type": "integer"
+          },
+          "name": {
+            "type": "string"
+          },
+          "paid_at": {
+            "description": "checkout: part of the total. outside_checkout: not part of it (the security hold).",
+            "enum": [
+              "checkout",
+              "outside_checkout"
+            ],
+            "type": "string"
+          },
+          "type": {
+            "enum": [
+              "nightly",
+              "fee",
+              "tax",
+              "discount",
+              "card_fee",
+              "security_hold",
+              "adjustment"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "name",
+          "amount_minor",
+          "paid_at"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "checked_at": {
+      "description": "When this quote was fetched, ISO 8601.",
+      "type": "string"
+    },
+    "currency": {
+      "description": "ISO 4217 code, e.g. USD.",
+      "type": "string"
+    },
+    "discounts_minor": {
+      "description": "A positive amount subtracted from the total; 0 when there is none.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "due_later_minor": {
+      "description": "The rest, charged automatically to the same card 60 days before check-in; 0 when everything is due now.",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "due_now_minor": {
+      "description": "Charged when the guest books: 50% of the total when check-in is more than 60 days away, otherwise all of it.",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "expires_at": {
+      "description": "When the quote lapses, ISO 8601; the same instant as quote_expires_at.",
+      "type": "string"
+    },
+    "incomplete": {
+      "description": "True when a required input or tax could not be determined; missing says which.",
+      "type": "boolean"
+    },
+    "inventory_held": {
+      "description": "False: a quote does not hold the home.",
+      "type": "boolean"
+    },
+    "mandatory_fees_minor": {
+      "description": "Cleaning and every other required fee.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "missing": {
+      "description": "rent_tax_rate: the provider's fee table could not be read, so the refundable rate cannot be priced. price_breakdown: the provider sent only a total. line_items_mismatch: the itemised charges add up to more than the total.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "nightly_subtotal_minor": {
+      "description": "Rent for the nights before any discount, plus the refundable-rate premium when that rate is quoted.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "nights": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "optional_fees_minor": {
+      "description": "Fees the guest chose, the pet fee for the pets in this quote.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "quote_id": {
+      "description": "Stable id for this priced stay: the same home, dates, guests, pets, rate and total give the same id; any change gives a new one. Not a hold or a reservation.",
+      "type": "string"
+    },
+    "refundable": {
+      "description": "True when the rate this quote prices can be cancelled for a refund until its free-cancellation deadline; false for the non-refundable rate.",
+      "type": "boolean"
+    },
+    "refundable_security_hold_minor": {
+      "description": "A refundable hold on the card on file, separate from the total. The home's own amount, or the standard hold when it states none.",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "tax_source": {
+      "description": "Where the tax comes from: the provider's own quote, or our verified rate table for the home's jurisdiction when the provider's quote had none. Either way the tax is collected and in the total.",
+      "enum": [
+        "provider",
+        "jurisdiction_table"
+      ],
+      "type": "string"
+    },
+    "taxes_included": {
+      "description": "True: the total includes lodging tax, which is collected on every stay.",
+      "type": "boolean"
+    },
+    "taxes_minor": {
+      "description": "Lodging tax.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "timezone": {
+      "description": "IANA zone of the home: the provider's own zone when it states one, otherwise the zone of the home's US state (timezone_source says which). Null when unknown.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "timezone_source": {
+      "enum": [
+        "listing",
+        "market",
+        "unknown"
+      ],
+      "type": "string"
+    },
+    "total_stay_price_minor": {
+      "description": "The whole price of the stay, equal to stay_total in cents.",
+      "minimum": 0,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "availability_status",
+    "inventory_held",
+    "checked_at",
+    "canonical_url",
+    "incomplete",
+    "missing"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "True when this rate can be cancelled for a refund until free_cancel_until; false when a confirmed reservation cannot be cancelled for a refund.",
+  "type": "boolean"
+}

Previous value: -[
-  "plan",
-  "stay_total",
-  "total_due_now",
-  "cancellation",
-  "booking_url"
-]New value: +[
+  "plan",
+  "refundable",
+  "stay_total",
+  "total_due_now",
+  "cancellation",
+  "booking_url"
+]

Added value: +{
+  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room",
+    "unknown"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
+  "enum": [
+    "private",
+    "shared",
+    "unknown"
+  ],
+  "type": "string"
+}

Previous value: -"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."

Previous value: -"How pet_fee applies. A per-pet-per-night fee multiplies by the nights."New value: +"How pet_fee applies. Per night multiplies by the nights; per pet by the number of pets; per pet per night by both."

Previous value: -[
-  "per stay",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per night",
+  "per pet",
+  "per pet per night"
+]

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "description": "The same stays split into whole homes and rooms, for the city alone and for the area. homes includes unknown_type; a room is not a whole home.",
+  "properties": {
+    "area": {
+      "properties": {
+        "homes": {
+          "description": "Entire homes, plus homes whose type is not recorded (unknown_type).",
+          "type": "integer"
+        },
+        "private_rooms": {
+          "type": "integer"
+        },
+        "shared_rooms": {
+          "type": "integer"
+        },
+        "total": {
+          "type": "integer"
+        },
+        "unknown_type": {
+          "description": "Counted inside homes: nothing on record says whether these are whole homes.",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "total",
+        "homes",
+        "private_rooms",
+        "shared_rooms",
+        "unknown_type"
+      ],
+      "type": "object"
+    },
+    "city": {
+      "properties": {
+        "homes": {
+          "description": "Entire homes, plus homes whose type is not recorded (unknown_type).",
+          "type": "integer"
+        },
+        "private_rooms": {
+          "type": "integer"
+        },
+        "shared_rooms": {
+          "type": "integer"
+        },
+        "total": {
+          "type": "integer"
+        },
+        "unknown_type": {
+          "description": "Counted inside homes: nothing on record says whether these are whole homes.",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "total",
+        "homes",
+        "private_rooms",
+        "shared_rooms",
+        "unknown_type"
+      ],
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "description": "Stays a search for this market returns before dates, including nearby cities (Chicago: 65 miles around the city). At least homes.",
+  "type": "integer"
+}

Added value: +{
+  "description": "The counts as a guest reads them, e.g. \"41 stays in Chicago · 47 in the Chicago area, including 13 private rooms\".",
+  "type": "string"
+}

Added value: +{
+  "description": "What the guest rents. Homes whose type is not recorded are left out and counted in accommodation_type_unknown.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room"
+  ],
+  "type": "string"
+}

Previous value: -"Amenities every returned home has, as recorded by the property manager."New value: +"Amenities every returned home has, as recorded by the property manager. The same hard filter as amenities_required, except a home with no amenity data is left out without being counted."

Added value: +{
+  "description": "Amenities that order homes when the requested sort ties, and appear in match_reasons. Homes lacking them stay in the results.",
+  "items": {
+    "enum": [
+      "pool",
+      "hot_tub",
+      "parking",
+      "wifi",
+      "kitchen",
+      "washer",
+      "pets"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Amenities every returned home has. A home whose amenity data is unavailable fails the filter and is counted in amenities_unknown.",
+  "items": {
+    "enum": [
+      "pool",
+      "hot_tub",
+      "parking",
+      "wifi",
+      "kitchen",
+      "washer",
+      "pets"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Exactly this many bedrooms; 0 is a studio. Cannot be sent together with bedrooms_min.",
+  "maximum": 100,
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "A spending limit. scope total compares amount with each home's stay total including cleaning, fees and taxes, and needs check_in and check_out. scope nightly compares it with each home's starting nightly rate, which excludes cleaning, fees and taxes. amount, currency and scope are all required.",
+  "properties": {
+    "amount": {
+      "description": "The limit, in the stated currency.",
+      "exclusiveMinimum": 0,
+      "maximum": 1000000,
+      "type": "number"
+    },
+    "currency": {
+      "description": "Only USD is supported.",
+      "enum": [
+        "USD"
+      ],
+      "type": "string"
+    },
+    "scope": {
+      "description": "total: the whole stay, with dates. nightly: the starting nightly rate, excluding fees and taxes.",
+      "enum": [
+        "total",
+        "nightly"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "amount",
+    "currency",
+    "scope"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "The next_cursor value of the previous response, valid only with the same other inputs. Returns the page after it.",
+  "type": "string"
+}

Previous value: -"Number of guests, including children."New value: +"Everyone staying, including children and infants."

Added value: +{
+  "description": "Page number, starting at 1, counted in units of page_size. Cannot be sent together with cursor.",
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "Results per page, up to 20. Takes the place of limit when both are sent.",
+  "maximum": 20,
+  "minimum": 1,
+  "type": "integer"
+}

Previous value: -"The guest is bringing a pet. Results are limited to pet-friendly homes, dated totals include the pet fee, and booking links keep the pet selection."New value: +"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. Results are limited to pet-friendly homes, dated totals include the pet fee for that many pets, and booking links keep the number of pets."

Added value: +4

Added value: +0

Previous value: -"boolean"New value: +[
+  "integer",
+  "boolean"
+]

Previous value: -"Free text place, e.g. 'Tampa', 'near Chicago downtown', a neighbourhood or a landmark."New value: +"Free text place, e.g. 'Tampa', a neighbourhood, or a landmark such as 'near McCormick Place, Chicago'. A known Chicago landmark or area (McCormick Place, Navy Pier, Wrigley Field, O'Hare Airport, the South Loop and others) returns homes within radius_miles, nearest first, with a straight-line distance. Text that names no city, state, neighbourhood or landmark is refused with INVALID_INPUT; it is not answered as an empty, complete result."

Added value: +{
+  "description": "How far from a named landmark or area to search, in whole miles, 1 to 25. Homes are included by the distance they state, to the nearest half mile. Defaults to 5 for a landmark and 3 for an area. Ignored for any other place.",
+  "maximum": 25,
+  "minimum": 1,
+  "type": "integer"
+}

Previous value: -"total_price_* needs dates and orders by the stay total; from_price_asc orders by starting nightly rate; sleeps_desc puts the largest homes first."New value: +"total_price_* needs dates and orders by the stay total; from_price_asc orders by a starting rate that is not returned, and with dates by the stay total; sleeps_desc puts the largest homes first."

Added value: +{
+  "description": "Otherwise matching homes left out of an accommodation_type search because no type is recorded for them. They are not confirmed to be another type. 0 when the filter was not sent.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Otherwise matching homes left out of an amenities_required search because no amenity data is available for them. They are not confirmed to lack the amenity. 0 when the filter was not sent.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Only returned when a budget was sent: what it was compared with.",
+  "properties": {
+    "amount": {
+      "type": "number"
+    },
+    "compared_to": {
+      "description": "stay_total includes cleaning, fees and taxes; from_price_per_night is a starting nightly rate that excludes them.",
+      "enum": [
+        "stay_total",
+        "from_price_per_night"
+      ],
+      "type": "string"
+    },
+    "currency": {
+      "type": "string"
+    },
+    "homes_not_checked": {
+      "description": "Matching homes the budget could not be checked against: unpriced for a total budget, no starting rate for a nightly one.",
+      "type": "integer"
+    },
+    "includes_fees_and_taxes": {
+      "type": "boolean"
+    },
+    "note": {
+      "type": "string"
+    },
+    "scope": {
+      "enum": [
+        "total",
+        "nightly"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "scope",
+    "amount",
+    "currency",
+    "compared_to",
+    "includes_fees_and_taxes",
+    "note"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Otherwise matching homes left out of a nightly budget search because no starting nightly rate is on record. 0 when the budget was not sent or was a total budget.",
+  "type": "integer"
+}

Added value: +{
+  "description": "The property_id of up to 30 of the homes counted in budget_unverified; each can be priced for specific dates with a live quote.",
+  "items": {
+    "type": "integer"
+  },
+  "maxItems": 30,
+  "type": "array"
+}

Added value: +{
+  "description": "complete: no matching home is unpriced, and none was left out for an unknown pet policy, accommodation type, amenity data, starting rate or position. partial: at least one is, so the results may omit a home that matches.",
+  "enum": [
+    "complete",
+    "partial"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Only on a landmark or area search: otherwise matching homes left out because no position is recorded for them, so their distance is unknown. They are not confirmed to be outside the radius.",
+  "type": "integer"
+}

Added value: +{
+  "description": "True when more results follow this page in the same ordering, within the priced sample. Homes counted in unpriced_in_time are not part of any page and have no effect on this.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "The value to send as cursor, with every other input unchanged, to get the next page. Null when has_more is false.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "How many results precede this page in the full ordering.",
+  "type": "integer"
+}

Added value: +{
+  "description": "How many results this page asked for.",
+  "type": "integer"
+}

Added value: +{
+  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room",
+    "unknown"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "available: confirmed available for the requested dates when this answer was produced. not_checked: no dates were given, so availability was not checked.",
+  "enum": [
+    "available",
+    "not_checked"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
+  "enum": [
+    "private",
+    "shared",
+    "unknown"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "When the property manager's record of this home last changed, ISO 8601, as the provider states it. Omitted when the provider gives no such time.",
+  "type": "string"
+}

Added value: +{
+  "description": "When this home's availability and price were fetched, ISO 8601. Only present on a row whose stay was priced.",
+  "type": "string"
+}

Added value: +{
+  "description": "Only on a landmark or area search: how far this home is from it, in miles, rounded to the nearest 0.5 (0.5 means under 0.5 mile), as a straight line over the ground, not a driving or walking route.",
+  "type": "number"
+}

Added value: +{
+  "description": "Only with distance_miles: how the distance was measured. straight_line is the direct distance, shorter than any route.",
+  "enum": [
+    "straight_line"
+  ],
+  "type": "string"
+}

Previous value: -"Only present when from_price_per_night is null: what is and is not visible about this home's calendar. A null starting rate means neither that the home is booked out nor that it is ready to book."New value: +"Deprecated, no longer returned along with from_price_per_night."

Previous value: -"Starting nightly rate, used to order results. It excludes cleaning, fees and taxes, so it is not the price of any stay. Only present on a row without stay_total. Null means no starting rate is published for this home, not that it is free or cheap; from_price_note says why."New value: +"Deprecated, no longer returned: only a row with a confirmed stay_total carries a price. Kept in this schema so existing clients still validate."

Added value: +{
+  "description": "Short statements of why this home passed the filters that were sent, e.g. \"2 bedrooms (exact)\" or \"has parking\". On a landmark search the first is the distance, e.g. \"1.5 mi from McCormick Place (straight line)\" or \"under 0.5 mi from McCormick Place (straight line)\". Empty when no filter was sent.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Facts about this home that could not be verified, drawn from: pet policy, amenities, accommodation type.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -[
-  "property_id",
-  "name",
-  "city",
-  "top_amenities",
-  "review_count",
-  "review_sources",
-  "highlights",
-  "booking_url"
-]New value: +[
+  "property_id",
+  "name",
+  "city",
+  "top_amenities",
+  "review_count",
+  "review_sources",
+  "highlights",
+  "booking_url",
+  "match_reasons",
+  "availability_status",
+  "missing_or_unverified"
+]

Added value: +{
+  "description": "The place actually searched and how it was read.",
+  "properties": {
+    "place": {
+      "description": "The place searched; null when no place was given and every home was searched.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "radius_miles": {
+      "description": "How far from its centre or point homes are included; given for a metro, landmark or area.",
+      "type": "number"
+    },
+    "type": {
+      "description": "metro: the metro area around the named city, within radius_miles. state: the whole state. city: homes in the named city. nearby_or_text: homes near the place or whose listing text matches it. landmark: homes within radius_miles of a named landmark, nearest first, by straight-line distance. area: the same, measured from the centre of a named area such as the South Loop.",
+      "enum": [
+        "all_homes",
+        "metro",
+        "state",
+        "city",
+        "nearby_or_text",
+        "landmark",
+        "area"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "place",
+    "type"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "NO_MATCHES: nothing matched and nothing is unknown (unpriced_in_time and pet_policy_unknown are both 0). It is a normal answer, not an error. Any other search is OK, even with no results, and unpriced_in_time and pet_policy_unknown say what is still unknown.",
+  "enum": [
+    "OK",
+    "NO_MATCHES"
+  ],
+  "type": "string"
+}

Previous value: -"Matching homes whose availability was not established for these dates, because their pet policy could not be verified, a quote failed, the request ran out of budget, or it did not reach them. They are unknown, not unavailable. `price_all_matches`, a higher `limit`, or a narrower place establishes more of them."New value: +"Matching homes whose availability was not established for these dates, because their pet policy could not be verified, a quote failed, the request ran out of budget, or it did not reach them. They are unknown, not unavailable. `price_all_matches`, a higher `limit`, or a narrower place establishes more of them. These counts cover the whole search, not one page, and the homes they count are not part of any page. A later page quotes more homes, so the count can fall."

Added value: +{
+  "description": "The property_id of up to 30 of the homes counted in unpriced_in_time; each can be priced individually with a live quote. Homes whose quote failed or timed out come first, then homes the request did not reach. A home listed here is unknown, not unavailable.",
+  "items": {
+    "type": "integer"
+  },
+  "maxItems": 30,
+  "type": "array"
+}

Previous value: -[
-  "matches",
-  "total_matching",
-  "total_matching_groups",
-  "unpriced_in_time",
-  "dates_checked",
-  "availability_note",
-  "properties"
-]New value: +[
+  "matches",
+  "total_matching",
+  "total_matching_groups",
+  "unpriced_in_time",
+  "unpriced_property_ids",
+  "dates_checked",
+  "availability_note",
+  "properties",
+  "completeness",
+  "search_scope",
+  "has_more",
+  "next_cursor"
+]

Previous value: -"Everyone staying, including children and infants."New value: +"Number of guests."

Previous value: -"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. Totals include the pet fee for that many pets."New value: +"Whether the guest is bringing a pet."

Removed value: -4

Removed value: -0

Previous value: -[
-  "integer",
-  "boolean"
-]New value: +"boolean"

Removed value: -{
-  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
-  "enum": [
-    "entire_home",
-    "private_room",
-    "shared_room",
-    "unknown"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
-  "enum": [
-    "private",
-    "shared",
-    "unknown"
-  ],
-  "type": "string"
-}

Previous value: -"Deprecated, no longer returned along with from_price_per_night."New value: +"Only present when from_price_per_night is null: what is and is not visible about this home's calendar. A null starting rate means neither that the home is booked out nor that it is ready to book."

Previous value: -"Deprecated, no longer returned: only a row with a confirmed stay_total carries a price. Kept in this schema so existing clients still validate."New value: +"Starting nightly rate. It excludes cleaning, fees and taxes, so it is not the price of any stay. Only present on a row without stay_total. Null means no starting rate is published for this home, not that it is free; from_price_note says why."

Previous value: -"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."

Previous value: -[
-  "per stay",
-  "per night",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per pet",
+  "per pet per night"
+]

Previous value: -"Everyone staying, including children and infants."New value: +"Number of guests."

Previous value: -"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. This changes the price: some homes charge per pet or per pet per night."New value: +"Whether the guest is bringing a pet; this changes the price."

Removed value: -4

Removed value: -0

Previous value: -[
-  "integer",
-  "boolean"
-]New value: +"boolean"

Previous value: -"A live total for one stay. When available is false only property_id, available, reason, booking_url and a short quote block are present."New value: +"A live total for one stay. When available is false only property_id, available, reason and booking_url are present."

Removed value: -"How many pets this quote is for. pet_fee in price_breakdown is the fee for that many."

Removed value: -4

Removed value: -0

Previous value: -"integer"New value: +"boolean"

Removed value: -{
-  "description": "The authoritative, machine-readable quote for this stay, for the rate stay_total prices (the non-refundable rate). Amounts ending in _minor are integer cents in `currency`. total_stay_price_minor is exactly what the guest is charged in total, including taxes and the card processing fee, and the amounts add up: total_stay_price_minor = nightly_subtotal_minor + mandatory_fees_minor + optional_fees_minor + taxes_minor + card_fee_minor - discounts_minor. When available is false only availability_status, inventory_held, checked_at, canonical_url, incomplete and missing are present. The itemised _minor amounts are null only when missing includes price_breakdown.",
-  "properties": {
-    "availability_status": {
-      "enum": [
-        "available",
-        "unavailable"
-      ],
-      "type": "string"
-    },
-    "cancellation_policy_id": {
-      "description": "The rate this quote prices; rate_options lists both.",
-      "enum": [
-        "non_refundable",
-        "refundable"
-      ],
-      "type": "string"
-    },
-    "cancellation_summary": {
-      "type": "string"
-    },
-    "canonical_url": {
-      "description": "The home's property page, not the booking link.",
-      "type": "string"
-    },
-    "card_fee_minor": {
-      "description": "The 3.5% card processing fee, added at checkout and included in the total.",
-      "minimum": 0,
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "charges": {
-      "description": "Every charge, itemised. The amounts of the rows with paid_at checkout add up to total_stay_price_minor exactly; a discount row is negative.",
-      "items": {
-        "properties": {
-          "amount_minor": {
-            "type": "integer"
-          },
-          "name": {
-            "type": "string"
-          },
-          "paid_at": {
-            "description": "checkout: part of the total. outside_checkout: not part of it (the security hold).",
-            "enum": [
-              "checkout",
-              "outside_checkout"
-            ],
-            "type": "string"
-          },
-          "type": {
-            "enum": [
-              "nightly",
-              "fee",
-              "tax",
-              "discount",
-              "card_fee",
-              "security_hold",
-              "adjustment"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "name",
-          "amount_minor",
-          "paid_at"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "checked_at": {
-      "description": "When this quote was fetched, ISO 8601.",
-      "type": "string"
-    },
-    "currency": {
-      "description": "ISO 4217 code, e.g. USD.",
-      "type": "string"
-    },
-    "discounts_minor": {
-      "description": "A positive amount subtracted from the total; 0 when there is none.",
-      "minimum": 0,
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "due_later_minor": {
-      "description": "The rest, charged automatically to the same card 60 days before check-in; 0 when everything is due now.",
-      "minimum": 0,
-      "type": "integer"
-    },
-    "due_now_minor": {
-      "description": "Charged when the guest books: 50% of the total when check-in is more than 60 days away, otherwise all of it.",
-      "minimum": 0,
-      "type": "integer"
-    },
-    "expires_at": {
-      "description": "When the quote lapses, ISO 8601; the same instant as quote_expires_at.",
-      "type": "string"
-    },
-    "incomplete": {
-      "description": "True when a required input or tax could not be determined; missing says which.",
-      "type": "boolean"
-    },
-    "inventory_held": {
-      "description": "False: a quote does not hold the home.",
-      "type": "boolean"
-    },
-    "mandatory_fees_minor": {
-      "description": "Cleaning and every other required fee.",
-      "minimum": 0,
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "missing": {
-      "description": "rent_tax_rate: the provider's fee table could not be read, so the refundable rate cannot be priced. price_breakdown: the provider sent only a total. line_items_mismatch: the itemised charges add up to more than the total.",
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "nightly_subtotal_minor": {
-      "description": "Rent for the nights before any discount, plus the refundable-rate premium when that rate is quoted.",
-      "minimum": 0,
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "nights": {
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "optional_fees_minor": {
-      "description": "Fees the guest chose, the pet fee for the pets in this quote.",
-      "minimum": 0,
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "quote_id": {
-      "description": "Stable id for this priced stay: the same home, dates, guests, pets, rate and total give the same id; any change gives a new one. Not a hold or a reservation.",
-      "type": "string"
-    },
-    "refundable": {
-      "description": "True when the rate this quote prices can be cancelled for a refund until its free-cancellation deadline; false for the non-refundable rate.",
-      "type": "boolean"
-    },
-    "refundable_security_hold_minor": {
-      "description": "A refundable hold on the card on file, separate from the total. The home's own amount, or the standard hold when it states none.",
-      "minimum": 0,
-      "type": "integer"
-    },
-    "tax_source": {
-      "description": "Where the tax comes from: the provider's own quote, or our verified rate table for the home's jurisdiction when the provider's quote had none. Either way the tax is collected and in the total.",
-      "enum": [
-        "provider",
-        "jurisdiction_table"
-      ],
-      "type": "string"
-    },
-    "taxes_included": {
-      "description": "True: the total includes lodging tax, which is collected on every stay.",
-      "type": "boolean"
-    },
-    "taxes_minor": {
-      "description": "Lodging tax.",
-      "minimum": 0,
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "timezone": {
-      "description": "IANA zone of the home: the provider's own zone when it states one, otherwise the zone of the home's US state (timezone_source says which). Null when unknown.",
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "timezone_source": {
-      "enum": [
-        "listing",
-        "market",
-        "unknown"
-      ],
-      "type": "string"
-    },
-    "total_stay_price_minor": {
-      "description": "The whole price of the stay, equal to stay_total in cents.",
-      "minimum": 0,
-      "type": "integer"
-    }
-  },
-  "required": [
-    "availability_status",
-    "inventory_held",
-    "checked_at",
-    "canonical_url",
-    "incomplete",
-    "missing"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "description": "True when this rate can be cancelled for a refund until free_cancel_until; false when a confirmed reservation cannot be cancelled for a refund.",
-  "type": "boolean"
-}

Previous value: -[
-  "plan",
-  "refundable",
-  "stay_total",
-  "total_due_now",
-  "cancellation",
-  "booking_url"
-]New value: +[
+  "plan",
+  "stay_total",
+  "total_due_now",
+  "cancellation",
+  "booking_url"
+]

Removed value: -{
-  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
-  "enum": [
-    "entire_home",
-    "private_room",
-    "shared_room",
-    "unknown"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
-  "enum": [
-    "private",
-    "shared",
-    "unknown"
-  ],
-  "type": "string"
-}

Previous value: -"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."

Previous value: -"How pet_fee applies. Per night multiplies by the nights; per pet by the number of pets; per pet per night by both."New value: +"How pet_fee applies. A per-pet-per-night fee multiplies by the nights."

Previous value: -[
-  "per stay",
-  "per night",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per pet",
+  "per pet per night"
+]

Removed value: -{
-  "type": "string"
-}

Removed value: -{
-  "description": "The same stays split into whole homes and rooms, for the city alone and for the area. homes includes unknown_type; a room is not a whole home.",
-  "properties": {
-    "area": {
-      "properties": {
-        "homes": {
-          "description": "Entire homes, plus homes whose type is not recorded (unknown_type).",
-          "type": "integer"
-        },
-        "private_rooms": {
-          "type": "integer"
-        },
-        "shared_rooms": {
-          "type": "integer"
-        },
-        "total": {
-          "type": "integer"
-        },
-        "unknown_type": {
-          "description": "Counted inside homes: nothing on record says whether these are whole homes.",
-          "type": "integer"
-        }
-      },
-      "required": [
-        "total",
-        "homes",
-        "private_rooms",
-        "shared_rooms",
-        "unknown_type"
-      ],
-      "type": "object"
-    },
-    "city": {
-      "properties": {
-        "homes": {
-          "description": "Entire homes, plus homes whose type is not recorded (unknown_type).",
-          "type": "integer"
-        },
-        "private_rooms": {
-          "type": "integer"
-        },
-        "shared_rooms": {
-          "type": "integer"
-        },
-        "total": {
-          "type": "integer"
-        },
-        "unknown_type": {
-          "description": "Counted inside homes: nothing on record says whether these are whole homes.",
-          "type": "integer"
-        }
-      },
-      "required": [
-        "total",
-        "homes",
-        "private_rooms",
-        "shared_rooms",
-        "unknown_type"
-      ],
-      "type": "object"
-    }
-  },
-  "type": "object"
-}

Removed value: -{
-  "description": "Stays a search for this market returns before dates, including nearby cities (Chicago: 65 miles around the city). At least homes.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "The counts as a guest reads them, e.g. \"41 stays in Chicago · 47 in the Chicago area, including 13 private rooms\".",
-  "type": "string"
-}

Removed value: -{
-  "description": "What the guest rents. Homes whose type is not recorded are left out and counted in accommodation_type_unknown.",
-  "enum": [
-    "entire_home",
-    "private_room",
-    "shared_room"
-  ],
-  "type": "string"
-}

Previous value: -"Amenities every returned home has, as recorded by the property manager. The same hard filter as amenities_required, except a home with no amenity data is left out without being counted."New value: +"Amenities every returned home has, as recorded by the property manager."

Removed value: -{
-  "description": "Amenities that order homes when the requested sort ties, and appear in match_reasons. Homes lacking them stay in the results.",
-  "items": {
-    "enum": [
-      "pool",
-      "hot_tub",
-      "parking",
-      "wifi",
-      "kitchen",
-      "washer",
-      "pets"
-    ],
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Amenities every returned home has. A home whose amenity data is unavailable fails the filter and is counted in amenities_unknown.",
-  "items": {
-    "enum": [
-      "pool",
-      "hot_tub",
-      "parking",
-      "wifi",
-      "kitchen",
-      "washer",
-      "pets"
-    ],
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Exactly this many bedrooms; 0 is a studio. Cannot be sent together with bedrooms_min.",
-  "maximum": 100,
-  "minimum": 0,
-  "type": "integer"
-}

Removed value: -{
-  "additionalProperties": false,
-  "description": "A spending limit. scope total compares amount with each home's stay total including cleaning, fees and taxes, and needs check_in and check_out. scope nightly compares it with each home's starting nightly rate, which excludes cleaning, fees and taxes. amount, currency and scope are all required.",
-  "properties": {
-    "amount": {
-      "description": "The limit, in the stated currency.",
-      "exclusiveMinimum": 0,
-      "maximum": 1000000,
-      "type": "number"
-    },
-    "currency": {
-      "description": "Only USD is supported.",
-      "enum": [
-        "USD"
-      ],
-      "type": "string"
-    },
-    "scope": {
-      "description": "total: the whole stay, with dates. nightly: the starting nightly rate, excluding fees and taxes.",
-      "enum": [
-        "total",
-        "nightly"
-      ],
-      "type": "string"
-    }
-  },
-  "required": [
-    "amount",
-    "currency",
-    "scope"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "description": "The next_cursor value of the previous response, valid only with the same other inputs. Returns the page after it.",
-  "type": "string"
-}

Previous value: -"Everyone staying, including children and infants."New value: +"Number of guests, including children."

Removed value: -{
-  "description": "Page number, starting at 1, counted in units of page_size. Cannot be sent together with cursor.",
-  "minimum": 1,
-  "type": "integer"
-}

Removed value: -{
-  "description": "Results per page, up to 20. Takes the place of limit when both are sent.",
-  "maximum": 20,
-  "minimum": 1,
-  "type": "integer"
-}

Previous value: -"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. Results are limited to pet-friendly homes, dated totals include the pet fee for that many pets, and booking links keep the number of pets."New value: +"The guest is bringing a pet. Results are limited to pet-friendly homes, dated totals include the pet fee, and booking links keep the pet selection."

Removed value: -4

Removed value: -0

Previous value: -[
-  "integer",
-  "boolean"
-]New value: +"boolean"

Previous value: -"Free text place, e.g. 'Tampa', a neighbourhood, or a landmark such as 'near McCormick Place, Chicago'. A known Chicago landmark or area (McCormick Place, Navy Pier, Wrigley Field, O'Hare Airport, the South Loop and others) returns homes within radius_miles, nearest first, with a straight-line distance. Text that names no city, state, neighbourhood or landmark is refused with INVALID_INPUT; it is not answered as an empty, complete result."New value: +"Free text place, e.g. 'Tampa', 'near Chicago downtown', a neighbourhood or a landmark."

Removed value: -{
-  "description": "How far from a named landmark or area to search, in whole miles, 1 to 25. Homes are included by the distance they state, to the nearest half mile. Defaults to 5 for a landmark and 3 for an area. Ignored for any other place.",
-  "maximum": 25,
-  "minimum": 1,
-  "type": "integer"
-}

Previous value: -"total_price_* needs dates and orders by the stay total; from_price_asc orders by a starting rate that is not returned, and with dates by the stay total; sleeps_desc puts the largest homes first."New value: +"total_price_* needs dates and orders by the stay total; from_price_asc orders by starting nightly rate; sleeps_desc puts the largest homes first."

Removed value: -{
-  "description": "Otherwise matching homes left out of an accommodation_type search because no type is recorded for them. They are not confirmed to be another type. 0 when the filter was not sent.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "Otherwise matching homes left out of an amenities_required search because no amenity data is available for them. They are not confirmed to lack the amenity. 0 when the filter was not sent.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "Only returned when a budget was sent: what it was compared with.",
-  "properties": {
-    "amount": {
-      "type": "number"
-    },
-    "compared_to": {
-      "description": "stay_total includes cleaning, fees and taxes; from_price_per_night is a starting nightly rate that excludes them.",
-      "enum": [
-        "stay_total",
-        "from_price_per_night"
-      ],
-      "type": "string"
-    },
-    "currency": {
-      "type": "string"
-    },
-    "homes_not_checked": {
-      "description": "Matching homes the budget could not be checked against: unpriced for a total budget, no starting rate for a nightly one.",
-      "type": "integer"
-    },
-    "includes_fees_and_taxes": {
-      "type": "boolean"
-    },
-    "note": {
-      "type": "string"
-    },
-    "scope": {
-      "enum": [
-        "total",
-        "nightly"
-      ],
-      "type": "string"
-    }
-  },
-  "required": [
-    "scope",
-    "amount",
-    "currency",
-    "compared_to",
-    "includes_fees_and_taxes",
-    "note"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "description": "Otherwise matching homes left out of a nightly budget search because no starting nightly rate is on record. 0 when the budget was not sent or was a total budget.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "The property_id of up to 30 of the homes counted in budget_unverified; each can be priced for specific dates with a live quote.",
-  "items": {
-    "type": "integer"
-  },
-  "maxItems": 30,
-  "type": "array"
-}

Removed value: -{
-  "description": "complete: no matching home is unpriced, and none was left out for an unknown pet policy, accommodation type, amenity data, starting rate or position. partial: at least one is, so the results may omit a home that matches.",
-  "enum": [
-    "complete",
-    "partial"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Only on a landmark or area search: otherwise matching homes left out because no position is recorded for them, so their distance is unknown. They are not confirmed to be outside the radius.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "True when more results follow this page in the same ordering, within the priced sample. Homes counted in unpriced_in_time are not part of any page and have no effect on this.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "The value to send as cursor, with every other input unchanged, to get the next page. Null when has_more is false.",
-  "type": [
-    "string",
-    "null"
-  ]
-}

Removed value: -{
-  "description": "How many results precede this page in the full ordering.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "How many results this page asked for.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
-  "enum": [
-    "entire_home",
-    "private_room",
-    "shared_room",
-    "unknown"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "available: confirmed available for the requested dates when this answer was produced. not_checked: no dates were given, so availability was not checked.",
-  "enum": [
-    "available",
-    "not_checked"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
-  "enum": [
-    "private",
-    "shared",
-    "unknown"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "When the property manager's record of this home last changed, ISO 8601, as the provider states it. Omitted when the provider gives no such time.",
-  "type": "string"
-}

Removed value: -{
-  "description": "When this home's availability and price were fetched, ISO 8601. Only present on a row whose stay was priced.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Only on a landmark or area search: how far this home is from it, in miles, rounded to the nearest 0.5 (0.5 means under 0.5 mile), as a straight line over the ground, not a driving or walking route.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Only with distance_miles: how the distance was measured. straight_line is the direct distance, shorter than any route.",
-  "enum": [
-    "straight_line"
-  ],
-  "type": "string"
-}

Previous value: -"Deprecated, no longer returned along with from_price_per_night."New value: +"Only present when from_price_per_night is null: what is and is not visible about this home's calendar. A null starting rate means neither that the home is booked out nor that it is ready to book."

Previous value: -"Deprecated, no longer returned: only a row with a confirmed stay_total carries a price. Kept in this schema so existing clients still validate."New value: +"Starting nightly rate, used to order results. It excludes cleaning, fees and taxes, so it is not the price of any stay. Only present on a row without stay_total. Null means no starting rate is published for this home, not that it is free or cheap; from_price_note says why."

Removed value: -{
-  "description": "Short statements of why this home passed the filters that were sent, e.g. \"2 bedrooms (exact)\" or \"has parking\". On a landmark search the first is the distance, e.g. \"1.5 mi from McCormick Place (straight line)\" or \"under 0.5 mi from McCormick Place (straight line)\". Empty when no filter was sent.",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Facts about this home that could not be verified, drawn from: pet policy, amenities, accommodation type.",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Previous value: -[
-  "property_id",
-  "name",
-  "city",
-  "top_amenities",
-  "review_count",
-  "review_sources",
-  "highlights",
-  "booking_url",
-  "match_reasons",
-  "availability_status",
-  "missing_or_unverified"
-]New value: +[
+  "property_id",
+  "name",
+  "city",
+  "top_amenities",
+  "review_count",
+  "review_sources",
+  "highlights",
+  "booking_url"
+]

Removed value: -{
-  "description": "The place actually searched and how it was read.",
-  "properties": {
-    "place": {
-      "description": "The place searched; null when no place was given and every home was searched.",
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "radius_miles": {
-      "description": "How far from its centre or point homes are included; given for a metro, landmark or area.",
-      "type": "number"
-    },
-    "type": {
-      "description": "metro: the metro area around the named city, within radius_miles. state: the whole state. city: homes in the named city. nearby_or_text: homes near the place or whose listing text matches it. landmark: homes within radius_miles of a named landmark, nearest first, by straight-line distance. area: the same, measured from the centre of a named area such as the South Loop.",
-      "enum": [
-        "all_homes",
-        "metro",
-        "state",
-        "city",
-        "nearby_or_text",
-        "landmark",
-        "area"
-      ],
-      "type": "string"
-    }
-  },
-  "required": [
-    "place",
-    "type"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "description": "NO_MATCHES: nothing matched and nothing is unknown (unpriced_in_time and pet_policy_unknown are both 0). It is a normal answer, not an error. Any other search is OK, even with no results, and unpriced_in_time and pet_policy_unknown say what is still unknown.",
-  "enum": [
-    "OK",
-    "NO_MATCHES"
-  ],
-  "type": "string"
-}

Previous value: -"Matching homes whose availability was not established for these dates, because their pet policy could not be verified, a quote failed, the request ran out of budget, or it did not reach them. They are unknown, not unavailable. `price_all_matches`, a higher `limit`, or a narrower place establishes more of them. These counts cover the whole search, not one page, and the homes they count are not part of any page. A later page quotes more homes, so the count can fall."New value: +"Matching homes whose availability was not established for these dates, because their pet policy could not be verified, a quote failed, the request ran out of budget, or it did not reach them. They are unknown, not unavailable. `price_all_matches`, a higher `limit`, or a narrower place establishes more of them."

Removed value: -{
-  "description": "The property_id of up to 30 of the homes counted in unpriced_in_time; each can be priced individually with a live quote. Homes whose quote failed or timed out come first, then homes the request did not reach. A home listed here is unknown, not unavailable.",
-  "items": {
-    "type": "integer"
-  },
-  "maxItems": 30,
-  "type": "array"
-}

Previous value: -[
-  "matches",
-  "total_matching",
-  "total_matching_groups",
-  "unpriced_in_time",
-  "unpriced_property_ids",
-  "dates_checked",
-  "availability_note",
-  "properties",
-  "completeness",
-  "search_scope",
-  "has_more",
-  "next_cursor"
-]New value: +[
+  "matches",
+  "total_matching",
+  "total_matching_groups",
+  "unpriced_in_time",
+  "dates_checked",
+  "availability_note",
+  "properties"
+]

Added value: +{
+  "description": "True when the rate this quote prices can be cancelled for a refund until its free-cancellation deadline; false for the non-refundable rate.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "True when this rate can be cancelled for a refund until free_cancel_until; false when a confirmed reservation cannot be cancelled for a refund.",
+  "type": "boolean"
+}

Previous value: -[
-  "plan",
-  "stay_total",
-  "total_due_now",
-  "cancellation",
-  "booking_url"
-]New value: +[
+  "plan",
+  "refundable",
+  "stay_total",
+  "total_due_now",
+  "cancellation",
+  "booking_url"
+]

Previous value: -"Free text place, e.g. 'Tampa', 'near Chicago downtown', a neighbourhood or a landmark."New value: +"Free text place, e.g. 'Tampa', a neighbourhood, or a landmark such as 'near McCormick Place, Chicago'. A known Chicago landmark or area (McCormick Place, Navy Pier, Wrigley Field, O'Hare Airport, the South Loop and others) returns homes within radius_miles, nearest first, with a straight-line distance. Text that names no city, state, neighbourhood or landmark is refused with INVALID_INPUT; it is not answered as an empty, complete result."

Added value: +{
+  "description": "How far from a named landmark or area to search, in whole miles, 1 to 25. Homes are included by the distance they state, to the nearest half mile. Defaults to 5 for a landmark and 3 for an area. Ignored for any other place.",
+  "maximum": 25,
+  "minimum": 1,
+  "type": "integer"
+}

Previous value: -"complete: no matching home is unpriced, and none was left out for an unknown pet policy, accommodation type, amenity data or starting rate. partial: at least one is, so the results may omit a home that matches."New value: +"complete: no matching home is unpriced, and none was left out for an unknown pet policy, accommodation type, amenity data, starting rate or position. partial: at least one is, so the results may omit a home that matches."

Added value: +{
+  "description": "Only on a landmark or area search: otherwise matching homes left out because no position is recorded for them, so their distance is unknown. They are not confirmed to be outside the radius.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Only on a landmark or area search: how far this home is from it, in miles, rounded to the nearest 0.5 (0.5 means under 0.5 mile), as a straight line over the ground, not a driving or walking route.",
+  "type": "number"
+}

Added value: +{
+  "description": "Only with distance_miles: how the distance was measured. straight_line is the direct distance, shorter than any route.",
+  "enum": [
+    "straight_line"
+  ],
+  "type": "string"
+}

Previous value: -"Short statements of why this home passed the filters that were sent, e.g. \"2 bedrooms (exact)\" or \"has parking\". Empty when no filter was sent."New value: +"Short statements of why this home passed the filters that were sent, e.g. \"2 bedrooms (exact)\" or \"has parking\". On a landmark search the first is the distance, e.g. \"1.5 mi from McCormick Place (straight line)\" or \"under 0.5 mi from McCormick Place (straight line)\". Empty when no filter was sent."

Previous value: -"Only present for a metro: how far from its centre homes are included."New value: +"How far from its centre or point homes are included; given for a metro, landmark or area."

Previous value: -"metro: the metro area around the named city, within radius_miles. state: the whole state. city: homes in the named city. nearby_or_text: homes near the place or whose listing text matches it."New value: +"metro: the metro area around the named city, within radius_miles. state: the whole state. city: homes in the named city. nearby_or_text: homes near the place or whose listing text matches it. landmark: homes within radius_miles of a named landmark, nearest first, by straight-line distance. area: the same, measured from the centre of a named area such as the South Loop."

Previous value: -[
-  "all_homes",
-  "metro",
-  "state",
-  "city",
-  "nearby_or_text"
-]New value: +[
+  "all_homes",
+  "metro",
+  "state",
+  "city",
+  "nearby_or_text",
+  "landmark",
+  "area"
+]

Added value: +{
+  "description": "What the guest rents. Homes whose type is not recorded are left out and counted in accommodation_type_unknown.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room"
+  ],
+  "type": "string"
+}

Previous value: -"Amenities every returned home has, as recorded by the property manager."New value: +"Amenities every returned home has, as recorded by the property manager. The same hard filter as amenities_required, except a home with no amenity data is left out without being counted."

Added value: +{
+  "description": "Amenities that order homes when the requested sort ties, and appear in match_reasons. Homes lacking them stay in the results.",
+  "items": {
+    "enum": [
+      "pool",
+      "hot_tub",
+      "parking",
+      "wifi",
+      "kitchen",
+      "washer",
+      "pets"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Amenities every returned home has. A home whose amenity data is unavailable fails the filter and is counted in amenities_unknown.",
+  "items": {
+    "enum": [
+      "pool",
+      "hot_tub",
+      "parking",
+      "wifi",
+      "kitchen",
+      "washer",
+      "pets"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Exactly this many bedrooms; 0 is a studio. Cannot be sent together with bedrooms_min.",
+  "maximum": 100,
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "A spending limit. scope total compares amount with each home's stay total including cleaning, fees and taxes, and needs check_in and check_out. scope nightly compares it with each home's starting nightly rate, which excludes cleaning, fees and taxes. amount, currency and scope are all required.",
+  "properties": {
+    "amount": {
+      "description": "The limit, in the stated currency.",
+      "exclusiveMinimum": 0,
+      "maximum": 1000000,
+      "type": "number"
+    },
+    "currency": {
+      "description": "Only USD is supported.",
+      "enum": [
+        "USD"
+      ],
+      "type": "string"
+    },
+    "scope": {
+      "description": "total: the whole stay, with dates. nightly: the starting nightly rate, excluding fees and taxes.",
+      "enum": [
+        "total",
+        "nightly"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "amount",
+    "currency",
+    "scope"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "The next_cursor value of the previous response, valid only with the same other inputs. Returns the page after it.",
+  "type": "string"
+}

Added value: +{
+  "description": "Page number, starting at 1, counted in units of page_size. Cannot be sent together with cursor.",
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "Results per page, up to 20. Takes the place of limit when both are sent.",
+  "maximum": 20,
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "Otherwise matching homes left out of an accommodation_type search because no type is recorded for them. They are not confirmed to be another type. 0 when the filter was not sent.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Otherwise matching homes left out of an amenities_required search because no amenity data is available for them. They are not confirmed to lack the amenity. 0 when the filter was not sent.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Only returned when a budget was sent: what it was compared with.",
+  "properties": {
+    "amount": {
+      "type": "number"
+    },
+    "compared_to": {
+      "description": "stay_total includes cleaning, fees and taxes; from_price_per_night is a starting nightly rate that excludes them.",
+      "enum": [
+        "stay_total",
+        "from_price_per_night"
+      ],
+      "type": "string"
+    },
+    "currency": {
+      "type": "string"
+    },
+    "homes_not_checked": {
+      "description": "Matching homes the budget could not be checked against: unpriced for a total budget, no starting rate for a nightly one.",
+      "type": "integer"
+    },
+    "includes_fees_and_taxes": {
+      "type": "boolean"
+    },
+    "note": {
+      "type": "string"
+    },
+    "scope": {
+      "enum": [
+        "total",
+        "nightly"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "scope",
+    "amount",
+    "currency",
+    "compared_to",
+    "includes_fees_and_taxes",
+    "note"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Otherwise matching homes left out of a nightly budget search because no starting nightly rate is on record. 0 when the budget was not sent or was a total budget.",
+  "type": "integer"
+}

Added value: +{
+  "description": "The property_id of up to 30 of the homes counted in budget_unverified; each can be priced for specific dates with a live quote.",
+  "items": {
+    "type": "integer"
+  },
+  "maxItems": 30,
+  "type": "array"
+}

Added value: +{
+  "description": "complete: no matching home is unpriced, and none was left out for an unknown pet policy, accommodation type, amenity data or starting rate. partial: at least one is, so the results may omit a home that matches.",
+  "enum": [
+    "complete",
+    "partial"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "True when more results follow this page in the same ordering, within the priced sample. Homes counted in unpriced_in_time are not part of any page and have no effect on this.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "The value to send as cursor, with every other input unchanged, to get the next page. Null when has_more is false.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "How many results precede this page in the full ordering.",
+  "type": "integer"
+}

Added value: +{
+  "description": "How many results this page asked for.",
+  "type": "integer"
+}

Added value: +{
+  "description": "available: confirmed available for the requested dates when this answer was produced. not_checked: no dates were given, so availability was not checked.",
+  "enum": [
+    "available",
+    "not_checked"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "When the property manager's record of this home last changed, ISO 8601, as the provider states it. Omitted when the provider gives no such time.",
+  "type": "string"
+}

Added value: +{
+  "description": "When this home's availability and price were fetched, ISO 8601. Only present on a row whose stay was priced.",
+  "type": "string"
+}

Added value: +{
+  "description": "Short statements of why this home passed the filters that were sent, e.g. \"2 bedrooms (exact)\" or \"has parking\". Empty when no filter was sent.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Facts about this home that could not be verified, drawn from: pet policy, amenities, accommodation type.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -[
-  "property_id",
-  "name",
-  "city",
-  "top_amenities",
-  "review_count",
-  "review_sources",
-  "highlights",
-  "booking_url"
-]New value: +[
+  "property_id",
+  "name",
+  "city",
+  "top_amenities",
+  "review_count",
+  "review_sources",
+  "highlights",
+  "booking_url",
+  "match_reasons",
+  "availability_status",
+  "missing_or_unverified"
+]

Added value: +{
+  "description": "The place actually searched and how it was read.",
+  "properties": {
+    "place": {
+      "description": "The place searched; null when no place was given and every home was searched.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "radius_miles": {
+      "description": "Only present for a metro: how far from its centre homes are included.",
+      "type": "number"
+    },
+    "type": {
+      "description": "metro: the metro area around the named city, within radius_miles. state: the whole state. city: homes in the named city. nearby_or_text: homes near the place or whose listing text matches it.",
+      "enum": [
+        "all_homes",
+        "metro",
+        "state",
+        "city",
+        "nearby_or_text"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "place",
+    "type"
+  ],
+  "type": "object"
+}

Previous value: -"Matching homes whose availability was not established for these dates, because their pet policy could not be verified, a quote failed, the request ran out of budget, or it did not reach them. They are unknown, not unavailable. `price_all_matches`, a higher `limit`, or a narrower place establishes more of them."New value: +"Matching homes whose availability was not established for these dates, because their pet policy could not be verified, a quote failed, the request ran out of budget, or it did not reach them. They are unknown, not unavailable. `price_all_matches`, a higher `limit`, or a narrower place establishes more of them. These counts cover the whole search, not one page, and the homes they count are not part of any page. A later page quotes more homes, so the count can fall."

Previous value: -[
-  "matches",
-  "total_matching",
-  "total_matching_groups",
-  "unpriced_in_time",
-  "unpriced_property_ids",
-  "dates_checked",
-  "availability_note",
-  "properties"
-]New value: +[
+  "matches",
+  "total_matching",
+  "total_matching_groups",
+  "unpriced_in_time",
+  "unpriced_property_ids",
+  "dates_checked",
+  "availability_note",
+  "properties",
+  "completeness",
+  "search_scope",
+  "has_more",
+  "next_cursor"
+]

Previous value: -"Number of guests."New value: +"Everyone staying, including children and infants."

Previous value: -"Number of guests."New value: +"Everyone staying, including children and infants."

Previous value: -"A live total for one stay. When available is false only property_id, available, reason and booking_url are present."New value: +"A live total for one stay. When available is false only property_id, available, reason, booking_url and a short quote block are present."

Added value: +{
+  "description": "The authoritative, machine-readable quote for this stay, for the rate stay_total prices (the non-refundable rate). Amounts ending in _minor are integer cents in `currency`. total_stay_price_minor is exactly what the guest is charged in total, including taxes and the card processing fee, and the amounts add up: total_stay_price_minor = nightly_subtotal_minor + mandatory_fees_minor + optional_fees_minor + taxes_minor + card_fee_minor - discounts_minor. When available is false only availability_status, inventory_held, checked_at, canonical_url, incomplete and missing are present. The itemised _minor amounts are null only when missing includes price_breakdown.",
+  "properties": {
+    "availability_status": {
+      "enum": [
+        "available",
+        "unavailable"
+      ],
+      "type": "string"
+    },
+    "cancellation_policy_id": {
+      "description": "The rate this quote prices; rate_options lists both.",
+      "enum": [
+        "non_refundable",
+        "refundable"
+      ],
+      "type": "string"
+    },
+    "cancellation_summary": {
+      "type": "string"
+    },
+    "canonical_url": {
+      "description": "The home's property page, not the booking link.",
+      "type": "string"
+    },
+    "card_fee_minor": {
+      "description": "The 3.5% card processing fee, added at checkout and included in the total.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "charges": {
+      "description": "Every charge, itemised. The amounts of the rows with paid_at checkout add up to total_stay_price_minor exactly; a discount row is negative.",
+      "items": {
+        "properties": {
+          "amount_minor": {
+            "type": "integer"
+          },
+          "name": {
+            "type": "string"
+          },
+          "paid_at": {
+            "description": "checkout: part of the total. outside_checkout: not part of it (the security hold).",
+            "enum": [
+              "checkout",
+              "outside_checkout"
+            ],
+            "type": "string"
+          },
+          "type": {
+            "enum": [
+              "nightly",
+              "fee",
+              "tax",
+              "discount",
+              "card_fee",
+              "security_hold",
+              "adjustment"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "name",
+          "amount_minor",
+          "paid_at"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "checked_at": {
+      "description": "When this quote was fetched, ISO 8601.",
+      "type": "string"
+    },
+    "currency": {
+      "description": "ISO 4217 code, e.g. USD.",
+      "type": "string"
+    },
+    "discounts_minor": {
+      "description": "A positive amount subtracted from the total; 0 when there is none.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "due_later_minor": {
+      "description": "The rest, charged automatically to the same card 60 days before check-in; 0 when everything is due now.",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "due_now_minor": {
+      "description": "Charged when the guest books: 50% of the total when check-in is more than 60 days away, otherwise all of it.",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "expires_at": {
+      "description": "When the quote lapses, ISO 8601; the same instant as quote_expires_at.",
+      "type": "string"
+    },
+    "incomplete": {
+      "description": "True when a required input or tax could not be determined; missing says which.",
+      "type": "boolean"
+    },
+    "inventory_held": {
+      "description": "False: a quote does not hold the home.",
+      "type": "boolean"
+    },
+    "mandatory_fees_minor": {
+      "description": "Cleaning and every other required fee.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "missing": {
+      "description": "rent_tax_rate: the provider's fee table could not be read, so the refundable rate cannot be priced. price_breakdown: the provider sent only a total. line_items_mismatch: the itemised charges add up to more than the total.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "nightly_subtotal_minor": {
+      "description": "Rent for the nights before any discount, plus the refundable-rate premium when that rate is quoted.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "nights": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "optional_fees_minor": {
+      "description": "Fees the guest chose, the pet fee for the pets in this quote.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "quote_id": {
+      "description": "Stable id for this priced stay: the same home, dates, guests, pets, rate and total give the same id; any change gives a new one. Not a hold or a reservation.",
+      "type": "string"
+    },
+    "refundable_security_hold_minor": {
+      "description": "A refundable hold on the card on file, separate from the total. The home's own amount, or the standard hold when it states none.",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "tax_source": {
+      "description": "Where the tax comes from: the provider's own quote, or our verified rate table for the home's jurisdiction when the provider's quote had none. Either way the tax is collected and in the total.",
+      "enum": [
+        "provider",
+        "jurisdiction_table"
+      ],
+      "type": "string"
+    },
+    "taxes_included": {
+      "description": "True: the total includes lodging tax, which is collected on every stay.",
+      "type": "boolean"
+    },
+    "taxes_minor": {
+      "description": "Lodging tax.",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "timezone": {
+      "description": "IANA zone of the home: the provider's own zone when it states one, otherwise the zone of the home's US state (timezone_source says which). Null when unknown.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "timezone_source": {
+      "enum": [
+        "listing",
+        "market",
+        "unknown"
+      ],
+      "type": "string"
+    },
+    "total_stay_price_minor": {
+      "description": "The whole price of the stay, equal to stay_total in cents.",
+      "minimum": 0,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "availability_status",
+    "inventory_held",
+    "checked_at",
+    "canonical_url",
+    "incomplete",
+    "missing"
+  ],
+  "type": "object"
+}

Previous value: -"Number of guests, including children."New value: +"Everyone staying, including children and infants."

Added value: +{
+  "description": "NO_MATCHES: nothing matched and nothing is unknown (unpriced_in_time and pet_policy_unknown are both 0). It is a normal answer, not an error. Any other search is OK, even with no results, and unpriced_in_time and pet_policy_unknown say what is still unknown.",
+  "enum": [
+    "OK",
+    "NO_MATCHES"
+  ],
+  "type": "string"
+}

Previous value: -"Whether the guest is bringing a pet."New value: +"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. Totals include the pet fee for that many pets."

Added value: +4

Added value: +0

Previous value: -"boolean"New value: +[
+  "integer",
+  "boolean"
+]

Previous value: -"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."

Previous value: -[
-  "per stay",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per night",
+  "per pet",
+  "per pet per night"
+]

Previous value: -"Whether the guest is bringing a pet; this changes the price."New value: +"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. This changes the price: some homes charge per pet or per pet per night."

Added value: +4

Added value: +0

Previous value: -"boolean"New value: +[
+  "integer",
+  "boolean"
+]

Added value: +"How many pets this quote is for. pet_fee in price_breakdown is the fee for that many."

Added value: +4

Added value: +0

Previous value: -"boolean"New value: +"integer"

Previous value: -"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."New value: +"The fee for one pet, from the fee table the quote charges from; with several pets a live quote charges it as pet_fee_basis says (per pet, per pet per night) and states the total in price_breakdown.pet_fee. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."

Previous value: -"How pet_fee applies. A per-pet-per-night fee multiplies by the nights."New value: +"How pet_fee applies. Per night multiplies by the nights; per pet by the number of pets; per pet per night by both."

Previous value: -[
-  "per stay",
-  "per pet",
-  "per pet per night"
-]New value: +[
+  "per stay",
+  "per night",
+  "per pet",
+  "per pet per night"
+]

Previous value: -"The guest is bringing a pet. Results are limited to pet-friendly homes, dated totals include the pet fee, and booking links keep the pet selection."New value: +"How many pets the guest is bringing, 0 to 4; 0 or leave out for none. true means one pet and false none. Results are limited to pet-friendly homes, dated totals include the pet fee for that many pets, and booking links keep the number of pets."

Added value: +4

Added value: +0

Previous value: -"boolean"New value: +[
+  "integer",
+  "boolean"
+]

Added value: +{
+  "description": "The property_id of up to 30 of the homes counted in unpriced_in_time; each can be priced individually with a live quote. Homes whose quote failed or timed out come first, then homes the request did not reach. A home listed here is unknown, not unavailable.",
+  "items": {
+    "type": "integer"
+  },
+  "maxItems": 30,
+  "type": "array"
+}

Previous value: -[
-  "matches",
-  "total_matching",
-  "total_matching_groups",
-  "unpriced_in_time",
-  "dates_checked",
-  "availability_note",
-  "properties"
-]New value: +[
+  "matches",
+  "total_matching",
+  "total_matching_groups",
+  "unpriced_in_time",
+  "unpriced_property_ids",
+  "dates_checked",
+  "availability_note",
+  "properties"
+]

Added value: +{
+  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room",
+    "unknown"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
+  "enum": [
+    "private",
+    "shared",
+    "unknown"
+  ],
+  "type": "string"
+}

Previous value: -"Only present when from_price_per_night is null: what is and is not visible about this home's calendar. A null starting rate means neither that the home is booked out nor that it is ready to book."New value: +"Deprecated, no longer returned along with from_price_per_night."

Previous value: -"Starting nightly rate. It excludes cleaning, fees and taxes, so it is not the price of any stay. Only present on a row without stay_total. Null means no starting rate is published for this home, not that it is free; from_price_note says why."New value: +"Deprecated, no longer returned: only a row with a confirmed stay_total carries a price. Kept in this schema so existing clients still validate."

Added value: +{
+  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room",
+    "unknown"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
+  "enum": [
+    "private",
+    "shared",
+    "unknown"
+  ],
+  "type": "string"
+}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "description": "The same stays split into whole homes and rooms, for the city alone and for the area. homes includes unknown_type; a room is not a whole home.",
+  "properties": {
+    "area": {
+      "properties": {
+        "homes": {
+          "description": "Entire homes, plus homes whose type is not recorded (unknown_type).",
+          "type": "integer"
+        },
+        "private_rooms": {
+          "type": "integer"
+        },
+        "shared_rooms": {
+          "type": "integer"
+        },
+        "total": {
+          "type": "integer"
+        },
+        "unknown_type": {
+          "description": "Counted inside homes: nothing on record says whether these are whole homes.",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "total",
+        "homes",
+        "private_rooms",
+        "shared_rooms",
+        "unknown_type"
+      ],
+      "type": "object"
+    },
+    "city": {
+      "properties": {
+        "homes": {
+          "description": "Entire homes, plus homes whose type is not recorded (unknown_type).",
+          "type": "integer"
+        },
+        "private_rooms": {
+          "type": "integer"
+        },
+        "shared_rooms": {
+          "type": "integer"
+        },
+        "total": {
+          "type": "integer"
+        },
+        "unknown_type": {
+          "description": "Counted inside homes: nothing on record says whether these are whole homes.",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "total",
+        "homes",
+        "private_rooms",
+        "shared_rooms",
+        "unknown_type"
+      ],
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "description": "Stays a search for this market returns before dates, including nearby cities (Chicago: 65 miles around the city). At least homes.",
+  "type": "integer"
+}

Added value: +{
+  "description": "The counts as a guest reads them, e.g. \"41 stays in Chicago · 47 in the Chicago area, including 13 private rooms\".",
+  "type": "string"
+}

Previous value: -"total_price_* needs dates and orders by the stay total; from_price_asc orders by starting nightly rate; sleeps_desc puts the largest homes first."New value: +"total_price_* needs dates and orders by the stay total; from_price_asc orders by a starting rate that is not returned, and with dates by the stay total; sleeps_desc puts the largest homes first."

Added value: +{
+  "description": "What the guest rents: an entire home, a private room in a shared building or a shared room. A private room or shared room is not an entire home. unknown means the type is not recorded for this home.",
+  "enum": [
+    "entire_home",
+    "private_room",
+    "shared_room",
+    "unknown"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Whether the guest has a private bathroom or shares one. unknown means it is not recorded for this home.",
+  "enum": [
+    "private",
+    "shared",
+    "unknown"
+  ],
+  "type": "string"
+}

Previous value: -"Only present when from_price_per_night is null: what is and is not visible about this home's calendar. A null starting rate means neither that the home is booked out nor that it is ready to book."New value: +"Deprecated, no longer returned along with from_price_per_night."

Previous value: -"Starting nightly rate, used to order results. It excludes cleaning, fees and taxes, so it is not the price of any stay. Only present on a row without stay_total. Null means no starting rate is published for this home, not that it is free or cheap; from_price_note says why."New value: +"Deprecated, no longer returned: only a row with a confirmed stay_total carries a price. Kept in this schema so existing clients still validate."

Previous value: -"Check-in date, YYYY-MM-DD. Give both dates to get totals."New value: +"Check-in date, YYYY-MM-DD. Totals are returned only when both dates are given."

Previous value: -40New value: +50

Added value: +"No longer returned; stay_total is the price of the stay."

Previous value: -"Only present, and only false, when this home's record could not be loaded. Such a row carries no name, place, amenity or review fields at all -- read detail_note, and call get_property_details for it again."New value: +"Only present, and only false, when this home's record could not be loaded. Such a row carries no name, place, amenity or review fields at all; detail_note says why."

Previous value: -"Only present when from_price_per_night is null: what we can and cannot see about this home's calendar. Call get_availability before suggesting dates; do not describe the home as booked out or as ready to book."New value: +"Only present when from_price_per_night is null: what is and is not visible about this home's calendar. A null starting rate means neither that the home is booked out nor that it is ready to book."

Previous value: -"Starting nightly rate. Null means no starting rate is published for this home, never that it is free -- read from_price_note."New value: +"Starting nightly rate. It excludes cleaning, fees and taxes, so it is not the price of any stay. Only present on a row without stay_total. Null means no starting rate is published for this home, not that it is free; from_price_note says why."

Previous value: -"Up to three short phrases an agent can repeat when recommending the home."New value: +"Up to three short phrases describing what sets the home apart."

Added value: +"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."

Added value: +{
+  "enum": [
+    "per stay",
+    "per pet",
+    "per pet per night"
+  ],
+  "type": "string"
+}

Added value: +{
+  "type": "string"
+}

Previous value: -"How many 4- and 5-star reviews this home has. Never present this as, or derive, an average rating."New value: +"How many 4- and 5-star reviews this home has. It is a count, not a rating; no average rating exists for any home."

Previous value: -40New value: +50

Previous value: -"This home's terms. Never promise a refund beyond what this says."New value: +"This home's own cancellation terms for the non-refundable rate, which stay_total prices. Each entry in rate_options carries its own terms, and those are the only refund terms that apply to that rate."

Added value: +{
+  "description": "When the guest pays. plan 'deposit': due_at_booking now and the balance charged automatically to the same card on balance_charged_on (60 days before check-in). plan 'full': everything at booking.",
+  "properties": {
+    "balance": {
+      "type": "number"
+    },
+    "balance_charged_on": {
+      "type": "string"
+    },
+    "due_at_booking": {
+      "type": "number"
+    },
+    "plan": {
+      "enum": [
+        "full",
+        "deposit"
+      ],
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "description": "The 8% of the nightly subtotal the refundable rate adds; 0 on the non-refundable rate.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

Previous value: -"Lodging tax. Always collected and always included in the total."New value: +"Lodging tax. It is collected on every stay and included in the total."

Previous value: -"After this the total must be re-quoted before it is given to a guest."New value: +"When this quote lapses. After it, the price of the stay can differ from stay_total until it is quoted again."

Added value: +{
+  "description": "Every rate on offer for this stay. The first is the non-refundable rate (the same totals as the top level). When check-in is more than 30 days away a refundable rate follows: 8% more on the nightly subtotal, taxed as rent, cancellable for a full refund of everything paid until free_cancel_until. Each rate has its own booking_url.",
+  "items": {
+    "properties": {
+      "booking_url": {
+        "type": "string"
+      },
+      "cancellation": {
+        "description": "This rate's terms.",
+        "type": "string"
+      },
+      "free_cancel_until": {
+        "description": "Refundable rate only. The last instant, in UTC, the stay can be cancelled for a full refund.",
+        "type": "string"
+      },
+      "payment_schedule": {
+        "type": "object"
+      },
+      "plan": {
+        "enum": [
+          "non_refundable",
+          "refundable"
+        ],
+        "type": "string"
+      },
+      "price_breakdown": {
+        "type": "object"
+      },
+      "stay_total": {
+        "type": "number"
+      },
+      "total_due_now": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "plan",
+      "stay_total",
+      "total_due_now",
+      "cancellation",
+      "booking_url"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"A refundable hold, not part of total_due_now."New value: +"A refundable hold, not part of stay_total."

Added value: +{
+  "description": "The price of the stay, including cleaning, fees and taxes. Nightly rates exclude them.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

Added value: +"stay_total, formatted."

Previous value: -"Everything the guest pays at booking, including cleaning, fees and taxes. State this, never the nightly rate alone."New value: +"What the guest pays at booking: the whole stay_total, or 50% of it when check-in is more than 60 days away; payment_schedule says which."

Previous value: -"The platform the review was left on. Always name it when quoting the review."New value: +"The platform the review was left on."

Previous value: -"Null when the provider gave none; never assume one."New value: +"Null when the provider gave none; the country is then unknown."

Added value: +"For a stay with one pet, from the fee table the quote charges from. Null when the home charges none; omitted when it could not be verified, and pet_fee_note says why."

Added value: +{
+  "description": "How pet_fee applies. A per-pet-per-night fee multiplies by the nights.",
+  "enum": [
+    "per stay",
+    "per pet",
+    "per pet per night"
+  ],
+  "type": "string"
+}

Added value: +{
+  "type": "string"
+}

Previous value: -"The public page for this market, when it has enough homes to have one. Safe to cite; it lists the homes and their neighbourhoods."New value: +"The public page for this market, when it has enough homes to have one. It lists the homes and their neighbourhoods."

Previous value: -"Amenities the home must have, as recorded by the property manager."New value: +"Amenities every returned home has, as recorded by the property manager."

Previous value: -"Check-in date, YYYY-MM-DD. Give both dates to filter by real availability."New value: +"Check-in date, YYYY-MM-DD. Availability is checked only when both dates are given."

Previous value: -40New value: +50

Previous value: -"Budget for the whole stay in dollars, including cleaning, fees and taxes. Only works with dates."New value: +"Budget for the whole stay in dollars, including cleaning, fees and taxes. Applies only when dates are given."

Previous value: -"The guest is bringing a pet. Only return pet-friendly homes, include the pet fee in dated totals, and preserve the pet selection in booking links."New value: +"The guest is bringing a pet. Results are limited to pet-friendly homes, dated totals include the pet fee, and booking links keep the pet selection."

Previous value: -"Price every matching home rather than a fast sample, so total_matching is the real count and the cheapest result is genuinely the cheapest. Slower, and still bounded — check unpriced_in_time. Use it when a guest asks how many homes are free or for the cheapest; leave it off for browsing."New value: +"Prices every matching home rather than a fast sample, so total_matching is the real count and the cheapest result is genuinely the cheapest. Slower, and still bounded: unpriced_in_time counts any homes it did not reach."

Previous value: -"False means availability is unknown and every price is a starting nightly rate."New value: +"False means availability is unknown and no stay has been priced; no row carries a stay_total."

Previous value: -"stay_total divided by nights. A derived figure; quote the total, not this."New value: +"No longer returned; stay_total is the price of the stay."

Previous value: -"Only present when from_price_per_night is null: what we can and cannot see about this home's calendar. Call get_availability before suggesting dates; do not describe the home as booked out or as ready to book."New value: +"Only present when from_price_per_night is null: what is and is not visible about this home's calendar. A null starting rate means neither that the home is booked out nor that it is ready to book."

Previous value: -"Starting nightly rate, not a stay total. Absent dates, this is all that is known. Null means no starting rate is published for this home, never that it is free or cheap -- read from_price_note."New value: +"Starting nightly rate, used to order results. It excludes cleaning, fees and taxes, so it is not the price of any stay. Only present on a row without stay_total. Null means no starting rate is published for this home, not that it is free or cheap; from_price_note says why."

Previous value: -"Up to three short phrases an agent can repeat when recommending the home."New value: +"Up to three short phrases describing what sets the home apart."

Previous value: -"How many 4- and 5-star reviews this home has. Never present this as, or derive, an average rating."New value: +"How many 4- and 5-star reviews this home has. It is a count, not a rating; no average rating exists for any home."

Previous value: -"Matching homes whose availability was never established for these dates, because their pet policy could not be verified, a quote failed, the request ran out of budget, or it did not reach them. They are unknown, not unavailable — raise `limit`, narrow the place, or use get_live_quote."New value: +"Matching homes whose availability was not established for these dates, because their pet policy could not be verified, a quote failed, the request ran out of budget, or it did not reach them. They are unknown, not unavailable. `price_all_matches`, a higher `limit`, or a narrower place establishes more of them."