canonical: https://jentic.com/apis/hospitable.com/hospitable

# Hospitable Public API

The Hospitable Public API reads and manages short-term rental operations: it lists properties and their calendars, retrieves reservations and the guest message threads attached to them, sends messages back to guests, and reads and responds to reviews. It follows REST conventions and authenticates with a Bearer token, so an agent can run day-to-day host operations across a portfolio of listings.

## For AI agents

List properties and calendars, read reservations and guest message threads, send guest messages, and read and respond to reviews across 12 endpoints.

## Scope

Manages properties, calendars, reservations, guest messages, and reviews. Does not process payments, charge guests, or handle host payouts.

## Capabilities

- List properties and search across a rental portfolio
- Read and update a property's availability calendar
- Retrieve reservations and their details
- Read guest message threads and send replies on a reservation
- Read reviews for a property and respond to them
- Look up the authenticated host account

## Use cases

### Guest messaging assistant

An AI agent reads the message thread on a reservation and sends context-aware replies to guests, handling routine check-in questions across many listings without a host opening each conversation manually.

Example prompt: Read the latest message on reservation ABC123 and send the guest the check-in instructions

### Calendar management

An agent reads a property's availability calendar and updates it to block or open dates, keeping availability accurate across a portfolio from a single instruction.

Example prompt: Block the dates from 2026-12-24 to 2026-12-26 on the calendar for property XYZ

### Review response

An agent reads new reviews on a property and drafts or posts responses, helping a host keep up with guest feedback across listings.

Example prompt: Fetch the most recent review for property XYZ and respond with a short thank-you note

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/properties` | List the properties on the account |
| GET | `/properties/{uuid}/calendar` | Read a property's availability calendar |
| PUT | `/properties/{uuid}/calendar` | Update dates on a property's calendar |
| GET | `/reservations/{uuid}/messages` | Read the guest message thread for a reservation |
| POST | `/reservations/{uuid}/messages` | Send a message to the guest on a reservation |
| POST | `/reviews/{uuid}/respond` | Respond to a review |

## Key resources

- **Properties** — List and search rental listings on the account
- **Calendars** — Read and update per-property availability
- **Reservations** — Retrieve bookings and their details
- **Messages** — Read guest threads and send replies on a reservation
- **Reviews** — Read reviews and post responses

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 39 / 100
- **Maturity:** Non-Ready
- **Dimensions:**
  - Foundational Compliance: 71 / 100
  - Developer Experience & Jentic Compatibility: 65 / 100
  - AI-Readiness & Agent Experience: 16 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 83 / 100
- **View full report:** https://jentic.com/apis/hospitable.com/hospitable/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Hospitable by hand means provisioning a Bearer token, attaching it to every request, and paging through properties, reservations, and message threads yourself. Through Jentic you install once, import the Hospitable Public API from the Directory, store the token once, and your agent calls it.
- **Permission scoping:** Property and reservation ids are path parameters, so scope by operation and by resource: allow reading calendars, reservations, and guest threads while withholding calendar writes and outbound guest messages, or restrict the agent to one property.
- **Credential handling:** Your Hospitable Bearer token credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent, such as 'read the message thread for a reservation' or 'block dates on a property calendar', and Jentic returns the matching Hospitable Public API operation with its input schema so the agent calls the right endpoint without reading the reference docs by hand.

## Related APIs

- **Cloudbeds API** — Property management for hotels and larger lodging operations
- **Smily (BookingSync) API** — Vacation rental management with bookings, clients, and rentals
- **Hostfully API** — Property management platform for short-term rental hosts
- **OwnerRez API** — Vacation rental bookings, channels, and guest management

## FAQ

### What can an AI agent do with the Hospitable Public API?

An agent can list properties and calendars, read reservations and their guest message threads, send replies to guests, and read and respond to reviews, covering routine short-term rental host operations.

### How do I connect the Hospitable Public API to an AI agent with Jentic?

Import the Hospitable Public API from the Jentic API Directory, store your Bearer token once, and your agent calls the operations it needs. To get started, install the self-hosted Jentic One runtime from its GitHub repository and import the Hospitable Public API from the Jentic API Directory.

### What authentication does the Hospitable Public API use?

Requests carry a Bearer token, passed with the Bearer prefix in the Authorization header. Jentic One stores that token encrypted in your own instance and attaches it at execution time.

### Can I limit what my agent is allowed to do with the Hospitable Public API?

Yes. Property and reservation ids are path parameters, so you can scope the agent by operation and by resource: permit reading calendars, reservations, and messages while withholding calendar updates and outbound messages, or confine it to a single property.

### Does the Hospitable Public API handle payments or payouts?

No. It manages properties, calendars, reservations, messages, and reviews, but it does not process payments, charge guests, or move host payouts.