Threshold

Find verified independent vacation rentals. Filters are strict: every listed amenity must be present. With dates, results include a cached availability signal and an indicative all-in total (no guest service fee). Maps to GET /v1/search.

{
  "type": "object",
  "properties": {
    "place": {
      "type": "string",
      "description": "Town and state/country, e.g. 'Asheville, NC'. Use near_lat/near_lng instead when you have coordinates."
    },
    "near_lat": {
      "type": "number"
    },
    "near_lng": {
      "type": "number"
    },
    "radius_km": {
      "type": "number",
      "default": 25
    },
    "check_in": {
      "type": "string",
      "format": "date"
    },
    "check_out": {
      "type": "string",
      "format": "date"
    },
    "adults": {
      "type": "integer",
      "minimum": 1,
      "default": 2
    },
    "children": {
      "type": "integer",
      "minimum": 0
    },
    "infants": {
      "type": "integer",
      "minimum": 0
    },
    "pets": {
      "type": "integer",
      "minimum": 0
    },
    "min_bedrooms": {
      "type": "integer"
    },
    "amenities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Amenity codes, e.g. hot_tub, wifi, ev_charger, dedicated_workspace, pool, fireplace_wood."
    },
    "max_total_usd": {
      "type": "number",
      "description": "Maximum all-in total in dollars. Requires dates."
    },
    "instant_only": {
      "type": "boolean"
    },
    "step_free_entrance": {
      "type": "boolean"
    },
    "min_wifi_mbps": {
      "type": "number"
    },
    "limit": {
      "type": "integer",
      "maximum": 20,
      "default": 8
    }
  }
}

Full record for one property: beds by room, amenities with details, access and stairs, rules, host FAQ, policies, and verification status. Maps to GET /v1/properties/{id}.

{
  "type": "object",
  "properties": {
    "property_id": {
      "type": "string"
    }
  },
  "required": [
    "property_id"
  ]
}

Day-by-day availability and indicative nightly prices for up to 180 days. Cached; use get_quote to confirm. Useful when the guest's dates are flexible. Maps to GET /v1/properties/{id}/availability.

{
  "type": "object",
  "properties": {
    "property_id": {
      "type": "string"
    },
    "from": {
      "type": "string",
      "format": "date"
    },
    "to": {
      "type": "string",
      "format": "date",
      "description": "Exclusive"
    }
  },
  "required": [
    "property_id",
    "from",
    "to"
  ]
}

Itemized, binding price for exact dates and party, after re-checking the host's live calendars. Valid 10 minutes. Returns house rules and an exact refund schedule to show the guest. Does not reserve the dates. Maps to POST /v1/properties/{id}/quotes.

{
  "type": "object",
  "properties": {
    "property_id": {
      "type": "string"
    },
    "check_in": {
      "type": "string",
      "format": "date"
    },
    "check_out": {
      "type": "string",
      "format": "date"
    },
    "adults": {
      "type": "integer",
      "minimum": 1
    },
    "children": {
      "type": "integer",
      "minimum": 0,
      "default": 0
    },
    "infants": {
      "type": "integer",
      "minimum": 0,
      "default": 0
    },
    "pets": {
      "type": "integer",
      "minimum": 0,
      "default": 0
    }
  },
  "required": [
    "property_id",
    "check_in",
    "check_out",
    "adults"
  ]
}

Status, amounts, refund schedule, guest ID verification link, and when arrival details will be sent. Maps to GET /v1/bookings/{id}.

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string"
    }
  },
  "required": [
    "booking_id"
  ]
}

Send a question the property record and FAQ don't answer. The answer arrives later; tell the guest you'll follow up. Don't include the guest's contact details. Maps to POST /v1/properties/{id}/questions.

{
  "type": "object",
  "properties": {
    "property_id": {
      "type": "string"
    },
    "question": {
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "property_id",
    "question"
  ]
}

The conversation between the guest and the host about a booking, oldest first (including the guest's note with the request and the host's note when accepting or declining). Use it to relay the host's replies. Pass guest_email (the email the booking was made with) unless you connect with an agent token.

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string"
    },
    "guest_email": {
      "type": "string",
      "format": "email"
    }
  },
  "required": [
    "booking_id"
  ]
}

Send a message to the host on the guest's behalf, e.g. a question about check-in or a late arrival. Only send what the guest asked you to say. The host is emailed and replies appear in get_messages. Open from the request until two weeks after check-out.

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string"
    },
    "body": {
      "type": "string",
      "maxLength": 2000
    },
    "guest_email": {
      "type": "string",
      "format": "email"
    }
  },
  "required": [
    "booking_id",
    "body"
  ]
}

Two-step. First call with confirm=false to see what the guest gets back if they cancel now (nothing changes). Tell the guest that refund and get their go-ahead, then call again with confirm=true and expected_refund_cents set to the refund amount from the first call. If the refund changed in between, the call fails with refund_changed instead of cancelling. Refunds go to the guest's card automatically. Pass guest_email (the email the booking was made with) unless you connect with an agent token.

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string"
    },
    "confirm": {
      "type": "boolean"
    },
    "expected_refund_cents": {
      "type": "integer",
      "description": "Required when confirm is true: refund.amount from the confirm=false call."
    },
    "guest_email": {
      "type": "string",
      "format": "email"
    }
  },
  "required": [
    "booking_id",
    "confirm"
  ]
}

Request a stay from a quote. Set house_rules_accepted only after the guest has seen and agreed to the quote's house_rules. If the quote's payment.collected_by is "threshold", the booking starts as awaiting_payment and the response includes payment_url: the guest must open payment_url and add a card within 60 minutes, after which the host gets the request (status pending_host_confirmation). Otherwise the request goes to the host immediately and the host arranges payment after accepting. Returns the booking and a status link to give the guest; poll get_booking for changes.

{
  "type": "object",
  "properties": {
    "quote_id": {
      "type": "string"
    },
    "first_name": {
      "type": "string"
    },
    "last_name": {
      "type": "string"
    },
    "email": {
      "type": "string",
      "format": "email"
    },
    "phone": {
      "type": "string"
    },
    "house_rules_accepted": {
      "type": "boolean"
    },
    "special_requests": {
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "quote_id",
    "first_name",
    "last_name",
    "email",
    "house_rules_accepted"
  ]
}