Kong Hotels Partner API

QuoteRequest

object
property_codestringrequired
room_type_codestringrequired
rate_plan_codestringrequired
check_instring(date)required
check_outstring(date)required
adultsintegerrequired

>= 1<= 36

childreninteger

Default:0

>= 0<= 18

roomsinteger

Default:1

>= 1<= 9

promotion_codestring | null
loyaltyobject | null

Required for member-only rate plans.

Show Child Parameters
add_onsarray[object]

<= 10 items

Show Child Parameters
Example

Quote

object
idstring

Example:qt_01jbx4m6n2kz9v8c7d5e3f1g0h

statestring

Allowed values:openexpiredbooked

property_codestring
room_typeobject
Show Child Parameters
rate_planobject
Show Child Parameters
check_instring(date)
check_outstring(date)
adultsinteger
childreninteger
roomsinteger
promotion_codestring | null
loyalty_tierstring | null
pricingobject

room_subtotal = Σ nightly_rates × rooms. Percentage taxes apply to
(room_subtotal − discount_total + add_ons_total); fixed taxes per room, per adult or per stay.
total = room_subtotal − discount_total + add_ons_total + tax_total.

Example:{"currency":"USD","nights":3,"rooms":1,"nightly_rates":[{"date":"2026-12-04","amount":"427.00"},{"date":"2026-12-05","amount":"449.00"},{"date":"2026-12-06","amount":"388.00"}],"average_nightly_rate":"421.33","room_subtotal":"1264.00","discounts":[{"code":"KONGWEEKEND","name":"King of the Weekend","amount":"151.68"}],"discount_total":"151.68","add_ons":[{"code":"BRKFST","name":"Breakfast","pricing_unit":"per_guest_per_night","unit_price":"34.00","quantity":1,"amount":"204.00"}],"add_ons_total":"204.00","taxes":[{"code":"NYC_OCC","name":"NY state & city occupancy tax","type":"percent","rate":"14.75","amount":"194.16"},{"code":"NYC_UNIT","name":"NYC hotel unit fee","type":"per_room_per_night","rate":"2.00","amount":"6.00"},{"code":"NYC_JAVITS","name":"Javits Center fee","type":"per_room_per_night","rate":"1.50","amount":"4.50"}],"tax_total":"204.66","total":"1520.98"}

Show Child Parameters
cancellationobject

The policy applied to a specific stay, with a concrete deadline and penalty amount.

Show Child Parameters
holdOne Of
Holdobject
Show Child Parameters
expires_atstring(date-time)
created_atstring(date-time)
Example

Hold

object
idstring

Example:hld_01jbx4q2r8s7t6u5v4w3x2y1z0

statusstring

Allowed values:activereleasedconvertedexpired

quote_idstring
room_type_codestring
check_instring(date)
check_outstring(date)
roomsinteger
expires_atstring(date-time)
released_atstring | null(date-time)
created_atstring(date-time)
Example

Guest

object
first_namestringrequired

<= 100 characters

last_namestringrequired

<= 100 characters

emailstring(email)required
phonestring | null
country_codestring | null

>= 2 characters<= 2 characters

Example

ReservationRequest

object
quote_idstringrequired
payment_modelstringrequired

pay_at_hotel: the guest pays the property; partner_collect: you collected payment and settle
with Kong Hotels under your contract (shown as a prepayment on the folio).

Allowed values:pay_at_hotelpartner_collect

partner_referencestring | null

Your booking reference; searchable via GET /reservations?partner_reference=.

<= 64 characters

guestobjectrequired
Show Child Parameters
additional_guestsarray[object]
Show Child Parameters
children_agesarray[integer]

>= 0<= 17

special_requestsstring | null

<= 2000 characters

estimated_arrival_timestring | null

Match pattern:^\d{2}:\d{2}$

Example