{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"1fe024e7-d9df-4918-ade1-f719b3a77d05","name":"hotel-matching","description":"\n\n### Welcome to Travelmap.tech\n\n##### All-in-one hotel ID & room mapping suite.\n\n### hotel-matching **API User's guide.**\n\n---\n\nStatus: beta. In prod oct. 2025\n\n---\n\n**Mapping endpoint:**\n\n##### [https://meta.hotel-matching.com/hotel](https://meta.hotel-matching.com/hotel)\n\n**Management endpoint:**\n\n##### [https://meta.hotel-matching.com/manager](https://meta.hotel-matching.com/manager)\n\n---\n\n**header:** UTF8 - JSON STRING - POST - GZIP - TEXT PLAIN\n\n---\n\n\n\nThe API provides **two families of mapping tools**:\n\n1. **LIVE Mapping**\n \n - Designed for **real-time mapping** of IDs or fields.\n \n - API calls return a **JSON-formatted detailed response**.\n \n2. **JOB Mapping**\n \n - Used for **mapping entire inventories**.\n \n - API calls return a **confirmation**, with results available for download.\n \n\nBoth share the same endpoint:\n\n##### [https://meta.hotel-matching.com/hotel](https://meta.hotel-matching.com/hotel)\n\nTo interact with the mapper, create a database, upload data, the endpoint is:\n\n##### [https://meta.hotel-matching.com/manager](https://meta.hotel-matching.com/hotel)\n\n---\n\n\n\n#### _**LIVE - Mapping**_ _supplier's ID_\n\n1. _one ID at a time_\n \n2. _multiple IDs at the same time_\n \n\n#### _**LIVE - Mapping**_ _using fields_\n\n1. _with optimal fields_\n \n2. _with standard fields_\n \n3. _partial on name & address_\n \n4. _partial on name & gps_\n \n5. _partial on address & gps_\n \n6. _partial on name only_\n \n7. _reverse geocoding_\n \n\n#### _**LIVE - Mapping**_ _multiple hotels at same time_\n\n1. _using a list of hotels_\n \n\n#### _LIVE - Mapping 2 lists ( in call ) together_\n\n1. _first list mapped against the second one_\n \n\n#### _**LIVE -**_ **call enpoint:**\n\n##### [https://meta.hotel-matching.com/hotel](https://meta.hotel-matching.com/hotel)\n\n---\n\n\n\n#### _JOB - Mapping 1 versus 1 or multiple_\n\n1. _using a iso2 list_\n \n2. _at global level_\n \n3. _1 versus 1_\n \n\n#### _JOB - Duplicates finder_\n\n1. _can be your inventory or a supplier_\n \n\n#### _JOB - Discovery mode_\n\n1. _use your inventory, suppliers, OTA, GDS, aggregators all together_\n \n\n#### _**JOB -**_ **call enpoint:**\n\n##### [https://meta.hotel-matching.com/hotel](https://meta.hotel-matching.com/hotel)\n\n---\n\n\n\n#### **About Inventory, Lists & Suppliers:**\n\n- The mapper is source-agnostic: inventory, lists, and suppliers are all treated the same as data sources.\n \n- It functions as a logger, recording every action you take. Each operation generates a row of mapped IDs, stored in a table, with every row tied to a unique session ID `(sid)`\n \n- The resulting table organizes the mapped IDs into columns, with one column per supplier.\n \n- When running multiple mapping jobs, you can retrieve the results by referencing the session ID you assigned.\n \n- For best performance and cleanliness, regularly purge the inventory log once your mapping batches are complete.\n \n\n#### **About duplicates:**\n\n- Duplicates are virtually unavoidable. At one point the discrepancies between sources are such, you prefer to keep a duplicate rather than having a mapping error.\n \n- The mapper detects 99% of them.\n \n\n#### **Uploading data:**\n\n- Upload each inventory, list, or supplier listing using `(upload a supplier | using csv)` or `(upload a supplier | using json)` into a nominal database.\n \n- The mapper is source-agnostic. It does not distinguish between inventory and suppliers. Use the genuine supplier name or an alias.\n \n- You are free to map any source against any other.\n \n\n#### **The importance of session ID:**\n\n- Each mapping call can include a session ID (`sid`, up to 50 characters).\n \n- Session IDs are particularly useful for long-running mapping jobs, such as discovery or when using 1 vs 1 or X methods.\n \n- Using the session ID `(sid)`, you interact with the mapper.\n \n- To check on a mapping job progress, call the `(manage | check on status)` using your session ID `(sid)`.\n \n\n---\n\n#### **On new supplier:**\n\n- When mapping hotels with geocode fields, you can include a supplier’s name `(suppl)` and its related hotel ID `(hid)`.\n \n- The mapped table automatically updates its columns when a new supplier name is detected.\n \n- Similarly, if you provide a hotel entry with a previously unseen supplier name, a new supplier database is created & the entry is stored in it.\n \n- If the supplier already exists, the entry is simply added to the existing database.\n \n\n---\n\n#### **On missing hotel ID:**\n\n- If a hotel ID `(hid)` is not provided, the system generates a dummy ID by combining the supplier’s name with a sequential number.\n \n\n---\n\n\n\n**Real-Time Mapping Response**\n\n- When using the API for **real-time (LIVE) mapping**, the response includes a **detailed JSON object**.\n \n- The response provides structured mapping information such as IDs, geocodes, and related attributes, allowing immediate use without further processing.\n \n- See an exemple at the end of the documentation.\n \n\n##### Contact me for more on integration [olivier@room-matching.com](https://mailto:olivier@room-matching.com).\n\n| field | type | **description** |\n| --- | --- | --- |\n| input | object | the sent input |\n| mappedAtAddress | | |\n| mappedAtAddress -> geocode | object | Normalized geocodes for the input. iso postal standard address, city, gps. |\n| mappedAtAddress -> mapping | list | mapping separation per hotel |\n| mappedAtAddress -> IDtable | list | mapped IDs |\n| otherAtAddress | | |\n| otherAtAddress -> mapping | list | other options at address location |\n| otherAtAddress -> IDtable | | IDs at address location |\n| roomAtAdress | | see room-matching.com |\n\n#### **Response Objects**\n\n- **mappedAtAddress**\n \n Contains the mapped ID(s) & details for a given input. \n Use this if your main goal is simply retrieving the mapped ID.\n \n- **otherAtAddress**\n \n Lists additional IDs associated with the address. Depending on context, this may include:\n \n - other premises at same address.\n \n - Insufficiently qualified entries.\n \n - Duplicates found.\n \n- **roomAtAddress**\n \n Provides mapped hotel rooms from suppliers such as Expedia and Hotelbeds. \n You may also add your own room data or integrate from other sources.\n \n- **IDtable**\n \n Provides the list of mapped IDs per supplier. _(shortcut for IDs)_\n \n - IDtable is present in **mappedAtAddress** and **otherAtAddress**.\n \n\n---\n\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"12680266","team":1262196,"collectionId":"1fe024e7-d9df-4918-ade1-f719b3a77d05","publishedId":"2sB3HgNhiQ","public":true,"publicUrl":"https://documenter-api.postman.tech/view/12680266/2sB3HgNhiQ","privateUrl":"https://go.postman.co/documentation/12680266-1fe024e7-d9df-4918-ade1-f719b3a77d05","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"262261"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/f3544dc8-a450-4de7-8adb-5c20e7a7b349/dHJhdmVsbWFwbG9nb3NtYWxsLnBuZw==","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"262261"}},{"name":"light","logo":"https://content.pstmn.io/f3544dc8-a450-4de7-8adb-5c20e7a7b349/dHJhdmVsbWFwbG9nb3NtYWxsLnBuZw==","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"262261"}}]}},"version":"8.10.1","publishDate":"2025-08-29T08:39:12.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/f3544dc8-a450-4de7-8adb-5c20e7a7b349/dHJhdmVsbWFwbG9nb3NtYWxsLnBuZw==","logoDark":"https://content.pstmn.io/f3544dc8-a450-4de7-8adb-5c20e7a7b349/dHJhdmVsbWFwbG9nb3NtYWxsLnBuZw=="}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/7b6ba7773b97198b8eb0c1bdba9ec4719e0ebf325dba59f0666f041d35555d07","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sB3HgNhiQ"}