Hotel Rates Workflow

Countries Flow

Call GET /api/v1/countries to list supported countries.

Hotels Flow

Call GET /api/v1/hotels with required country_code and optional city_name to list hotels.

The response returns hotel_id.

Minimum Rates Flow

Call POST /api/v1/hotel-min-rates with multiple hotel_ids to compare the cheapest available rates across hotels.

Use this when showing search results for many hotels.

Hotel Rates Flow

Call POST /api/v1/hotel-rates with a selected hotel_id, check_in, check_out, and guest details.

The response returns detailed room rates and bookable offer_id values.

Complete Rates Workflow

GET /countries
→ GET /hotels
→ POST /hotel-min-rates optional comparison step
→ POST /hotel-rates
→ choose offer_id

Hotel Booking Workflow

The Global BedBank Rates API supports a two-step booking flow: Prebook and Confirm.

Step 1: Authenticate

Use your Agent API Key in the Authorization header:

You can call POST /api/v1/auth/login to validate your key and view your agent details.

Step 2: Search Hotels

Call GET /api/v1/countries, then GET /api/v1/hotels with country_code.

Each hotel returns a hotel_id.

Step 3: Get Hotel Rates

Call POST /api/v1/hotel-rates with the selected hotel_id, stay dates, occupancy, currency, and guest nationality.

Choose one returned offer_id.

Step 4: Prebook

Call POST /api/v1/bookings/prebook with the selected offer_id and traveller details.

The response returns:

booking_id

prebook_id

room and price details

payment_url and transaction_id if use_payment_sdk is enabled

Step 5: Payment and Confirmation

If use_payment_sdk is true, redirect the customer to payment_url.

After payment, the customer returns to return_url, and the booking may be automatically confirmed.

If you are not using the Payment SDK, confirm manually with:

POST /api/v1/bookings/confirm

Use the booking_id or prebook_id, plus holder and guest details.

Manage Bookings

GET /api/v1/bookings - List bookings

GET /api/v1/bookings/{reference} - Get booking details

PUT /api/v1/bookings/{reference}/cancel - Cancel booking

PUT /api/v1/bookings/{reference}/amend - Amend guest name

Discover

Hotel Rates Workflow#

Countries Flow#

Hotels Flow#

Minimum Rates Flow#

Hotel Rates Flow#

Complete Rates Workflow#

Hotel Booking Workflow#

Step 1: Authenticate#

Step 2: Search Hotels#

Step 3: Get Hotel Rates#

Step 4: Prebook#

Step 5: Payment and Confirmation#

Manage Bookings#