Hostrail
The booking layer for AI agents.
Canonical docs for Hostrail's bookable hotel supply: public machine surfaces on `hostrail.dev`, typed contracts on `api.hostrail.dev`, and recovery-safe booking flows for agent and developer runtimes.
Docs site is AI-readable too
Public machine surfaces
Typed contracts + OpenAPI
Retry-safe quote, hold, booking
4
Core flow steps
44
Error codes
100%
Envelope coverage target
Reference flow
POST /v1/search
POST /v1/quotes
POST /v1/holds
POST /v1/bookings
POST /v1/quotes
POST /v1/holds
POST /v1/bookings
Envelope contract
Every response follows the same shape. Match on error.code, follow next_actions.
Discovery surfaces
llms.txt, capabilities.json, Agent Card, OpenAPI, MCP metadata.
44 error codes
Stable codes with remediation and recovery actions. Agents never guess.
Idempotent by design
Holds and bookings are safe to retry. Even failed payments are sealed.