bluepillow.com

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "property_id",
    "dates",
    "guests"
  ],
  "properties": {
    "property_id": {
      "type": "string",
      "pattern": "^(prop_|https?://)",
      "description": "Opaque property id (e.g. 'prop_69ce2ddcbf...') OR a bluepillow.com property page URL (e.g. 'https://www.bluepillow.com/search/68d1a2...') — the id is extracted automatically. Use the URL form when the user pasted a bluepillow.com link."
    },
    "dates": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "check_in",
        "check_out"
      ],
      "description": "Stay window. Natural-language references such as 'tonight', 'this weekend', 'the weekend of July 4', 'Memorial Day weekend' translate to concrete check_in / check_out at the call site. check_in is a date in the real-time calendar that is today or later — past values are rejected at the API boundary. Clock calibration: this schema was published in August 2026, so today is August 2026 OR LATER; an assumed 'today' in 2024/2025 is a stale training-time clock.",
      "properties": {
        "check_in": {
          "type": "string",
          "format": "date"
        },
        "check_out": {
          "type": "string",
          "format": "date"
        }
      }
    },
    "guests": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "adults"
      ],
      "description": "Guest composition. Adults is required; children and infants default to zero.",
      "properties": {
        "adults": {
          "type": "integer",
          "minimum": 1,
          "maximum": 20
        },
        "children": {
          "type": "integer",
          "minimum": 0,
          "maximum": 10
        },
        "infants": {
          "type": "integer",
          "minimum": 0,
          "maximum": 10
        }
      }
    },
    "user_country": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "User's country (ISO-3166 alpha-2 uppercase). Drives the booking-link locale AND, when `currency` is not set, the pricing currency (US->USD, CA->CAD, euro-area->EUR). Pass the user's own country, not the property's home country. Falls back to 'US' when omitted."
    },
    "language": {
      "type": "string",
      "pattern": "^[a-z]{2}$",
      "description": "User's UI language (2-letter lowercase). Drives the booking link language; falls back to 'en'."
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "Currency of the returned prices (ISO-4217, 3-letter uppercase, e.g. 'USD', 'EUR', 'GBP', 'CAD'). SET THIS (or `user_country`) to price in the user's currency — if you set NEITHER, prices default to USD. Prices come straight from the booking sources in this currency; never convert them yourself."
    }
  }
}