---
title: "Get a currently published property's host destination, reviewed bookingCapabilities and matching handoff instructions. Request-only homes accept a booking request; price-only readers cannot confirm availability. Unknown or expired capabilities never promise online quotes or checkout. Open the destination for the host's booking options. This tool never creates a reservation or takes payment."
method: GET
path: "/api/public/v1/properties/{id}/booking"
---

# Get a currently published property's host destination, reviewed bookingCapabilities and matching handoff instructions. Request-only homes accept a booking request; price-only readers cannot confirm availability. Unknown or expired capabilities never promise online quotes or checkout. Open the destination for the host's booking options. This tool never creates a reservation or takes payment.

`GET /api/public/v1/properties/{id}/booking`

## Request

- Base URL: `https://chucho.ai`
- URL: `https://chucho.ai/api/public/v1/properties/{id}/booking`
- Auth: none required

## Path parameters

- `id` string, required

## Query parameters

- `locale` 'en' | 'es'

## Response `200`

Current public facts

- object
  - `propertyId` string, required
  - `propertyName` string, required
  - `bookingUrl` string, uri, required
  - `bookingCapabilities` object, required
    - `mode` 'request' | 'quote' | 'price' | 'unknown' | 'unsupported', required
    - `verifiedAt` number
    - `expiresAt` number
  - `bookingProvider` 'host', required
  - `bookingStatus` 'requires_host_confirmation', required
  - `reservationCreated` false, required
  - `instructions` string, required
  - `action` object, required
    - `@type` 'CommunicateAction' | 'ViewAction', required
    - `name` string, required
    - `target` object, required
      - `@type` 'EntryPoint', required
      - `urlTemplate` string, uri, required
      - `actionPlatform` string[], 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)
