What you can build
- Discovery & storefront — Browse cities, collections, and thousands of experiences. Build a branded storefront powered by Headout’s supply.
- Real-time booking — Check live availability, collect guest details, and create bookings with instant or delayed confirmation.
- Post-booking management — Track booking status, deliver tickets, handle cancellations and reschedules — all via API or webhooks.
- Affiliate deep-linking — Show Headout inventory in your storefront and hand off checkout to Headout with attributed deep links.
Two integration paths
Headout supports two partner types, each with its own API surface and level of control.API overview
The API is organized around the booking lifecycle:How the docs are organized
Essential resources
How it works
Understand the booking lifecycle — discovery, availability, booking, and post-booking — before you start building.
Setup
Read the technical rules that shape authentication, versioning, payloads, and responses before you follow the walkthrough.
Integration walkthrough
End-to-end flows for API Partners and Affiliates.
Key concepts
The core model — cities, products, variants, inventory, pricing, bookings, tickets — and the rules that govern how they fit together.
Launch checklist
Use this when you are ready to build and validate the integration before launch.
Enums and error codes
Reference material for implementers who need exact values, statuses, and validation rules.
Updates
What's new
Recent changes and release notes.
Upcoming releases
Planned work and near-term roadmap items.