Public Key Events
\nRoomPriceGenie rotates its public keys regularly for security purposes, and partners will be notified whenever a new key is added or an existing one is deprecated or removed.
\nTo ensure you have the most up-to-date keys for verifying our messages, we will regularly send public key notifications to your endpoint. At any given time, there will always be three active keys, which are rotated monthly for enhanced security. Additionally, you can request the current set of keys at any time using the GET method described above.
\n","urlObject":{"protocol":"https","path":["endpoint"],"host":["partnerdomain","com"],"query":[],"variable":[]}},"response":[{"id":"93ee62af-b69a-4108-ae2a-18b6a4a74743","name":"Public Key Notification (JWT)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer access_token","type":"text"},{"key":"x-api-key","value":"partner_api_key","type":"text"}],"body":{"mode":"raw","raw":"{\n \"event\": \"public_key\",\n \"tracking_id\": \"2f7a6d3e-9b4b-4d1e-9f8a-1c2d3e4f5a6b\",\n \"data\": [\n {\n \"type\": \"added\",\n \"key\": {\n \"kid\": \"b3c1d2e3-4f56-47a8-9bcd-0123456789ab\",\n \"kty\": \"RSA\",\n \"alg\": \"RS256\",\n \"e\": \"AQAB\",\n \"n\": \"uX1mY9m0DUMMY_PUBLIC_MODULUS_VALUE_0000000000000000000000000000000000000000000000000000000000000000000000\"\n }\n },\n {\n \"type\": \"deleted\",\n \"key\": {\n \"kid\": \"c0ffee00-1234-4abc-9def-1234567890ab\",\n \"kty\": \"RSA\",\n \"alg\": \"RS256\",\n \"e\": \"AQAB\",\n \"n\": \"vZ2nA8p1DUMMY_PUBLIC_MODULUS_VALUE_1111111111111111111111111111111111111111111111111111111111111111111111\"\n }\n }\n ]\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://partnerdomain.com/endpoint"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{}"}],"_postman_id":"51cd607a-7f3f-4c0b-b5d6-158775cf03e1"}],"id":"7417127f-2a55-48aa-903d-28331bcabc29","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"{{open_api_partner_api_key}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"3e94456e-3bdc-48a8-bb3b-dbe85a1cac6c","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"9a18206e-3a05-4b39-846b-37052181c151","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"7417127f-2a55-48aa-903d-28331bcabc29","description":""},{"name":"💰 Pricing Integration","item":[{"name":"🏨 Property ARI Updates","item":[{"name":"Inventories (Rooms and Rate Plans)","id":"24f5aeae-218b-4bcf-8511-1dc9248de4d2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"partner-api-key"}],"body":{"mode":"raw","raw":"{\n \"event\": \"inventory.update\",\n \"tracking_id\": \"UUID4\",\n \"property_code\": \"property_code\",\n \"data\": {\n \"room_types\": [\n {\n \"room_type_code\": \"SGL\",\n \"room_type_name\": \"Single Room\",\n \"default_occupancy\": 2,\n \"min_occupancy\": 2,\n \"max_occupancy\": 3,\n \"number_of_rooms\": 11\n },\n {\n \"room_type_code\": \"DBL\",\n \"room_type_name\": \"Double Room\",\n \"default_occupancy\": 2,\n \"min_occupancy\": 1,\n \"max_occupancy\": 3,\n \"number_of_rooms\": 10\n }\n ],\n \"rate_plans\": [\n {\n \"rate_plan_code\": \"BAR\",\n \"rate_plan_name\": \"Best Available Rate\",\n \"room_type_code\": \"SGL\" // Only if Rate Plan is Dependent of Room Type\n },\n {\n \"rate_plan_code\": \"BAR\",\n \"rate_plan_name\": \"Best Available Rate\",\n \"room_type_code\": \"DBL\" // Only if Rate Plan is Dependent of Room Type\n }\n ]\n }\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"{{server-backend}}/integrations/api/v1/event/","description":"The Inventory is the information about the Room Types and Rate Plans (if applicable) for a property. This message must be sent once during account setup and whenever there are changes to room types or rate plans in the PMS/CM. Depending on the features supported on the PMS/CM, the data may vary.
\n🧠 Important Notes:
\n- \n
Room Type Code and Rate Plan Code must be an immutable ID on your side, that the user should not be able to change. This is to avoid any disruption in the integration.
\n \nAfter sending the initial
\ninventory.update, do not send any further messages until we confirm the mapping is complete and the account is ready to receive ARI updates. \nDo not send this regularly. Only send an
\ninventory.updatewhen there are actual changes—such as a room type or rate plan being added or removed—and always include the full list of inventories, not just the changes. Each message fully replaces the existing inventory on our side. \nIf any previously mapped room type or rate plan is missing from the list you send, it will be automatically un-mapped on our side.
\n \nIf your system supports both room-level and occupancy-based pricing, then for any room type that should be priced as a whole (not per occupancy), set
\nmin_occupancy,max_occupancy, anddefault_occupancyto 1. \n
Availability is the information about how many rooms are left for sale for a particular date and room type for a property.
\nThe partner is required to send a initial full push of Availability after initial setup, and a delta update whenever there are changes in availability, as soon as possible.
\nRoomPriceGenie considers number of rooms available to sell to calculate Occupancy and propose rates. That way, it is important that you always send the correct number of rooms left for the property, even if a stop-sell is put in place.
\nIf you support Out-Of-Order (Closed Rooms) it is important that you send the amount of rooms that are out-of-order for that room type and date, even when it's 0.
\nExample:
\n- \n
Total Number of Rooms: 14
\n \nNumber of Rooms Sold: 6
\n \nNumber of Rooms Out-of-Order: 2
\n \nNumber of Rooms left: Total - (Sold + OOO) = 6
\n \n
You should send \"rooms_left\": 6 and \"out_of_order\": 2
Important:
\n- \n
The End Date can be equal or higher than start date. The update will be applied to all dates in the date range.
\n \nIf the integration supports Out of Order, you must send the value for this key, even if it's 0.
\n \nIf you support Stop-Sell, it's very important that you send the real availability to us, instead of 0.
\n \n
This endpoint is used by the partner to send changes on Prices to RoomPriceGenie.
\nAfter the initial setup (mapping), you must send a full push of the current prices covering the next 12 or 18 months, starting from the current date.
\nFor Prices, you can update RoomPriceGenie as:
\n- \n
Room Only Prices: If you do not support Rate Plans, you don't need to send
\nrate_plan_codeandrate_plan_name\nRoom and Rate Plan Prices: If you support Rate Plans, you must send us the prices for all rate plans that were provided in your
\ninventory.updatemessage. \nOccupancy Based Pricing: If you support it, you should push the Rates for all occupancy levels that were provided in your
\ninventory.updatemessage, using the prices dictionary. \n
Important:
\n- \n
Do not send decimals with the rates. Round it to the closest integer value.
\n \nDo not pair Availability updates with Rates update. They should be sent separately, when a change occurs to each.
\n \nPlease make sure to always use Date Ranges whenever possible (e.g. a rate is the same from day x to y). In other words, do not send one object for each day, if not necessary.
\n \nDo not send the rates back to RoomPriceGenie when you receive an update from RoomPriceGenie.
\n \nThe End Date can be equal or higher than start date. The update will be applied to all dates in the date range.
\n \n
RoomPriceGenie will send this payload to the partner whenever there are changes in Prices.
\nThe partner must validate the Bearer Token using JWT to ensure the authenticity of the request.
\nIn the same payload, we can push updates for different room types and/or different rate plans. Also for different occupancies. Please check the different examples on the right side.
\nThe partner must respond with a 200 OK status code to acknowledge the successful processing of the request. The response must include the same tracking_id from the request in the response body to confirm the correlation between the request and the response.
\n","urlObject":{"protocol":"https","path":["endpoint"],"host":["partnerdomain","com"],"query":[],"variable":[]}},"response":[{"id":"94e1bb37-0c14-41fb-8cee-4362599b0379","name":"RPG Price Update (Room Type Based)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-API-Key","value":"partner-api-key"},{"key":"Authorization","value":"Bearer token"}],"body":{"mode":"raw","raw":"{\n\t\"event\": \"rates.update\",\n\t\"tracking_id\": \"UUID4\",\n\t\"property_code\": \"property_code\",\n\t\"data\": [\n\t\t{\n\t\t\t\"room_type_code\": \"DBL\",\n\t\t\t\"room_type_name\": \"Double Room\",\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"price\": 100\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"price\": 100\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"room_type_code\": \"SGL\",\n\t\t\t\"room_type_name\": \"Single Room\",\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"price\": 90\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"price\": 90\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t]\n}","options":{"raw":{"language":"json"}}},"url":"https://partnerdomain.com/endpoint"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"event\": \"rates.update\",\n \"tracking_id\": \"3cc216d5-3a7a-4d3b-acc8-7af2ec0019ae\",\n \"property_code\": \"TEST_ACCOUNT\"\n}"},{"id":"570c35e7-f855-41a1-80a8-5c90941ea225","name":"RPG Price Update (Occupancy Pricing)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-API-Key","value":"partner-api-key"},{"key":"Authorization","value":"Bearer token"}],"body":{"mode":"raw","raw":"{\n\t\"event\": \"rates.update\",\n\t\"tracking_id\": \"UUID4\",\n\t\"property_code\": \"property_code\",\n\t\"data\": [\n\t\t{\n\t\t\t\"room_type_code\": \"DBL\",\n\t\t\t\"room_type_name\": \"Double Room\",\n\t\t\t\"rate_plan_code\": \"BAR\", // Required if Rate Plans is supported\n\t\t\t\"rate_plan_name\": \"Best Available Rate\", // Required if Rate Plans is supported\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"prices\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"occupancy\": 1,\n\t\t\t\t\t\t\t\"price\": 100\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"occupancy\": 2,\n\t\t\t\t\t\t\t\"price\": 150\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"prices\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"occupancy\": 1,\n\t\t\t\t\t\t\t\"price\": 150\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"occupancy\": 2,\n\t\t\t\t\t\t\t\"price\": 180\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"room_type_code\": \"SGL\",\n\t\t\t\"room_type_name\": \"Single Room\",\n\t\t\t\"rate_plan_code\": \"BAR\",\n\t\t\t\"rate_plan_name\": \"Best Available Rate\",\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"prices\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"occupancy\": 1,\n\t\t\t\t\t\t\t\"price\": 100\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"prices\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"occupancy\": 1,\n\t\t\t\t\t\t\t\"price\": 100\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t]\n}","options":{"raw":{"language":"json"}}},"url":"https://partnerdomain.com/endpoint"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"event\": \"rates.update\",\n \"tracking_id\": \"3cc216d5-3a7a-4d3b-acc8-7af2ec0019ae\",\n \"property_code\": \"TEST_ACCOUNT\"\n}"},{"id":"88d70538-b45c-4a40-a83b-b63c386e872c","name":"RPG Price Update (Independent Rate Plan)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-API-Key","value":"partner-api-key"},{"key":"Authorization","value":"Bearer token"}],"body":{"mode":"raw","raw":"{\n\t\"event\": \"rates.update\",\n\t\"tracking_id\": \"UUID4\",\n\t\"property_code\": \"property_code\",\n\t\"data\": [\n\t\t{\n\t\t\t\"room_type_code\": \"DBL\",\n\t\t\t\"room_type_name\": \"Double Room\",\n\t\t\t\"rate_plan_code\": \"BAR\",\n\t\t\t\"rate_plan_name\": \"Best Available Rate\",\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"price\": 100\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"price\": 100\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"room_type_code\": \"SGL\",\n\t\t\t\"room_type_name\": \"Single Room\",\n\t\t\t\"rate_plan_code\": \"BAR\",\n\t\t\t\"rate_plan_name\": \"Best Available Rate\",\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"price\": 90\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"price\": 90\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t]\n}","options":{"raw":{"language":"json"}}},"url":"https://partnerdomain.com/endpoint"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"event\": \"rates.update\",\n \"tracking_id\": \"3cc216d5-3a7a-4d3b-acc8-7af2ec0019ae\",\n \"property_code\": \"TEST_ACCOUNT\"\n}"},{"id":"fbdf7daa-94f9-4347-a159-c0129e1692d8","name":"Price Update (Dependent Rate Plans)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-API-Key","value":"partner-api-key"},{"key":"Authorization","value":"Bearer token"}],"body":{"mode":"raw","raw":"{\n\t\"event\": \"rates.update\",\n\t\"tracking_id\": \"3cc216d5-3a7a-4d3b-acc8-7af2ec0019ae\",\n\t\"property_code\": \"property_code\",\n\t\"data\": [\n\t\t{\n\t\t\t\"room_type_code\": \"DBL\",\n\t\t\t\"room_type_name\": \"Double Room\",\n\t\t\t\"rate_plan_code\": \"BAR-DBL\", // Only when Rate Plan is supported\n\t\t\t\"rate_plan_name\": \"Best Available Rate\", // Only when Rate Plan is supported\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"price\": 100\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"price\": 100\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"room_type_code\": \"SGL\",\n\t\t\t\"room_type_name\": \"Single Room\",\n\t\t\t\"rate_plan_code\": \"BAR-SGL\", // Only when Rate Plan is supported\n\t\t\t\"rate_plan_name\": \"Best Available Rate\", // Only when Rate Plan is supported\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"price\": 100\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"price\": 100\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t]\n}","options":{"raw":{"language":"json"}}},"url":"https://partnerdomain.com/endpoint"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 12 Jul 2024 11:22:10 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"150"},{"key":"Connection","value":"keep-alive"},{"key":"x-srv-trace","value":"v=1;t=ae193746991e46b6"},{"key":"x-srv-span","value":"v=1;s=05dd89e3e7c57465"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-RateLimit-Limit","value":"120"},{"key":"X-RateLimit-Remaining","value":"118"},{"key":"X-RateLimit-Reset","value":"1720783386"},{"key":"ETag","value":"W/\"96-S/5iQ2y1qqIInh5BwoPc+chvDJU\""},{"key":"Vary","value":"Accept-Encoding"}],"cookie":[],"responseTime":null,"body":"{\n \"event\": \"rates.update\",\n \"tracking_id\": \"3cc216d5-3a7a-4d3b-acc8-7af2ec0019ae\",\n \"property_code\": \"property_code\"\n}"},{"id":"b3035675-73fb-4a68-ace2-46e23c882874","name":"Price Update (Derived Rate Plans)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-API-Key","value":"partner-api-key"},{"key":"Authorization","value":"Bearer token"}],"body":{"mode":"raw","raw":"{\n\t\"event\": \"rates.update\",\n\t\"tracking_id\": \"3cc216d5-3a7a-4d3b-acc8-7af2ec0019ae\",\n\t\"property_code\": \"TEST_ACCOUNT\",\n\t\"data\": [\n\t\t{\n\t\t\t\"room_type_code\": \"DBL\",\n\t\t\t\"room_type_name\": \"Double Room\",\n\t\t\t\"rate_plan_code\": \"BAR\", // Only when Rate Plan is supported\n\t\t\t\"rate_plan_name\": \"Best Available Rate\", // Only when Rate Plan is supported\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"price\": 100\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"price\": 100\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"room_type_code\": \"DBL\",\n\t\t\t\"room_type_name\": \"Double Room\",\n\t\t\t\"rate_plan_code\": \"NONREF\", // Only when Rate Plan is supported\n\t\t\t\"rate_plan_name\": \"Non Refundable\", // Only when Rate Plan is supported\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"price\": 90\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"price\": 90\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"room_type_code\": \"SGL\",\n\t\t\t\"room_type_name\": \"Single Room\",\n\t\t\t\"rate_plan_code\": \"BAR\", // Only when Rate Plan is supported\n\t\t\t\"rate_plan_name\": \"Best Available Rate\", // Only when Rate Plan is supported\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"price\": 100\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"price\": 100\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"room_type_code\": \"SGL\",\n\t\t\t\"room_type_name\": \"Single Room\",\n\t\t\t\"rate_plan_code\": \"NONREF\", // Only when Rate Plan is supported\n\t\t\t\"rate_plan_name\": \"Non Refundable\", // Only when Rate Plan is supported\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"price\": 90\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"price\": 90\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t]\n}","options":{"raw":{"language":"json"}}},"url":"https://partnerdomain.com/endpoint"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 12 Jul 2024 11:22:10 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"150"},{"key":"Connection","value":"keep-alive"},{"key":"x-srv-trace","value":"v=1;t=ae193746991e46b6"},{"key":"x-srv-span","value":"v=1;s=05dd89e3e7c57465"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-RateLimit-Limit","value":"120"},{"key":"X-RateLimit-Remaining","value":"118"},{"key":"X-RateLimit-Reset","value":"1720783386"},{"key":"ETag","value":"W/\"96-S/5iQ2y1qqIInh5BwoPc+chvDJU\""},{"key":"Vary","value":"Accept-Encoding"}],"cookie":[],"responseTime":null,"body":"{\n \"event\": \"rates.update\",\n \"tracking_id\": \"3cc216d5-3a7a-4d3b-acc8-7af2ec0019ae\",\n \"property_code\": \"TEST_ACCOUNT\"\n}"}],"_postman_id":"62e5ec79-7ab4-4d93-ad78-f7afc96dfac7"}],"id":"2e913ff4-9afa-4f11-9736-9551023f27a4","description":"RoomPriceGenie uses the data provided by the partner to calculate and propose new rates.
\nTo receive rate and restriction updates, as well as any other data from RoomPriceGenie, the partner must provide a single, fixed endpoint URL where updates will be sent via HTTP POST requests. This URL will remain the same for all accounts connected to RoomPriceGenie and for all types of data. To minimize data size, only relevant updates will be transmitted.
\n","auth":{"type":"noauth","isInherited":false},"event":[{"listen":"prerequest","script":{"id":"262d5d51-12ac-4a44-ab2a-6743f41c37aa","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"f6ac66e5-84d0-44f3-90ef-c2ade0d06f13","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"2e913ff4-9afa-4f11-9736-9551023f27a4"}],"id":"42dd50f7-f77f-4509-9e2f-a476204e47b7","auth":{"type":"bearer","bearer":{"basicConfig":[]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"d5ce4bcf-d931-4319-ab11-dc23152b9c1f","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"91835f6c-4ab7-468e-9a25-5b516dde83e3","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"42dd50f7-f77f-4509-9e2f-a476204e47b7","description":""},{"name":"🌙 Min Stay Feature","item":[{"name":"Restrictions Update (from partner)","id":"3eb53b23-58bd-411f-a409-e3e843b2837a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access-token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"X-API-Key","value":"partner-api-key"}],"body":{"mode":"raw","raw":"{\n\t\"event\": \"restrictions.update\",\n\t\"tracking_id\": \"114cb8ce-df20-4d8f-92d1-e4411112ed16\",\n\t\"property_code\": \"property_code\",\n\t\"data\": [\n\t\t{\n\t\t\t\"room_type_code\": \"DBL\",\n\t\t\t\"room_type_name\": \"Double Room\",\n\t\t\t\"rate_plan_code\": \"BAR\", // Only when Rate Plan is supported\n\t\t\t\"rate_plan_name\": \"Best Available Rate\", // Only when Rate Plan is supported\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2024-01-01\",\n\t\t\t\t\t\"end_date\": \"2024-01-01\",\n\t\t\t\t\t\"min_stay_through\": 2 // If MinStay Stay Through is supported\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2024-01-02\",\n\t\t\t\t\t\"end_date\": \"2025-01-05\",\n\t\t\t\t\t\"min_stay_through\": 1, // If MinStay Stay Through is supported\n\t\t\t\t\t\"min_stay_arrival\": 2 // If MinStay Arrival is supported\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"room_type_code\": \"SGL\",\n\t\t\t\"room_type_name\": \"Single Room\",\n\t\t\t\"rate_plan_code\": \"BAR\", // Only when Rate Plan is supported\n\t\t\t\"rate_plan_name\": \"Best Available Rate\", // Only when Rate Plan is supported\n\t\t\t\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2024-01-01\",\n\t\t\t\t\t\"end_date\": \"2024-01-01\",\n\t\t\t\t\t\"min_stay_arrival\": 2 // If MinStay Arrival is supported\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t]\n}","options":{"raw":{"language":"json"}}},"url":"{{server-backend}}/integrations/api/v1/event/","description":"This endpoint allows partners to send Minimum Stay restriction data to RoomPriceGenie. It is structurally very similar to the rates.update payload, but with some key differences:
\n- \n
The event name is
\nrestrictions.update. \nInstead of pricing parameters (
\npriceandprices[]), it usesmin_stay_through(for Stay-Through minimum stay) andmin_stay_arrival(for arrival-based minimum stay). \n
During initial setup, if Minimum Stay restrictions are configured in the PMS, you should send us the data for at least one year in advance.
\nUnlike availability and prices—where a value must be sent for every date—for Minimum Stay, you only need to send values for the dates where a restriction is actually configured.
\nIf there are no Minimum Stay set in the PMS (or set as 1), this data is not required.
\nSubsequently, you should send any changes whenever they happen.
\n🧠 Important Notes:
\n- \n
If your PMS does not support minimum stay restrictions, this endpoint is not required.
\n \nWhen we receive a value of 0 or 1, we interpret it as if no restriction is set for that date.
\n \nPlease make sure to always use Date Ranges whenever possible (e.g. a restriction is the same from day x to y). In other words, do not send one object for each day, if not necessary.
\n \nDo not send the restrictions back when you receive an update from RoomPriceGenie.
\n \nThe End Date can be equal or higher than start date. The update will be applied to all dates in the date range.
\n \n
RoomPriceGenie will send this payload to the partner whenever there are changes in Restrictions. Currently, we support Minimum Stay Arrival or Stay-Through based.
\nThe partner must respond with a 200 OK status code to acknowledge the successful processing of the request. The response must include the same tracking_id from the request in the response body to confirm the correlation between the request and the response.
\n","urlObject":{"protocol":"https","path":["endpoint"],"host":["partnerdomain","com"],"query":[],"variable":[]}},"response":[{"id":"d5f50f3f-07e3-4119-b5c3-e44920a99558","name":"RPG Restrictions Update (Room Type Based)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-API-Key","value":"partner-api-key"},{"key":"Authorization","value":"Bearer token"}],"body":{"mode":"raw","raw":"{\n\t\"event\": \"restrictions.update\",\n\t\"tracking_id\": \"UUID4\",\n\t\"property_code\": \"property_code\",\n\t\"data\": [\n\t\t{\n\t\t\t\"room_type_code\": \"DBL\",\n\t\t\t\"room_type_name\": \"Double Room\",\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"min_stay_arrival\": 1 // Optional if Stay Through Based Min Stay is supported\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"min_stay_arrival\": 1\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"room_type_code\": \"SGL\",\n\t\t\t\"room_type_name\": \"Single Room\",\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"min_stay_arrival\": 1 // Optional if Stay Through Based Min Stay is supported\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"min_stay_arrival\": 1\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t]\n}","options":{"raw":{"language":"json"}}},"url":"https://partnerdomain.com/endpoint"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"event\": \"restrictions.update\",\n \"tracking_id\": \"3cc216d5-3a7a-4d3b-acc8-7af2ec0019ae\",\n \"property_code\": \"TEST_ACCOUNT\"\n}"},{"id":"20d4c808-2121-4400-93a3-fe14f449eafc","name":"RPG Restrictions Update (Single Rate Plan)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-API-Key","value":"partner-api-key"},{"key":"Authorization","value":"Bearer token"}],"body":{"mode":"raw","raw":"{\n\t\"event\": \"restrictions.update\",\n\t\"tracking_id\": \"UUID4\",\n\t\"property_code\": \"property_code\",\n\t\"data\": [\n\t\t{\n\t\t\t\"room_type_code\": \"DBL\",\n\t\t\t\"room_type_name\": \"Double Room\",\n\t\t\t\"rate_plan_code\": \"BAR\",\n\t\t\t\"rate_plan_name\": \"Best Available Rate\",\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"min_stay_arrival\": 1 // Optional if Stay Through Based Min Stay is supported\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"min_stay_arrival\": 1\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"room_type_code\": \"SGL\",\n\t\t\t\"room_type_name\": \"Single Room\",\n\t\t\t\"rate_plan_code\": \"BAR\",\n\t\t\t\"rate_plan_name\": \"Best Available Rate\",\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"min_stay_arrival\": 1 // Optional if Stay Through Based Min Stay is supported\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"min_stay_arrival\": 1\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t]\n}","options":{"raw":{"language":"json"}}},"url":"https://partnerdomain.com/endpoint"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"event\": \"restrictions.update\",\n \"tracking_id\": \"3cc216d5-3a7a-4d3b-acc8-7af2ec0019ae\",\n \"property_code\": \"TEST_ACCOUNT\"\n}"},{"id":"eab658c4-5a68-4833-acdf-16e2753e85bb","name":"RPG Restrictions Update (Multiple Rate Plans)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-API-Key","value":"partner-api-key"},{"key":"Authorization","value":"Bearer token"}],"body":{"mode":"raw","raw":"{\n\t\"event\": \"restrictions.update\",\n\t\"tracking_id\": \"UUID4\",\n\t\"property_code\": \"property_code\",\n\t\"data\": [\n\t\t{\n\t\t\t\"room_type_code\": \"DBL\",\n\t\t\t\"room_type_name\": \"Double Room\",\n\t\t\t\"rate_plan_code\": \"BAR\", // Only when Rate Plan is supported\n\t\t\t\"rate_plan_name\": \"Best Available Rate\", // Only when Rate Plan is supported\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"min_stay_through\": 1 // Optional if Stay Through Based Min Stay is supported\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"min_stay_through\": 1\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"room_type_code\": \"DBL\",\n\t\t\t\"room_type_name\": \"Double Room\",\n\t\t\t\"rate_plan_code\": \"NONREF\", // Only when Rate Plan is supported\n\t\t\t\"rate_plan_name\": \"Non Refundable\", // Only when Rate Plan is supported\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"min_stay_through\": 1 // Optional if Stay Through Based Min Stay is supported\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"min_stay_through\": 1\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"room_type_code\": \"SGL\",\n\t\t\t\"room_type_name\": \"Single Room\",\n\t\t\t\"rate_plan_code\": \"BAR\", // Only when Rate Plan is supported\n\t\t\t\"rate_plan_name\": \"Best Available Rate\", // Only when Rate Plan is supported\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"min_stay_through\": 1 // Optional if Stay Through Based Min Stay is supported\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"min_stay_through\": 1\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"room_type_code\": \"SGL\",\n\t\t\t\"room_type_name\": \"Single Room\",\n\t\t\t\"rate_plan_code\": \"NONREF\", // Only when Rate Plan is supported\n\t\t\t\"rate_plan_name\": \"Non Refundable\", // Only when Rate Plan is supported\n\t\t\t\"calendar\": [\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-01\",\n\t\t\t\t\t\"end_date\": \"2020-01-01\", // Equal or higher than start_date\n\t\t\t\t\t\"min_stay_through\": 1 // Optional if Stay Through Based Min Stay is supported\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"start_date\": \"2020-01-02\",\n\t\t\t\t\t\"end_date\": \"2020-01-07\",\n\t\t\t\t\t\"min_stay_through\": 1\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t]\n}","options":{"raw":{"language":"json"}}},"url":"https://partnerdomain.com/endpoint"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 12 Jul 2024 11:22:10 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"150"},{"key":"Connection","value":"keep-alive"},{"key":"x-srv-trace","value":"v=1;t=ae193746991e46b6"},{"key":"x-srv-span","value":"v=1;s=05dd89e3e7c57465"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-RateLimit-Limit","value":"120"},{"key":"X-RateLimit-Remaining","value":"118"},{"key":"X-RateLimit-Reset","value":"1720783386"},{"key":"ETag","value":"W/\"96-S/5iQ2y1qqIInh5BwoPc+chvDJU\""},{"key":"Vary","value":"Accept-Encoding"}],"cookie":[],"responseTime":null,"body":"{\n \"event\": \"restrictions.update\",\n \"tracking_id\": \"3cc216d5-3a7a-4d3b-acc8-7af2ec0019ae\",\n \"property_code\": \"TEST_ACCOUNT\"\n}"}],"_postman_id":"2997d50f-3e9f-4de7-9e53-b45a6796edd6"}],"id":"f9a8e99a-e2cd-4be3-b054-818925794e3d","description":"RoomPriceGenie supports both Arrival-based and Stay-through-based minimum stay restrictions. Please tell us which option you support: one of the types or both.
\n- \n
Arrival-based means the minimum stay restriction applies only to guests starting their stay on that date.
\n \nStay-through-based means the minimum stay applies to any night the stay overlaps, even if the guest arrives earlier.
\n \n
If you support only one type, use the matching key in the payload when sending and receiving minimum stay values. If you support both, you may send both values.
\nWhen both are supported, RoomPriceGenie will let the user choose which type they want to use, and we will send updates using that selected key.
\n","_postman_id":"f9a8e99a-e2cd-4be3-b054-818925794e3d"},{"name":"📊 Reporting Integration","item":[{"name":"Reservations Update","id":"dde4483d-1511-48ec-8885-f8fc9f1f8057","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"partner-api-key","type":"text"}],"body":{"mode":"raw","raw":"{\n \"event\": \"reservation.update\",\n \"tracking_id\": \"{{UUID}}\",\n \"property_code\": \"{{property_code}}\",\n \"partner_property_code\": \"{{partner_account_id}}\",\n \"data\": [\n {\n \"reservation_id\": \"RES510\",\n \"group_reservation_id\": \"GRP510\",\n \"shared_reservation_id\": \"SHARE123\",\n \"status\": \"confirmed\",\n \"arrival_date\": \"2025-11-06\",\n \"departure_date\": \"2025-11-08\",\n \"guest_country_code\": \"NL\",\n \"guest_company_name\": \"ACME Unlimited\",\n \"guest_company_id\": \"CO001\",\n \"source_name\": \"OTA\",\n \"source_id\": \"OTA001\",\n \"channel_name\": \"Booking.com\",\n \"channel_id\": \"CH001\",\n \"travel_agent_name\": \"Genie Travels\",\n \"travel_agent_id\": \"TA001\",\n \"created_at\": \"2025-10-10T09:00:00Z\",\n \"updated_at\": \"2025-11-06T12:30:00Z\",\n \"cancelled_at\": \"2025-11-06T12:30:00Z\",\n \"stay_dates\": [\n {\n \"date\": \"2025-11-06\",\n \"room_reservation_id\": \"RES510-A\",\n \"room_type_id\": \"DBL\",\n \"room_type_name\": \"Double Room\",\n \"room_number\": \"101\",\n \"originally_booked_room_type_id\": \"SGL\",\n \"originally_booked_room_type_name\": \"Single Room\",\n \"is_virtual_room\": false,\n \"rate_plan_id\": \"BAR\",\n \"rate_plan_name\": \"Bar Rate\",\n \"market_segment_id\": \"MS001\",\n \"market_segment_name\": \"leisure\",\n \"number_of_adults\": 1,\n \"number_of_children\": 0,\n \"rate_gross_amount\": \"95.0\",\n \"rate_net_amount\": \"80.75\",\n \"room_revenue_gross_amount\": \"190.0\",\n \"room_revenue_net_amount\": \"161.5\",\n \"fnb_gross_amount\": \"45.0\",\n \"fnb_net_amount\": \"38.25\",\n \"currency_code\": \"EUR\"\n },\n {\n \"date\": \"2025-11-07\",\n \"room_reservation_id\": \"RES510-A\",\n \"room_type_id\": \"DBL\",\n \"room_type_name\": \"Double Room\",\n \"room_number\": \"101\",\n \"originally_booked_roomtype_id\": \"SGL\",\n \"originally_booked_roomtype_name\": \"Single Room\",\n \"is_virtual_room\": false,\n \"rate_plan_id\": \"BAR\",\n \"rate_plan_name\": \"Bar Rate\",\n \"market_segment_id\": \"MS002\",\n \"market_segment_name\": \"business\",\n \"number_of_adults\": 1,\n \"rate_gross_amount\": \"100.0\",\n \"rate_net_amount\": \"85.0\",\n \"room_revenue_gross_amount\": \"200.0\",\n \"room_revenue_net_amount\": \"170.0\",\n \"other_gross_amount\": \"45.0\",\n \"other_net_amount\": \"38.25\",\n \"currency_code\": \"GBP\"\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{server-backend}}/integrations/api/v1/event/","description":"🛏️ Reservation Object
\n🏨 Stay Dates
\n\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access-token}}"}]},"isInherited":true,"source":{"_postman_id":"3c10b740-5d96-44e4-9d38-21d8ac83657c","id":"3c10b740-5d96-44e4-9d38-21d8ac83657c","name":"📊 Reporting Integration","type":"folder"}},"urlObject":{"path":["integrations","api","v1","event",""],"host":["{{server-backend}}"],"query":[],"variable":[]}},"response":[{"id":"267f9d1a-6d0c-404e-a405-2a1837a5f8ab","name":"Reservations Update","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-API-Key","value":"partner-api-key","type":"text"},{"key":"Authorization","value":"Bearer token","type":"text"}],"body":{"mode":"raw","raw":"{\n \"event\": \"reservation.update\",\n \"tracking_id\": \"aeadfd86-f4ef-4344-9c36-ea8ad5f32d66\",\n \"property_code\": \"986\", // RoomPriceGenie Account ID as provided for the integration connection.\n \"partner_property_code\": \"Hotel123\", // The account ID on the partner side.\n \"data\": [\n {\n \"reservation_id\": \"RES510\",\n \"group_reservation_id\": \"GRP510\",\n \"shared_reservation_id\": \"SHARE123\",\n \"status\": \"confirmed\",\n \"arrival_date\": \"2025-11-06\",\n \"departure_date\": \"2025-11-08\",\n \"guest_country_code\": \"NL\",\n \"guest_company_name\": \"ACME Unlimited\",\n \"guest_company_id\": \"CO001\",\n \"source_name\": \"OTA\",\n \"source_id\": \"OTA001\",\n \"channel_name\": \"Booking.com\",\n \"channel_id\": \"CH001\",\n \"travel_agent_name\": \"Genie Travels\",\n \"travel_agent_id\": \"TA001\",\n \"created_at\": \"2025-10-10T09:00:00Z\",\n \"updated_at\": \"2025-11-06T12:30:00Z\",\n \"cancelled_at\": \"2025-11-06T12:30:00Z\", // Required if status = canceled. Omit otherwise.\n \"stay_dates\": [\n {\n \"date\": \"2025-11-06\",\n \"room_reservation_id\": \"RES510-A\",\n \"room_type_id\": \"DBL\",\n \"room_type_name\": \"Double Room\",\n \"room_number\": \"101\",\n \"originally_booked_room_type_id\": \"SGL\",\n \"originally_booked_room_type_name\": \"Single Room\",\n \"is_virtual_room\": false,\n \"rate_plan_id\": \"BAR\",\n \"rate_plan_name\": \"Bar Rate\",\n \"market_segment_id\": \"MS001\",\n \"market_segment_name\": \"leisure\",\n \"number_of_adults\": 1,\n \"number_of_children\": 0,\n \"rate_gross_amount\": \"95.0\",\n \"rate_net_amount\": \"80.75\",\n \"room_revenue_gross_amount\": \"190.0\",\n \"room_revenue_net_amount\": \"161.5\",\n \"fnb_gross_amount\": \"45.0\",\n \"fnb_net_amount\": \"38.25\",\n \"currency_code\": \"EUR\"\n },\n {\n \"date\": \"2025-11-07\",\n \"room_reservation_id\": \"RES510-A\",\n \"room_type_id\": \"DBL\",\n \"room_type_name\": \"Double Room\",\n \"room_number\": \"101\",\n \"originally_booked_roomtype_id\": \"SGL\",\n \"originally_booked_roomtype_name\": \"Single Room\",\n \"is_virtual_room\": false,\n \"rate_plan_id\": \"BAR\",\n \"rate_plan_name\": \"Bar Rate\",\n \"market_segment_id\": \"MS002\",\n \"market_segment_name\": \"business\",\n \"number_of_adults\": 1,\n \"rate_gross_amount\": \"100.0\",\n \"rate_net_amount\": \"85.0\",\n \"room_revenue_gross_amount\": \"200.0\",\n \"room_revenue_net_amount\": \"170.0\",\n \"other_gross_amount\": \"45.0\",\n \"other_net_amount\": \"38.25\",\n \"currency_code\": \"GBP\"\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{server-backend}}/integrations/api/v1/event/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"event\": \"reservation.update\",\n \"tracking_id\": \"aeadfd86-f4ef-4344-9c36-ea8ad5f32d66\",\n \"property_code\": \"986\"\n}"}],"_postman_id":"dde4483d-1511-48ec-8885-f8fc9f1f8057"},{"name":"Reservations Update (Standard Partners)","id":"95347c90-2907-4f39-945f-1be25ada03f7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"Nightly-level rates data. Sorted by stay date (chronological order). Should only include dates that are equal or greater than arrival_date and before departure_date.
\n
Reservation Endpoint for Standard Integrations
\nFor partners with standard integrations (not built against the RoomPriceGenie Open API), we provide a reservation endpoint that allows them to send reservation data for our Reporting feature. This integration follows a simplified flow compared to the Open API setup, with the differences outlined below:
\n- \n
Authentication: Authentication is done by passing the partner API key in the request header:
\nx-api-key. There is no pre-authentication flow required (no access tokens, refresh tokens, or OTT exchange). \nEndpoint URL:
\n/integrations/api/v1/reservation/\nProperty Code: The
\nproperty_codemust be the same value used in the pricing integration. In most cases, this corresponds to the partner’s account ID. If you are unsure which value to use, please contact us for confirmation. \nPayload: Apart from the differences described above, the request payload follows the same structure as documented for reservation events.
\n \n
Any other Open API–specific concepts and flows described elsewhere in this documentation do not apply to standard integrations.
\n","urlObject":{"path":["integrations","api","v1","reservation",""],"host":["{{server-backend}}"],"query":[],"variable":[]}},"response":[{"id":"f9e99cb4-8183-45ee-a697-273e1ba9e5e5","name":"Reservations Update (Standard Partners)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-API-Key","value":"partner-api-key","type":"text"}],"body":{"mode":"raw","raw":"{\n \"event\": \"reservation.update\",\n \"tracking_id\": \"aeadfd86-f4ef-4344-9c36-ea8ad5f32d66\",\n \"property_code\": \"Hotel123\", // The same property code used for the pricing integration.\n \"partner_property_code\": \"Hotel123\", // The account ID on the partner side. It may be the same as property_code\n \"data\": [\n {\n \"reservation_id\": \"RES510\",\n \"group_reservation_id\": \"GRP510\",\n \"shared_reservation_id\": \"SHARE123\",\n \"status\": \"confirmed\",\n \"arrival_date\": \"2025-11-06\",\n \"departure_date\": \"2025-11-08\",\n \"guest_country_code\": \"NL\",\n \"guest_company_name\": \"ACME Unlimited\",\n \"guest_company_id\": \"CO001\",\n \"source_name\": \"OTA\",\n \"source_id\": \"OTA001\",\n \"channel_name\": \"Booking.com\",\n \"channel_id\": \"CH001\",\n \"travel_agent_name\": \"Genie Travels\",\n \"travel_agent_id\": \"TA001\",\n \"created_at\": \"2025-10-10T09:00:00Z\",\n \"updated_at\": \"2025-11-06T12:30:00Z\",\n \"cancelled_at\": \"2025-11-06T12:30:00Z\", // Required if status = canceled. Omit otherwise.\n \"stay_dates\": [\n {\n \"date\": \"2025-11-06\",\n \"room_reservation_id\": \"RES510-A\",\n \"room_type_id\": \"DBL\",\n \"room_type_name\": \"Double Room\",\n \"room_number\": \"101\",\n \"originally_booked_room_type_id\": \"SGL\",\n \"originally_booked_room_type_name\": \"Single Room\",\n \"is_virtual_room\": false,\n \"rate_plan_id\": \"BAR\",\n \"rate_plan_name\": \"Bar Rate\",\n \"market_segment_id\": \"MS001\",\n \"market_segment_name\": \"leisure\",\n \"number_of_adults\": 1,\n \"number_of_children\": 0,\n \"rate_gross_amount\": \"95.0\",\n \"rate_net_amount\": \"80.75\",\n \"room_revenue_gross_amount\": \"190.0\",\n \"room_revenue_net_amount\": \"161.5\",\n \"fnb_gross_amount\": \"45.0\",\n \"fnb_net_amount\": \"38.25\",\n \"currency_code\": \"EUR\"\n },\n {\n \"date\": \"2025-11-07\",\n \"room_reservation_id\": \"RES510-A\",\n \"room_type_id\": \"DBL\",\n \"room_type_name\": \"Double Room\",\n \"room_number\": \"101\",\n \"originally_booked_roomtype_id\": \"SGL\",\n \"originally_booked_roomtype_name\": \"Single Room\",\n \"is_virtual_room\": false,\n \"rate_plan_id\": \"BAR\",\n \"rate_plan_name\": \"Bar Rate\",\n \"market_segment_id\": \"MS002\",\n \"market_segment_name\": \"business\",\n \"number_of_adults\": 1,\n \"rate_gross_amount\": \"100.0\",\n \"rate_net_amount\": \"85.0\",\n \"room_revenue_gross_amount\": \"200.0\",\n \"room_revenue_net_amount\": \"170.0\",\n \"other_gross_amount\": \"45.0\",\n \"other_net_amount\": \"38.25\",\n \"currency_code\": \"GBP\"\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{server-backend}}/integrations/api/v1/reservation/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"event\": \"reservation.update\",\n \"tracking_id\": \"aeadfd86-f4ef-4344-9c36-ea8ad5f32d66\",\n \"property_code\": \"Hotel123\"\n}"},{"id":"0cdcfc78-26b8-4c56-aef1-42d66bb4c078","name":"Reservations Update (Standard Partners)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"event\": \"reservation.update\",\n \"tracking_id\": \"6b66d4b7-577d-493d-8cbe-81493a4cba2b\",\n \"property_code\": \"{{property_code}}\",\n \"partner_property_code\": \"{{partner_account_id}}\",\n \"data\": [\n {\n \"arrival_date\": \"2026-01-19\",\n \"channel_id\": \"PMS\",\n \"channel_name\": \"PMS\",\n \"created_at\": \"2026-01-19T16:37:25.767864Z\",\n \"updated_at\": \"2026-04-16T02:04:50.182Z\",\n \"cancelled_at\": \"2026-04-16T02:04:50.182Z\",\n \"departure_date\": \"2026-01-21\",\n \"group_reservation_id\": \"cas2630881244\",\n \"guest_country_code\": \"DE\",\n \"reservation_id\": \"cas2630881244\",\n \"source_id\": \"4\",\n \"source_name\": \"E-Mail\",\n \"status\": \"cancelled\",\n \"stay_dates\": [\n {\n \"currency_code\": \"EUR\",\n \"date\": \"2026-01-19\",\n \"fnb_gross_amount\": \"0\",\n \"fnb_net_amount\": \"0\",\n // \"is_virtual_room\": false,\n \"number_of_adults\": 0,\n // \"other_gross_amount\": \"52.00\",\n // \"other_net_amount\": \"48.36\",\n \"rate_gross_amount\": \"0\",\n \"rate_net_amount\": \"0\",\n \"rate_plan_id\": \"-\",\n \"rate_plan_name\": \"-\",\n // \"room_number\": \"501\",\n // \"room_reservation_id\": \"cro2604542703\",\n \"room_revenue_gross_amount\": \"0\",\n \"room_revenue_net_amount\": \"0\",\n \"room_type_id\": \"-\",\n \"room_type_name\": \"-\"\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{server-backend}}/integrations/api/v1/reservation/"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Fri, 06 Feb 2026 11:22:32 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"allow","value":"POST, OPTIONS"},{"key":"x-frame-options","value":"DENY"},{"key":"vary","value":"Authorization, origin"},{"key":"x-content-type-options","value":"nosniff"},{"key":"referrer-policy","value":"same-origin"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"x-request-id","value":"7605b70e-929b-401a-bdca-a21db0121b55"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Strict-Transport-Security","value":"max-age=2592000; includeSubDomains; preload"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=MzS6NeAY%2FnvUhAG5vrXTmMshR%2Fvhx89L989p3U3P8tRI7llfLMNG%2FkSI%2Fqil5WwKmJe9iHSSFaGZD79KH1YHOSxDn81yRa1NMDBL2iWw98vhH%2BE7HaRhoW85kne9NAMky5LR\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"9c9a4525cfe8f19c-GRU"}],"cookie":[],"responseTime":null,"body":"{\n \"event\": \"reservation.update\",\n \"tracking_id\": \"dfb851a5-f65d-47eb-856d-098d432e3dd0\",\n \"property_code\": \"6157ba50-1c3e-4e86-be2e-c8a25362b748\"\n}"}],"_postman_id":"95347c90-2907-4f39-945f-1be25ada03f7"}],"id":"3c10b740-5d96-44e4-9d38-21d8ac83657c","description":"By providing detailed reservation data via the Open API integration, you enable RoomPriceGenie to deliver rich, actionable reporting and analytics to our common clients. This includes insights into booking patterns, market segmentation, revenue breakdowns, and guest behavior — all displayed in a user-friendly dashboard. With this integration, hoteliers can make faster, more informed decisions and better understand how their business is performing over time.
\nInitial Setup:
\n- \n
For each hotel, we require a minimum of 2 years of reservation history, ideally 3 years, along with all future reservations. This includes all reservations that have stayed at the hotel within that date range.
\n \nYou can send up to 200 reservations in a single payload.
\n \n
Ongoing Updates:
\nAfter the initial setup, we expect real-time updates if possible. If real-time is not feasible, a minimum of hourly pushes is required. Each push should include all reservations that have been created, modified, checked-in/out, or cancelled since the last push.
\nFrequently Asked Questions
\nFor more detail on specific implementation scenarios and common edge cases, refer to the Frequently Asked Questions section.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access-token}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"d1368035-1681-4772-a3c8-7410ee0ece1d","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"51200d38-42e7-477b-a552-57499787e6bb","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"3c10b740-5d96-44e4-9d38-21d8ac83657c"},{"name":"🧩 Revenue Intelligence SDK","item":[{"name":"Request OTT Code","event":[{"listen":"prerequest","script":{"id":"bdd175e2-2b0e-4fab-bbb1-63bd272e7833","exec":["// 1) API key","const apiKey = pm.environment.get('partner-api-key');","if (!apiKey) throw new Error('Missing partner-api-key');","","// 2) Resolve vars from the current raw body and ensure valid JSON/types","const currentContentType = pm.request.headers.get('Content-Type');","const currentLanguage = pm.request.body?.options?.raw?.language;","","const raw = pm.request.body?.mode === 'raw' ? (pm.request.body.raw || '{}') : '{}';","const resolved = pm.variables.replaceIn(raw);","let bodyObj;","try {"," bodyObj = JSON.parse(resolved);","} catch {"," throw new Error('Body must be valid JSON after variable substitution');","}","","// Enforce required fields/types (numbers, not strings)","if (typeof bodyObj.partner_id !== 'number') bodyObj.partner_id = Number(bodyObj.partner_id);","const ts = Math.floor(Date.now() / 1000);","bodyObj.timestamp = ts;","","// Reorder to the server’s expected order and minify","const ordered = {"," scope: bodyObj.scope,"," username: bodyObj.username,"," property_code: bodyObj.property_code,"," partner_id: bodyObj.partner_id,"," timestamp: bodyObj.timestamp,","};","const message = JSON.stringify(ordered); // minified, correct order","","// 3) Compute signature over EXACT string you’ll send","const sig = CryptoJS.HmacSHA256(message, apiKey).toString(CryptoJS.enc.Hex);","","// 4) Update request and headers to match the signed string","pm.request.body.update(message);","pm.request.headers.upsert({ key: 'X-Request-Signature', value: sig });","","// Preserve UI settings","if (currentLanguage && pm.request.body?.options?.raw) {"," pm.request.body.options.raw.language = currentLanguage;","}","if (!currentContentType) {"," pm.request.headers.upsert({ key: 'Content-Type', value: 'application/json' });","}","","// Expose for debugging if needed","pm.variables.set('unix_ts', String(ts));","pm.variables.set('HMAC-SHA256-Signature', sig);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"aea383e3-ccce-4d93-8e13-f661a24ec63f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-request-signature","value":"{{HMAC-SHA256-Signature}}"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"scope\":\"genieinside-widget\",\"username\":\"john@doe.com\",\"property_code\":\"345342\",\"partner_id\":1234,\"timestamp\":12345678}","options":{"raw":{"language":"json"}}},"url":"{{server-backend}}/integrations/v1/connect/","description":"Backend Authentication
\nTo initialize the SDK, you first need an OTT (one-time token). To request it, build a minified JSON body using this exact key order: scope, username, property_code, partner_id, timestamp (no spaces or line breaks, and keep numbers as numbers). Then generate an HMAC-SHA256 signature of that exact JSON string using your Partner API key and send the signature in the X-Request-Signature header.
Request Body
\n{\"scope\":\"genieinside-widget\",\"username\":\"john@doe.com\",\"property_code\":\"345342\",\"partner_id\":1234,\"timestamp\":12345678}\n\nResponse
\nThe response will provide a OTT value. This is a one time token, that expires very quickly. Do not cache it. Every time you initiate the SDK, you should request a new OTT and pass it over.
\n{ \"ott\": \"zltZcUH0IguNdAQZjdasNAjpC7jdJKIjPr1CnBw8\" }\n\n💡 Notes
\n- \n
If your system doesn't use email addresses as usernames but has email addresses associated with usernames, you must send the email address in the request. If you don't have access to users' email addresses, please reach out to discuss alternative solutions.
\n \nAs long as your Partner ID and Partner API key are correct, and the X-Request-Signature is valid, the authentication endpoint will return an OTT. This is true even if we can’t match the property_code and/or username to an account on our side.
\n \nFor development testing, please share an email address that is registered as a user in your system, so we can add it to a test account in RoomPriceGenie.
\n \n
\"Revenue Intelligence” (formerly GenieInside) is our JavaScript SDK that adds a widget inside your PMS. The goal is simple: your shared users can see RoomPriceGenie insights right where they’re working, without switching tabs or juggling extra windows, so they can stay focused and move faster.
\n\n\nPlease note that the \"Revenue Intelligence\" SDK is still in development, so you may experience some issues during testing. We’re actively improving it and appreciate your feedback—feel free to share it with us at integrations@roompricegenie.com
\n
Implementation
\nTo embed the “Revenue Intelligence” SDK in your PMS, add the snippet below to your frontend page template right before the closing tag. Replace OTT_KEY_HERE with the OTT returned by the authentication request, and adjust the config parameters as needed.
\n <script src=\"https://cdn.roompricegenie.com/latest/genie-inside-client-sdk.umd.js\" crossorigin=\"anonymous\"></script>\n <script>\n GenieInside.init('OTT_KEY_HERE', {\n environment: 'development',\n position: 'floating',\n language: 'en'\n });\n </script>\n\nUse the parameters below to configure the SDK. Values shown in bold are the defaults.
\nBundle (files, versioning, integrity)
\nOur SDK bundles are hosted on our CDN. The /latest/ path always points to the most recently released build.
Bundle info (released version, file URLs, integrity hashes):
https://cdn.roompricegenie.com/latest/bundle-info.json
Main files (see bundle-info.json for exact URLs):
- \n
- UMD bundle:
genie-inside-client-sdk.umd.js\n - Iframe bundle:
iframe.js\n - Iframe HTML:
iframe.html\n - Type definitions:
GenieInside.d.ts\n
Packaging / distribution format:
The SDK is distributed as a UMD bundle (works with <script> tag, AMD, CommonJS, and many bundlers).
Integrity checks (optional):
We publish Subresource Integrity (SRI) values in the integrity field inside bundle-info.json.
- \n
- Development (pre-launch): we recommend not enforcing integrity/hash checks. We are iterating quickly and
/latest/updates over time. If you enforce integrity with/latest/, you’ll need to update the hash frequently. \n - Production: if you want more stability, you may enforce integrity checks (SRI). In that case, pin to a specific released version (avoid
/latest/) and use the matchingintegrityvalue frombundle-info.json. \n
Browser compatibility
\nThe SDK is compatible with Chrome 64+, Firefox 67+, Safari 12+, Edge 79+
\nDistribution format: UMD (works in browsers, Node.js, AMD, CommonJS).
\nTroubleshooting
\n","_postman_id":"732befa7-6230-4b9a-b076-1d076a2cb42b"},{"name":"🔬 Future Implementations","item":[{"name":"Request iframe URL","id":"9ce14903-0930-4a40-aeef-82390e3193c6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"x-request-signature","value":"{{HMAC-SHA256-Signature}}","type":"text"}],"body":{"mode":"raw","raw":"{\"scope\":\"roompricegenie-ui\",\"username\":\"john@doe.com\",\"property_code\":\"345342\",\"partner_id\":1234,\"timestamp\":12345678}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"{{server-backend}}/integrations/api/v1/iframe/","description":"We’d love to help you offer a more seamless experience to our mutual clients. RoomPriceGenie can provide a secure URL that you can embed in your system using an iframe. This allows your users to access their RoomPriceGenie account directly within your platform—no extra logins or new windows—making it simple and convenient for them to manage rates without ever leaving your app.
\nRequest Body
\nAuthentication
\nAuthentication requires an HMAC-SHA256 signature passed in the X-Request-Signature header. To generate it, construct a minified JSON body with keys in this exact order: scope, username, property_code, partner_id, timestamp. Ensure there are no spaces or line breaks, and that numeric values remain as numbers. Then sign that exact JSON string using your Partner API key.
Response
\n{\n \"url\": \"https://iframe.roompricegenie.com/?token=dc2b15951b&hotel_id=37&language=en-US\",\n \"valid_until\": \"2026-03-13T16:48:15.855254Z\",\n \"message\": \"Connected hotel found\"\n}\n\nImportant Notes
\n- \n
If you have already implemented the Revenue Intelligence SDK, the same authentication logic applies here — only the
\nscopevalue and endpoint URL are different. \nThe
\nusernamemust be the email address of the user currently logged into your PMS.- \n
- If you don't have access to the user's email address, contact us to discuss alternatives. \n
\nThe returned URL can be embedded in your web application using a standard tag.
\n \nIf the email address matches a RoomPriceGenie account with access to the specified property, we will return a URL containing an authentication token that grants the same permission level as that user for that property — no additional login will be required.
\n \nIf no matching account is found, or the user doesn't have access to the specified property, the returned URL will point to the RoomPriceGenie login page, where the user can sign in with their username and password as usual.
\n \n