HolidaySG App
Book attractions faster
GET

Media Release

HolidaySG Hotels API and B2B portal booking open to travel partners

Search rates, read the hotel rules, lock a quote and book, with partner cancellation terms shown on every rate.

A mountain lodge with guests resting beside a small lake

HolidaySG has opened hotel booking to travel partners, through the Partner API and through the B2B portal. A partner can search a destination for given dates, read every bookable rate together with the hotel's own rules, lock a quote and book from a wallet or credit line. The API is built so that everything a customer must see before paying travels with each rate.

What partners can do

The Hotels API lives under the same base address, keys, address allow-list, rate limits and request signing as the rest of the Partner API. Hotels are enabled for a key by the partner's account manager; until then, hotel paths refuse the call. Prices are the partner's nett price in Singapore dollars, which is what the partner pays, and the partner sets its own selling price.

  • GET /hotels searches a destination for dates and guests.
  • GET /hotels/{slug}/rates lists every bookable rate for one hotel.
  • POST /hotels/quotes locks the price of one rate.
  • POST /hotels/bookings makes a booking, signed with an idempotency key.
  • GET /hotels/bookings/{id} reads a booking.
  • POST /hotels/bookings/{id}/cancel cancels one, signed.

Searching a destination

A search takes a destination, check-in and check-out dates and the guests. For one room, send the number of adults, from one to six, and the age of each child from zero to seventeen. For several rooms, send up to nine rooms, each with its own adults and children. The residency of the lead guest, a two-letter country code, must be the real one because the rate can depend on it.

Results show only hotels that have a bookable rate for those dates. Each shows the name, city, country, star rating, review score, an image and a "from" total with the number of nights, the meal plan, whether the rate is refundable and any taxes paid at the hotel. Pages are cursor-paginated.

Rates that carry the hotel's rules

The rates call returns each rate with a rate identifier, room and bedding, meal plan, availability count, total, per-night figure and taxes due at the hotel, which are shown separately and are never part of the total. Alongside the rates, the hotel block returns check-in and check-out times, the hotel's important information, extra notes and a link to the Hotel Booking Policy and its Partner Hotel Terms.

Under the partner terms, a partner shows its customer these items before payment:

  • The hotel's important information, such as deposits, children, extra beds, parking, pets and check-in or check-out fees.
  • The taxes and charges paid at the hotel, which are not included in the total.
  • The cancellation terms of the rate, with the deadline given both in the hotel's time zone and in Singapore time.

Quotes lock the price

A quote checks the rate with the hotel again and holds its price until a stated expiry. If the price has moved since the rates call, the quote says so with a price-changed flag and the new total, so the partner can show it to its customer before booking. A rate that can no longer be confirmed is refused, and the partner calls the rates endpoint again for fresh identifiers.

Booking and its outcomes

A booking names the quote, the payment method, which is wallet or credit, the customer and each guest by room. Guest names accept letters, spaces, hyphens and apostrophes, as written on the passport, and each room needs at least one adult with a full name. Because the request moves money it is signed and carries an idempotency key, and repeating it returns the same booking.

The answer tells the partner exactly what to do next.

  • Confirmed: the booking is made and paid.
  • Pending confirmation: paid and sent to the hotel, which has not confirmed yet. Read the booking again; do not retry.
  • Confirmation failed: the hotel did not confirm. HolidaySG reviews it and credits the wallet or credit line after approval.
  • Insufficient funds or credit limit exceeded: nothing is charged.
  • Quote not found or expired: request a new quote.

Cancellation and refunds for partners

Partners always see the partner cancellation terms, which differ from the consumer wording on holidaysg.com. The refund on a cancellation is the nett price the partner paid minus the hotel's penalty at that moment, and HolidaySG adds no cancellation fee for partners. Refunds are never automatic: HolidaySG checks each one and approves it, then credits the wallet or credit line, and the booking moves from pending approval to refunded with a credit note number.

No-shows and early departures are not refunded. A booking past its cancellation deadline, or one already cancelled, is refused and nothing moves. Names, dates and rooms cannot be edited; the partner cancels and books again.

Special requests and questions

A booking can carry special requests of up to 250 characters, which are passed to the hotel on a best-effort basis and are not guaranteed. After booking there is no messaging endpoint: partners use the Ask about this booking option in the B2B portal, or contact the team with the booking reference, and HolidaySG contacts the hotel on their behalf.

Booking in the B2B portal

Agents who prefer a screen to an integration use the same hotels in the B2B portal: search, a hotel page with its rates, a quote, a checkout and a booking list. The checkout asks the booker to accept the Hotel Booking Policy before paying, each booking can be cancelled from its page, and the invoice, and the credit note after a cancellation, can be downloaded from the booking.

Testing safely

A booking made with a sandbox key is confirmed as a simulation. Nothing is sent to the hotel and nothing is charged, so a partner can run the whole flow, including cancellation, as often as needed before asking for a live key.

Frequently asked questions

Why must I send the guest nationality?

Residency is the lead guest's nationality, and the rate can depend on it. Send the real value, never a default.

Are hotel taxes included in the total?

Taxes and fees paid at the hotel are listed separately as taxes at the hotel and are not part of the total.

What should I show my customer before they pay?

The hotel's important information, the taxes paid at the hotel, and the cancellation deadline in the hotel's time and in Singapore time.

How is a cancellation refunded?

The refund is the nett price paid minus the hotel's penalty. HolidaySG approves it and then credits your wallet or credit line; it is never automatic.

Can I change dates or names on a booking?

No. Cancel and book again. No-shows and early departures are not refunded.

How do I ask the hotel something after booking?

Use Ask about this booking in the B2B portal or contact the team with the booking reference. There is no messaging endpoint.

Do I have to use the API?

No. The same hotels can be booked in the B2B portal.

Explore the Partner API

About HolidaySG

HolidaySG.com is a Singapore travel platform for attractions and tours, visas, hotels, ferry tickets and eSIM plans, with a B2B portal and Partner API for travel businesses.

Media enquiries: contact us.

Google reviews

5.0 ★★★★★

Based on 129 reviews of HolidaySG on Google

★★★★★

I booked all my tickets on this Singapore website. The process was smooth and efficient I’m very satisfied and would definitely use it again
Vincent Yu · 7 months ago on Google

★★★★★

Tickets are issued very fast. Price is also reasonable. Very satisfied purchase!
David Yap · 3 months ago on Google · Flight reservation customer

★★★★★

Fantastic experience with Holiday SG , i have planned 5 days Singapore for my daughters from India. The whole package includes Hotel Booking,Transport, Sightseeing, VISA...
Santosh Mkar · 7 months ago on Google

★★★★★

Had an amazing 3 Days Malaysia Tour with HolidaySG! Everything was perfectly organized from hotel pickup to sightseeing. Our itinerary included Day 1: Kuala Lumpur City T...
Htun · 4 months ago on Google

More from HolidaySG

Things to do worldwide

Attractions, tours and experiences in destinations around the world.

HolidaySG eSIM plans

Mobile data for your trip: install a HolidaySG eSIM on your phone before you travel, no SIM card swap needed. Choose your destination on the HolidaySG eSIM page; eSIM plans are bought there, separately from tickets.

Need a flight reservation for your visa?

Applying for a visa? Embassies often ask for a flight itinerary. A flight reservation is not an issued ticket.

Hotels worldwide

Compare hotels in popular destinations and check room rates for your dates on HolidaySG.

Free travel tools

Trip cost calculators and free online tools to plan your holiday.

Work with HolidaySG

Travel agents, suppliers and developers: join our partner programmes or connect through the HolidaySG API.

Ask me anything!
HolidaySG panda mascot

Luna
Luna — HolidaySG

We use cookies

Read our Cookie Policy