booking

Open and booked nights for Wanaka Haus (sleeps 8, Wānaka NZ) in a date window, up to 18 months ahead. Ranges are check-in inclusive, check-out exclusive.

{
  "type": "object",
  "properties": {
    "from": {
      "description": "Window start, YYYY-MM-DD. Defaults to today.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "Window end, YYYY-MM-DD. Defaults to 18 months out.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Itemised NZD total for a stay at Wanaka Haus. Validates the stay rules (minimum nights, peak-season minimum, guest cap) and checks the dates are open, before you commit to a booking.

{
  "type": "object",
  "properties": {
    "check_in": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD"
    },
    "check_out": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, exclusive — the morning the guests leave"
    },
    "guests": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8
    }
  },
  "required": [
    "check_in",
    "check_out",
    "guests"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Book Wanaka Haus: atomically holds the dates for 30 minutes and returns a Stripe Checkout URL. The booking confirms only when payment completes on that URL — give it to your user to pay (or pay with an agent wallet's one-time card). No account or API key needed.

{
  "type": "object",
  "properties": {
    "check_in": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD"
    },
    "check_out": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD"
    },
    "guests": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8
    },
    "guest_name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "The guest's full name"
    },
    "guest_email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "The guest's real email — confirmation and door code go here, and it is required to cancel"
    },
    "notes": {
      "type": "string",
      "maxLength": 2000
    }
  },
  "required": [
    "check_in",
    "check_out",
    "guests",
    "guest_name",
    "guest_email"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Status of a Wanaka Haus booking: held, confirmed, cancelled or lapsed.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The booking id, e.g. bk_1a2b3c4d5e6f"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Cancel a Wanaka Haus booking under the published policy (full refund to 14 days before arrival, 50% to 7 days, none inside 7). Requires the guest email the booking was made with.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "guest_email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Must match the email the booking was made with"
    }
  },
  "required": [
    "id",
    "guest_email"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}