---
title: "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."
method: POST
path: "/api/public/v1/stay-quotes"
---

# 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

- object
  - `id` string, required
  - `arrival` string, date, required
  - `departure` string, date, required
  - `guests` integer, 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 `200`

Current public facts

- object
  - `propertyId` string, required
  - `arrival` string, date, required
  - `departure` string, date, required
  - `guests` integer, required
  - `nights` integer, required
  - `roomSelection` object
    - `name` string, required
    - `ratePlan` string
    - `rooms` 1, required
    - `averageNightlyPrice` object
      - `currency` string, required
      - `amount` number, 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
  - `minimumNights` integer, nullable, required
  - `partyBasis` 'all_adults'
  - `price` object, nullable, required
    - `currency` string, required
    - `total` number, required
    - `breakdown` object[], required
      - `label` string, required
      - `amount` number, required
    - `completeness` 'total' | 'partial', required
    - `taxesIncluded` boolean, nullable, required
  - `startingNightlyPrice` object
    - `currency` string, required
    - `amount` number, required
  - `checkedAt` string, date-time, required
  - `expiresAt` string, date-time, required
  - `sourceUrl` string, uri, required
  - `bookingUrl` string, uri, required
  - `held` false, required

## Other responses

- `400`: Invalid or unknown filters
- `404`: Property unavailable or unpublished
- `429`: Rate limit; respect Retry-After

---

[API](https://skmtc.dev/chucho/apis/chucho-public-property-discovery.md) · [All operations](https://skmtc.dev/chucho/apis/chucho-public-property-discovery/llms.txt) · [OpenAPI document](https://skmtc.dev/chucho/apis/chucho-public-property-discovery/revisions/b80049fc8cf0?raw)