Agentic Hospitality

What the Turneo API covers, service by service

Turneo runs 13 families of hotel services beyond the room. Most are bookable experiences, and the public API covers them end to end: catalogue, live availability, booking orders, staff operations and booking data. Some needs (choosing a specific spot or table, retail stock, gift vouchers) are handled in Turneo’s own apps today, and a few belong to another system.

Every operation named below is in the API reference. For which system owns what across the hotel, see the agentic hotel stack. Last checked 2026-11-19; the whole matrix is also available as JSON.

Public API
Covered by documented operations.
Public API, with limits
Covered, with the limits in the note.
Turneo product only
Turneo does it, in its own apps; there is no public API for it yet.
Another system
Owned by a system other than Turneo.

Every family

What holds for every service

Authentication
Every request carries an X-API-Key. The key is scoped to one Turneo partner account: its own experiences and bookings, plus experiences other partners share with it.
Several hotels
One partner account covers all its properties and stores. Filter experiences and bookings by store or property; there is no operation to list properties.GET /v2/experiencesGET /v2/bookings
Partners and commission
Experiences can be shared with chosen partners, with commission rates per partner, and every booking records the commission. Partner onboarding, payouts and invoices stay in Turneo.GET /v2/experiences/{id}GET /v2/bookings/digest
Retries
Confirming an order that is already confirmed returns it unchanged, so a confirm is safe to retry. Creating an order isn't: a retried create makes a second order, so keep the first order's ID.POST /v2/booking-orders/{id}/confirmPOST /v2/booking-orders

Spa and wellness

Public API: 7 in full, 4 with limits

Treatments, massages and wellness sessions, each needing a qualified therapist and a treatment room.

Inventory: Appointment. A duration, plus the staff member and room the booking needs, with time to turn over between guests.

Staff-facing agent
Tomorrow's treatments, with the therapist and room each one is assigned to, and which are still unpaid.
Guest-facing agent
Recommend a 60-minute massage during the guest's stay, check live slots, and book the one they pick.
Boundaries
An agent can request a specific therapist or room, or let Turneo assign them by the spa's rules. Health notes a guest shares belong in the booking, never in agent logs.
Spa and wellness in Turneo
Capacity and resourcesPublic API, with limits

Therapists and treatment rooms are set up and scheduled in Turneo. Read them on the option, and a booking shows who and which room it's assigned to.

BookingPublic API

Request a specific therapist or room by passing their IDs on the booking, or let Turneo assign them by the spa's rules. Staff can reassign afterwards.

PaymentPublic API, with limits

Send the guest a payment link, or record a payment the hotel took itself. Payment status is separate from booking status. There is no operation to charge a card directly.

Room chargePublic API

Confirm the order as charged to the room, with the guest's room number. Turneo posts the charge to the guest's folio in the PMS.

FulfilmentPublic API, with limits

Mark a booking completed or a no-show, and resend its confirmation. There is no check-in or ticket-scanning operation.

ReportingPublic API, with limits

One row per booking, with the assigned therapist and room on each booking. Therapist and room utilisation stays in Turneo.

Hotel experiences

Public API: 7 in full, 4 with limits

The hotel's own activities: cooking classes, tastings, yoga, guided walks, signature dinners.

Inventory: Session. A scheduled time with group capacity, and often rules on who can join (age, level).

Staff-facing agent
Which of this week's in-house sessions are under-booked, and how many places each has left.
Guest-facing agent
Suggest activities that fit the guest's dates and interests, and book places on a session.
Boundaries
A booked place is not attendance: whether the guest showed up is recorded when staff complete or mark the booking.
Hotel experiences in Turneo
Capacity and resourcesPublic API, with limits

Slot capacity can be read and overridden. The staff, rooms and equipment behind it are set up and scheduled in Turneo; a booking shows the ones assigned to it.

BookingPublic API

A booking order holds the slots for 15 minutes; confirming it turns the holds into bookings.

PaymentPublic API, with limits

Send the guest a payment link, or record a payment the hotel took itself. Payment status is separate from booking status. There is no operation to charge a card directly.

Room chargePublic API

Confirm the order as charged to the room, with the guest's room number. Turneo posts the charge to the guest's folio in the PMS.

FulfilmentPublic API, with limits

Attendance is recorded by marking a booking completed or a no-show. There is no check-in operation.

ReportingPublic API, with limits

One row per booking with price, currency, commission and status, plus an activity feed of changes. Totals are yours to compute; utilisation and revenue dashboards stay in Turneo.

Kids' clubs and academies

Public API: 6 in full, 5 with limits

Kids' club sessions and sports or arts academies, booked by session with age-based places.

Inventory: Session. A scheduled time with group capacity, and often rules on who can join (age, level).

Staff-facing agent
Tomorrow's sessions, places taken and places left, for the team planning staff ratios.
Guest-facing agent
Find a session that suits the child's age and the family's dates, and book it with the parent's confirmation.
Boundaries
Only a parent or guardian books, and the agent checks the child's age against the session's range: the API doesn't. Consent forms, medical details and who may collect a child stay in the club's own safeguarding process; ask for the minimum about children.
Capacity and resourcesPublic API, with limits

Slot capacity can be read and overridden. The staff, rooms and equipment behind it are set up and scheduled in Turneo; a booking shows the ones assigned to it.

PricingPublic API

Participant types carry an age range and their own prices.

BookingPublic API, with limits

The API doesn't check a child's age against the participant type's range: your agent must. Details about the child go in the option's booking questions.

PaymentPublic API, with limits

Send the guest a payment link, or record a payment the hotel took itself. Payment status is separate from booking status. There is no operation to charge a card directly.

Room chargePublic API

Confirm the order as charged to the room, with the guest's room number. Turneo posts the charge to the guest's folio in the PMS.

FulfilmentPublic API, with limits

No attendance, sign-in or collection tracking in the API; those stay with the club's own process.

ReportingPublic API, with limits

One row per booking with price, currency, commission and status, plus an activity feed of changes. Totals are yours to compute; utilisation and revenue dashboards stay in Turneo.

Local tours and partner experiences

Public API: 6 in full, 5 with limits

Tours, excursions and activities run by vetted local partners, sold by the hotel with commission.

Inventory: Supplier-owned. Availability and confirmation belong to the partner who runs it; the hotel earns commission.

Staff-facing agent
Partner bookings still waiting for the operator to accept, and what the hotel earned in commission this month.
Guest-facing agent
Recommend an excursion for the guest's free day, check the operator's live slots, and book it.
Boundaries
The partner owns availability, confirmation and the cancellation terms; a booking can wait for the operator to accept it. Tell the guest who runs the tour.
Local tours and partner experiences in Turneo
Capacity and resourcesPublic API, with limits

Slot capacity can be read and overridden. The staff, rooms and equipment behind it are set up and scheduled in Turneo; a booking shows the ones assigned to it.

BookingPublic API

A booking can stay PENDING until the partner accepts it. Bookings from partners on their own reservation system are confirmed there.

PaymentPublic API, with limits

Send the guest a payment link, or record a payment the hotel took itself. Payment status is separate from booking status. There is no operation to charge a card directly.

Room chargePublic API

Confirm the order as charged to the room, with the guest's room number. Turneo posts the charge to the guest's folio in the PMS.

Staff operationsPublic API, with limits

Accepting and rejecting are the partner's. Bookings synced from a partner's own system can't be rescheduled through Turneo.

FulfilmentPublic API, with limits

Mark a booking completed or a no-show, and resend its confirmation. There is no check-in or ticket-scanning operation.

ReportingPublic API, with limits

Each booking row carries the hotel's commission. Partner payout statements stay in Turneo.

Events and ticketing

Public API: 7 in full, 4 with limits

In-house dinners, live music and themed nights, plus tickets for local concerts and festivals.

Inventory: Ticket. Admission to a dated event, by ticket type, up to the event's capacity.

Staff-facing agent
The guest list and ticket count for tonight's event, by ticket type.
Guest-facing agent
Find what's on during the stay and reserve tickets for the party.
Boundaries
If the event itself is cancelled, the hotel cancels the dated slot, which cancels every booking on it.
Events and ticketing in Turneo
Capacity and resourcesPublic API, with limits

Slot capacity can be read and overridden. The staff, rooms and equipment behind it are set up and scheduled in Turneo; a booking shows the ones assigned to it.

BookingPublic API

A booking order holds the slots for 15 minutes; confirming it turns the holds into bookings.

PaymentPublic API, with limits

Send the guest a payment link, or record a payment the hotel took itself. Payment status is separate from booking status. There is no operation to charge a card directly.

Room chargePublic API

Confirm the order as charged to the room, with the guest's room number. Turneo posts the charge to the guest's folio in the PMS.

FulfilmentPublic API, with limits

Upload a pool of ticket codes for an option; guests receive them in their confirmation. No scanning or check-in.

Cancellation and refundsPublic API

Cancelling a dated slot cancels and refunds every booking on it.

ReportingPublic API, with limits

One row per booking with price, currency, commission and status, plus an activity feed of changes. Totals are yours to compute; utilisation and revenue dashboards stay in Turneo.

Sunbeds, beach and cabanas

Public API: 6 in full, 5 with limits

Sunbeds, double beds, cabanas and VIP loungers on the beach or pool deck, sold from a live map.

Inventory: Spot or table. A specific place (a sunbed, a cabana, a table) in a zone, for a time window.

Staff-facing agent
Tomorrow's bookings and the spot each one is assigned to, so the beach team can set up before guests arrive.
Guest-facing agent
Reserve a cabana for tomorrow afternoon for two adults and a child.
Boundaries
The map and its zones are designed in Turneo. An agent can book the exact spot the guest picks, or let Turneo assign one; closures and weather changes are handled by the beach team.
Sunbeds, beach and cabanas in Turneo
Capacity and resourcesPublic API, with limits

The beach or pool map and its zones are designed in Turneo. Every spot is a resource you can read on its option.

AvailabilityPublic API, with limits

Availability is per spot type (an option); whether a chosen spot is free is checked when you book it.

BookingPublic API

Book the exact spot the guest picks by passing it on the booking, or let Turneo assign one. Staff can move the guest afterwards.

PaymentPublic API, with limits

Send the guest a payment link, or record a payment the hotel took itself. Payment status is separate from booking status. There is no operation to charge a card directly.

Room chargePublic API

Confirm the order as charged to the room, with the guest's room number. Turneo posts the charge to the guest's folio in the PMS.

FulfilmentPublic API, with limits

Mark a booking completed or a no-show, and resend its confirmation. There is no check-in or ticket-scanning operation.

ReportingPublic API, with limits

One row per booking, with the assigned spot. Occupancy by zone stays in Turneo.

Dining and F&B

Public API: 6 in full, 3 with limits

Table reservations across restaurants, bars and patios, chef's tables, tasting menus and private dining.

Inventory: Spot or table. A specific place (a sunbed, a cabana, a table) in a zone, for a time window.

Staff-facing agent
Tonight's reservations and covers by restaurant, with special requests the kitchen should see.
Guest-facing agent
Find a table for four at 8pm in the restaurant that suits the guest's tastes, and reserve it.
Boundaries
Turneo holds the reservation; the bill belongs to the restaurant's POS. Allergies go in the booking's special requests, and the kitchen confirms them.
Dining and F&B in Turneo
Capacity and resourcesPublic API, with limits

Tables and the floor plan are set up in Turneo. Every table is a resource you can read on its option.

BookingPublic API

Covers are the booking's participant counts. Reserve a specific table by passing it on the booking, or let Turneo assign one.

PaymentAnother system

The meal is paid through the restaurant's POS. Turneo holds the reservation, not the bill.

Room chargeAnother system

The bill goes from the POS to the PMS. Turneo doesn't post restaurant checks.

FulfilmentPublic API, with limits

Mark a booking completed or a no-show, and resend its confirmation. There is no check-in or ticket-scanning operation.

ReportingPublic API, with limits

One row per booking with price, currency, commission and status, plus an activity feed of changes. Totals are yours to compute; utilisation and revenue dashboards stay in Turneo.

Rentals

Public API: 7 in full, 4 with limits

Bikes and e-bikes, kayaks and paddleboards, courts, beach gear and vehicles, by the hour or the day.

Inventory: Rental asset. A physical item with a pickup and a return, out of service while it's out or being serviced.

Staff-facing agent
Today's pickups and returns, and which items go out next.
Guest-facing agent
Reserve two e-bikes for tomorrow morning and tell the guest where to pick them up.
Boundaries
An agent can reserve a specific bike or boat, or let Turneo assign one. Deposits, damage and the handover stay with the hotel's team at pickup and return.
Rentals in Turneo
Capacity and resourcesPublic API, with limits

The fleet's bikes, boats and items are set up and scheduled in Turneo. Every unit is a resource you can read on its option.

BookingPublic API

Booked by duration. Reserve a specific unit by passing it on the booking, or let Turneo assign one; staff can swap it.

PaymentPublic API, with limits

Same as other services: payment link or a payment the hotel took. Deposits and damage charges are handled at the desk.

Room chargePublic API

Confirm the order as charged to the room, with the guest's room number. Turneo posts the charge to the guest's folio in the PMS.

FulfilmentPublic API, with limits

Completion and no-show only. Pickup, return and late returns are handled by the team, not the API.

ReportingPublic API, with limits

One row per booking with price, currency, commission and status, plus an activity feed of changes. Totals are yours to compute; utilisation and revenue dashboards stay in Turneo.

Transfers

Public API: 7 in full, 3 with limits

Airport pickups, shuttles and point-to-point rides, with a vehicle for the party and an assigned driver or partner.

Inventory: Ride. A pickup time and route, a vehicle that fits the party, and a driver or partner to run it.

Staff-facing agent
Tomorrow's pickup manifest: times, party sizes and the driver assigned to each ride.
Guest-facing agent
Book an airport pickup for the guest's arrival flight.
Boundaries
Flight changes and driver dispatch are handled by the hotel's team or the transfer partner. Pickup details are personal data: share them only with the people running the ride.
Transfers in Turneo
Capacity and resourcesTurneo product only

Vehicles and drivers are set up and scheduled in Turneo. Vehicle classes are sold as variants.

BookingPublic API

A booking order holds the slots for 15 minutes; confirming it turns the holds into bookings.

PaymentPublic API, with limits

Send the guest a payment link, or record a payment the hotel took itself. Payment status is separate from booking status. There is no operation to charge a card directly.

Room chargePublic API

Confirm the order as charged to the room, with the guest's room number. Turneo posts the charge to the guest's folio in the PMS.

Staff operationsPublic API

Staff assign or change the vehicle and driver with reassign-resources, and move a pickup with reschedule.

FulfilmentPublic API, with limits

Flight tracking for airport pickups runs inside Turneo and isn't in the public API.

ReportingPublic API, with limits

One row per booking with price, currency, commission and status, plus an activity feed of changes. Totals are yours to compute; utilisation and revenue dashboards stay in Turneo.

Retail

Public API: 8 in full, 3 with limits

Branded merchandise, spa products, wine and in-room enhancements, sold on their own or with a booking.

Inventory: Product. Sold by quantity rather than time; optionally limited by a stock count.

Staff-facing agent
Products running low, and items sold but not yet delivered, so the boutique can restock and hand them over.
Guest-facing agent
Add a bottle of Champagne to the guest's spa booking in the same order, and charge it to the room.
Boundaries
Stock is taken when the order is confirmed, so check the available quantity just before. Tax and returns follow the hotel's own policy.
Retail in Turneo
CataloguePublic API

Products are experiences of type RETAIL (filter with experienceType); each variant with its own price is a SKU.

PricingPublic API

Each SKU carries its own price.

AvailabilityPublic API

The product shows each SKU's available quantity, net of what's held in other carts.

BookingPublic API

Add products to a booking order as retailItems, on their own or next to bookings. Stock is taken when the order is confirmed.

PaymentPublic API, with limits

Send the guest a payment link, or record a payment the hotel took itself. Payment status is separate from booking status. There is no operation to charge a card directly.

Room chargePublic API

Confirm the order as charged to the room, with the guest's room number. Turneo posts the charge to the guest's folio in the PMS.

Staff operationsPublic API

List what was sold, and mark items delivered.

FulfilmentPublic API

Mark an item delivered or collected.

Cancellation and refundsPublic API, with limits

Cancel or refund a sold item, which puts it back in stock. Card payments taken through Turneo are refunded to the card; other payments are refunded by the hotel.

ReportingPublic API, with limits

The digest has one row per retail sale, next to the bookings; sold items can also be listed directly. Totals are yours to compute.

Gift vouchers

Public API: 10 in full, 1 with limits

Single- and multi-use vouchers for experiences, treatments and dining, bought now and redeemed later.

Inventory: Voucher. Bought now and redeemed later against one or more bookings, until used up or expired.

Staff-facing agent
Vouchers sold this month, and which bookings were paid with one.
Guest-facing agent
Sell a spa voucher as a gift, emailed to the recipient, or redeem the code a guest already has on their next booking.
Boundaries
A voucher code is as good as cash: never log it or show it to anyone but its holder. Look a code up before redeeming it, and redeem only codes the guest gives you.
Gift vouchers in Turneo
CataloguePublic API

Vouchers are experiences of type VOUCHER. Their config says which experiences they can be redeemed on, and how many times.

Capacity and resourcesPublic API

Vouchers aren't limited by stock.

PricingPublic API

Each voucher value is a SKU with its own price.

AvailabilityPublic API

Always on sale; what matters is which experiences a voucher can be redeemed on.

BookingPublic API

Sell a voucher as a retail line on an order. Redeem one by passing its voucherCode when creating the order, or as the payment when confirming it; look the code up first. The order vouchers operation is for seller promo codes, not gift vouchers.

PaymentPublic API

A redeemed voucher pays for the booking (RETAIL_VOUCHER). Buying a voucher is paid like any other order.

Room chargePublic API

Confirm the order as charged to the room, with the guest's room number. Turneo posts the charge to the guest's folio in the PMS.

Staff operationsPublic API

Look up a code, list the vouchers sold, and take a voucher off an order before it's confirmed.

FulfilmentPublic API

Confirming the order emails the code to the buyer, or to the recipient named on the line.

Cancellation and refundsPublic API

Cancelling or refunding a voucher invalidates its code.

ReportingPublic API, with limits

The digest has one row per voucher sale. Bookings paid with a voucher carry the voucher's redeemedRetailItemId, so redemptions can be traced.

Packages and bundles

Public API: 4 in full, 7 with limits

Several services sold together, such as a spa treatment with dinner, or a retail add-on with a booking.

Inventory: Package. Several services sold together, each with its own availability, in one order.

Staff-facing agent
Orders that combine several services this week, and the state of each part.
Guest-facing agent
Book a spa treatment and dinner for the same evening in one order, checking both are available first.
Boundaries
Each part has its own availability. Check every part before the order, and tell the guest plainly if one part can't be booked.
CataloguePublic API, with limits

There is no package type: sell the parts as separate bookings in one order.

Capacity and resourcesPublic API, with limits

Slot capacity can be read and overridden. The staff, rooms and equipment behind it are set up and scheduled in Turneo; a booking shows the ones assigned to it.

PricingPublic API, with limits

No bundle price. Each part keeps its own price; a concierge discount can be applied to the order.

BookingPublic API

One order holds every part, in one currency, and confirms them together.

PaymentPublic API, with limits

Send the guest a payment link, or record a payment the hotel took itself. Payment status is separate from booking status. There is no operation to charge a card directly.

Room chargePublic API

Confirm the order as charged to the room, with the guest's room number. Turneo posts the charge to the guest's folio in the PMS.

FulfilmentPublic API, with limits

Mark a booking completed or a no-show, and resend its confirmation. There is no check-in or ticket-scanning operation.

Cancellation and refundsPublic API, with limits

Per booking: cancelling one part leaves the others booked.

ReportingPublic API, with limits

Booking rows don't carry their order; group parts by order through the orders list.

Other hotel services

Public API: 7 in full, 4 with limits

Extras such as celebration set-ups, in-room amenities and private services, set up by each hotel in Turneo.

Inventory: Request. An extra the hotel's team fulfils, with its own eligibility; some belong to the PMS.

Staff-facing agent
Requests for extras due today, so the team can prepare them.
Guest-facing agent
Arrange a birthday set-up in the room on the guest's second night.
Boundaries
Which extras exist differs per hotel: an agent offers only what the hotel's catalogue lists. Room-level changes such as late checkout belong to the PMS.
CataloguePublic API

Each hotel's extras are experiences in its catalogue. A one-off service can be added as a custom booking.

Capacity and resourcesPublic API, with limits

Slot capacity can be read and overridden. The staff, rooms and equipment behind it are set up and scheduled in Turneo; a booking shows the ones assigned to it.

BookingPublic API

A booking order holds the slots for 15 minutes; confirming it turns the holds into bookings.

PaymentPublic API, with limits

Send the guest a payment link, or record a payment the hotel took itself. Payment status is separate from booking status. There is no operation to charge a card directly.

Room chargePublic API

Confirm the order as charged to the room, with the guest's room number. Turneo posts the charge to the guest's folio in the PMS.

FulfilmentPublic API, with limits

Mark a booking completed or a no-show, and resend its confirmation. There is no check-in or ticket-scanning operation.

ReportingPublic API, with limits

One row per booking with price, currency, commission and status, plus an activity feed of changes. Totals are yours to compute; utilisation and revenue dashboards stay in Turneo.