Welcome to GuestPro Revenue Booster Open API Documentation
\nThis page contains information about the services and API provided by GuestPro. You'll find API documentation with examples, object model explanations, code snippets and integration best practices examples.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"47774192","collectionId":"4cc8bd55-8b28-415c-a037-a82e00e7aad2","publishedId":"2sB3BLhSLv","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-02-04T09:05:15.000Z"},"item":[{"name":"Channel Manager","item":[{"name":"Availability","item":[{"name":"Update Availability","id":"e1d4ef73-7e41-4d88-98a2-d267f625a4aa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{api_key}}","description":"api key for authorization
\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"data\": [\n {\n \"attributes\": {\n \"changes\": [\n {\n \"attributes\": {\n \"room_type_id\": \"a5b80161-8f78-40ff-ae25-6bd690ebdf35\",\n \"date_from\": \"2026-12-01\",\n \"date_to\": \"2026-12-03\",\n \"availability\": 4\n },\n \"type\": \"availability_changes\"\n }\n ],\n \"hotel_code\": \"{{your_hotel_code}}\",\n \"request_id\": \"3911470b-1a95-48a5-b726-2ac187bdc662\"\n },\n \"type\": \"changes_notification\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/cm/api/{{your_cm_code}}/changes/availability","description":"This endpoint allows you to submit changes related to hotel availability for a specific hotel. It is primarily used to notify the system about updates in room availability over a specified date range.
\nHTTP Method: POST
URL: {{base_url}}/cm/api/{{your_cm_code}}/changes
The request body must be in JSON format and should include the following structure:
\n{\n \"data\": [\n {\n \"attributes\": {\n \"changes\": [\n {\n \"attributes\": {\n \"room_type_id\": \"string\", // Unique identifier for the room type\n \"date_from\": \"string\", // Start date for the availability change (YYYY-MM-DD)\n \"date_to\": \"string\", // End date for the availability change (YYYY-MM-DD)\n \"availability\": \"integer\" // Availability status (1 for available, 0 for unavailable)\n },\n \"type\": \"availability_changes\" // Type of change being reported\n }\n ],\n \"hotel_code\": \"string\", // Unique code for the hotel\n \"request_id\": \"string\" // Unique identifier for the request\n },\n \"type\": \"changes_notification\" // Type of the data being sent\n }\n ]\n}\n\nThe response will contain information regarding the success or failure of the request. It typically includes status codes and any relevant messages that indicate the outcome of the operation. The exact structure of the response may vary based on the implementation but will generally provide feedback on the processed changes.
\nResponse Example
\nEnsure that the room_type_id, hotel_code, and request_id are correctly specified to avoid processing errors.
The date_from and date_to fields should be formatted as per the ISO 8601 standard (YYYY-MM-DD).
Availability should be represented as an integer, where 1 indicates available and 0 indicates not available.
Each time CM catches any changes at the property state associated with Room Types and Availability mapped to your system, CM will generate a changes message and send it to Revenue Booster endpoint via POST request.
\n","_postman_id":"6b9edb87-bdf3-45ce-a4af-258deacb8139"},{"name":"Rates","item":[{"name":"Update Rates","id":"b9305c5b-7ff0-4a39-95c9-1dfd2716cb99","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{api_key}}","description":"api key for authorization
\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"data\": [\n {\n \"attributes\": {\n \"changes\": [\n {\n \"attributes\": {\n \"date_from\": \"2026-12-01\",\n \"date_to\": \"2026-12-02\",\n \"rate_plan_id\": \"1e5d0be9-875d-4f80-8af1-d5a0e60e94dd\",\n \"rates\": [\n {\n \"currency\": \"USD\",\n \"occupancy\": 2,\n \"rate\": \"125.00\"\n }\n ],\n \"extra_adult\": 20,\n \"extra_child\": 10,\n \"extra_infant\": 0,\n \"room_type_id\": \"a5b80161-8f78-40ff-ae25-6bd690ebdf35\"\n },\n \"type\": \"rate_changes\"\n }\n ],\n \"hotel_code\": \"{{your_hotel_code}}\",\n \"request_id\": \"3911470b-1a95-48a5-b726-2ac187bdc662\"\n },\n \"type\": \"changes_notification\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/cm/api/{{your_cm_code}}/changes/rate","description":"This endpoint allows users to submit changes related to hotel rates and availability. It is designed to notify the system about specific rate changes for a given hotel.
\nThe request body must be a JSON object containing the following structure:
\ndata: An array of change objects.
\nattributes: Contains the details of the changes.
\nchanges: An array of change details.
\nattributes: Contains the specifics of the rate change.
\ndate_from: (String) The start date of the rate change in YYYY-MM-DD format.
\ndate_to: (String) The end date of the rate change in YYYY-MM-DD format.
\nrate_plan_id: (String) The unique identifier for the rate plan being modified.
\nrates: An array of rate objects.
\ncurrency: (String) The currency code for the rate.
\noccupancy: (Integer) The occupancy level for which the rate is applicable.
\nrate: (String) The rate amount.
\nextra_adult (integer): The additional charge applied per extra adult guest per night beyond the base occupancy of the room.
\nextra_child (integer): The additional charge applied per extra child guest per night beyond the base occupancy of the room.
\nextra_infant (integer): The additional charge applied per extra infant guest per night beyond the base occupancy of the room.
\nroom_type_id: (String) The unique identifier for the room type being modified.
\nhotel_code: (String) The unique code for the hotel.
\nrequest_id: (String) A unique identifier for the request.
\ntype: (String) Indicates the type of the notification, which should be set to \"changes_notification\".
\nThe response will confirm the successful processing of the request. It typically includes a status code and a message indicating the outcome of the operation. The exact structure may vary based on the implementation but generally includes:
\nstatus: (String) Indicates whether the request was successful or if there were errors.
\nmessage: (String) A descriptive message providing additional information about the request outcome.
\ndata: (Object) May contain additional details related to the processed changes, if applicable.
\nEnsure that the input adheres to the specified structure to avoid errors in processing the request.
\n","urlObject":{"path":["cm","api","{{your_cm_code}}","changes","rate"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"b9305c5b-7ff0-4a39-95c9-1dfd2716cb99"}],"id":"069461d0-b221-40ed-b50d-aa494d6550eb","description":"Each time CM catches any changes at the property state associated with Rate Plans and Room Type mapped to your system, CM will generate a changes message and send it to Revenue Booster endpoint via POST request.
\n","_postman_id":"069461d0-b221-40ed-b50d-aa494d6550eb"},{"name":"Restriction","item":[{"name":"Update Restrictions","id":"49b36827-2554-498e-9f75-2ef9e14bd95c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{api_key}}","description":"api key for authorization
\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"data\": [\n {\n \"attributes\": {\n \"changes\": [\n {\n \"attributes\": {\n \"rate_plan_id\": \"1e5d0be9-875d-4f80-8af1-d5a0e60e94dd\",\n \"room_type_id\": \"a5b80161-8f78-40ff-ae25-6bd690ebdf35\",\n \"closed_to_arrival\": true,\n \"closed_to_departure\": true,\n \"date_from\": \"2026-12-01\",\n \"date_to\": \"2026-12-02\",\n \"max_stay\": 123,\n \"min_stay_arrival\": 2,\n \"stop_sell\": true\n },\n \"type\": \"restriction_changes\"\n },\n {\n \"attributes\": {\n \"rate_plan_id\": \"1e5d0be9-875d-4f80-8af1-d5a0e60e94dd\",\n \"room_type_id\": \"a5b80161-8f78-40ff-ae25-6bd690ebdf35\",\n \"date_from\": \"2026-12-01\",\n \"date_to\": \"2026-12-02\",\n \"stop_sell\": false\n },\n \"type\": \"restriction_changes\"\n },\n {\n \"attributes\": {\n \"rate_plan_id\": \"1e5d0be9-875d-4f80-8af1-d5a0e60e94dd\",\n \"room_type_id\": \"a5b80161-8f78-40ff-ae25-6bd690ebdf35\",\n \"date_from\": \"2026-12-01\",\n \"date_to\": \"2026-12-04\",\n \"max_stay\": 12,\n \"min_stay_arrival\": 3\n },\n \"type\": \"restriction_changes\"\n }\n ],\n \"hotel_code\": \"{{your_hotel_code}}\",\n \"request_id\": \"3911470b-1a95-48a5-b726-2ac187bdc662\"\n },\n \"type\": \"changes_notification\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/cm/api/{{your_cm_code}}/changes/restriction","description":"This endpoint allows users to submit changes related to hotel restrictions and availability. It is designed to handle updates for specific hotel properties by providing a structured payload that includes details about the changes being made.
\nMethod: POST
URL: {{base_url}}/cm/api/{{your_cm_code}}/changes
The request body must be in JSON format and should contain the following structure:
\n{\n \"data\": [\n {\n \"attributes\": {\n \"changes\": [\n {\n \"attributes\": {\n \"closed_to_arrival\": <boolean>,\n \"closed_to_departure\": <boolean>,\n \"date_from\": <string>,\n \"date_to\": <string>,\n \"max_stay\": <integer>,\n \"min_stay_arrival\": <integer>,\n \"rate_plan_id\": <string>,\n \"room_type_id\": <string>,\n \"stop_sell\": <boolean>\n },\n \"type\": \"restriction_changes\"\n }\n ],\n \"hotel_code\": <string>,\n \"request_id\": <string>\n },\n \"type\": \"changes_notification\"\n }\n ]\n}\n\nclosed_to_arrival (boolean): Indicates if arrivals are closed for the specified dates.
\nclosed_to_departure (boolean): Indicates if departures are closed for the specified dates.
\ndate_from (string): The start date for the changes in YYYY-MM-DD format.
date_to (string): The end date for the changes in YYYY-MM-DD format.
max_stay (integer): The maximum number of nights a guest can stay.
\nmin_stay_arrival (integer): The minimum number of nights required for arrivals.
\nrate_plan_id (string): The identifier for the rate plan associated with the changes.
\nroom_type_id (string): The identifier for the room type affected by the changes.
\nstop_sell (boolean): Indicates if the property should stop selling for the specified dates.
\nhotel_code (string): The unique identifier for the hotel.
\nrequest_id (string): A unique identifier for the request, useful for tracking purposes.
\nThe response will contain a confirmation of the changes submitted. The structure of the response will typically include:
\nA status indicating the success or failure of the request.
\nAny relevant messages or error details if applicable.
\nThis endpoint is crucial for managing hotel availability and restrictions effectively, ensuring that the changes are communicated accurately to the system.
\n","urlObject":{"path":["cm","api","{{your_cm_code}}","changes","restriction"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"49b36827-2554-498e-9f75-2ef9e14bd95c"}],"id":"44ffe3f6-688b-4d4c-a82b-b022f7cc8b12","_postman_id":"44ffe3f6-688b-4d4c-a82b-b022f7cc8b12","description":""},{"name":"Reservation","item":[{"name":"Push Reservation","id":"ad909039-5be5-4d72-8fd6-a71261c81b7e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"booking\": {\n \"status\": \"new\",\n \"provider_code\": \"Guestaps\",\n \"hotel_code\": \"the-uma-desa\",\n \"reservation_id\": \"b3b24f0b-179b-4e9a-afa4-e3a1ef882a48\",\n \"arrival_date\": \"2024-08-11\",\n \"departure_date\": \"2024-08-13\",\n \"currency\": \"IDR\",\n \"payment_collect\": \"property\",\n \"payment_type\": \"bank_transfer\",\n \"customer\": {\n \"name\": \"Made Cenik\",\n \"surname\": \"\",\n \"country\": \"ID\",\n \"address\": \"\",\n \"mail\": \"opit.guestpro@gmail.com\",\n \"phone\": \"+628123456789\",\n \"meta\": {}\n },\n \"notes\": \"Other request\",\n \"rooms\": [\n {\n \"room_type_code\": \"5a30f1b7-ea38-44ed-93a7-6b6c95e24930\",\n \"occupancy\": {\n \"adults\": 2,\n \"children\": 1,\n \"infants\": 0\n },\n \"guests\": [],\n \"days\": [\n {\n \"date\": \"2024-08-11\",\n \"price\": \"2050000.0\",\n \"rate_plan_code\": \"ea6e904c-c9c2-415c-8c48-4536c36478a1\"\n },\n {\n \"date\": \"2024-08-12\",\n \"price\": \"2050000.0\",\n \"rate_plan_code\": \"ea6e904c-c9c2-415c-8c48-4536c36478a1\"\n }\n ],\n \"services\": [],\n \"taxes\": [],\n \"meta\": {}\n },\n {\n \"room_type_code\": \"c7d11888-4676-47d4-a891-bff26cee71d3\",\n \"occupancy\": {\n \"adults\": 0,\n \"children\": 0,\n \"infants\": 1\n },\n \"guests\": [],\n \"days\": [\n {\n \"date\": \"2024-08-11\",\n \"price\": \"4000000.0\",\n \"rate_plan_code\": \"495203a8-04f4-4194-b3d1-89ea67ace1e9\"\n },\n {\n \"date\": \"2024-08-12\",\n \"price\": \"4000000.0\",\n \"rate_plan_code\": \"495203a8-04f4-4194-b3d1-89ea67ace1e9\"\n }\n ],\n \"services\": [],\n \"taxes\": [],\n \"meta\": {}\n }\n ],\n \"services\": [],\n \"taxes\": [],\n \"deposits\": [\n {\n \"amount\": \"12700000.00\",\n \"currency\": \"IDR\",\n \"charget_at\": \"2024-07-11T07:06:35.701583Z\",\n \"type\": \"bank_transfer\",\n \"notes\": \"\",\n \"provider_meta\": null\n }\n ],\n \"meta\": {}\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{your_cm_reservation_api}}","description":"This endpoint is designed to create a new booking. It accepts a JSON payload that contains comprehensive details about the booking, including customer information, reservation dates, room types, and payment details.
\nThe request body must be a JSON object with the following structure:
\nbooking: An object containing all booking-related information.
\nstatus: (string) The current status of the booking (e.g., \"new\").
\nprovider_code: (string) The code representing the booking provider.
\nhotel_code: (string) The code of the hotel where the booking is made.
\nreservation_id: (string) A unique identifier for the reservation.
\narrival_date: (string) The date of arrival in the format YYYY-MM-DD.
\ndeparture_date: (string) The date of departure in the format YYYY-MM-DD.
\ncurrency: (string) The currency code for the booking (e.g., \"IDR\").
\npayment_collect: (string) Indicates who will collect the payment (e.g., \"property\").
\npayment_type: (string) The type of payment method used (e.g., \"bank_transfer\").
\ncustomer: An object containing customer details.
\nname: (string) The first name of the customer.
\nsurname: (string) The last name of the customer.
\ncountry: (string) The country code of the customer.
\naddress: (string) The address of the customer.
\nmail: (string) The email address of the customer.
\nphone: (string) The phone number of the customer.
\nmeta: (object) Additional metadata about the customer.
\nnotes: (string) Any additional notes related to the booking.
\nrooms: (array) A list of room objects, each containing:
\nroom_type_code: (string) The code for the type of room booked.
\noccupancy: An object specifying the number of occupants.
\nadults: (integer) Number of adults.
\nchildren: (integer) Number of children.
\ninfants: (integer) Number of infants.
\nguests: (array) A list of guests (if applicable).
\ndays: (array) A list of objects for each day of the stay, each containing:
\ndate: (string) The date in the format YYYY-MM-DD.
\nprice: (string) The price for that day.
\nrate_plan_code: (string) The code for the rate plan.
\ntaxes: (array) A list of taxes applicable to the room.
\nmeta: (object) Additional metadata related to the room.
\nservices: (array) A list of additional services requested.
\ntaxes: (array) A list of taxes applicable to the booking.
\ndeposits: (array) A list of deposit objects, each containing:
\namount: (string) The amount of the deposit.
\ncurrency: (string) The currency of the deposit.
\ncharget_at: (string) The date and time when the charge is expected.
\ntype: (string) The type of deposit (e.g., \"bank_transfer\").
\nnotes: (string) Any notes related to the deposit.
\nprovider_meta: (object) Additional metadata from the provider.
\nThe expected response will confirm the successful creation of the booking, typically returning a status code indicating success (e.g., 200 OK) along with a confirmation message or the details of the created booking.
\nEnsure that all required fields are provided in the request body to avoid validation errors.
\nBe mindful of the data formats, especially for dates and currency.
\nIt is recommended to handle any errors gracefully in your application to enhance user experience.
\nThis endpoint retrieves mapping details for a specific hotel. It allows users to obtain information related to the mapping configuration based on the provided hotel code.
\nMethod: GET
URL: {{base_url}}/cm/api/{{your_cm_code}}/mapping_details?hotel_code={{your_hotel_code}}
hotel_code (required): The unique identifier for the hotel whose mapping details are being requested.GET {{base_url}}/cm/api/12345/mapping_details?hotel_code=H123\n\nThe response will contain the mapping details for the specified hotel in JSON format. The structure of the response typically includes the following fields:
\nstatus: Indicates the success or failure of the request.
data: An object containing the mapping details, which may include:
mapping_id: The unique identifier for the mapping.
hotel_code: The hotel code associated with the mapping.
mapping_info: Detailed information regarding the mapping configuration.
{\n \"data\": {\n \"type\": \"mapping_details\",\n \"attributes\": {\n \"room_types\": [\n {\n \"id\": \"1cd68008-6bae-45d1-8d58-961820530a8d\",\n \"title\": \"Hashira Room\",\n \"rate_plans\": [\n {\n \"id\": \"722399c4-e5f9-4bdc-9a22-1a096bc5e2f8\",\n \"title\": \"Hashira Room Only\",\n \"sell_mode\": \"per_room\",\n \"max_persons\": 3,\n \"currency\": \"IDR\",\n \"read_only\": false\n }\n ]\n },\n {\n \"id\": \"5a4e1c44-e5d6-4e76-8efb-633aab7db41e\",\n \"title\": \"Luxury Room\",\n \"rate_plans\": [\n {\n \"id\": \"20b766b4-b1ab-4963-9a78-015a7a5f0e19\",\n \"title\": \"Luxury Honey Moon Package 7 Night\",\n \"sell_mode\": \"per_room\",\n \"max_persons\": 2,\n \"currency\": \"IDR\",\n \"read_only\": false\n },\n {\n \"id\": \"46784792-4b91-4bf1-9394-b9d7c4a7d802\",\n \"title\": \"Luxury Room Only\",\n \"sell_mode\": \"per_room\",\n \"max_persons\": 2,\n \"currency\": \"IDR\",\n \"read_only\": false\n },\n {\n \"id\": \"dd6bd055-3cd7-4434-9e9e-93abf8a54a06\",\n \"title\": \"Luxury Room with Breakfast\",\n \"sell_mode\": \"per_room\",\n \"max_persons\": 2,\n \"currency\": \"IDR\",\n \"read_only\": false\n },\n {\n \"id\": \"fc0bfd0b-96c2-40e2-8229-fb2f7c7b2262\",\n \"title\": \"Luxury Room Package\",\n \"sell_mode\": \"per_room\",\n \"max_persons\": 2,\n \"currency\": \"IDR\",\n \"read_only\": false\n }\n ]\n }\n ]\n }\n }\n}\n\nThis response indicates that the request was successful and provides detailed mapping information for the specified hotel.
\n","urlObject":{"path":["cm","api","{{your_cm_code}}","mapping-details"],"host":["{{base_url}}"],"query":[{"key":"hotel_code","value":"{{your_hotel_code}}"}],"variable":[]}},"response":[{"id":"9ac0e3fe-7aa7-4481-aa67-983f612277f5","name":"Get Mapping Details","originalRequest":{"method":"GET","header":[{"key":"api-key","value":"{{api_key}}","type":"text"}],"url":{"raw":"{{base_url}}/cm/api/{{your_cm_code}}/mapping-details?hotel_code={{your_hotel_code}}","host":["{{base_url}}"],"path":["cm","api","{{your_cm_code}}","mapping-details"],"query":[{"key":"hotel_code","value":"{{your_hotel_code}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 08 Sep 2025 03:03:31 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"allow","value":"GET, HEAD, OPTIONS"},{"key":"x-frame-options","value":"DENY"},{"key":"vary","value":"Accept-Language, origin"},{"key":"content-language","value":"en"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"x-served-by","value":"demo-ga-api.guestpro.co.id"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=LGjSkdX2iUMQKRGxySJPzxVb%2Fp5zj1ikl5uY6OXUTqkgAg0dfD%2BNQQWK3gh8mka0qm90UTlIDN2CcysvYMrtC3b7E2OKJErCycsMVx0ziVDP59gqPN%2B9GA%3D%3D\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"97bb36914d4b5542-SIN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"type\": \"mapping_details\",\n \"attributes\": {\n \"room_types\": [\n {\n \"id\": \"a5b80161-8f78-40ff-ae25-6bd690ebdf35\",\n \"title\": \"Deluxe1\",\n \"rate_plans\": [\n {\n \"id\": \"0cc3ad0a-6a79-4daa-8a5c-76e6fd5b0c00\",\n \"title\": \"Deluxe Breakfast\",\n \"sell_mode\": \"per_room\",\n \"max_persons\": 4,\n \"currency\": \"USD\",\n \"read_only\": false\n },\n {\n \"id\": \"1e5d0be9-875d-4f80-8af1-d5a0e60e94dd\",\n \"title\": \"Deluxe Room Only\",\n \"sell_mode\": \"per_room\",\n \"max_persons\": 4,\n \"currency\": \"USD\",\n \"read_only\": false\n }\n ]\n }\n ]\n }\n }\n}"}],"_postman_id":"5a007f54-da78-4c78-a5b3-812698c91cbd"},{"name":"Update Mapping","id":"dcd3664e-314f-4ebe-aea6-380f75a8f1c5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{api_key}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"data\": {\n \"type\": \"mapping_update\",\n \"hotel_code\": \"HTMVO1\",\n \"attributes\": {\n \"room_types\": [\n {\n \"id\": \"1b791f41-6a1d-45a6-bc81-b43464226e6f\",\n \"cm_id\": \"BVL\",\n \"rate_plans\": [\n {\n \"id\": \"377ad35e-515c-4027-9614-7476d690faae\",\n \"cm_id\": \"BAR\"\n },\n {\n \"id\": \"f0862517-590c-45eb-a3a2-1ed6b8b771c1\",\n \"cm_id\": \"WEB\"\n }\n ]\n },\n {\n \"id\": \"d16681b0-7937-4abd-b529-97da327e20e2\",\n \"cm_id\": \"WVL\",\n \"rate_plans\": [\n {\n \"id\": \"53709b8e-ea55-46cd-9ca5-b6af63a31f94\",\n \"cm_id\": \"WEB\"\n },\n {\n \"id\": \"1343013a-c077-498b-8749-f35a6cf9f734\",\n \"cm_id\": \"BAR\"\n }\n ]\n }\n ]\n }\n }\n}\n","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/cm/api/{{your_cm_code}}/mapping-update","description":"This endpoint allows you to update the mapping information for a specific hotel in the system. It is primarily used to modify the room types and associated rate plans for a hotel.
\nMethod: POST
\nEndpoint: {{base_url}}/cm/api/{{your_cm_code}}/mapping-update
The request body must be in JSON format and should contain the following structure:
\n{\n \"data\": {\n \"type\": \"mapping_update\",\n \"hotel_code\": \"MALDIVES_HOTEL\",\n \"attributes\": {\n \"room_types\": [\n {\n \"id\": \"string\",\n \"cm_id\": \"string\",\n \"rate_plans\": [\n {\n \"id\": \"string\",\n \"cm_id\": \"string\"\n }\n ]\n }\n ]\n }\n }\n}\n\ndata: An object that contains the details of the mapping update.
\ntype: A string indicating the type of operation, which should be set to \"mapping_update\".
\nhotel_code: A string representing the unique code of the hotel being updated.
\nattributes: An object containing the attributes of the mapping.
\nroom_types: An array of room type objects.
\nid: A unique identifier for the room type.
\ncm_id: A unique identifier for the room type in the channel manager system.
\nrate_plans: An array of rate plan objects associated with the room type.
\nid: A unique identifier for the rate plan.
\ncm_id: A unique identifier for the rate plan in the channel manager system.
\nThe response will contain the status of the update operation, which typically includes:
\nstatus: A string indicating the success or failure of the operation.
\nmessage: A string providing additional details about the operation's outcome.
\nEnsure that the request body adheres to the specified format to avoid errors during processing.
\n","urlObject":{"path":["cm","api","{{your_cm_code}}","mapping-update"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"dcd3664e-314f-4ebe-aea6-380f75a8f1c5"}],"id":"2cb03532-e2c1-4026-b625-5da359edfd22","description":"This endpoint will be used to get information about Room Types and Rate
Plans from your side. This will allow the user to map in the CM
interface.
The Channel Manager module provides endpoints to synchronize property data between external systems and Revenue Booster. It ensures that room availability, rates, restrictions, and reservations are always kept up to date across all connected channels
\n","_postman_id":"8337a590-59b0-43d4-8df6-9cba82da378a"},{"name":"Booking Engine","item":[{"name":"Merchant","item":[{"name":"Merchant Detail","id":"36deca22-7e60-4c06-b683-b2bbb6394f0d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/guestapp-hotel/api/merchant/:pk","description":"This endpoint retrieves the public profile and configuration details of a specific merchant (hotel or property). It returns a comprehensive dataset including general information, facilities, policies, location data, UI configurations, and community associations.
\nReturns the full merchant object.
\n{\n \"success\": true,\n \"data\": {\n \"id\": \"f1d6ef5b-d62d-41f3-9c30-be5d546ed53d\",\n \"merchant_category_name\": \"Guest House\",\n \"name\": \"The Uma Desa\",\n \"code\": \"the-uma-desa\",\n \"address\": \"Jl. Bisma, Ubud, Kecamatan Ubud, Kabupaten Gianyar, Bali 80571\",\n \"phone\": \"0812345678\",\n \"email\": \"email@gmail.com\",\n \"location_point\": \"SRID=4326;POINT (115.2834912642318 -8.523541680044865)\",\n \"check_in_time_start\": \"14:00:00\",\n \"check_out_time_end\": \"12:00:00\",\n \"star\": 4.0,\n \"is_open\": false,\n \"merchant_images\": [\n {\n \"id\": \"3bfdaf7b-fb37-4297-881b-a659a9e25126\",\n \"image_url\": \"https://dksw6vf0i66fe.cloudfront.net/merchant/image_url/fb75c10e-c130-4ec8-a56f-617556ad2cc2_6572e163-647b-4a5c-a738-8bd3c044fc70.jpg\",\n \"image_type\": \"SLIDER\",\n \"position\": 1\n }\n // ... additional images\n ],\n \"facilities\": [\n {\n \"id\": \"2ef5bb6c-d7e1-459f-bbc4-3dc0121b1ba1\",\n \"name\": \"Wifi\",\n \"icon\": \"iconsmind-Wifi\"\n }\n // ... additional facilities\n ],\n \"community\": {\n \"id\": \"a52c7ba6-3a8a-423d-86b4-fe8da8d039ee\",\n \"name\": \"Kagum Hotel\",\n \"code\": \"nakula\"\n },\n \"description\": \"<p class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>Strategically located in the heart of Ubud...</p>\",\n \"cancellation_policy\": \"<ul class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'><li class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>Cancellations made 7 days or more...</li></ul>\",\n \"social_media\": [\n {\n \"type\": \"INSTAGRAM\",\n \"account_url\": \"https://www.instagram.com/opit.pratama\"\n }\n ]\n // ... full data object\n }\n}\n\nReturns objects with key suucess andthe error message.
\n{\n \"success\": false,\n \"message\": \"Merchant not found\"\n}\n\nThe unique identifier (Slug or UUID) for the merchant.
\n","type":"text/plain"},"type":"any","value":"the-uma-des","key":"pk"}]}},"response":[],"_postman_id":"36deca22-7e60-4c06-b683-b2bbb6394f0d"}],"id":"a76a7a73-77c3-433e-9819-5bc531b15cf6","_postman_id":"a76a7a73-77c3-433e-9819-5bc531b15cf6","description":""},{"name":"Room Filter","item":[{"name":"Search Availability","id":"9451f770-c863-4172-b4b3-211ecbabd8fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/guestapp-hotel/api/search-availability?merchant_id=f1d6ef5b-d62d-41f3-9c30-be5d546ed53d&start_date=2026-03-01&end_date=2026-02-31&adult=1","description":"This endpoint retrieves daily availability, inventory status, and pricing information for a specific merchant over a given date range. It is designed to populate availability calendars, allowing users to see which dates are available and the starting price for each day before selecting their check-in/out dates.
\nThe request utilizes query parameters to define the search criteria:
\nmerchant_id: (UUID) The unique identifier of the merchant/hotel.
\nstart_date: (String) The start date of the range to check in YYYY-MM-DD format.
\nend_date: (String) The end date of the range to check in YYYY-MM-DD format.
\nadult: (Integer) The number of adults to calculate the applicable price for.
\nchild: (Integer) The number of children to calculate the applicable price for. (Optional)
\ninfant: (Integer) The number of infants to calculate the applicable price for. (Optional)
\nThe response body returns a JSON object containing the following structure:
\nsuccess: (Boolean) Indicates if the request was successful.
\ndata: An array of daily availability objects.
\ndate: (String) The specific calendar date for the data entry in YYYY-MM-DD format.
\navailability: (Integer) The total number of physical rooms available (inventory) across all room types for this specific date.
\nnot_stop_sell: (Integer) The count of rate plans or room types that are active (i.e., not flagged as \"Stop Sell\"). If this is 0, the date is effectively unbookable.
\nnot_closed_to_arrival: (Integer) The count of rate plans that allow Check-In on this date.
\nnot_closed_to_departure: (Integer) The count of rate plans that allow Check-Out on this date.
\nlower_price: (Decimal) The lowest \"starting from\" price available for this date before applying specific dynamic promotions.
\nhighest_promotion_price: (Decimal) The maximum monetary value deducted by a promotion (Negative values indicate a discount amount).
\nhighest_promotion_percent: (Decimal) The maximum percentage deducted by a specific promotion campaign (Negative values indicate a percentage discount).
\nhighest_discount_percent: (Decimal) The overall highest discount percentage available from all sources (campaigns, basic discounts, etc.).
\nmin_nights: (Integer) The minimum length of stay (MLOS) required if the guest checks in on this specific date.
\nmax_nights: (Integer) The maximum length of stay allowed if the guest checks in on this specific date.
\nmessage: (String) A descriptive message explaining the request status. Returned only when success is false.
\nValid UUID of the merchant.
\n","type":"text/plain"},"key":"merchant_id","value":"f1d6ef5b-d62d-41f3-9c30-be5d546ed53d"},{"description":{"content":"Start date for availability search (YYYY-MM-DD).
\n","type":"text/plain"},"key":"start_date","value":"2026-03-01"},{"description":{"content":"End date for availability search (YYYY-MM-DD). Max 66 days range.
\n","type":"text/plain"},"key":"end_date","value":"2026-02-31"},{"description":{"content":"Number of adults.
\n","type":"text/plain"},"key":"adult","value":"1"},{"disabled":true,"description":{"content":"Number of children.
\n","type":"text/plain"},"key":"child","value":"0"},{"disabled":true,"description":{"content":"Number of infants.
\n","type":"text/plain"},"key":"infant","value":"0"}],"variable":[]}},"response":[],"_postman_id":"9451f770-c863-4172-b4b3-211ecbabd8fd"}],"id":"c09a3194-3292-4292-9a30-57d734830a0a","_postman_id":"c09a3194-3292-4292-9a30-57d734830a0a","description":""},{"name":"Search Room","item":[{"name":"Search Room","id":"c571eee8-2e3a-4bd4-a228-6f4e2aab744a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/guestapp-hotel/api/search-room?merchant_id=f1d6ef5b-d62d-41f3-9c30-be5d546ed53d&check_in_date=2026-12-12&check_out_date=2026-12-13&adult=1&child=0&infant=0&sort_by=room_type&promo_code=&price_min=&price_max=","description":"This endpoint searches for available room types and their associated rate plans based on a specific check-in and check-out range. It calculates the final price dynamically, accounting for number of guests (adults/children), active promotions, seasonal tiers, and taxes. It returns a hierarchical structure of Rooms containing Rate Plans.
\nThe request utilizes query parameters to define the booking criteria:
\nmerchant_id: (UUID) The unique identifier of the merchant/hotel.
\ncheck_in_date: (String) The check-in date in YYYY-MM-DD format.
\ncheck_out_date: (String) The check-out date in YYYY-MM-DD format.
\nadult: (Integer) Number of adults.
\nchild: (Integer) Number of children. (Optional, default 0)
\ninfant: (Integer) Number of infants. (Optional, default 0)
\nsort_by: (String) Criteria to group the results (e.g., room_type, package, promotion). (Optional)
promo_code: (String) A specific promotion code to apply to the search. (Optional)
\nprice_min: (Float) Filter results by minimum price. (Optional)
\nprice_max: (Float) Filter results by maximum price. (Optional)
\nThe response body returns a JSON object containing the following structure:
\nsuccess: (Boolean) Indicates if the request was successful.
\nmessage: (String) A descriptive message explaining the request status. Returned only when success is false.
\ndata: An array of available Room Types.
\nid: (UUID) Unique ID of the physical room type.
\nname: (String) Name of the room (e.g., \"Standard Room\").
\ndescription: (String) Description of the room.
\ntotal_rooms: (Integer) Total physical inventory existing for this type.
\nimage: (Array) List of images associated with this specific rate/room.
\nfacility: (Array) List of amenities (Wifi, Bathtub, etc.).
\nbed: (Array) Bed configuration details.
\nbest_price: (Object) same as the best_price on room_rate, but pict the lowest final_price.
\nroom_rate: (Array) List of sellable Rate Plans for this room type.
\nid: (UUID) Unique ID of the rate plan.
\nname: (String) Name of the rate plan (e.g., \"Room with Breakfast\").
\nprice: (String) Base price of the rate plan.
\nfinal_price: (Float) The final calculated price after promotions/discounts for the search duration.
\ncancellation_policy: (Object) Details on cancellation rules and penalties.
\nbest_price: (Object) Summary of the pricing calculation.
\nprice: (Float) Original price.
\npromotion_price: (Float) Deduction amount from promotions.
\nfinal_price: (Float) The price the user has to pay.
\ndates: (Array) Daily breakdown of pricing and availability for the requested duration.
\nroom_type_availability: (Array) A summary of inventory counts per room type for the requested dates.
\nid: (UUID) The unique identifier of the room type.name: (String) The name of the room type.
\nis_virtual: (Boolean) Indicates if this is a virtual room type (e.g., a \"Family Combo\" made of two connecting rooms).
\navailability: (Integer) The calculated minimum availability for the entire requested stay duration.
\navailability_affected: (Array) List of other room types whose inventory is linked to this room type (relevant for virtual/connected rooms).
\nid: (UUID) ID of the linked room type.
\nname: (String) Name of the linked room type.
\navailability: (Integer) Current availability of the linked room type.
\ndate: (Array) Daily breakdown of availability for this room type.
\ndate: (String) The specific calendar date (YYYY-MM-DD).
\navailability: (Integer) The inventory count available for that specific date.
\nValid UUID of the merchant.
\n","type":"text/plain"},"key":"merchant_id","value":"f1d6ef5b-d62d-41f3-9c30-be5d546ed53d"},{"description":{"content":"Check-in date in YYYY-MM-DD format.
\n","type":"text/plain"},"key":"check_in_date","value":"2026-12-12"},{"description":{"content":"Check-out date in YYYY-MM-DD format.
\n","type":"text/plain"},"key":"check_out_date","value":"2026-12-13"},{"description":{"content":"Number of adults.
\n","type":"text/plain"},"key":"adult","value":"1"},{"description":{"content":"Number of children.
\n","type":"text/plain"},"key":"child","value":"0"},{"description":{"content":"Number of infants.
\n","type":"text/plain"},"key":"infant","value":"0"},{"description":{"content":"Sorting criteria. Choices: [room_type, promotion, packages]
\n","type":"text/plain"},"key":"sort_by","value":"room_type"},{"description":{"content":"Optional promo code.
\n","type":"text/plain"},"key":"promo_code","value":""},{"description":{"content":"Minimum price filter.
\n","type":"text/plain"},"key":"price_min","value":""},{"description":{"content":"Maximum price filter.
\n","type":"text/plain"},"key":"price_max","value":""}],"variable":[]}},"response":[],"_postman_id":"c571eee8-2e3a-4bd4-a228-6f4e2aab744a"}],"id":"4300fb98-019a-406f-8691-950b076d8c6d","_postman_id":"4300fb98-019a-406f-8691-950b076d8c6d","description":""}],"id":"2868c682-17db-4cde-8c5e-b434642aff6c","_postman_id":"2868c682-17db-4cde-8c5e-b434642aff6c","description":""}],"event":[{"listen":"prerequest","script":{"id":"643aa27e-e832-4306-8abb-d20734a13502","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"9e895138-2945-41d4-b942-4b6329633622","type":"text/javascript","packages":{},"exec":[""]}}],"variable":[{"key":"room_type_id","value":"a5b80161-8f78-40ff-ae25-6bd690ebdf35"},{"key":"rateplanse_id","value":"1e5d0be9-875d-4f80-8af1-d5a0e60e94dd"}]}