Partner integrations

Connect your runtime to bookable hotel supply.

Hostrail is the booking layer for AI agents. Start from machine-readable discovery, then move through search, quote, hold, booking and guest follow-up on the same platform.

Request sandbox access Open full docs site

Builder line

Integrate once, access bookable hotel supply.

Responses preserve next_actions, trace IDs and stable error semantics so agents can retry, hand off or recover without inventing missing control flow.

Typed

Stable request and response shapes for quote, hold and booking operations

Traceable

Request IDs and explicit next actions for recovery

Scoped

Hotel coverage is limited to onboarded inventory and visible routes

REST API for typed orchestration

Remote MCP when the endpoint is enabled

Public hotel pages and markdown for retrieval

Discover

Fetch machine-readable routes first.

Start from Agent Card, OpenAPI and markdown routes before a runtime tries to infer capability from the human UI.

Integrate

Use quote before hold or booking.

Quote is where price, cancellation and expiry become current. Do not treat markdown or static hotel pages as final booking confirmation.

Operate

Plan for retries and handoff.

Receipts, audit surfaces and deterministic errors make retries and human escalation explicit instead of implied.

5-minute evaluator path

Start from one live property instead of abstract placeholders.

When live supply is available, this page hydrates a concrete property, room type and rate plan so an evaluator can move straight into quote creation. If no sample appears, the platform may still be up while inventory is unavailable.

No live property sample is available right now. Fetch property, room type and rate-plan IDs first, then continue with the quote flow.

Read first

Three URLs to fetch before a booking attempt.

Agent Card

https://api.agenthotel.dev/.well-known/agent-card.json

Fetch capability and auth metadata first.

Use this before tool selection so the runtime can see supported flows, auth expectations and available endpoints.

OpenAPI

https://api.agenthotel.dev/openapi.json

Pull the typed contract before calling write flows.

Use this for request, response and error shapes, especially on quote, hold, booking and receipt flows.

Docs site

https://docs.hostrail.dev

Use the canonical docs for concepts, quickstarts and error semantics.

This is the primary human-readable reference for agent integrations, recovery patterns and booking flow details.

Machine context

/llms-full.txt

Use markdown context for retrieval and planning.

Useful for hotel, room-plan and policy grounding. Do not treat markdown as the final price or cancellation source of truth.

Practical limits

Do not treat every surface the same way.

Use quote output as the current source of truth for price and cancellation terms.

Hotel descriptions may contain publisher-written marketing language.

Coverage is limited to onboarded inventory and city rollout is incremental.

MCP availability depends on environment configuration.

Execution path

One explicit path from discovery to confirmation.

The goal is not just API coverage. It is giving the runtime a path it can reason about, retry and audit without inventing missing state.

Retrieve hotel, room-type and policy context.

Quote

Confirm current price, taxes, cancellation and expiry.

Hold

Reserve availability while payment or confirmation is pending.

Book

Create the booking and persist the booking reference.

Service

Use guest portal or booking APIs for follow-up.

Automation-ready primitives

Search and ranking-ready hotel inventory

Short-lived quotes with policy snapshots and expiry timestamps

Inventory holds with idempotent confirmation semantics

Booking receipts, audit evidence and recovery endpoints

Copy-paste examples

Run the full direct-booking flow from your terminal.

These snippets target the same commerce API the agent runtime calls. When a live sample exists, the quote snippet is already hydrated with real IDs.

Full machine surface

1. List properties

curl -s 'https://api.agenthotel.dev/v1/properties' \
  -H 'accept: application/json'

2. Create quote

curl -s -X POST 'https://api.agenthotel.dev/v1/quotes' \
  -H 'content-type: application/json' \
  -d '{
    "hotel_id": "<property_id>",
    "room_type_id": "<room_type_id>",
    "rate_plan_id": "<rate_plan_id>",
    "check_in": "2026-05-02",
    "check_out": "2026-05-04",
    "adults": 2
  }'

3. Hold inventory

curl -s -X POST 'https://api.agenthotel.dev/v1/holds' \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: hold-demo-001' \
  -d '{ "quote_id": "<quote_id>" }'

4. Confirm booking

curl -s -X POST 'https://api.agenthotel.dev/v1/bookings' \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: booking-demo-001' \
  -d '{
    "quote_id": "<quote_id>",
    "hold_id": "<hold_id>",
    "payment_intent_id": "<payment_intent_id>",
    "guest": { "full_name": "Alex Nguyen", "email": "alex@example.com", "phone": "+84900111222" }
  }'

5. Verify receipt

curl -s -X POST 'https://api.agenthotel.dev/v1/receipts/verify' \
  -H 'content-type: application/json' \
  -d '{ "receipt": <receipt_from_booking_response> }'