Blog Detail Title

Short Content Here

by Author Name

Date Published


API Clean Up - What Changed in the Last Week?

Andrea Stubbe October 5, 2017

Being close to going live, we wanted to take the opportunity for some last minute cleanup. Because we want to go live with a version 1 that we're happy with, not just whatever we ended up with after eight months of developing.
Turned out, there was a lot we wanted to improve. Here's the list of updates from last week, and some tips on how to migrate over.

Big changes

We combined rate plans and extra services into a new module called 'rateplan'. Just change the paths:
catalog/services => rateplan/services
catalog/inventory => rateplan/inventory
rates/rateplans => rateplan/rateplan
rates/rates => rateplan/rates
Rate plans, inventory and services now all have a service type and a VAT type. The two values where previously concatenated, which was a bit dirty.

The booking model changed to accomodate new requirements:

  • In the output model, we do not include the reservations anymore. You can still get them, just call GET reservations and filter by bookingId.
  • The guest is now called 'primaryGuest', as a preparation to support more than one registered person in a room, instead of one registered person and a bunch of strangers.
  • We added a second comment field. Now there is one for the guest ("I am horribly allergic to peanuts and cats."), and one for the hotel team ("Forward the *peanut* allergy information to the restaurant team.")
  • We have less required fields in the addresses of booker and guest, to not annoy potential guests with filling out long forms. That also means you cannot rely on them being there. For the booker, only email and name are required, for the guest, only the name.
  • The guest and booker title now have actual values, not numbers. For now, there are Mr, Ms, Dr and 'other', if you are none of those, or don't want to tell.

Small changes

  • When amending a reservation, you now have to specify the number of persons.
  • Rate plans must have a cancellation policy set. You can define those using
  • renamed 'serviceIds' to 'extraServiceIds' in reservations, to make it clearer that those are not the services included in a predefined package.

Fix Spelling

The service type enum value 'accommodation' finally got its second 'm', and addressline1 and addressline2 were renamed to addressLine1 and addressLine2. Capital L.

Added - gives you the VAT types and percentages for one specific country. We don't support many now, but that list will grow as we go.


The links are gone. We realized nobody was using them, and keeping them around seemed pretty useless.

That's all. We tried our best to come up with a clean structure and understandable names. If you have any feedback on what to improve or change (or also what you like), it would be amazing if you'd let us know - we build the API for you, and want you to like it.

Andrea Stubbe

Posted by

Andrea Stubbe
Andrea started coding as a kid, paused that for some years trying to find more interesting things, but then ended up doing that for a living. After working as a freelancer, researcher, teacher, and a normal employee in small and giant corporations, she fulfilled her childhood dream and co-founded a company a year ago. Being a fan of microservices since before she knew that term, she’s still contemplating how and if to use them in micro-sized companies.


by Benjamin Schmid


IBE Integration Guide

Let's talk Internet Booking Engines (IBEs). They work best when directly connected to the PMS, without any intermediaries that might get in the way with delays ...

by Andrea Stubbe


Digital guest journey with apaleo

apaleo is building software for hotels, and our users are people that work at hotels. To create amazing guest experiences we need you, creators of guest facing ...

by Andrea Stubbe


Push it! Webhooks in apaleo

The notification service allows you to build or set up apps which subscribe to certain events on apaleo (webhooks). When an event is triggered, we send an HTTP ...


Subscribe to our a-list for all the fun:

  • Keep up to date with hotel trends
  • Understand what matters most to hotel clients
  • Sweet gifs and special offers

Get it in your inbox every Monday ;)

By entering your email you expressly consent to receive our newsletter every week and other material related to...