--- title: Pre-Booking slug: pre-booking createdAt: 2025-10-14T04:42:36.427Z --- :::ApiMethodV2 ```json { "name": "Pre - Booking", "method": "POST", "url": "https://wsb.bakuun.com/v2/booking/MPBXX/XXXX", "description": "During the pre-booking process, the partner must send the booking data without a reservation ID, as the booking is not yet confirmed.\nIn response, we will generate and return a unique token code for that pre-booking. Each token is valid for 2 minutes.\n\nTo confirm the booking, you must resend the same token code together with your reservation ID.\nIf the token is missing, invalid, or expired, the reservation request will be rejected.\n\nOnce we receive the reservation data together with a valid token code, we will create the booking in our system and return a success response.\n\nAll pre-bookings are initially created with the status “New.”", "tab": "examples", "examples": { "languages": [ { "id": "NWQsuC0YyAXzpBxC7Hsc4", "language": "json", "code": "{\n \"username\": \"XXXXXX\",\n \"password\": \"XXXXXX\",\n \"partnerId\": \"MPBXX\",\n \"partnerName\": \"May test Slough\",\n \"action\": \"getBooking\",\n \"hotelReservation\": [\n {\n \"hotelCode\": \"HTLXXX\",\n \"hotelName\": \"Novotel Barossa Valley Resort\",\n \"resStatus\": \"New\",\n \"checkIn\": \"YYYY-MM-DDTHH:MM\",\n \"checkOut\": \"YYYY-MM-DDTHH:MM\",\n \"paymentMethod\": \"BANK\",\n \"rateType\": \"BAR\",\n \"currencyCode\": \"HKD\",\n \"totalAdult\": \"3\",\n \"totalChild\": \"2\",\n \"child_ages\": [1,2],\n \"totalBaby\": \"1\",\n \"baby_ages\": [1],\n \"roomStays\": [\n {\n \"roomTypeId\": \"RXXX.X\",\n \"roomName\": \"Deluxe Double Room with Sea View\",\n \"roomType\": \"Daily Room\",\n \"ratePlanId\": \"RXXX.X.X\",\n \"cancelPolicy\": \"Non refundable\",\n \"numberOfUnits\": \"1\",\n \"adultCount\": \"2\",\n \"childCount\": \"1\",\n \"child_ages\": [1],\n \"babyCount\": \"1\",\n \"baby_ages\": [1],\n \"commission\": \"5.00\",\n \"roomIndex\": \"1\",\n \"ResGuestRPH\": \"1\",\n \"bookingPerDayPrices\": [\n {\n \"dateYmd\": \"YYYY-MM-DD\",\n \"price\": \"XXX.XX\"\n }\n ],\n \"total\": {\n \"amountAfterTaxes\": \"XXX.XX\",\n \"amountBeforeTaxes\": \"XXX.XX\"\n },\n \"roomIncServices\": [\n {\n \"serviceId\": \"123\",\n \"IncServiceName\": \"servicename\",\n \"inclusion\": \"0\",\n \"priceExtra\": \"500.30\"\n }\n ]\n },\n {\n \"roomTypeId\": \"RXXX.X\",\n \"roomName\": \"Deluxe Double Room with Sea View\",\n \"roomType\": \"Daily Room\",\n \"ratePlanId\": \"RXXX.X.X\",\n \"cancelPolicy\": \"Non refundable\",\n \"numberOfUnits\": \"1\",\n \"adultCount\": \"2\",\n \"childCount\": \"1\",\n \"child_ages\": [2],\n \"babyCount\": \"0\",\n \"baby_ages\": [],\n \"commission\": \"5.00\",\n \"roomIndex\": \"2\",\n \"ResGuestRPH\": \"2\",\n \"bookingPerDayPrices\": [\n {\n \"dateYmd\": \"YYYY-MM-DD\",\n \"price\": \"XXX.XX\"\n }\n ],\n \"total\": {\n \"amountAfterTaxes\": \"XXX.XX\",\n \"amountBeforeTaxes\": \"XXX.XX\"\n },\n \"roomIncServices\": [\n {\n \"serviceId\": \"123\",\n \"IncServiceName\": \"servicename\",\n \"inclusion\": \"0\",\n \"priceExtra\": \"500.30\"\n }\n ]\n }\n ],\n \"guestDetails\": [\n {\n \"ResGuestRPH\": \"1\",\n \"firstName\": \"Test\",\n \"lastName\": \"User\",\n \"middleName\": \"Test\",\n \"email\": \"TestUser@bakuun.com\",\n \"phone\": \"111111111\",\n \"address\": \"Pune\",\n \"country\": \"India\"\n },\n {\n \"ResGuestRPH\": \"2\",\n \"firstName\": \"Test\",\n \"lastName\": \"Userg\",\n \"middleName\": \"\",\n \"email\": \"TestUsegr@bakuun.com\",\n \"phone\": \"111111111\",\n \"address\": \"Pune\",\n \"country\": \"india\"\n }\n ],\n \"Comment\": {\n \"Text\": \"one-room\"\n },\n \"paymentCard\": {\n \"cardHolderName\": \"\",\n \"cardType\": \"\",\n \"cardCategory\": \"\",\n \"cardNumber\": \"\",\n \"ExpiryMonth\": \"\",\n \"ExpiryYear\": \"\",\n \"StartDayMonth\": \"\",\n \"StartDayYear\": \"\",\n \"IssueNum\": \"\",\n \"seriesCode\": \"\",\n \"vccBalance\": \"\",\n \"vccCurrencyCode\": \"\",\n \"vccDeactivationDate\": \"\",\n \"vccActivationDate\": \"\"\n },\n \"totalCharge\": [\n {\n \"taxDetails\": {\n \"typeTax\": \"VAT\",\n \"includes\": \"0/1\",\n \"taxPrice\": \"10.00\",\n \"taxDetails\": \"TAX 10% not included\"\n },\n \"priceDetails\": [\n {\n \"rateType\": \"BAR\",\n \"amountAfterTaxes\": \"XXX.XX\",\n \"amountBeforeTaxes\": \"XXX.XX\"\n }\n ]\n }\n ]\n }\n ]\n}", "customLabel": "" }, { "id": "b_wU_f3DwGEvnBx18_3nu", "language": "curl", "code": "curl --location 'https://wsb.bakuun.com/v1/booking/MPBXX/668451' \\\n--header 'Accept: application/json' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"username\": \"String\",\n \"password\": \"String\",\n \"partnerId\": \"String\",\n \"partnerName\": \"String\",\n \"action\": \"String\",\n \"hotelReservation\": {\n \"hotelCode\": \"\",\n \"hotelName\": \"\",\n \"resStatus\": \"\",\n \"checkIn\": \"\",\n \"checkOut\": \"\",\n \"paymentMethod\": \"\",\n \"rateType\": \"\",\n \"currencyCode\": \"\",\n \"totalAdult\": \"\",\n \"totalChild\": \"\",\n \"child_ages\": \"\",\n \"totalBaby\": \"\",\n \"baby_ages\": \"\",\n \"roomStays\": {\n \"roomTypeId\": \"\",\n \"roomName\": \"\",\n \"roomType\": \"\",\n \"ratePlanId\": \"\",\n \"cancelPolicy\": \"\",\n \"numberOfUnits\": \"\",\n \"adultCount\": \"\",\n \"childCount\": \"\",\n \"child_ages\": \"\",\n \"babyCount\": \"\",\n \"baby_ages\": \"\",\n \"commission\": \"\",\n \"roomIndex\": \"\",\n \"ResGuestRPH\": \"\",\n \"bookingPerDayPrices\": {\n \"dateYmd\": \"\",\n \"price\": \"\"\n },\n \"total\": {\n \"amountAfterTaxes\": \"\",\n \"amountBeforeTaxes\": \"\"\n },\n \"roomIncServices\": {}\n },\n \"guestDetails\": {\n \"ResGuestRPH\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"middleName\": \"\",\n \"email\": \"\",\n \"phone\": \"\",\n \"address\": \"\",\n \"country\": \"\"\n },\n \"Comment\": {\n \"Text\": \"\"\n },\n \"paymentCard\": {\n \"cardHolderName\": \"\",\n \"cardType\": \"\",\n \"cardCategory\": \"\",\n \"cardNumber\": \"\",\n \"ExpiryMonth\": \"\",\n \"ExpiryYear\": \"\",\n \"StartDayMonth\": \"\",\n \"StartDayYear\": \"\",\n \"IssueNum\": \"\",\n \"seriesCode\": \"\",\n \"vccBalance\": \"\",\n \"vccCurrencyCode\": \"\",\n \"vccDeactivationDate\": \"\",\n \"vccActivationDate\": \"\"\n },\n \"totalCharge\": {\n \"taxDetails\": {\n \"typeTax\": \"\",\n \"includes\": \"\",\n \"taxPrice\": \"\",\n \"taxDetails\": \"\"\n },\n \"priceDetails\": {\n \"rateType\": \"\",\n \"amountAfterTaxes\": \"\",\n \"amountBeforeTaxes\": \"\"\n }\n }\n }\n}'", "customLabel": "" }, { "id": "JaKd_ncp4pnb4XGXuuwcY", "language": "nodejs", "code": "var request = require('request');\nvar options = {\n 'method': 'POST',\n 'url': 'https://wsb.bakuun.com/v1/booking/MPBXX/668451',\n 'headers': {\n 'Accept': 'application/json',\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify({\n \"username\": \"String\",\n \"password\": \"String\",\n \"partnerId\": \"String\",\n \"partnerName\": \"String\",\n \"action\": \"String\",\n \"hotelReservation\": {\n \"hotelCode\": \"\",\n \"hotelName\": \"\",\n \"resStatus\": \"\",\n \"checkIn\": \"\",\n \"checkOut\": \"\",\n \"paymentMethod\": \"\",\n \"rateType\": \"\",\n \"currencyCode\": \"\",\n \"totalAdult\": \"\",\n \"totalChild\": \"\",\n \"child_ages\": \"\",\n \"totalBaby\": \"\",\n \"baby_ages\": \"\",\n \"roomStays\": {\n \"roomTypeId\": \"\",\n \"roomName\": \"\",\n \"roomType\": \"\",\n \"ratePlanId\": \"\",\n \"cancelPolicy\": \"\",\n \"numberOfUnits\": \"\",\n \"adultCount\": \"\",\n \"childCount\": \"\",\n \"child_ages\": \"\",\n \"babyCount\": \"\",\n \"baby_ages\": \"\",\n \"commission\": \"\",\n \"roomIndex\": \"\",\n \"ResGuestRPH\": \"\",\n \"bookingPerDayPrices\": {\n \"dateYmd\": \"\",\n \"price\": \"\"\n },\n \"total\": {\n \"amountAfterTaxes\": \"\",\n \"amountBeforeTaxes\": \"\"\n },\n \"roomIncServices\": {}\n },\n \"guestDetails\": {\n \"ResGuestRPH\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"middleName\": \"\",\n \"email\": \"\",\n \"phone\": \"\",\n \"address\": \"\",\n \"country\": \"\"\n },\n \"Comment\": {\n \"Text\": \"\"\n },\n \"paymentCard\": {\n \"cardHolderName\": \"\",\n \"cardType\": \"\",\n \"cardCategory\": \"\",\n \"cardNumber\": \"\",\n \"ExpiryMonth\": \"\",\n \"ExpiryYear\": \"\",\n \"StartDayMonth\": \"\",\n \"StartDayYear\": \"\",\n \"IssueNum\": \"\",\n \"seriesCode\": \"\",\n \"vccBalance\": \"\",\n \"vccCurrencyCode\": \"\",\n \"vccDeactivationDate\": \"\",\n \"vccActivationDate\": \"\"\n },\n \"totalCharge\": {\n \"taxDetails\": {\n \"typeTax\": \"\",\n \"includes\": \"\",\n \"taxPrice\": \"\",\n \"taxDetails\": \"\"\n },\n \"priceDetails\": {\n \"rateType\": \"\",\n \"amountAfterTaxes\": \"\",\n \"amountBeforeTaxes\": \"\"\n }\n }\n }\n })\n\n};\nrequest(options, function (error, response) {\n if (error) throw new Error(error);\n console.log(response.body);\n});\n", "customLabel": "" }, { "id": "SJfUTfk7e2TYZlsq9yZGf", "language": "javascript", "code": "var myHeaders = new Headers();\nmyHeaders.append(\"Accept\", \"application/json\");\nmyHeaders.append(\"Content-Type\", \"application/json\");\n\nvar raw = JSON.stringify({\n \"username\": \"String\",\n \"password\": \"String\",\n \"partnerId\": \"String\",\n \"partnerName\": \"String\",\n \"action\": \"String\",\n \"hotelReservation\": {\n \"hotelCode\": \"\",\n \"hotelName\": \"\",\n \"resStatus\": \"\",\n \"checkIn\": \"\",\n \"checkOut\": \"\",\n \"paymentMethod\": \"\",\n \"rateType\": \"\",\n \"currencyCode\": \"\",\n \"totalAdult\": \"\",\n \"totalChild\": \"\",\n \"child_ages\": \"\",\n \"totalBaby\": \"\",\n \"baby_ages\": \"\",\n \"roomStays\": {\n \"roomTypeId\": \"\",\n \"roomName\": \"\",\n \"roomType\": \"\",\n \"ratePlanId\": \"\",\n \"cancelPolicy\": \"\",\n \"numberOfUnits\": \"\",\n \"adultCount\": \"\",\n \"childCount\": \"\",\n \"child_ages\": \"\",\n \"babyCount\": \"\",\n \"baby_ages\": \"\",\n \"commission\": \"\",\n \"roomIndex\": \"\",\n \"ResGuestRPH\": \"\",\n \"bookingPerDayPrices\": {\n \"dateYmd\": \"\",\n \"price\": \"\"\n },\n \"total\": {\n \"amountAfterTaxes\": \"\",\n \"amountBeforeTaxes\": \"\"\n },\n \"roomIncServices\": {}\n },\n \"guestDetails\": {\n \"ResGuestRPH\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"middleName\": \"\",\n \"email\": \"\",\n \"phone\": \"\",\n \"address\": \"\",\n \"country\": \"\"\n },\n \"Comment\": {\n \"Text\": \"\"\n },\n \"paymentCard\": {\n \"cardHolderName\": \"\",\n \"cardType\": \"\",\n \"cardCategory\": \"\",\n \"cardNumber\": \"\",\n \"ExpiryMonth\": \"\",\n \"ExpiryYear\": \"\",\n \"StartDayMonth\": \"\",\n \"StartDayYear\": \"\",\n \"IssueNum\": \"\",\n \"seriesCode\": \"\",\n \"vccBalance\": \"\",\n \"vccCurrencyCode\": \"\",\n \"vccDeactivationDate\": \"\",\n \"vccActivationDate\": \"\"\n },\n \"totalCharge\": {\n \"taxDetails\": {\n \"typeTax\": \"\",\n \"includes\": \"\",\n \"taxPrice\": \"\",\n \"taxDetails\": \"\"\n },\n \"priceDetails\": {\n \"rateType\": \"\",\n \"amountAfterTaxes\": \"\",\n \"amountBeforeTaxes\": \"\"\n }\n }\n }\n});\n\nvar requestOptions = {\n method: 'POST',\n headers: myHeaders,\n body: raw,\n redirect: 'follow'\n};\n\nfetch(\"https://wsb.bakuun.com/v1/booking/MPBXX/668451\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));", "customLabel": "" }, { "id": "M1bUz-RJyosksUCRH6xQT", "language": "python", "code": "import requests\nimport json\n\nurl = \"https://wsb.bakuun.com/v1/booking/MPBXX/668451\"\n\npayload = json.dumps({\n \"username\": \"String\",\n \"password\": \"String\",\n \"partnerId\": \"String\",\n \"partnerName\": \"String\",\n \"action\": \"String\",\n \"hotelReservation\": {\n \"hotelCode\": \"\",\n \"hotelName\": \"\",\n \"resStatus\": \"\",\n \"checkIn\": \"\",\n \"checkOut\": \"\",\n \"paymentMethod\": \"\",\n \"rateType\": \"\",\n \"currencyCode\": \"\",\n \"totalAdult\": \"\",\n \"totalChild\": \"\",\n \"child_ages\": \"\",\n \"totalBaby\": \"\",\n \"baby_ages\": \"\",\n \"roomStays\": {\n \"roomTypeId\": \"\",\n \"roomName\": \"\",\n \"roomType\": \"\",\n \"ratePlanId\": \"\",\n \"cancelPolicy\": \"\",\n \"numberOfUnits\": \"\",\n \"adultCount\": \"\",\n \"childCount\": \"\",\n \"child_ages\": \"\",\n \"babyCount\": \"\",\n \"baby_ages\": \"\",\n \"commission\": \"\",\n \"roomIndex\": \"\",\n \"ResGuestRPH\": \"\",\n \"bookingPerDayPrices\": {\n \"dateYmd\": \"\",\n \"price\": \"\"\n },\n \"total\": {\n \"amountAfterTaxes\": \"\",\n \"amountBeforeTaxes\": \"\"\n },\n \"roomIncServices\": {}\n },\n \"guestDetails\": {\n \"ResGuestRPH\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"middleName\": \"\",\n \"email\": \"\",\n \"phone\": \"\",\n \"address\": \"\",\n \"country\": \"\"\n },\n \"Comment\": {\n \"Text\": \"\"\n },\n \"paymentCard\": {\n \"cardHolderName\": \"\",\n \"cardType\": \"\",\n \"cardCategory\": \"\",\n \"cardNumber\": \"\",\n \"ExpiryMonth\": \"\",\n \"ExpiryYear\": \"\",\n \"StartDayMonth\": \"\",\n \"StartDayYear\": \"\",\n \"IssueNum\": \"\",\n \"seriesCode\": \"\",\n \"vccBalance\": \"\",\n \"vccCurrencyCode\": \"\",\n \"vccDeactivationDate\": \"\",\n \"vccActivationDate\": \"\"\n },\n \"totalCharge\": {\n \"taxDetails\": {\n \"typeTax\": \"\",\n \"includes\": \"\",\n \"taxPrice\": \"\",\n \"taxDetails\": \"\"\n },\n \"priceDetails\": {\n \"rateType\": \"\",\n \"amountAfterTaxes\": \"\",\n \"amountBeforeTaxes\": \"\"\n }\n }\n }\n})\nheaders = {\n 'Accept': 'application/json',\n 'Content-Type': 'application/json'\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.text)\n", "customLabel": "" }, { "id": "TnqH6b8wimJP1yLmXjvbg", "language": "ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://wsb.bakuun.com/v1/booking/MPBXX/668451\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"Accept\"] = \"application/json\"\nrequest[\"Content-Type\"] = \"application/json\"\nrequest.body = JSON.dump({\n \"username\": \"String\",\n \"password\": \"String\",\n \"partnerId\": \"String\",\n \"partnerName\": \"String\",\n \"action\": \"String\",\n \"hotelReservation\": {\n \"hotelCode\": \"\",\n \"hotelName\": \"\",\n \"resStatus\": \"\",\n \"checkIn\": \"\",\n \"checkOut\": \"\",\n \"paymentMethod\": \"\",\n \"rateType\": \"\",\n \"currencyCode\": \"\",\n \"totalAdult\": \"\",\n \"totalChild\": \"\",\n \"child_ages\": \"\",\n \"totalBaby\": \"\",\n \"baby_ages\": \"\",\n \"roomStays\": {\n \"roomTypeId\": \"\",\n \"roomName\": \"\",\n \"roomType\": \"\",\n \"ratePlanId\": \"\",\n \"cancelPolicy\": \"\",\n \"numberOfUnits\": \"\",\n \"adultCount\": \"\",\n \"childCount\": \"\",\n \"child_ages\": \"\",\n \"babyCount\": \"\",\n \"baby_ages\": \"\",\n \"commission\": \"\",\n \"roomIndex\": \"\",\n \"ResGuestRPH\": \"\",\n \"bookingPerDayPrices\": {\n \"dateYmd\": \"\",\n \"price\": \"\"\n },\n \"total\": {\n \"amountAfterTaxes\": \"\",\n \"amountBeforeTaxes\": \"\"\n },\n \"roomIncServices\": {}\n },\n \"guestDetails\": {\n \"ResGuestRPH\": \"\",\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"middleName\": \"\",\n \"email\": \"\",\n \"phone\": \"\",\n \"address\": \"\",\n \"country\": \"\"\n },\n \"Comment\": {\n \"Text\": \"\"\n },\n \"paymentCard\": {\n \"cardHolderName\": \"\",\n \"cardType\": \"\",\n \"cardCategory\": \"\",\n \"cardNumber\": \"\",\n \"ExpiryMonth\": \"\",\n \"ExpiryYear\": \"\",\n \"StartDayMonth\": \"\",\n \"StartDayYear\": \"\",\n \"IssueNum\": \"\",\n \"seriesCode\": \"\",\n \"vccBalance\": \"\",\n \"vccCurrencyCode\": \"\",\n \"vccDeactivationDate\": \"\",\n \"vccActivationDate\": \"\"\n },\n \"totalCharge\": {\n \"taxDetails\": {\n \"typeTax\": \"\",\n \"includes\": \"\",\n \"taxPrice\": \"\",\n \"taxDetails\": \"\"\n },\n \"priceDetails\": {\n \"rateType\": \"\",\n \"amountAfterTaxes\": \"\",\n \"amountBeforeTaxes\": \"\"\n }\n }\n }\n})\n\nresponse = https.request(request)\nputs response.read_body\n", "customLabel": "" } ], "selectedLanguageId": "NWQsuC0YyAXzpBxC7Hsc4" }, "results": { "languages": [ { "id": "38fZnvOie_bNLYPuvjyWh", "language": "200", "code": "{\n \"success\": true,\n \"data\": [\n {\n \"hotelId\": \"HTLXX\",\n \"BookingTokenCode\": \"BTCXXXXXXXXXXXXX\"\n }\n ],\n \"warnings\": [],\n \"errors\": []\n}", "customLabel": "" }, { "id": "13et4ryAH9wUvy10huIqK", "language": "451", "code": "{\n \"success\": false,\n \"errors\": [\n {\n \"code\": 449,\n \"message\": \"Check-in date exceeded\"\n }\n ]\n}", "customLabel": "" } ], "selectedLanguageId": "38fZnvOie_bNLYPuvjyWh" }, "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": "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 getBooking", "": "Always set as getBooking" }, { "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 New" }, { "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": "child_ages", "kind": "required", "type": "array", "description": "Ages of all children." }, { "name": "totalBaby", "kind": "required", "type": "string", "description": "Total infant across all rooms." }, { "name": "baby_ages", "kind": "required", "type": "array", "description": "Ages of all infant." }, { "name": "roomStays", "kind": "required", "type": "object", "description": "", "children": [ { "name": "roomTypeId", "kind": "required", "type": "string", "description": "Bakuun / Partner room ID." }, { "name": "roomName", "kind": "required", "type": "string", "description": "Room name" }, { "name": "roomType", "kind": "required", "type": "string", "description": "DailyRoom would be the used default category " }, { "name": "ratePlanId", "kind": "required", "type": "string", "description": "Bakuun / Partner 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 min value" }, { "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": "child_ages", "kind": "required", "type": "array", "description": "Ages of children." }, { "name": "babyCount", "kind": "required", "type": "string", "description": "Number of infant in this room." }, { "name": "baby_ages", "kind": "required", "type": "array", "description": "Ages of infant." }, { "name": "commission", "kind": "required", "type": "string", "description": "Commission value accepted between 0 and 99, or left empty if not applicable." }, { "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": "roomIncServices", "kind": "required", "type": "object", "description": "", "children": [ { "name": "serviceId", "kind": "optional", "type": "string", "description": "Unique service identifier." }, { "name": "IncServiceName", "kind": "optional", "type": "string", "description": "Name of the service." }, { "name": "inclusion", "kind": "optional", "type": "string", "description": "Indicator of whether the service is included in the room price.\n0 = Included\n1 = Not included (added as extra)" }, { "name": "priceExtra", "kind": "optional", "type": "string", "description": "Extra charge amount, only applicable when inclusion = 1." } ] } ] }, { "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": "Expiry MM." }, { "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": "vccDeactivationDate", "kind": "required", "type": "string", "description": "Deactivation date." }, { "name": "vccActivationDate", "kind": "required", "type": "string", "description": "Activation 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", "children": [] }, { "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." } ] } ] } ], "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 New" }, { "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": "child_ages", "kind": "required", "type": "array", "description": "Ages of all children." }, { "name": "totalBaby", "kind": "required", "type": "string", "description": "Total infant across all rooms." }, { "name": "baby_ages", "kind": "required", "type": "array", "description": "Ages of all infant." }, { "name": "roomStays", "kind": "required", "type": "object", "description": "", "children": [ { "name": "roomTypeId", "kind": "required", "type": "string", "description": "Bakuun / Partner room ID." }, { "name": "roomName", "kind": "required", "type": "string", "description": "Room name" }, { "name": "roomType", "kind": "required", "type": "string", "description": "DailyRoom would be the used default category " }, { "name": "ratePlanId", "kind": "required", "type": "string", "description": "Bakuun / Partner 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 min value" }, { "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": "child_ages", "kind": "required", "type": "array", "description": "Ages of children." }, { "name": "babyCount", "kind": "required", "type": "string", "description": "Number of infant in this room." }, { "name": "baby_ages", "kind": "required", "type": "array", "description": "Ages of infant." }, { "name": "commission", "kind": "required", "type": "string", "description": "Commission value accepted between 0 and 99, or left empty if not applicable." }, { "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": "roomIncServices", "kind": "required", "type": "object", "description": "", "children": [ { "name": "serviceId", "kind": "optional", "type": "string", "description": "Unique service identifier." }, { "name": "IncServiceName", "kind": "optional", "type": "string", "description": "Name of the service." }, { "name": "inclusion", "kind": "optional", "type": "string", "description": "Indicator of whether the service is included in the room price.\n0 = Included\n1 = Not included (added as extra)" }, { "name": "priceExtra", "kind": "optional", "type": "string", "description": "Extra charge amount, only applicable when inclusion = 1." } ] } ] }, { "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": "Expiry MM." }, { "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": "vccDeactivationDate", "kind": "required", "type": "string", "description": "Deactivation date." }, { "name": "vccActivationDate", "kind": "required", "type": "string", "description": "Activation 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", "children": [] }, { "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." } ] } ] } ] } ], "formDataParameters": [] }, "currentNewParameter": { "label": "Body Parameter", "value": "bodyDataParameters" }, "hasTryItOut": false, "response": [ { "name": "success", "kind": "optional", "type": "boolean", "description": "" }, { "name": "data", "kind": "optional", "type": "object", "description": "", "children": [ { "name": "hotelId", "kind": "optional", "type": "string", "description": "Unique Bakuun or Partner property ID. " }, { "name": "BookingTokenCode", "kind": "optional", "type": "string", "description": "Unique Token code generated in pre-booking response" } ] }, { "name": "warnings", "kind": "optional", "type": "array", "description": "", "children": [] }, { "name": "errors", "kind": "optional", "type": "array", "description": "", "children": [] } ], "autoGeneratedAnchorSlug": "pre-booking", "legacyHash": "45Qw1MU_Vc6tLp1-Abf2n" } ``` :::