HM ID
HM ID (hotelmapping ID)
Definition
An HM ID is the permanent identifier hotelmapping.org gives to each lodging property; it collects all of the property's supplier codes and cross-references such as the customer's own hotel codes in a single record, and it is never reassigned to another hotel.
An HM ID is a number with the “HM-” prefix (e.g., HM-1048213); rooms in the hotel are linked to this number with a room suffix (HM-1048213-R03). An agency or tour operator works only with the HM ID; hotelmapping.org keeps track of which supplier code each supplier uses for the same hotel. The hotel IDs of your existing mapping provider or your own system are also kept in the same record as cross-references. The ID is permanent: if a hotel closes, the record’s status (status) becomes closed; if two records turn out to be duplicates and are merged, the old HM ID’s status becomes merged and the merged_into field points to the new HM ID; the number is never given to another property. HM ID records are accessible through the API (GET /v1/hotels/{hm_id}) or through daily full and delta dump files. You can find how to get from a supplier code to an HM ID on the hotel mapping product page, and the background of the concept in the guide What is hotel mapping?.
Example
Supplier B's hotel with code 40917 is linked to ID HM-1048213. The sea view double room in the same hotel carries HM-1048213-R03, and the Belek resort area containing the hotel carries TR-07-SERIK-BELEK.