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.
- CataloguePublic API
- 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.
- PricingPublic API
- AvailabilityPublic API
- 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.
- Staff operationsPublic API
Accepting and rejecting belong to whoever runs the service.
- 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
- 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.
- CataloguePublic API
- 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
- AvailabilityPublic API
- 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
Accepting and rejecting belong to whoever runs the service.
- FulfilmentPublic API, with limits
Attendance is recorded by marking a booking completed or a no-show. There is no check-in operation.
- Cancellation and refundsPublic 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.
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.
- CataloguePublic API
- 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.
- AvailabilityPublic API
- 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.
- Staff operationsPublic API
Accepting and rejecting belong to whoever runs the service.
- FulfilmentPublic API, with limits
No attendance, sign-in or collection tracking in the API; those stay with the club's own process.
- Cancellation and refundsPublic 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.
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.
- CataloguePublic API
- 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
- AvailabilityPublic API
- 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.
- Cancellation and refundsPublic API
- 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.
- CataloguePublic API
- 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
- AvailabilityPublic API
- 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
Accepting and rejecting belong to whoever runs the service.
- 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.
- CataloguePublic API
- 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.
- PricingPublic API
- 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.
- Staff operationsPublic API
Accepting and rejecting belong to whoever runs the service.
- 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
- 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.
- CataloguePublic API
- 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.
- PricingPublic API
- AvailabilityPublic API
- 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.
- Staff operationsPublic API
Accepting and rejecting belong to whoever runs the service.
- 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
- 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.
- CataloguePublic API
- 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.
- PricingPublic API
- AvailabilityPublic API
- 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.
- Staff operationsPublic API
Accepting and rejecting belong to whoever runs the service.
- FulfilmentPublic API, with limits
Completion and no-show only. Pickup, return and late returns are handled by the team, not the API.
- Cancellation and refundsPublic 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.
- CataloguePublic API
- Capacity and resourcesTurneo product only
Vehicles and drivers are set up and scheduled in Turneo. Vehicle classes are sold as variants.
- PricingPublic API
- AvailabilityPublic API
- 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.
- Cancellation and refundsPublic 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.
- CataloguePublic API
Products are experiences of type RETAIL (filter with experienceType); each variant with its own price is a SKU.
- Capacity and resourcesPublic API
Stock per SKU, with add and remove operations and a history of every movement.
- 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.
- 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.
- AvailabilityPublic API
Check every part before creating 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.
- Staff operationsPublic API
Accepting and rejecting belong to whoever runs the service.
- 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.
- PricingPublic API
- AvailabilityPublic API
- 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
Accepting and rejecting belong to whoever runs the service.
- 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
- 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.