> For the complete documentation index, see [llms.txt](https://adrasis.gitbook.io/developer/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adrasis.gitbook.io/developer/readme.md).

# Overview

Integrate hotels, vacation rentals, villas, and apartments through a single canonical REST API: property content, real-time availability and rates, prebook, book, and cancel.

The Distribution Partner API exposes one REST contract for hotels, vacation rentals, villas, and apartments. Clients do not branch by property type:

```
content  →  search  →  prebook  →  book  →  (poll)  →  cancel
```

* **Content:** Ingest and cache property catalogue: names, photos, room types, location, check-in rules and important information. Delta-synced.
* **Search:** Compare 1..100 properties with exact top-1 bulk search, search a whole place sorted and filtered, or inspect the best allocation and every room product through the single-property detail route.
* **Prebook:** Send a whole-party `selection_token`, or one to nine room product proofs as `selection_tokens`, to revalidate its sealed slots and lock price + cancellation policy behind a short-lived token.
* **Book:** Finalize the reservation idempotently.
* **Cancel:** Quote the penalty, then cancel.

The same search → prebook → book sequence applies to three other verticals: [Transfers](/developer/transfers.md), [Tours](/developer/tours.md), and [Flights](/developer/flights.md).

Two or more selected offers can be sold **as one contract**. [Package booking](/developer/package-booking.md) composes them into a single atomic booking with one inclusive price: either every service confirms, or nothing does. If instead you only need to group bookings you already confirmed, keeping their separate totals and lifecycles, use [Trip bundling](/developer/trip-bundling.md).

## Base URL

```
https://ari.console.adrasis.com/api/v1
```

All field names are `snake_case`, all dates are ISO 8601, all currencies are ISO 4217, and resources use opaque `public_id` values except hotels. A hotel is addressed by its Adrasis hotel id, a decimal string such as `"72259"`. Use it unchanged in every hotel field, even one named `property_public_id`. See [Hotel id](/developer/property-content.md#hotel-id). A place is addressed by its Adrasis place id, a decimal string such as `"87066"`, and a country by its ISO code such as `"TR"`. See [Place id](/developer/property-content.md#place-id).

## Where to start

1. [Getting started](/developer/getting-started.md): Obtain credentials and make your first authenticated call.
2. [Authentication](/developer/authentication.md): Use the OAuth 2.0 client-credentials flow.
3. [Property content](/developer/property-content.md): Build and refresh your catalogue.
4. [Currencies, occupancy & allocations](/developer/currencies-occupancy-allocations.md): Choose bulk or detail and express strict or flexible occupancy.
5. [The booking flow](/developer/booking-flow.md): Follow search → prebook → book → cancel.
6. [Transfers](/developer/transfers.md), [Tours](/developer/tours.md), [Flights](/developer/flights.md): The other product verticals follow the same three-step sequence.
7. [Package booking](/developer/package-booking.md): Sell several services as one atomic, single-price booking.
8. [Trip bundling](/developer/trip-bundling.md): Group confirmed bookings into one trip.
9. [Booking webhooks](/developer/booking-webhooks.md): Receive signed lifecycle events.
10. [API reference](/developer/api-reference.md): Use the interactive specification.

Building an AI agent? See [AI agent integration (MCP)](/developer/ai-agents-mcp.md). The published site also serves an LLM-readable index at `/llms.txt`.