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

# LivBnB Partner API

The LivBnB Partner API powers vacation rental search and booking for LivBnB properties. It searches available properties, returns property details, calendar availability, and price breakdowns, creates bookings and retrieves booking details, and exposes the partner FAQ, terms, and privacy content.

## For AI agents

Search vacation rental properties, read details, availability, and price breakdowns, create bookings, and look up booking details. Authenticates with a Bearer token in the Authorization header.

## Scope

Does not process payments or manage property listings. Use the LivBnB Partner API for property search, availability, pricing, and booking only.

## Capabilities

- Search available properties by criteria
- Get details for a specific property
- Check the calendar availability for a property
- Get a price breakdown for a property
- Create a booking
- Retrieve details for an existing booking

## Use cases

### Property Search and Discovery

An AI agent connected through Jentic can help a traveler find a place to stay. It searches available properties by the traveler's criteria and returns matching listings with their details, so an assistant can shortlist options without a manual browse of the site.

Example prompt: Search for available properties matching a location and date range and return the top matches

### Availability and Pricing Checks

Before booking, an agent needs to confirm dates and cost. The LivBnB Partner API returns a property's availability calendar and a price breakdown, letting an assistant confirm that a stay is bookable and quote the total before committing.

Example prompt: Check availability for a property over a date range and return the price breakdown

### Booking Creation

Once a stay is chosen, the agent can complete the reservation. The API creates a booking and returns its details, so an assistant can turn a confirmed selection into a reservation and read back the booking reference.

Example prompt: Create a booking for a selected property and return the booking details

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/properties/search` | Search available properties |
| GET | `/properties/{id}/availability` | Get a property's availability calendar |
| GET | `/properties/{id}/pricebreakdown` | Get a property's price breakdown |
| POST | `/booking` | Create a booking |
| GET | `/booking/{id}` | Get booking details |

## Key resources

- **Properties** — Property search and details
- **Availability** — Calendar availability for a property
- **Pricing** — Price breakdown for a property
- **Booking** — Create and retrieve bookings
- **Policies** — Partner FAQ, terms, and privacy content

## Why Jentic

- **Setup:** Wiring the LivBnB Partner API by hand means obtaining a partner token, building search and availability queries, and threading the token through every call yourself. Through Jentic you install once, import LivBnB from the API Directory, store the token once, and your agent calls the property and booking operations directly.
- **Permission scoping:** You choose which of the operations your agent may call. You might allow property search, availability, and pricing while blocking booking creation, so the agent can research without committing a reservation.
- **Credential handling:** Your LivBnB partner token 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 'search available properties', and Jentic returns the matching LivBnB operation with its input schema so the agent calls it with the right criteria.

## Related APIs

- **Booking.com** — Accommodation search and reservations across a large lodging inventory
- **Amadeus** — Travel data for flights, hotels, and trip planning
- **Stripe** — Payments platform for charging cards and handling checkout

## FAQ

### What authentication does the LivBnB Partner API use?

The LivBnB Partner API authenticates with a Bearer token in the Authorization header, per its OpenAPI spec. Through Jentic the token is stored once, encrypted, by your own self-hosted instance and injected when the agent calls, so it never appears in the agent's prompt or logs.

### Can I limit what my agent is allowed to do with the LivBnB Partner API?

Yes. You choose which operations the agent may call. You might allow property search, availability, and pricing lookups while blocking booking creation, so the agent can research stays without committing a reservation, with every call logged by your own instance.

### Is there a LivBnB MCP server?

You don't need an MCP server to give your agent the LivBnB Partner API. Jentic connects it directly from the API Directory: import it, store your token once, and your agent calls the property and booking operations. Operations are discovered on demand, so nothing extra loads into the agent's context.

### What are the rate limits for the LivBnB Partner API?

The OpenAPI spec does not define rate limits. Check the LivBnB partner documentation for current limits before running high-volume property searches.

### What can the LivBnB Partner API do?

It handles the vacation rental journey for LivBnB properties: search available properties, read their details, check availability and price breakdowns, create bookings, and retrieve booking details, plus access to partner FAQ, terms, and privacy content.

### How do I check property availability through Jentic?

Search Jentic by intent, for example 'check property availability', and Jentic returns the matching LivBnB operation with its input schema. Your agent supplies the property and date range and reads back the availability. To run it on your own infrastructure, install Jentic One from its GitHub repo.