FeaturesHeadless Guest Experience
Headless · Developer API

Your interface.
Our engine.

Keep the front end you've already built — your app, your site, your kiosk, your brand — and power it with HolidayHero's guest-experience backend. Stays, guidebooks, upsells and the AI Concierge, all over a single GraphQL API.

GraphQL
+ subscriptions & SDK
100%
your front end & brand
EU
hosted · GDPR-ready
HolidayHero APIv1
POST /graphql
query {
  stay(id: "9F3K2") {
    guest language status
  } }
{
  "data": {
    "stay": {
      "guest": "Sophie Bergmann",
      "language": "es",
      "status": "in_stay"
    } } }
Render it in your own UI — your design, our data.
You keep the front end and the brand.We run the stay underneath it.

What is headless?

Front end and backend, cleanly separated.

"Headless" means the guest-facing interface is decoupled from the engine that powers it. You own and design the experience; HolidayHero handles the heavy backend — guest data, content, payments and AI — and serves it through an API.

No backend to build or maintain, no inconsistent branding, and the freedom to ship and adapt fast.

Your front end
Your appYour websiteKiosk · in-room
API
HolidayHero engine
Stays & guestsGuidebooks & contentUpsells & folioAI Concierge

The API

One API for the whole stay.

Pick an operation to see what comes back.

One typed endpoint — ask for exactly the fields you need, no over-fetching or version churn. Token-authenticated, scoped per property.

querystay200
{
  "data": {
    "stay": {
      "id": "9F3K2",
      "guest": "Sophie Bergmann",
      "language": "es",
      "property": "Villa Maritiem",
      "status": "in_stay"
    }
  }
}

Build with

Everything you need to ship.

GraphQL API

One typed, documented endpoint — query exactly the fields you need across stays, guests, content and commerce.

Subscriptions & webhooks

Real-time events — check-in completed, order placed, message received — over GraphQL subscriptions or webhooks.

Embeddable components

Drop-in guest-app modules and an SDK, themed to your brand — when you don't want to build from scratch.

AI Concierge API

Send a guest message, get a sourced answer back — grounded in the guidebook, in any language.

Multilingual content

Guidebooks and upsells come back auto-translated — request any locale on the fly.

Secure & compliant

Scoped API keys, token auth, EU-hosted and GDPR-ready out of the box.

Integration levels

Pick how deep you go.

Start hosted and move toward fully headless whenever you're ready — the data model stays the same.

Level 1
Hosted

Go live on the HolidayHero guest app. No engineering — set up properties and launch.

No-code onboarding
Your logo, colours & domain
Fastest time to live
Start free
Level 2
Embedded

Drop our components and SDK into your own app — keep your UI, we handle the modules.

Embeddable components & SDK
Themed to match your app
Webhooks for key events
Talk to sales
Level 3
Fully headless

Build entirely on our backend over the API. Total control, real-time sync, your stack.

Full GraphQL API & subscriptions
Your front end, end to end
Sandbox, keys & support
Read the docs
Seamless integration

Connect to the systems you already run — no rip-and-replace.

Flexibility & control

Own the experience end to end and adapt it whenever you need.

Rapid time to market

Skip the backend build and launch in a fraction of the time.

Cost saving

No infrastructure to build, host or maintain — we carry it.

Start building

Get your sandbox keys.

Read the reference, grab a test key and make your first call in minutes. Talk to us when you're ready for production.

# install the SDK
npm i @holidayhero/sdk
# or call it directly
curl api.holidayhero.com/graphql \
  -H "Authorization: Bearer …" \
  -d '{"query":"{ stay(id:..){ guest } }"}'

Build the experience. We'll run the stay.

Plug HolidayHero's guest-experience engine into your own software — and ship faster, with less to maintain.