--- title: Modify Booking slug: modify-booking createdAt: 2025-10-14T05:55:17.068Z --- :::ApiMethodV2 ```json { "name": "Modify Booking API", "method": "POST", "url": "https://wspull.bakuun.com/v2/booking/MPBXX/xxxxx", "description": "", "tab": "examples", "examples": { "languages": [ { "id": "LwdXJbVcQ70iiSuuysqTj", "language": "json", "code": "{\n \"username\": \"testusername\",\n \"password\": \"testpassword\",\n \"tokenId\": \"4434324324324\",\n \"partnerId\": \"RDKXX\",\n \"partnerName\": \"Captooe Hindustan\",\n \"action\": \"pushModifyBooking\",\n \"hotelReservation\": [\n {\n \"hotelCode\": \"HTLXX.X\",\n \"hotelName\": \"Ibis Testing Brand 1234\",\n \"resID\": \"test-reservatuion1223\",\n \"resStatus\": \"Modify\",\n \"checkIn\": \"2022-12-23T15:00\",\n \"checkOut\": \"2022-12-25T15:00\",\n \"paymentMethod\": \"VCC\",\n \"rateType\": \"BAR\",\n \"currencyCode\": \"RUB\",\n \"totalAdult\": \"2\",\n \"totalChild\": \"2\",\n \"childAges\": [\n 3,\n 6\n ],\n \"roomStays\": [\n {\n \"occupancyRefId\": \"2\",\n \"roomTypeId\": \"R503.1.2\",\n \"roomName\": \"Budget Single Room\",\n \"ratePlanId\": \"R503.1.2.1\",\n \"cancelPolicy\": \"Non Refundable\",\n \"numberOfUnits\": \"2\",\n \"mealslncluded\": \"Breakfast\",\n \"adultCount\": \"2\",\n \"childCount\": \"2\",\n \"childAges\": [\n \"3\",\n \"6\"\n ],\n \"commission\": \"5.00\",\n \"roomIndex\": \"1\",\n \"ResGuestRPH\": \"1\",\n \"bookingPerDayPrices\": [\n {\n \"dateYmd\": \"2022-12-23\",\n \"price\": \"110.00\"\n },\n {\n \"dateYmd\": \"2022-12-24\",\n \"price\": \"190.00\"\n }\n ],\n \"total\": {\n \"amountAfterTaxes\": \"600.00\",\n \"amountBeforeTaxes\": \"600.00\"\n },\n \"mealsExcluded\": {\n \"mealsExlcudedPerDayPrices\": [\n {\n \"dateYmd\": \"2022-12-23\",\n \"excludedMeals\": \"breakfast,lunch,dinner\",\n \"breakfastChargeInfo\": [\n {\n \"ageQualifying\": \"adult\",\n \"mealsPerUnit\": \"100.00\",\n \"mealPerDay\": \"300.00\",\n \"adultMealCount\": \"3\"\n },\n {\n \"ageQualifying\": \"child\",\n \"mealsPerUnit\": \"100.00\",\n \"mealPerDay\": \"300.00\",\n \"childMealCount\": \"2\",\n \"child_ages\": [\n 3,\n 6\n ]\n },\n {\n \"ageQualifying\": \"infant\",\n \"mealsPerUnit\": \"null\",\n \"mealPerDay\": \"null\",\n \"infantMealCount\": \"2\",\n \"infant_ages\": [\n 3,\n 6\n ]\n }\n ],\n \"lunchChargeInfo\": [\n {\n \"ageQualifying\": \"adult\",\n \"mealsPerUnit\": \"100.00\",\n \"mealPerDay\": \"300.00\",\n \"adultMealCount\": \"3\"\n },\n {\n \"ageQualifying\": \"child\",\n \"mealsPerUnit\": \"100.00\",\n \"mealPerDay\": \"300.00\",\n \"childMealCount\": \"2\",\n \"child_ages\": [\n 3,\n 6\n ]\n },\n {\n \"ageQualifying\": \"infant\",\n \"mealsPerUnit\": \"null\",\n \"mealPerDay\": \"null\",\n \"infantMealCount\": \"2\",\n \"infant_ages\": [\n 3,\n 6\n ]\n }\n ],\n \"dinnerChargeInfo\": [\n {\n \"ageQualifying\": \"adult\",\n \"mealsPerUnit\": \"100.00\",\n \"mealPerDay\": \"300.00\",\n \"adultMealCount\": \"3\"\n },\n {\n \"ageQualifying\": \"child\",\n \"mealsPerUnit\": \"100.00\",\n \"mealPerDay\": \"300.00\",\n \"childMealCount\": \"2\",\n \"child_ages\": [\n 3,\n 6\n ]\n },\n {\n \"ageQualifying\": \"infant\",\n \"mealsPerUnit\": \"null\",\n \"mealPerDay\": \"null\",\n \"infantMealCount\": \"2\",\n \"infant_ages\": [\n 3,\n 6\n ]\n }\n ]\n },\n {\n \"dateYmd\": \"2022-12-24\",\n \"excludedMeals\": \"no meals\"\n }\n ]\n },\n \"roomIncServices\": [\n {\n \"serviceId\": \"123\",\n \"serviceName\": \"servicename\"\n },\n {\n \"serviceId\": \"234\",\n \"serviceName\": \"servicename\"\n }\n ],\n \"roomExtraServices\": [\n {\n \"serviceId\": \"123\",\n \"serviceName\": \"servicefirst\",\n \"servicesChargeInfo\": [\n {\n \"ageQualifying\": \"adult\",\n \"extraAdultCount\": \"3\",\n \"extraRate\": \"10.00\",\n \"totalExtraAmount\": \"30.00\"\n },\n {\n \"ageQualifying\": \"child\",\n \"extraChildRate\": \"10.00\",\n \"totalExtraAmount\": \"30.00\",\n \"childExtraCount\": \"2\",\n \"child_ages\": [\n 3,\n 6\n ]\n },\n {\n \"ageQualifying\": \"infant\",\n \"extraInfantRate\": \"10.00\",\n \"totalExtraAmount\": \"30.00\",\n \"childInfantCount\": \"3\",\n \"child_ages\": [\n 3,\n 3,\n 6\n ]\n }\n ]\n },\n {\n \"serviceId\": \"343\",\n \"serviceName\": \"servicesecond\",\n \"servicesChargeInfo\": [\n {\n \"ageQualifying\": \"guest\",\n \"extraCount\": \"3\",\n \"extraRate\": \"null\",\n \"totalExtraAmount\": \"null\"\n },\n {\n \"ageQualifying\": \"child\",\n \"extraChildRate\": \"null\",\n \"totalExtraAmount\": \"null\",\n \"childExtraCount\": \"1\",\n \"child_ages\": [\n 3\n ]\n },\n {\n \"ageQualifying\": \"infant\",\n \"extraInfantRate\": \"\",\n \"totalExtraAmount\": \"\",\n \"childInfantCount\": \"\"\n }\n ]\n }\n ]\n },\n {\n \"occupancyRefId\": \"3\",\n \"roomTypeId\": \"R503.1.2\",\n \"roomName\": \"Budget Single Room\",\n \"ratePlanId\": \"R503.1.2.1\",\n \"cancelPolicy\": \"Non Refundable\",\n \"numberOfUnits\": \"2\",\n \"mealslncluded\": \"Breakfast\",\n \"adultCount\": \"2\",\n \"childCount\": \"0\",\n \"commission\": \"5.00\",\n \"roomIndex\": \"2\",\n \"ResGuestRPH\": \"2\",\n \"bookingPerDayPrices\": [\n {\n \"dateYmd\": \"2022-12-23\",\n \"price\": \"110.00\"\n },\n {\n \"dateYmd\": \"2022-12-24\",\n \"price\": \"190.00\"\n }\n ],\n \"total\": {\n \"amountAfterTaxes\": \"600.00\",\n \"amountBeforeTaxes\": \"600.00\"\n },\n \"mealsExcluded\": {\n \"mealsExlcudedPerDayPrices\": [\n {\n \"dateYmd\": \"2022-12-23\",\n \"excludedMeals\": \"no meals\"\n },\n {\n \"dateYmd\": \"2022-12-24\",\n \"excludedMeals\": \"no meals\"\n }\n ]\n }\n }\n ],\n \"guestDetails\": [\n {\n \"ResGuestRPH\": \"1\",\n \"firstName\": \"Test1\",\n \"lastName\": \"Booking\",\n \"middleName\": \"\",\n \"email\": \"test1@bakuun.com\",\n \"phone\": \"111111111\",\n \"address\": \"Pune\",\n \"country\": \"India\"\n },\n {\n \"ResGuestRPH\": \"2\",\n \"firstName\": \"Test2\",\n \"lastName\": \"Booking\",\n \"middleName\": \"\",\n \"email\": \"test2@bakuun.com\",\n \"phone\": \"909999989\",\n \"address\": \"Italy\",\n \"country\": \"Italy\"\n }\n ],\n \"Comment\": {\n \"Text\": \"one-room\"\n },\n \"paymentCard\": {\n \"cardHolderName\": \"IVANOV IVAN\",\n \"cardType\": \"Visa\",\n \"cardCategory\": \"CC\",\n \"cardNumber\": \"123213213216549687\",\n \"ExpiryMonth\": \"04\",\n \"ExpiryYear\": \"2022\",\n \"StartDayMonth\": \"XYZ\",\n \"StartDayYear\": \"XYZ\",\n \"IssueNum\": \"2\",\n \"seriesCode\": \"123\",\n \"vccBalance\": \"200.99\",\n \"vccCurrencyCode\": \"EUR\",\n \"vccActivationDate\": \"2021-09-19\",\n \"vccDeactivationDate\": \"2021-09-19\"\n },\n \"totalCharge\": [\n {\n \"taxDetails\": {\n \"typeTax\": \"VAT\",\n \"includes\": \"0\",\n \"taxPrice\": \"10.00\",\n \"taxDetails\": \"TAX 10% not included\"\n },\n \"priceDetails\": [\n {\n \"rateType\": \"BAR\",\n \"amountAfterTaxes\": \"490.00\",\n \"amountBeforeTaxes\": \"490.00\"\n }\n ]\n }\n ]\n }\n ]\n}", "customLabel": "" } ], "selectedLanguageId": "LwdXJbVcQ70iiSuuysqTj" }, "results": { "languages": [ { "id": "ti0q2-_90UM_6o2RgiDhd", "language": "200", "code": "[\n {\n \"success\": true,\n \"message\": \"Reservation Modify Success\",\n \"roomIndex\": \"1\",\n \"reservationID\": \"MPB68-1\"\n },\n {\n \"success\": true,\n \"message\": \"Reservation Modify Success\",\n \"roomIndex\": \"2\",\n \"reservationID\": \"MPB68-2\"\n }\n]", "customLabel": "" }, { "id": "kgcZrlGfb_S0LiEkJKoo8", "language": "410", "code": "{\n \"success\": false,\n \"errors\": [\n {\n \"code\": 410,\n \"message\": \"Unauthorized user\"\n }\n ]", "customLabel": "" } ], "selectedLanguageId": "kgcZrlGfb_S0LiEkJKoo8" }, "request": { "pathParameters": [], "queryParameters": [], "headerParameters": [], "bodyDataParameters": [ { "name": "username", "kind": "required", "type": "string", "description": "System-generated, API access secret key (unique per account).", "": "System-generated, API access secret key (unique per account)." }, { "name": "password", "kind": "required", "type": "string", "description": "System-generated, API access secret key (unique per account).", "": "System-generated, API access secret key (unique per account)." }, { "name": "tokenId", "kind": "required", "type": "string", "description": "The tokenId given in the SPS ( Single Property Search) and sent during the pre-booking request", "": "The tokenId given in the SPS ( Single Property Search) and sent during the pre-booking request" }, { "name": "partnerId", "kind": "required", "type": "string", "description": "Partner (buyer) identifier (e.g. RDKXX - MPBXXX).", "": "Partner (buyer) identifier (e.g. RDKXX - MPBXXX)." }, { "name": "partnerName", "kind": "required", "type": "string", "description": "Partner (buyer) name", "": "Partner (buyer) name" }, { "name": "action", "kind": "required", "type": "string", "description": "Always set as pushModifyBooking", "": "Always set as pushModifyBooking" }, { "name": "hotelReservation", "kind": "required", "type": "object", "description": "", "": "required", "children": [ { "name": "hotelCode", "kind": "required", "type": "string", "description": "Unique Bakuun or Partner property ID. " }, { "name": "hotelName", "kind": "required", "type": "string", "description": "Hotel/property name." }, { "name": "resStatus", "kind": "required", "type": "string", "description": "Always set as Modify" }, { "name": "checkIn", "kind": "required", "type": "string", "description": "ISO check-in datetime (e.g., 2025-10-05T15:00). " }, { "name": "checkOut", "kind": "required", "type": "string", "description": "ISO check-out datetime (e.g., 2025-10-05T15:00)." }, { "name": "paymentMethod", "kind": "required", "type": "string", "description": "Available payment method \nVCC, CC, BANK, CASH, CREDIT\nFor MarketPlace Booking always set as BANK " }, { "name": "rateType", "kind": "required", "type": "string", "description": "Used to identify the rate type , the allowed value would be BAR or NET" }, { "name": "currencyCode", "kind": "required", "type": "string", "description": "Booking currency (ISO 4217)." }, { "name": "totalAdult", "kind": "required", "type": "string", "description": "Total adults across all rooms." }, { "name": "totalChild", "kind": "required", "type": "string", "description": "Total children across all rooms." }, { "name": "childAges", "kind": "required", "type": "array", "description": "Ages of all children." }, { "name": "roomStays", "kind": "required", "type": "object", "description": "", "children": [ { "name": "occupancyRefId", "kind": "required", "type": "string", "description": "Links room result to the requested occupancy." }, { "name": "roomTypeId", "kind": "required", "type": "string", "description": "Bakuun room ID." }, { "name": "roomName", "kind": "required", "type": "string", "description": "Room name" }, { "name": "ratePlanId", "kind": "required", "type": "string", "description": "Bakuun rate plan ID." }, { "name": "cancelPolicy", "kind": "required", "type": "string", "description": "Defines the cancellation policy associated with the selected ratePlanId. \nSupported options are:\n\nRefundable\nNon Refundable" }, { "name": "numberOfUnits", "kind": "required", "type": "string", "description": "Number of units booked. 1 would be the allowed minvalue" }, { "name": "mealslncluded", "kind": "required", "type": "string", "description": "Used to identify the meals included as given in the SPS ( Single Property Search)\nAvailable options are :\n- Breakfast \n- Half Bord \n- Full Board" }, { "name": "adultCount", "kind": "required", "type": "string", "description": "Number of adults in this room." }, { "name": "childCount", "kind": "required", "type": "string", "description": "Number of child in this room." }, { "name": "childAges", "kind": "required", "type": "array", "description": "Ages of children." }, { "name": "roomIndex", "kind": "required", "type": "string", "description": "Room index reference." }, { "name": "ResGuestRPH", "kind": "required", "type": "string", "description": "Guest index reference." }, { "name": "bookingPerDayPrices", "kind": "required", "type": "object", "description": "Date-wise price list for the stay.", "children": [ { "name": "dateYmd", "kind": "required", "type": "string", "description": "ISO date (e.g., 2025-10-25)." }, { "name": "price", "kind": "required", "type": "string", "description": "Date-wise price" } ] }, { "name": "total", "kind": "required", "type": "object", "description": "", "children": [ { "name": "amountAfterTaxes", "kind": "required", "type": "string", "description": "Total amount for the room stay after taxes and fees." }, { "name": "amountBeforeTaxes", "kind": "required", "type": "string", "description": "Total amount for the room stay before taxes and fees." } ] }, { "name": "mealsExcluded", "kind": "required", "type": "object", "description": "", "children": [ { "name": "mealsExlcudedPerDayPrices", "kind": "required", "type": "object", "description": "Indicates the meal types excluded by the guest in the SPS (Single Property Search) request.\nThese exclusions are applied during the pricing and availability calculation.\n\nAvailable options are:\n- Breakfast\n- Half Board\n- Full Board", "children": [ { "name": "dateYmd", "kind": "required", "type": "string", "description": "ISO date (e.g., 2025-10-25)." }, { "name": "excludedMeals", "kind": "required", "type": "string", "description": "Selected exclused meals for this room type by the guest ", "children": [] }, { "name": "breakfastChargeInfo", "kind": "required", "type": "object", "description": "A list containing the meal charging rules per age category (adult, child, infant).\nEach object defines how breakfast charges are applied based on age qualification.", "children": [ { "name": "ageQualifying", "kind": "required", "type": "string", "description": "Indicates the selected age qualifying range for this meal type \nadult\nchild\ninfant" }, { "name": "mealsPerUnit", "kind": "required", "type": "string", "description": "Number of meals selected for this combination" }, { "name": "mealPerDay", "kind": "required", "type": "string", "description": "Meal day-wise value " }, { "name": "adultMealCount", "kind": "required", "type": "string", "description": "Number of meal for adult ageQualifying group" }, { "name": "childMealCount", "kind": "required", "type": "string", "description": "Number of meal for child ageQualifying group" }, { "name": "child_ages", "kind": "required", "type": "array", "description": "Child ages for this block " }, { "name": "infantMealCount", "kind": "required", "type": "string", "description": "Number of meal for infant ageQualifying group" }, { "name": "infant_ages", "kind": "required", "type": "array", "description": "Infant ages for this block" } ] }, { "name": "lunchChargeInfo", "kind": "required", "type": "object", "description": "A list containing the meal charging rules per age category (adult, child, infant).\nEach object defines how breakfast charges are applied based on age qualification.", "children": [ { "name": "ageQualifying", "kind": "required", "type": "string", "description": "Indicates the selected age qualifying range for this meal type \nadult\nchild\ninfant" }, { "name": "mealsPerUnit", "kind": "required", "type": "string", "description": "Number of meals selected for this combination " }, { "name": "mealPerDay", "kind": "required", "type": "string", "description": "Meals day-wise value " }, { "name": "adultMealCount", "kind": "required", "type": "string", "description": "Number of meal for adult ageQualifying group" }, { "name": "childMealCount", "kind": "required", "type": "string", "description": "Number of meal for adult ageQualifying group" }, { "name": "child_ages", "kind": "required", "type": "array", "description": "Child ages for this block " }, { "name": "infantMealCount", "kind": "required", "type": "string", "description": "Number of meal for infant ageQualifying group" }, { "name": "infant_ages", "kind": "required", "type": "array", "description": "Infant ages for this block" } ] }, { "name": "dinnerChargeInfo", "kind": "required", "type": "object", "description": "A list containing the meal charging rules per age category (adult, child, infant).\nEach object defines how breakfast charges are applied based on age qualification.", "children": [ { "name": "ageQualifying", "kind": "required", "type": "string", "description": "Indicates the selected age qualifying range for this meal type \nadult\nchild\ninfant" }, { "name": "mealsPerUnit", "kind": "required", "type": "string", "description": "Number of meals selected for this combination " }, { "name": "mealPerDay", "kind": "required", "type": "string", "description": "Meal day-wise value " }, { "name": "adultMealCount", "kind": "required", "type": "string", "description": "Number of meal for adult ageQualifying group" }, { "name": "childMealCount", "kind": "required", "type": "string", "description": "Number of meal for child ageQualifying group" }, { "name": "child_ages", "kind": "required", "type": "array", "description": "Child ages for this block " }, { "name": "infantMealCount", "kind": "required", "type": "string", "description": "Number of meal for infant ageQualifying group" }, { "name": "infant_ages", "kind": "required", "type": "array", "description": "Infant ages for this block" } ] } ] } ] }, { "name": "roomIncServices", "kind": "required", "type": "object", "description": "", "children": [ { "name": "serviceId", "kind": "required", "type": "string", "description": "Unique service identifier." }, { "name": "serviceName", "kind": "required", "type": "string", "description": "Name of the service." } ] }, { "name": "roomExtraServices", "kind": "required", "type": "object", "description": "", "children": [ { "name": "serviceId", "kind": "required", "type": "string", "description": "Unique service identifier." }, { "name": "serviceName", "kind": "required", "type": "string", "description": "Name of the service." }, { "name": "servicesChargeInfo", "kind": "required", "type": "object", "description": "Service cost breakdown ", "children": [ { "name": "ageQualifying", "kind": "required", "type": "string", "description": "Indicates the selected age qualifying range for this service type \nadult\nchild\ninfant" }, { "name": "extraAdultCount", "kind": "required", "type": "string", "description": "Indicates the cost for the service for adult age qualifying" }, { "name": "extraRate", "kind": "required", "type": "string", "description": "Indicates the cost for the service for adult age qualifying" }, { "name": "totalExtraAmount", "kind": "required", "type": "string", "description": "Indicates the cost for the service for each age qualifying range" }, { "name": "extraChildRate", "kind": "required", "type": "string", "description": "Indicates the cost for the service for child age qualifying" }, { "name": "childExtraCount", "kind": "required", "type": "string", "description": "Number of children requesting this service " }, { "name": "child_ages", "kind": "required", "type": "array", "description": "Ages of children requesting this service " }, { "name": "extraInfantRate", "kind": "required", "type": "string", "description": "Indicates the cost for the service for infant age qualifying" }, { "name": "childInfantCount", "kind": "required", "type": "string", "description": "Number of infant requesting this service " } ] } ] }, { "name": "commission: ", "kind": "required", "type": "string", "description": "Commission value accepted between 0 and 99, or left empty if not applicable." } ] }, { "name": "guestDetails", "kind": "required", "type": "object", "description": "Standard guest contact information.", "children": [ { "name": "ResGuestRPH", "kind": "required", "type": "string", "description": "Guest index reference." }, { "name": "firstName", "kind": "required", "type": "string", "description": "Guest first name." }, { "name": "lastName", "kind": "required", "type": "string", "description": "Guest surname." }, { "name": "middleName", "kind": "required", "type": "string", "description": "Optional" }, { "name": "email", "kind": "required", "type": "string", "description": "Guest email." }, { "name": "phone", "kind": "required", "type": "string", "description": "Guest phone number." }, { "name": "address", "kind": "required", "type": "string", "description": "Guest address." }, { "name": "country", "kind": "required", "type": "string", "description": "Guest country." } ] }, { "name": "Comment", "kind": "required", "type": "object", "description": "", "children": [ { "name": "Text", "kind": "required", "type": "string", "description": "" } ] }, { "name": "paymentCard", "kind": "required", "type": "object", "description": "Required only when paymentMethod = CC or VCC.", "children": [ { "name": "cardHolderName", "kind": "required", "type": "string", "description": "Name on card." }, { "name": "cardType", "kind": "required", "type": "string", "description": "Visa/Mastercard/etc." }, { "name": "cardCategory", "kind": "required", "type": "string", "description": "CC or VCC." }, { "name": "cardNumber", "kind": "required", "type": "string", "description": "Valid card number" }, { "name": "ExpiryMonth", "kind": "required", "type": "string", "description": "Valid card number" }, { "name": "ExpiryYear", "kind": "required", "type": "string", "description": "Expiry YYYY." }, { "name": "StartDayMonth", "kind": "required", "type": "string", "description": "Start day month MM. \nThis is only needed for card different from Visa, Mastercard, Amex, UnionPay, JCB" }, { "name": "StartDayYear", "kind": "required", "type": "string", "description": "Start day year YYYY. \nThis is only needed for card different from Visa, Mastercard, Amex, UnionPay, JCB" }, { "name": "IssueNum", "kind": "required", "type": "string", "description": "This is only needed for card different from Visa, Mastercard, Amex, UnionPay, JCB" }, { "name": "seriesCode", "kind": "required", "type": "string", "description": "This is only needed for card different from Visa, Mastercard, Amex, UnionPay, JCB" }, { "name": "vccBalance", "kind": "required", "type": "string", "description": "VCC current balance" }, { "name": "vccCurrencyCode", "kind": "required", "type": "string", "description": "VCC currency (ISO 4217)." }, { "name": "vccActivationDate", "kind": "required", "type": "string", "description": "Activation date." }, { "name": "vccDeactivationDate", "kind": "required", "type": "string", "description": "Deactivation date." } ] }, { "name": "totalCharge", "kind": "required", "type": "object", "description": "", "children": [ { "name": "taxDetails", "kind": "required", "type": "object", "description": "The type of tax applied to the booking (e.g., VAT, City Tax, Service Tax).", "children": [ { "name": "typeTax", "kind": "required", "type": "string", "description": "The type of tax applied to the booking (e.g., VAT, FEES)." }, { "name": "includes", "kind": "required", "type": "string", "description": "Indicates whether the tax amount is included in the room price.\n\n1 = Tax is included in the price\n0 = Tax is not included (added on top)" }, { "name": "taxPrice", "kind": "required", "type": "string", "description": "The value of the tax.\nCan represent either a percentage or a fixed amount, depending on the property setup." }, { "name": "taxDetails", "kind": "required", "type": "string", "description": "Description of the tax applied to the booking (e.g., “TAX 10% not included”)." } ] }, { "name": "priceDetails", "kind": "required", "type": "object", "description": "", "children": [ { "name": "rateType", "kind": "required", "type": "string", "description": "Used to identify the rate type , the allowed value would be BAR or NET" }, { "name": "amountAfterTaxes", "kind": "required", "type": "string", "description": "Total amount for the reservation after taxes and fees." }, { "name": "amountBeforeTaxes", "kind": "required", "type": "string", "description": "Total amount for the reservation before taxes and fees." } ] } ] }, { "name": "resID", "kind": "required", "type": "string", "description": "Reservation ID previously generated" } ], "schema": [ { "name": "hotelCode", "kind": "required", "type": "string", "description": "Unique Bakuun or Partner property ID. " }, { "name": "hotelName", "kind": "required", "type": "string", "description": "Hotel/property name." }, { "name": "resStatus", "kind": "required", "type": "string", "description": "Always set as Modify" }, { "name": "checkIn", "kind": "required", "type": "string", "description": "ISO check-in datetime (e.g., 2025-10-05T15:00). " }, { "name": "checkOut", "kind": "required", "type": "string", "description": "ISO check-out datetime (e.g., 2025-10-05T15:00)." }, { "name": "paymentMethod", "kind": "required", "type": "string", "description": "Available payment method \nVCC, CC, BANK, CASH, CREDIT\nFor MarketPlace Booking always set as BANK " }, { "name": "rateType", "kind": "required", "type": "string", "description": "Used to identify the rate type , the allowed value would be BAR or NET" }, { "name": "currencyCode", "kind": "required", "type": "string", "description": "Booking currency (ISO 4217)." }, { "name": "totalAdult", "kind": "required", "type": "string", "description": "Total adults across all rooms." }, { "name": "totalChild", "kind": "required", "type": "string", "description": "Total children across all rooms." }, { "name": "childAges", "kind": "required", "type": "array", "description": "Ages of all children." }, { "name": "roomStays", "kind": "required", "type": "object", "description": "", "children": [ { "name": "occupancyRefId", "kind": "required", "type": "string", "description": "Links room result to the requested occupancy." }, { "name": "roomTypeId", "kind": "required", "type": "string", "description": "Bakuun room ID." }, { "name": "roomName", "kind": "required", "type": "string", "description": "Room name" }, { "name": "ratePlanId", "kind": "required", "type": "string", "description": "Bakuun rate plan ID." }, { "name": "cancelPolicy", "kind": "required", "type": "string", "description": "Defines the cancellation policy associated with the selected ratePlanId. \nSupported options are:\n\nRefundable\nNon Refundable" }, { "name": "numberOfUnits", "kind": "required", "type": "string", "description": "Number of units booked. 1 would be the allowed minvalue" }, { "name": "mealslncluded", "kind": "required", "type": "string", "description": "Used to identify the meals included as given in the SPS ( Single Property Search)\nAvailable options are :\n- Breakfast \n- Half Bord \n- Full Board" }, { "name": "adultCount", "kind": "required", "type": "string", "description": "Number of adults in this room." }, { "name": "childCount", "kind": "required", "type": "string", "description": "Number of child in this room." }, { "name": "childAges", "kind": "required", "type": "array", "description": "Ages of children." }, { "name": "roomIndex", "kind": "required", "type": "string", "description": "Room index reference." }, { "name": "ResGuestRPH", "kind": "required", "type": "string", "description": "Guest index reference." }, { "name": "bookingPerDayPrices", "kind": "required", "type": "object", "description": "Date-wise price list for the stay.", "children": [ { "name": "dateYmd", "kind": "required", "type": "string", "description": "ISO date (e.g., 2025-10-25)." }, { "name": "price", "kind": "required", "type": "string", "description": "Date-wise price" } ] }, { "name": "total", "kind": "required", "type": "object", "description": "", "children": [ { "name": "amountAfterTaxes", "kind": "required", "type": "string", "description": "Total amount for the room stay after taxes and fees." }, { "name": "amountBeforeTaxes", "kind": "required", "type": "string", "description": "Total amount for the room stay before taxes and fees." } ] }, { "name": "mealsExcluded", "kind": "required", "type": "object", "description": "", "children": [ { "name": "mealsExlcudedPerDayPrices", "kind": "required", "type": "object", "description": "Indicates the meal types excluded by the guest in the SPS (Single Property Search) request.\nThese exclusions are applied during the pricing and availability calculation.\n\nAvailable options are:\n- Breakfast\n- Half Board\n- Full Board", "children": [ { "name": "dateYmd", "kind": "required", "type": "string", "description": "ISO date (e.g., 2025-10-25)." }, { "name": "excludedMeals", "kind": "required", "type": "string", "description": "Selected exclused meals for this room type by the guest ", "children": [] }, { "name": "breakfastChargeInfo", "kind": "required", "type": "object", "description": "A list containing the meal charging rules per age category (adult, child, infant).\nEach object defines how breakfast charges are applied based on age qualification.", "children": [ { "name": "ageQualifying", "kind": "required", "type": "string", "description": "Indicates the selected age qualifying range for this meal type \nadult\nchild\ninfant" }, { "name": "mealsPerUnit", "kind": "required", "type": "string", "description": "Number of meals selected for this combination" }, { "name": "mealPerDay", "kind": "required", "type": "string", "description": "Meal day-wise value " }, { "name": "adultMealCount", "kind": "required", "type": "string", "description": "Number of meal for adult ageQualifying group" }, { "name": "childMealCount", "kind": "required", "type": "string", "description": "Number of meal for child ageQualifying group" }, { "name": "child_ages", "kind": "required", "type": "array", "description": "Child ages for this block " }, { "name": "infantMealCount", "kind": "required", "type": "string", "description": "Number of meal for infant ageQualifying group" }, { "name": "infant_ages", "kind": "required", "type": "array", "description": "Infant ages for this block" } ] }, { "name": "lunchChargeInfo", "kind": "required", "type": "object", "description": "A list containing the meal charging rules per age category (adult, child, infant).\nEach object defines how breakfast charges are applied based on age qualification.", "children": [ { "name": "ageQualifying", "kind": "required", "type": "string", "description": "Indicates the selected age qualifying range for this meal type \nadult\nchild\ninfant" }, { "name": "mealsPerUnit", "kind": "required", "type": "string", "description": "Number of meals selected for this combination " }, { "name": "mealPerDay", "kind": "required", "type": "string", "description": "Meals day-wise value " }, { "name": "adultMealCount", "kind": "required", "type": "string", "description": "Number of meal for adult ageQualifying group" }, { "name": "childMealCount", "kind": "required", "type": "string", "description": "Number of meal for adult ageQualifying group" }, { "name": "child_ages", "kind": "required", "type": "array", "description": "Child ages for this block " }, { "name": "infantMealCount", "kind": "required", "type": "string", "description": "Number of meal for infant ageQualifying group" }, { "name": "infant_ages", "kind": "required", "type": "array", "description": "Infant ages for this block" } ] }, { "name": "dinnerChargeInfo", "kind": "required", "type": "object", "description": "A list containing the meal charging rules per age category (adult, child, infant).\nEach object defines how breakfast charges are applied based on age qualification.", "children": [ { "name": "ageQualifying", "kind": "required", "type": "string", "description": "Indicates the selected age qualifying range for this meal type \nadult\nchild\ninfant" }, { "name": "mealsPerUnit", "kind": "required", "type": "string", "description": "Number of meals selected for this combination " }, { "name": "mealPerDay", "kind": "required", "type": "string", "description": "Meal day-wise value " }, { "name": "adultMealCount", "kind": "required", "type": "string", "description": "Number of meal for adult ageQualifying group" }, { "name": "childMealCount", "kind": "required", "type": "string", "description": "Number of meal for child ageQualifying group" }, { "name": "child_ages", "kind": "required", "type": "array", "description": "Child ages for this block " }, { "name": "infantMealCount", "kind": "required", "type": "string", "description": "Number of meal for infant ageQualifying group" }, { "name": "infant_ages", "kind": "required", "type": "array", "description": "Infant ages for this block" } ] } ] } ] }, { "name": "roomIncServices", "kind": "required", "type": "object", "description": "", "children": [ { "name": "serviceId", "kind": "required", "type": "string", "description": "Unique service identifier." }, { "name": "serviceName", "kind": "required", "type": "string", "description": "Name of the service." } ] }, { "name": "roomExtraServices", "kind": "required", "type": "object", "description": "", "children": [ { "name": "serviceId", "kind": "required", "type": "string", "description": "Unique service identifier." }, { "name": "serviceName", "kind": "required", "type": "string", "description": "Name of the service." }, { "name": "servicesChargeInfo", "kind": "required", "type": "object", "description": "Service cost breakdown ", "children": [ { "name": "ageQualifying", "kind": "required", "type": "string", "description": "Indicates the selected age qualifying range for this service type \nadult\nchild\ninfant" }, { "name": "extraAdultCount", "kind": "required", "type": "string", "description": "Indicates the cost for the service for adult age qualifying" }, { "name": "extraRate", "kind": "required", "type": "string", "description": "Indicates the cost for the service for adult age qualifying" }, { "name": "totalExtraAmount", "kind": "required", "type": "string", "description": "Indicates the cost for the service for each age qualifying range" }, { "name": "extraChildRate", "kind": "required", "type": "string", "description": "Indicates the cost for the service for child age qualifying" }, { "name": "childExtraCount", "kind": "required", "type": "string", "description": "Number of children requesting this service " }, { "name": "child_ages", "kind": "required", "type": "array", "description": "Ages of children requesting this service " }, { "name": "extraInfantRate", "kind": "required", "type": "string", "description": "Indicates the cost for the service for infant age qualifying" }, { "name": "childInfantCount", "kind": "required", "type": "string", "description": "Number of infant requesting this service " } ] } ] }, { "name": "commission: ", "kind": "required", "type": "string", "description": "Commission value accepted between 0 and 99, or left empty if not applicable." } ] }, { "name": "guestDetails", "kind": "required", "type": "object", "description": "Standard guest contact information.", "children": [ { "name": "ResGuestRPH", "kind": "required", "type": "string", "description": "Guest index reference." }, { "name": "firstName", "kind": "required", "type": "string", "description": "Guest first name." }, { "name": "lastName", "kind": "required", "type": "string", "description": "Guest surname." }, { "name": "middleName", "kind": "required", "type": "string", "description": "Optional" }, { "name": "email", "kind": "required", "type": "string", "description": "Guest email." }, { "name": "phone", "kind": "required", "type": "string", "description": "Guest phone number." }, { "name": "address", "kind": "required", "type": "string", "description": "Guest address." }, { "name": "country", "kind": "required", "type": "string", "description": "Guest country." } ] }, { "name": "Comment", "kind": "required", "type": "object", "description": "", "children": [ { "name": "Text", "kind": "required", "type": "string", "description": "" } ] }, { "name": "paymentCard", "kind": "required", "type": "object", "description": "Required only when paymentMethod = CC or VCC.", "children": [ { "name": "cardHolderName", "kind": "required", "type": "string", "description": "Name on card." }, { "name": "cardType", "kind": "required", "type": "string", "description": "Visa/Mastercard/etc." }, { "name": "cardCategory", "kind": "required", "type": "string", "description": "CC or VCC." }, { "name": "cardNumber", "kind": "required", "type": "string", "description": "Valid card number" }, { "name": "ExpiryMonth", "kind": "required", "type": "string", "description": "Valid card number" }, { "name": "ExpiryYear", "kind": "required", "type": "string", "description": "Expiry YYYY." }, { "name": "StartDayMonth", "kind": "required", "type": "string", "description": "Start day month MM. \nThis is only needed for card different from Visa, Mastercard, Amex, UnionPay, JCB" }, { "name": "StartDayYear", "kind": "required", "type": "string", "description": "Start day year YYYY. \nThis is only needed for card different from Visa, Mastercard, Amex, UnionPay, JCB" }, { "name": "IssueNum", "kind": "required", "type": "string", "description": "This is only needed for card different from Visa, Mastercard, Amex, UnionPay, JCB" }, { "name": "seriesCode", "kind": "required", "type": "string", "description": "This is only needed for card different from Visa, Mastercard, Amex, UnionPay, JCB" }, { "name": "vccBalance", "kind": "required", "type": "string", "description": "VCC current balance" }, { "name": "vccCurrencyCode", "kind": "required", "type": "string", "description": "VCC currency (ISO 4217)." }, { "name": "vccActivationDate", "kind": "required", "type": "string", "description": "Activation date." }, { "name": "vccDeactivationDate", "kind": "required", "type": "string", "description": "Deactivation date." } ] }, { "name": "totalCharge", "kind": "required", "type": "object", "description": "", "children": [ { "name": "taxDetails", "kind": "required", "type": "object", "description": "The type of tax applied to the booking (e.g., VAT, City Tax, Service Tax).", "children": [ { "name": "typeTax", "kind": "required", "type": "string", "description": "The type of tax applied to the booking (e.g., VAT, FEES)." }, { "name": "includes", "kind": "required", "type": "string", "description": "Indicates whether the tax amount is included in the room price.\n\n1 = Tax is included in the price\n0 = Tax is not included (added on top)" }, { "name": "taxPrice", "kind": "required", "type": "string", "description": "The value of the tax.\nCan represent either a percentage or a fixed amount, depending on the property setup." }, { "name": "taxDetails", "kind": "required", "type": "string", "description": "Description of the tax applied to the booking (e.g., “TAX 10% not included”)." } ] }, { "name": "priceDetails", "kind": "required", "type": "object", "description": "", "children": [ { "name": "rateType", "kind": "required", "type": "string", "description": "Used to identify the rate type , the allowed value would be BAR or NET" }, { "name": "amountAfterTaxes", "kind": "required", "type": "string", "description": "Total amount for the reservation after taxes and fees." }, { "name": "amountBeforeTaxes", "kind": "required", "type": "string", "description": "Total amount for the reservation before taxes and fees." } ] } ] }, { "name": "resID", "kind": "required", "type": "string", "description": "Reservation ID previously generated" } ] } ], "formDataParameters": [] }, "currentNewParameter": { "label": "Body Parameter", "value": "bodyDataParameters" }, "hasTryItOut": false, "response": [ { "name": "success", "kind": "optional", "type": "boolean", "description": "true --> when the reservation is modified" }, { "name": "message", "kind": "optional", "type": "string", "description": "Reservation Modify Success --> when the reservation is modified.", "children": [] }, { "name": "roomIndex", "kind": "optional", "type": "string", "description": "The room reference index tied to the original request payload.", "children": [] }, { "name": "reservationID", "kind": "optional", "type": "string", "description": "The room reference index tied to the original request payload.", "children": [] } ], "autoGeneratedAnchorSlug": "modify-booking-api", "legacyHash": "55Yssil4pakj22jbL1hPX" } ``` :::