Skip to main content
Whether you’re a first-time visitor trying to find a hotel or a developer integrating OpenBookings into your app, these answers cover the most common questions about how the platform works.

​
Getting started

OpenBookings is an open-source hotel booking platform that lets you search for available rooms near any destination, compare real-time pricing, and complete bookings — all without a password. You enter a destination, choose your dates and guest count, and OpenBookings returns a ranked list of properties with up-to-date availability and pricing.The project is fully open-source. You can find the source code on GitHub.
Yes. Searching for hotels and browsing results is completely free. You only pay for a room when you complete a booking, and the price you see is the price charged by the property — OpenBookings does not add service fees on top of the displayed rate.
OpenBookings searches globally. As long as a destination has properties registered in the platform, it will appear in search results. The destination search uses a city index powered by Algolia, so you can type any city name and see matching suggestions instantly. Coverage depends on which hotels have listed rooms; if your destination returns no results, try a nearby larger city.

​
Search & booking

A few things can cause an empty results page:
  • No properties within range. OpenBookings searches within a 250 km radius of the destination’s coordinates. If no hotels are listed within that area, you’ll see no results.
  • No available rooms for your dates. All rooms shown must be available for every night of your stay. If a property is fully booked, it won’t appear.
  • Guest count too high. Results are filtered to rooms that can accommodate your selected number of adults and children. Reducing the guest count may reveal more options.
  • Dates too far in advance. Some properties only open availability within a certain window. Try searching closer to your intended travel dates.
OpenBookings queries properties within 250 km of your destination’s coordinates, then filters to rooms that are available for every night of your stay and can accommodate your guest count. Each property’s pricing is calculated in real time based on your specific dates and guest configuration before results are returned.
Results are sorted by total price for your stay, lowest first. OpenBookings picks the cheapest qualifying room for each property and ranks properties by that price, so the most affordable options always appear at the top.
When you search for a destination, OpenBookings finds all properties within 250 km of that city’s coordinates. This radius is fixed and cannot be adjusted. If you want results closer to a specific neighbourhood or landmark, choose the nearest city as your destination — the radius is large enough to surface properties across an entire metropolitan region.
Yes. Use the guest selector on the home page to set the number of rooms you need alongside your adult and children count. The search will return rooms priced per room, and the total price shown reflects the number of rooms you selected.

​
Pricing

Hotel rates on OpenBookings are dynamic. Each room has a base nightly rate, but properties can apply modifiers that adjust the price based on factors like the day of the week, how far in advance you’re booking, and how many guests you’re bringing. The price you see is always calculated for your exact dates and guest count.
An early-bird discount is a price reduction applied when you book a set number of days before your arrival date. If a property offers an early-bird modifier and your booking date is far enough in advance, the discount is automatically applied to your total — you don’t need a coupon code. The threshold varies by property.
A last-minute surcharge is an additional charge applied when you book within a short window before your arrival date. Properties use this modifier to reflect higher demand close to the stay date. If your check-in is soon and you see a higher-than-expected price, a last-minute surcharge may be contributing to it.
A last-minute surcharge and a discount modifier can both apply to the same booking — they are independent. However, only one discount (either an early-bird discount or a length-of-stay discount) can fire per booking, not both.
A refundable rate means the booking can be cancelled for a full refund, subject to the property’s cancellation policy. A non-refundable rate is typically cheaper but carries no cancellation flexibility. Each result in the search list shows whether the rate is refundable so you can compare before booking.
Every room has a base occupancy — the number of guests included in the base nightly rate. If your total guest count (adults plus children) exceeds that base occupancy, an extra-guest surcharge is added for each additional person per night. This surcharge can be a flat amount per guest or a percentage of the base rate, depending on the property’s configuration.

​
Authentication

OpenBookings uses magic-link email authentication — no passwords required.
1

Enter your email

Click the sign-in button on the home page and type your email address.
2

Check your inbox

OpenBookings sends you an email containing a one-time sign-in link. The link expires after 15 minutes.
3

Click the link

Click the link in the email. You’re signed in automatically and redirected back to OpenBookings.
Yes. OpenBookings supports signing in with Google and Apple in addition to magic-link email. Look for the social sign-in buttons on the authentication form. Social sign-in is the fastest option if you’re already logged into one of those accounts in your browser.
Click your profile avatar in the top-right corner of the home page. This signs you out immediately and refreshes the page. Your session is cleared from the browser, and you’ll need to sign in again to access your account.