{ "info": { "name": "Tripgic API ยท Hotel", "description": "Hotel search, rooms, rates and bookings.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "Booking flow", "item": [ { "name": "Get hotel location suggestions", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{apikey}}", "type": "text" }, { "key": "secretecode", "value": "{{secretecode}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/hotel/auto-suggetion", "host": [ "{{baseUrl}}" ], "path": [ "hotel", "auto-suggetion" ] }, "body": { "mode": "raw", "raw": "{\n \"location\": \"paris\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Returns destination, city and hotel suggestions for a partial location name. Use a returned location string as the `location` value in hotel search." }, "response": [] }, { "name": "Search hotels by location and occupancy", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{apikey}}", "type": "text" }, { "key": "secretecode", "value": "{{secretecode}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/hotel/search", "host": [ "{{baseUrl}}" ], "path": [ "hotel", "search" ] }, "body": { "mode": "raw", "raw": "{\n \"location\": \"Dubai, United Arab Emirates\",\n \"radius\": \"auto\",\n \"checkIn\": \"2026-12-15\",\n \"checkOut\": \"2026-12-17\",\n \"occupancies\": [\n {\n \"adult\": \"2\"\n }\n ],\n \"guest_nationality\": \"AE\",\n \"hotel_star_level\": \"any\",\n \"partner_id\": \"1\",\n \"language\": \"en\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Searches hotels for a location, dates and room occupancies. Send a unique `short_ref` so progress logs can be polled until the search completes." }, "response": [] }, { "name": "Get room availability for a hotel", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{apikey}}", "type": "text" }, { "key": "secretecode", "value": "{{secretecode}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/hotel/rooms", "host": [ "{{baseUrl}}" ], "path": [ "hotel", "rooms" ] }, "body": { "mode": "raw", "raw": "{\n \"hotel_id\": \"H1EA00004#795905\",\n \"ittid\": \"AE00000027\",\n \"checkIn\": \"2026-12-15\",\n \"checkOut\": \"2026-12-17\",\n \"occupancies\": [\n {\n \"adult\": \"2\"\n }\n ],\n \"guest_nationality\": \"BD\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Returns room and rate availability with pricing and cancellation policies for one hotel from a search result." }, "response": [] }, { "name": "Get hotel content details", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{apikey}}", "type": "text" }, { "key": "secretecode", "value": "{{secretecode}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/hotel/get-hotel-details", "host": [ "{{baseUrl}}" ], "path": [ "hotel", "get-hotel-details" ] }, "body": { "mode": "raw", "raw": "{\n \"hotel_id\": \"H1AS00029#RTPARDAM#PAR\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Returns static content for a single hotel such as description, images, facilities and policies." }, "response": [] }, { "name": "Validate room price and policy", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{apikey}}", "type": "text" }, { "key": "secretecode", "value": "{{secretecode}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/hotel/validation-price-get-detail", "host": [ "{{baseUrl}}" ], "path": [ "hotel", "validation-price-get-detail" ] }, "body": { "mode": "raw", "raw": "{\n \"tracking_id\": 11171005026802720,\n \"room_tracking_id\": \"11175108883326193VKD98-H1AS00029-0\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Revalidates the selected room rate and returns the final price and cancellation policy before booking." }, "response": [] }, { "name": "Update guest details", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{apikey}}", "type": "text" }, { "key": "secretecode", "value": "{{secretecode}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/hotel/update-travellers", "host": [ "{{baseUrl}}" ], "path": [ "hotel", "update-travellers" ] }, "body": { "mode": "raw", "raw": "{\n \"tracking_id\": \"111771747633261941E6VT\",\n \"member_id\": \"1\",\n \"save_pax\": \"yes\",\n \"passenger\": [\n {\n \"pax_id\": \"1\",\n \"room_number\": \"1\",\n \"pax_type\": \"ADT\",\n \"gender\": \"M\",\n \"title\": \"Mr\",\n \"first_name\": \"Jhon\",\n \"last_name\": \"Doe\",\n \"age\": \"30\"\n },\n {\n \"pax_id\": \"2\",\n \"room_number\": \"1\",\n \"pax_type\": \"ADT\",\n \"gender\": \"M\",\n \"title\": \"Mr\",\n \"first_name\": \"Jons\",\n \"last_name\": \"Don\",\n \"age\": \"30\"\n },\n {\n \"pax_id\": \"3\",\n \"room_number\": \"2\",\n \"pax_type\": \"ADT\",\n \"gender\": \"M\",\n \"title\": \"Mr\",\n \"first_name\": \"Jins\",\n \"last_name\": \"Kon\",\n \"age\": \"30\"\n },\n {\n \"pax_id\": \"4\",\n \"room_number\": \"2\",\n \"pax_type\": \"ADT\",\n \"gender\": \"M\",\n \"title\": \"Mr\",\n \"first_name\": \"Smallll\",\n \"last_name\": \"Kids\",\n \"age\": \"30\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Attaches guest and contact details to a validated hotel booking session." }, "response": [] }, { "name": "Create hotel booking", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{apikey}}", "type": "text" }, { "key": "secretecode", "value": "{{secretecode}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/hotel/create-booking", "host": [ "{{baseUrl}}" ], "path": [ "hotel", "create-booking" ] }, "body": { "mode": "raw", "raw": "{\n \"tracking_id\": 11175108883326192,\n \"room_tracking_id\": \"11175108883326193VKD98-H1AS00029-0\",\n \"isd_code\": \"1\",\n \"contact_no\": \"01700000000\",\n \"email_address\": \"sandbox@example.com\",\n \"agency_isd_code\": \"1\",\n \"agency_contact_no\": \"01700000000\",\n \"agency_email\": \"sandbox@example.com\",\n \"member_id\": \"1\",\n \"special_requests_notes\": \"n/a\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Creates the hotel booking from the validated session and guest details." }, "response": [] }, { "name": "Issue hotel voucher", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{apikey}}", "type": "text" }, { "key": "secretecode", "value": "{{secretecode}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/hotel/issue-voucher", "host": [ "{{baseUrl}}" ], "path": [ "hotel", "issue-voucher" ] }, "body": { "mode": "raw", "raw": "{\n \"member_id\": \"1\",\n \"tracking_id\": \"11177251811403210FPDT2\",\n \"price_change_accepted\": \"no\",\n \"notes\": \"not required\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Issues the voucher for a confirmed hotel booking." }, "response": [] }, { "name": "Cancel hotel booking", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{apikey}}", "type": "text" }, { "key": "secretecode", "value": "{{secretecode}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/hotel/cancel-booking", "host": [ "{{baseUrl}}" ], "path": [ "hotel", "cancel-booking" ] }, "body": { "mode": "raw", "raw": "{\n \"member_id\": \"1\",\n \"tracking_id\": \"11177251811403210FPDT2\",\n \"reason\": \"not required\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Cancels an existing hotel booking and returns the cancellation outcome." }, "response": [] } ] }, { "name": "More endpoints", "item": [ { "name": "Get validated hotel room details", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{apikey}}", "type": "text" }, { "key": "secretecode", "value": "{{secretecode}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/hotel/validation-get-detail", "host": [ "{{baseUrl}}" ], "path": [ "hotel", "validation-get-detail" ] }, "body": { "mode": "raw", "raw": "{\n \"tracking_id\": \"281179388052280180CFJFB\",\n \"member_id\": \"1\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Called after /hotel/rooms succeeds, using that response's tracking_id. Returns the room list, hotel contents and echoed search parameters that b2b renders on the hotel details page. Observed in itt_b2b; semantics unconfirmed." }, "response": [] }, { "name": "Get room cancellation policy", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{apikey}}", "type": "text" }, { "key": "secretecode", "value": "{{secretecode}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/hotel/cancellation-policy", "host": [ "{{baseUrl}}" ], "path": [ "hotel", "cancellation-policy" ] }, "body": { "mode": "raw", "raw": "{\n \"hotel_id\": \"H1EA00004\",\n \"room_key\": \"281179388052280180CFJFB-H1EA00004-0\",\n \"member_id\": \"1\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Returns the cancellation policy for one room of a hotel, shown in the room cancellation modal. b2b treats an empty policy_breakdown as non-refundable and shows reason if present." }, "response": [] }, { "name": "Compare room prices with Agoda", "request": { "method": "POST", "header": [ { "key": "apikey", "value": "{{apikey}}", "type": "text" }, { "key": "secretecode", "value": "{{secretecode}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/hotel/rooms-price-comparison", "host": [ "{{baseUrl}}" ], "path": [ "hotel", "rooms-price-comparison" ] }, "body": { "mode": "raw", "raw": "{\n \"tracking_id\": \"281179388052280180CFJFB\",\n \"hotel_id\": \"H1EA00004\",\n \"checkIn\": \"2026-12-15\",\n \"checkOut\": \"2026-12-16\",\n \"occupancies\": [\n {\n \"adult\": 2,\n \"child\": 0,\n \"child_age\": []\n }\n ],\n \"guest_nationality\": \"BD\",\n \"comparator_suppler\": {\n \"supplier_code\": \"agoda\"\n },\n \"member_id\": \"1\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Sends the search parameters plus the connected Agoda supplier entry and returns per-room comparison prices. b2b indexes data[] by room_tracking_id. Observed in itt_b2b; semantics unconfirmed." }, "response": [] } ] } ], "variable": [ { "key": "baseUrl", "value": "https://serviceapi.tripgic.com" } ] }