{"info":{"_postman_id":"dfb9fb5c-e609-489a-83ee-0ea3d9e25c86","name":"StructurrAI room mapping","description":"

StructurrAI Room Mapping

\n

This collection provides an interface for mapping supplier room data to StructurrAI's standardized room taxonomy. It is designed to help normalize and reconcile room information sourced from third-party suppliers (e.g., TBO) against StructurrAI's internal hotel and room catalog.

\n

What's included

\n

Folder: room mapping

\n\n
The `sync` flag controls whether the mapping is processed synchronously.\n\n

Authentication

\n

Requests are authenticated using an api-key header.

\n

Base URL

\n

All requests use the environment variable. Make sure the appropriate environment is selected before running requests.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"46998739","collectionId":"dfb9fb5c-e609-489a-83ee-0ea3d9e25c86","publishedId":"2sBXwmPYG5","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-05-25T13:17:30.000Z"},"item":[{"name":"room mapping","item":[{"name":"room_mappings","id":"6712ade6-0583-47e0-afca-74e2d8240d24","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"bkNROEwhZP9As3ePldGvJL8ze2wXme3HwIuIHTbPEjA","type":"text"}],"body":{"mode":"raw","raw":"{\n \"sync\": true,\n \"rooms\": [\n {\n \"name\": \"Deluxe Room, 1 King Bed (City View)\",\n \"index\": 1,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed (City View),NonSmoking\",\n \"index\": 2,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed (Family),NonSmoking\",\n \"index\": 3,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed (Grand),NonSmoking\",\n \"index\": 4,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed (High Floor),NonSmoking\",\n \"index\": 5,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed (with sofa bed)\",\n \"index\": 6,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed (with sofa bed),NonSmoking\",\n \"index\": 7,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed, Balcony\",\n \"index\": 8,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed, Balcony,NonSmoking\",\n \"index\": 9,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed, Bay View,NonSmoking\",\n \"index\": 10,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \" Junior Studio Suite\",\n \"index\": 11,\n \"hotel_id\": \"\"\n },\n {\n \"name\": \"Junior Suite - Studio\",\n \"index\": 12,\n \"hotel_id\": \"\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"/api/v2/room-mappings","urlObject":{"path":["api","v2","room-mappings"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"0288dd82-51fe-4181-86f6-21addefc361f","name":"room_mappings","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"rooms\": [\n {\n \"name\": \"Deluxe Room, 1 King Bed (City View)\",\n \"index\": 1,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed (City View),NonSmoking\",\n \"index\": 2,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed (Family),NonSmoking\",\n \"index\": 3,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed (Grand),NonSmoking\",\n \"index\": 4,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed (High Floor),NonSmoking\",\n \"index\": 5,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed (with sofa bed)\",\n \"index\": 6,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed (with sofa bed),NonSmoking\",\n \"index\": 7,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed, Balcony\",\n \"index\": 8,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed, Balcony,NonSmoking\",\n \"index\": 9,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"name\": \"Deluxe Room, 1 King Bed, Bay View,NonSmoking\",\n \"index\": 10,\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n }\n ],\n \"sync\": true,\n \"skip_ft\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://api.structurrai.com/api/v2/room-mappings"},"_postman_previewlanguage":"","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Room extraction completed\",\n \"data\": {\n \"hotel_id\": 0,\n \"results\": [\n {\n \"structurrai_room_code\": \"STR_0_0\",\n \"room_name\": \"Deluxe Room, 1 King Bed (City View)\",\n \"type_of_accomodation\": \"Room\",\n \"room_category\": \"Deluxe\",\n \"bed_type\": \"King\",\n \"view_type\": \"City View\",\n \"bed_count\": \"1\",\n \"bedroom_count\": null,\n \"family_room\": false,\n \"family_suite\": false,\n \"family_villa\": false,\n \"guest_room\": false,\n \"master_suite\": false,\n \"business_class\": false,\n \"duplex\": false,\n \"connecting_rooms\": false,\n \"balcony\": false,\n \"terrace_access\": false,\n \"pool_access\": false,\n \"spa\": false,\n \"jacuzzi\": false,\n \"sauna\": false,\n \"kitchenette\": false,\n \"bathtub\": false,\n \"bar\": false,\n \"living_room\": false,\n \"club_lounge_access\": false,\n \"high_floor\": false,\n \"low_floor\": false,\n \"windowless\": false,\n \"smoking_allowed\": false,\n \"extra_bed\": false,\n \"room_description\": null,\n \"room_size_sqm\": null,\n \"room_size_sqft\": null,\n \"image_urls\": [],\n \"rooms\": [\n {\n \"index\": 1,\n \"room_name\": \"Deluxe Room, 1 King Bed (City View)\",\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"index\": 2,\n \"room_name\": \"Deluxe Room, 1 King Bed (City View),NonSmoking\",\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n }\n ],\n \"fine_tuned_status\": \"fine_tuned_not_triggered\"\n },\n {\n \"structurrai_room_code\": \"STR_0_1\",\n \"room_name\": \"Deluxe Room, 1 King Bed (Family),NonSmoking\",\n \"type_of_accomodation\": \"Room\",\n \"room_category\": \"Deluxe\",\n \"bed_type\": \"King\",\n \"view_type\": null,\n \"bed_count\": \"1\",\n \"bedroom_count\": null,\n \"family_room\": true,\n \"family_suite\": false,\n \"family_villa\": false,\n \"guest_room\": false,\n \"master_suite\": false,\n \"business_class\": false,\n \"duplex\": false,\n \"connecting_rooms\": false,\n \"balcony\": false,\n \"terrace_access\": false,\n \"pool_access\": false,\n \"spa\": false,\n \"jacuzzi\": false,\n \"sauna\": false,\n \"kitchenette\": false,\n \"bathtub\": false,\n \"bar\": false,\n \"living_room\": false,\n \"club_lounge_access\": false,\n \"high_floor\": false,\n \"low_floor\": false,\n \"windowless\": false,\n \"smoking_allowed\": false,\n \"extra_bed\": false,\n \"room_description\": null,\n \"room_size_sqm\": null,\n \"room_size_sqft\": null,\n \"image_urls\": [],\n \"rooms\": [\n {\n \"index\": 3,\n \"room_name\": \"Deluxe Room, 1 King Bed (Family),NonSmoking\",\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n }\n ],\n \"fine_tuned_status\": \"fine_tuned_triggered_responded\"\n },\n {\n \"structurrai_room_code\": \"STR_0_2\",\n \"room_name\": \"Deluxe Room, 1 King Bed (Grand),NonSmoking\",\n \"type_of_accomodation\": \"Room\",\n \"room_category\": \"Grand Deluxe\",\n \"bed_type\": \"King\",\n \"view_type\": null,\n \"bed_count\": \"1\",\n \"bedroom_count\": null,\n \"family_room\": false,\n \"family_suite\": false,\n \"family_villa\": false,\n \"guest_room\": false,\n \"master_suite\": false,\n \"business_class\": false,\n \"duplex\": false,\n \"connecting_rooms\": false,\n \"balcony\": false,\n \"terrace_access\": false,\n \"pool_access\": false,\n \"spa\": false,\n \"jacuzzi\": false,\n \"sauna\": false,\n \"kitchenette\": false,\n \"bathtub\": false,\n \"bar\": false,\n \"living_room\": false,\n \"club_lounge_access\": false,\n \"high_floor\": false,\n \"low_floor\": false,\n \"windowless\": false,\n \"smoking_allowed\": false,\n \"extra_bed\": false,\n \"room_description\": null,\n \"room_size_sqm\": null,\n \"room_size_sqft\": null,\n \"image_urls\": [],\n \"rooms\": [\n {\n \"index\": 4,\n \"room_name\": \"Deluxe Room, 1 King Bed (Grand),NonSmoking\",\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n }\n ],\n \"fine_tuned_status\": \"fine_tuned_not_triggered\"\n },\n {\n \"structurrai_room_code\": \"STR_0_3\",\n \"room_name\": \"Deluxe Room, 1 King Bed (High Floor),NonSmoking\",\n \"type_of_accomodation\": \"Room\",\n \"room_category\": \"Deluxe\",\n \"bed_type\": \"King\",\n \"view_type\": null,\n \"bed_count\": \"1\",\n \"bedroom_count\": null,\n \"family_room\": false,\n \"family_suite\": false,\n \"family_villa\": false,\n \"guest_room\": false,\n \"master_suite\": false,\n \"business_class\": false,\n \"duplex\": false,\n \"connecting_rooms\": false,\n \"balcony\": false,\n \"terrace_access\": false,\n \"pool_access\": false,\n \"spa\": false,\n \"jacuzzi\": false,\n \"sauna\": false,\n \"kitchenette\": false,\n \"bathtub\": false,\n \"bar\": false,\n \"living_room\": false,\n \"club_lounge_access\": false,\n \"high_floor\": true,\n \"low_floor\": false,\n \"windowless\": false,\n \"smoking_allowed\": false,\n \"extra_bed\": false,\n \"room_description\": null,\n \"room_size_sqm\": null,\n \"room_size_sqft\": null,\n \"image_urls\": [],\n \"rooms\": [\n {\n \"index\": 5,\n \"room_name\": \"Deluxe Room, 1 King Bed (High Floor),NonSmoking\",\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n }\n ],\n \"fine_tuned_status\": \"fine_tuned_triggered_responded\"\n },\n {\n \"structurrai_room_code\": \"STR_0_4\",\n \"room_name\": \"Deluxe Room, 1 King Bed (with sofa bed)\",\n \"type_of_accomodation\": \"Room\",\n \"room_category\": \"Deluxe\",\n \"bed_type\": \"King & Sofa Bed\",\n \"view_type\": null,\n \"bed_count\": \"1 & 1\",\n \"bedroom_count\": null,\n \"family_room\": false,\n \"family_suite\": false,\n \"family_villa\": false,\n \"guest_room\": false,\n \"master_suite\": false,\n \"business_class\": false,\n \"duplex\": false,\n \"connecting_rooms\": false,\n \"balcony\": false,\n \"terrace_access\": false,\n \"pool_access\": false,\n \"spa\": false,\n \"jacuzzi\": false,\n \"sauna\": false,\n \"kitchenette\": false,\n \"bathtub\": false,\n \"bar\": false,\n \"living_room\": false,\n \"club_lounge_access\": false,\n \"high_floor\": false,\n \"low_floor\": false,\n \"windowless\": false,\n \"smoking_allowed\": false,\n \"extra_bed\": false,\n \"room_description\": null,\n \"room_size_sqm\": null,\n \"room_size_sqft\": null,\n \"image_urls\": [],\n \"rooms\": [\n {\n \"index\": 6,\n \"room_name\": \"Deluxe Room, 1 King Bed (with sofa bed)\",\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"index\": 7,\n \"room_name\": \"Deluxe Room, 1 King Bed (with sofa bed),NonSmoking\",\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n }\n ],\n \"fine_tuned_status\": \"fine_tuned_not_triggered\"\n },\n {\n \"structurrai_room_code\": \"STR_0_5\",\n \"room_name\": \"Deluxe Room, 1 King Bed, Balcony\",\n \"type_of_accomodation\": \"Room\",\n \"room_category\": \"Deluxe\",\n \"bed_type\": \"King\",\n \"view_type\": null,\n \"bed_count\": \"1\",\n \"bedroom_count\": null,\n \"family_room\": false,\n \"family_suite\": false,\n \"family_villa\": false,\n \"guest_room\": false,\n \"master_suite\": false,\n \"business_class\": false,\n \"duplex\": false,\n \"connecting_rooms\": false,\n \"balcony\": true,\n \"terrace_access\": false,\n \"pool_access\": false,\n \"spa\": false,\n \"jacuzzi\": false,\n \"sauna\": false,\n \"kitchenette\": false,\n \"bathtub\": false,\n \"bar\": false,\n \"living_room\": false,\n \"club_lounge_access\": false,\n \"high_floor\": false,\n \"low_floor\": false,\n \"windowless\": false,\n \"smoking_allowed\": false,\n \"extra_bed\": false,\n \"room_description\": null,\n \"room_size_sqm\": null,\n \"room_size_sqft\": null,\n \"image_urls\": [],\n \"rooms\": [\n {\n \"index\": 8,\n \"room_name\": \"Deluxe Room, 1 King Bed, Balcony\",\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n },\n {\n \"index\": 9,\n \"room_name\": \"Deluxe Room, 1 King Bed, Balcony,NonSmoking\",\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n }\n ],\n \"fine_tuned_status\": \"fine_tuned_not_triggered\"\n },\n {\n \"structurrai_room_code\": \"STR_0_6\",\n \"room_name\": \"Deluxe Room, 1 King Bed, Bay View,NonSmoking\",\n \"type_of_accomodation\": \"Room\",\n \"room_category\": \"Deluxe\",\n \"bed_type\": \"King\",\n \"view_type\": \"Bay View\",\n \"bed_count\": \"1\",\n \"bedroom_count\": null,\n \"family_room\": false,\n \"family_suite\": false,\n \"family_villa\": false,\n \"guest_room\": false,\n \"master_suite\": false,\n \"business_class\": false,\n \"duplex\": false,\n \"connecting_rooms\": false,\n \"balcony\": false,\n \"terrace_access\": false,\n \"pool_access\": false,\n \"spa\": false,\n \"jacuzzi\": false,\n \"sauna\": false,\n \"kitchenette\": false,\n \"bathtub\": false,\n \"bar\": false,\n \"living_room\": false,\n \"club_lounge_access\": false,\n \"high_floor\": false,\n \"low_floor\": false,\n \"windowless\": false,\n \"smoking_allowed\": false,\n \"extra_bed\": false,\n \"room_description\": null,\n \"room_size_sqm\": null,\n \"room_size_sqft\": null,\n \"image_urls\": [],\n \"rooms\": [\n {\n \"index\": 10,\n \"room_name\": \"Deluxe Room, 1 King Bed, Bay View,NonSmoking\",\n \"hotel_id\": \"9054312\",\n \"supplier_name\": \"tbo\"\n }\n ],\n \"fine_tuned_status\": \"fine_tuned_not_triggered\"\n }\n ]\n },\n \"errors\": null\n}"}],"_postman_id":"6712ade6-0583-47e0-afca-74e2d8240d24"}],"id":"4185f4d7-4c97-4548-ab95-6e719c7e5612","description":"

📘 **Room Mapping API Documentation
**

\n

🔹 Overview

\n

The Room Mapping API is an AI-powered solution that standardizes supplier-provided room names into structured, canonical room definitions. It intelligently clusters similar room types and enriches them with detailed attributes such as bed configuration, view type, and website readiness.

\n

This API helps OTAs, travel agencies, bed banks, and travel technology platforms eliminate inconsistencies, improve content quality, and streamline inventory management.

\n","_postman_id":"4185f4d7-4c97-4548-ab95-6e719c7e5612"}],"variable":[{"key":"baseUrl","value":""}]}