# Hotelbeds hotel mapping solutions

> URL: https://hotelmapping.org/en/integrations/hotelbeds-hotel-mapping-solutions/ · Language: English

Static hotel data from Hotelbeds is processed on hotelmapping.org as a ready connector: hotel codes, room names, board codes and destination codes are standardized and linked to a permanent HM ID. As a result, Hotelbeds inventory merges into the same hotel card as your other suppliers.

## About the provider

Hotelbeds is a B2B accommodation supplier (bedbank) that sells hotel rooms wholesale to agencies, tour operators and other travel companies. It operates under the HBX Group. It provides static hotel content and availability/rate data through separate APIs.

Official website: https://www.hotelbeds.com

## What data we map

- Hotelbeds hotel code → HM ID
- Hotel name, address, phone and website (for scoring)
- Coordinates → latitude and longitude selected from supplier records (validation planned)
- Room codes and room names → standard room type, view, bed
- Board codes → RO, BB, HB, FB, AI, UAI…
- Destination and zone codes → country, province, district, resort area
- Star rating and property category

## Challenges specific to this provider

- **A large, constantly changing catalog:** In a global bedbank catalog, hotels are added, closed or updated every day. A one-time mapping is not enough; changes must be reprocessed on a regular basis.
- **Supplier-specific room and board codes:** Room and board information arrives with the supplier's own code list. The same abbreviation can mean something different at another supplier, so codes cannot be compared until they are translated into a standard dictionary.
- **Resort area distinctions:** Destination codes are kept at a different level by each supplier. A hotel one supplier calls Belek may be listed under Serik or Antalya by another; the hierarchy has to close that gap.
- **Multiple records for the same property:** In large catalogs the same property can appear with several codes for different sections or different contracts. Whether these codes link to the same HM ID or to separate records is decided by rules and human review.

## Sample output

**GET /v1/suppliers/hotelbeds/codes/918274 (fictional code)**

```json
{
  "supplier": "hotelbeds",
  "code": "918274",
  "supplier_name": "LARA PALM HOTEL",
  "hm_id": "HM-1052207",
  "name": "Lara Palm Hotel",
  "destination_id": "TR-07-MURATPASA-LARA",
  "confidence": 0.993,
  "matched_at": "2026-11-02T08:14:00Z"
}
```

## Why does Hotelbeds data need separate mapping?

For an agency that works with several suppliers alongside Hotelbeds, the same hotel appears multiple times in the list when no mapping is done. A Hotelbeds hotel code is meaningful only inside the Hotelbeds system; it cannot be compared directly with another supplier's code. [Hotel mapping](https://hotelmapping.org/en/products/hotel-mapping-solutions/) gathers these codes under a single permanent identity, the HM ID. If you are new to the topic, start with the [what is hotel mapping](https://hotelmapping.org/en/guide/what-is-hotel-mapping/) guide.

## Which field becomes what?

| Hotelbeds data | Standard output |
| --- | --- |
| Hotel code | HM ID (e.g. `HM-1052207`) |
| Room code and room name | HM room ID, room type, view, bed |
| Board code | Standard code: RO, BB, HB, FB, AI, UAI… |
| Destination code | Hierarchy in the form `TR-07-MURATPASA-LARA` |
| Coordinates | Latitude and longitude selected from supplier records (validation planned) |

## Flow

1. Static data is received through the ready connector and stored in its raw form.
2. Name, address and coordinates are normalized; each record is scored against nearby candidates.
3. A score of 0.97 or higher matches automatically; 0.80–0.97 goes to human review; below 0.80 creates a new HM ID.
4. The result reaches you through the REST API and a daily dump.

You can see how board codes are translated on the [board mapping](https://hotelmapping.org/en/products/board-mapping-solutions/) page. For the bedbank concept, see the [glossary definition](https://hotelmapping.org/en/glossary/bedbank/).

_Connection status and brand usage will be verified with the provider before launch._

## Frequently asked questions

### How do you receive Hotelbeds data?

Static data is received through the ready connector; the connection typically works with the API access of your own Hotelbeds account. If you prefer, you can also upload a file you exported, as CSV or JSON.

### Can I use this service without a contract with Hotelbeds?

hotelmapping.org does not sell rooms and is not a supplier. Mapping is done on the data of suppliers you already work with; if you do not work with Hotelbeds, you do not need this connector.

### What happens if a Hotelbeds code changes?

The HM ID is permanent and is never reused. The new Hotelbeds code goes through mapping; if it belongs to the same property, it is linked to the existing HM ID. Exposing code change history through the API and webhooks is planned.

## Related products

- [Hotel mapping solutions](https://hotelmapping.org/en/products/hotel-mapping-solutions/)
- [Destination mapping solutions](https://hotelmapping.org/en/products/destination-mapping-solutions/)
- [Board mapping solutions](https://hotelmapping.org/en/products/board-mapping-solutions/)
