Check dates and total pricing on a published property's public host website. Send its property id, arrival/departure (YYYY-MM-DD) and guests; no guest contact or card details. Availability may be unknown even when a price is returned. Optional startingNightlyPrice is an advertised starting nightly rate, separate from price.total; never multiply it into a stay total or infer dates, party, fees or tax coverage. partyBasis:all_adults means every occupant was priced as an adult; disclose that assumption, since child ages are not collected. Inspect reason, price.completeness, actual currency, checkedAt and expiresAt. Optional execution:browser requests the experimental selected-home browser agent on reviewed Stays sites and may take up to two minutes including source discovery; omit it for fast automatic execution. Search never starts this agent. Recent matching quotes may be reused until expiry; a pending search check is joined rather than repeated. The host may create an expiring anonymous price draft. A quote never reserves or confirms a booking; held is always false. Unsupported/protected sites return unknown. No host integration or credentials are required.

post/api/public/v1/stay-quotes

Request

  • Base URL: https://chucho.ai
  • URL: https://chucho.ai/api/public/v1/stay-quotes
  • Auth: none required

Request body

idstring required
arrivalstring date required
departurestring date required
guestsinteger required
currency'USD' | 'EUR' | 'GBP' | 'CRC' | 'MXN' | 'COP' | 'PEN' | 'BRL' | 'AUD'
execution'auto' | 'browser'

Selected-home execution only. Default auto prefers the fast supported reader. browser requests the slower experimental quote-only agent on reviewed Stays sites; unsupported sites return unknown. Search never starts this agent.

Response

Current public facts

propertyIdstring required
arrivalstring date required
departurestring date required
guestsinteger required
nightsinteger required
availability'available' | 'unavailable' | 'unknown' required
reason'checked' | 'blocked_dates' | 'minimum_stay' | 'maximum_stay' | 'arrival_departure_rules' | 'advance_notice' | 'capacity' | 'unsupported_host' | 'browser_unconfigured' | 'upstream_unavailable' | 'date_range_unknown' required
minimumNightsinteger nullable required
partyBasis'all_adults'
checkedAtstring date-time required
expiresAtstring date-time required
sourceUrlstring uri required
bookingUrlstring uri required
heldfalse required

Changes

No recorded changes to this operation across all 1 revision of this API.