{ "info": { "name": "Tourmind Hotel Supplier API", "description": "", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "Search", "description": "Search for bookable hotels and rooms that meet specific criteria.\nNote: When searching for multiple rooms, the same room type and rate plan apply to all rooms, but each room may have a different occupancy count. The returned price is the total amount (including taxes and fees, if applicable) for all rooms.", "event": [], "auth": {}, "request": { "auth": {}, "method": "POST", "body": { "mode": "raw", "raw": "{\n \"hotels\": [\n \"12345\",\n \"67891\"\n ],\n \"checkIn\": \"2026-08-15\",\n \"checkOut\": \"2026-08-16\",\n \"occupancies\": [\n {\n \"roomId\": 1,\n \"adults\": 2,\n \"childrenAges\": [\n 8\n ]\n },\n {\n \"roomId\": 2,\n \"adults\": 2,\n \"childrenAges\": [\n 8\n ]\n }\n ],\n \"currency\": \"USD\",\n \"nationality\": \"US\",\n \"timeout\": 3000,\n \"requestId\": \"16c74e57-9a86-4e17-843c-3dd66cf84788\"\n}", "options": { "raw": { "language": "json" } } }, "header": [], "url": { "raw": "{{baseUrl}}/search", "path": [ "search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] } }, "response": [ { "name": "成功", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/search", "path": [ "search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "body": { "mode": "raw", "raw": "{\n \"hotels\": [\n \"12345\",\n \"67891\"\n ],\n \"checkIn\": \"2025-08-15\",\n \"checkOut\": \"2025-08-16\",\n \"occupancies\": [\n {\n \"roomId\": 1,\n \"adults\": 2,\n \"childrenAges\": [\n 8\n ]\n },\n {\n \"roomId\": 2,\n \"adults\": 2,\n \"childrenAges\": [\n 8\n ]\n }\n ],\n \"currency\": \"USD\",\n \"nationality\": \"US\",\n \"timeout\": 3000,\n \"requestId\": \"16c74e57-9a86-4e17-843c-3dd66cf84788\"\n}", "options": { "raw": { "language": "json" } } } }, "cookie": [] } ], "protocolProfileBehavior": { "strictSSL": false, "followRedirects": true } }, { "name": "Prebook", "description": "Call this API before making a reservation. This operation will verify the real-time price and availability of the selected room type and return a bookingToken for use in subsequent booking requests. The bookingToken must be valid for at least 10 minutes.\nTimeout: 12s", "event": [], "auth": {}, "request": { "auth": {}, "method": "POST", "body": { "mode": "raw", "raw": "{\n \"requestId\": \"16c74e57-9a86-4e17-843c-3dd6653453434\",\n \"hotelCode\": \"12345\",\n \"checkIn\": \"2026-03-23\",\n \"checkOut\": \"2026-03-24\",\n \"occupancies\": [\n {\n \"roomId\": 1,\n \"adults\": 2,\n \"childrenAges\": null\n }\n ],\n \"roomCode\": \"12345#DBL\",\n \"ratePlanCode\": \"1734534\",\n \"optionToken\": \"12345|12345#DBL#16#RF#32235\",\n \"nationality\": \"US\"\n}", "options": { "raw": { "language": "json" } } }, "header": [], "url": { "raw": "{{baseUrl}}/prebook", "path": [ "prebook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] } }, "response": [ { "name": "成功", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/prebook", "path": [ "prebook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "text" } } } }, "cookie": [] } ], "protocolProfileBehavior": { "strictSSL": false, "followRedirects": true } }, { "name": "Booking", "description": "The Booking operation requests a reservation confirmation for the specified rate option\nTimeout: 60s.", "event": [], "auth": {}, "request": { "auth": {}, "method": "POST", "body": { "mode": "raw", "raw": "{\n \"requestId\": \"16c74e57-9a86-4e34-843c-3dd66534ef434\",\n \"referenceId\": \"532432532\",\n \"hotelCode\": \"12345\",\n \"checkIn\": \"2026-08-24\",\n \"checkOut\": \"2026-08-25\",\n \"bookingToken\": \"12345|12345#DBL#16#RF#32235|2026-03-23|2026-03-24|2\",\n \"holder\": {\n \"firstName\": \"Shan\",\n \"lastName\": \"Zhang\",\n \"phone\": \"13212341234\",\n \"email\": \"xxx@xx.com\"\n },\n \"occupancies\": [\n {\n \"roomId\": 1,\n \"paxes\": [\n {\n \"firstName\": \"Shan\",\n \"lastName\": \"Zhang\",\n \"type\": \"ADULT\"\n },\n {\n \"age\": 8,\n \"type\": \"CHILD\"\n }\n ]\n }\n ],\n \"totalPrice\": 99.99,\n \"currency\": \"USD\",\n \"nationality\": \"US\",\n \"customerRequirements\": \"xxxxx\"\n}", "options": { "raw": { "language": "json" } } }, "header": [], "url": { "raw": "{{baseUrl}}/booking", "path": [ "booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] } }, "response": [ { "name": "成功", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/booking", "path": [ "booking" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "text" } } } }, "cookie": [] } ], "protocolProfileBehavior": { "strictSSL": false, "followRedirects": true } }, { "name": "Cancel", "description": "Cancel a confirmed reservation using the referenceId or bookingCode. Returns the cancellation status and the actual penalty amount incurred.\nTimeout: 60s.", "event": [], "auth": {}, "request": { "auth": {}, "method": "POST", "body": { "mode": "raw", "raw": "{\n \"requestId\": \"16c74e57-9a86-4e17-843c-3dd66cf86524\",\n \"referenceId\": \"532432532\"\n}", "options": { "raw": { "language": "json" } } }, "header": [], "url": { "raw": "{{baseUrl}}/cancel", "path": [ "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] } }, "response": [ { "name": "成功", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/cancel", "path": [ "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "text" } } } }, "cookie": [] } ], "protocolProfileBehavior": { "strictSSL": false, "followRedirects": true } }, { "name": "Booking List", "description": "Search for booking details using the following criteria:\n1. referenceId: TourMind booking ID\n2. bookingCode: Supplier booking ID\n3. date range: Check-in / Booking Time\nNote: The supplier must support searching for bookings by referenceId or date range. When create or canceling a booking, network timeouts may prevent us from receiving a response; in such cases, we can only retrieve the booking status using the referenceId or date range.\nTimeout: 30s.", "event": [], "auth": {}, "request": { "auth": {}, "method": "POST", "body": { "mode": "raw", "raw": "{\n \"requestId\": \"16c74e57-9a86-4e34-843c-3dd66534ef434\",\n \"referenceId\": \"532432532\"\n}", "options": { "raw": { "language": "json" } } }, "header": [], "url": { "raw": "{{baseUrl}}/bookings", "path": [ "bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] } }, "response": [ { "name": "成功", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/bookings", "path": [ "bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "text" } } } }, "cookie": [] } ], "protocolProfileBehavior": { "strictSSL": false, "followRedirects": true } }, { "name": "Hotel List", "description": "Retrieve hotel static data including basic hotel information and room type lists. Supports filtering by hotel code, country, or last update time. Results are paginated.", "event": [], "auth": {}, "request": { "auth": {}, "method": "POST", "body": { "mode": "raw", "raw": "{\n \"hotels\": [\n \"12345\"\n ],\n \"page\": 1,\n \"perPage\": 100\n}", "options": { "raw": { "language": "json" } } }, "header": [], "url": { "raw": "{{baseUrl}}/hotels", "path": [ "hotels" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] } }, "response": [ { "name": "成功", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/hotels", "path": [ "hotels" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "text" } } } }, "cookie": [] } ], "protocolProfileBehavior": { "strictSSL": false, "followRedirects": true } } ], "variable": [], "event": [], "auth": {} }